Release v4.5.0 (#445)

## 🎯 Aim

The aim is to create a new minor release with the latest enhancements. 

## 📷 Result

![image](https://github.com/user-attachments/assets/0fe28fb9-3650-476f-b553-2734f91782d0)

![image](https://github.com/user-attachments/assets/be5d32fd-6e2e-4bd8-84fa-f8dfc07db429)

## ✅ What was done

- [X] Adds new Gulp task Publish, which includes both bundle and package
- [X] Updates settings to allow not to load apps for app catalogs
- [X] Updates serve gulp tasks to combine them into a single task
- [X] Refactors pipeline scaffolding form to smaller components
- [X] Adds initial integration tests for the product
- [X] Add an action that allows to increase project version and
implement version increment logic
- [X] Fixes App Install/Uninstall issue to allow installing apps on root
site

---------

Co-authored-by: Nishkalank Bezawada <[email protected]>
Co-authored-by: Ervin Gayle <[email protected]>
Co-authored-by: Saurabh Tripathi <[email protected]>
Co-authored-by: Nico De Cleyre <[email protected]>

Author: 5 people

.github/workflows/check-tests.yml

@@ -0,0 +1,63 @@
+name: Check Tests
+
+on: 
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: "Test"
+    runs-on: windows-latest
+
+    steps:
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+      
+      - name: Checkout SPFx Toolkit
+        uses: actions/checkout@v4
+        with:
+          path: vscode-viva
+        
+      - name: Install dependencies for SPFx Toolkit
+        run: npm ci
+        working-directory: vscode-viva
+
+      - name: Checkout CLI for Microsoft 365
+        uses: actions/checkout@v4
+        with:
+          repository: Adam-it/cli-microsoft365
+          path: cli-microsoft365
+          ref: cli-cjs
+
+      - name: Print dir
+        run: |
+          dir
+
+      - name: Install dependencies for CLI for Microsoft 365
+        run: npm i
+        working-directory: cli-microsoft365
+
+      - name: Build CLI for Microsoft 365
+        run: npm run build
+        working-directory: cli-microsoft365
+
+      - name: Run script to copy local CLI for Microsoft 365   
+        run: .\vscode-viva\scripts\cli-for-microsoft365-copy-local-version.ps1 -workspacePath "${{ github.workspace }}"
+        shell: pwsh
+        continue-on-error: false
+
+      - name: Build SPFx Toolkit
+        run: npm run package
+        working-directory: vscode-viva
+
+      - name: Compile tests for SPFx Toolkit
+        run: npm run compile-tests
+        working-directory: vscode-viva
+
+      - name: Run tests for SPFx Toolkit
+        run: npm run test
+        working-directory: vscode-viva
+      

.vscode-test.mjs

@@ -0,0 +1,5 @@
+import { defineConfig } from '@vscode/test-cli';
+
+export default defineConfig({
+	files: 'out/test/**/*.test.js'
+});

.vscode/launch.json

@@ -15,6 +15,17 @@
 			"outFiles": [
 				"${workspaceFolder}/dist/**/*.js"
 			]
-		}
+		},
+		{
+			"name": "Extension Tests",
+			"type": "extensionHost",
+			"request": "launch",
+			"runtimeExecutable": "${execPath}",
+			"args": [
+			  "--extensionDevelopmentPath=${workspaceFolder}",
+			  "--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
+			],
+			"outFiles": ["${workspaceFolder}/out/test/**/*.js"]
+		  }
 	]
 }

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Change Log
 
+## [4.5.0] - 2025-04-14
+
+- Adds new Gulp task Publish, which includes both bundle and package
+- Updates settings to allow not to load apps for app catalogs
+- Updates serve gulp tasks to combine them into a single task
+- Refactors pipeline scaffolding form to smaller components
+- Adds initial integration tests for the product
+- Add an action that allows to increase project version and implement version increment logic
+- Fixes App Install/Uninstall issue to allow installing apps on root site
+
 ## [4.4.0] - 2025-02-04
 
 - Updated the gulp bundle local and production to a single task with an additional prompt

README.md

@@ -161,7 +161,7 @@ Additionally, it will show you all tenant-wide extensions installed on your tena
 
 ![tenant details](./assets/images/app-catalog-list.png)
 
-Using the extension settings you may choose show or hide the tenant-wide extensions list and tenant health incidents list.
+Using the extension settings you may choose to show or hide the apps in app catalog list and tenant health incidents list.
 
 ![settings](./assets/images/settings.png)
 
@@ -245,6 +245,12 @@ And the code tour guidance will provide you upgrade tips directly in your code!
 
 [Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#set-form-customizer)
 
+- **Increase project version** - This action allows you to increase project major, minor or patch varsion and automatically align the versioning between `package.json` and `package-solution.json` files.
+
+![Increase project version](./assets/images/increase-versioning.png)
+
+[Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#increase-project-version)
+
 - **Open sample/scenario galleries of the SPFx web part, extensions, or ACEs projects** - SharePoint Framework Toolkit supports a couple of sample galleries that may be used to scaffold a new SPFx project. 
 
 [Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#open-samplescenario-galleries-of-the-spfx-web-part-extensions-or-aces-projects)

assets/images/actions.png

@@ -60,6 +60,18 @@ And the code tour guidance will provide you upgrade tips directly in your code!
 
 [Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#add-new-component)
 
+- **Set Form Customizer** - Allows to update the New, Edit or View from of any SharePoint List to a given SPFx Form Customizer based on provided GUID. 
+
+![Set Form Customizer](../images/set-form-customizer-action.png)
+
+[Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#set-form-customizer)
+
+- **Increase project version** - This action allows you to increase project major, minor or patch varsion and automatically align the versioning between `package.json` and `package-solution.json` files.
+
+![Increase project version](../images/increase-versioning.png)
+
+[Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#increase-project-version)
+
 - **Open sample/scenario galleries of the SPFx web part, extensions, or ACEs projects** - SharePoint Framework Toolkit supports a couple of sample galleries that may be used to scaffold a new SPFx project. 
 
 [Check out our docs for more details](https://github.com/pnp/vscode-viva/wiki/5.5-Actions#open-samplescenario-galleries-of-the-spfx-web-part-extensions-or-aces-projects)

assets/images/increase-versioning.png

@@ -12,7 +12,6 @@ test - Runs unit tests, if available, for the client-side solution project.
 package-solution - Packages the client-side solution into a SharePoint package.
 deploy-azure-storage - Deploys client-side solution project assets to Azure Storage.
 
-
 SPFx Toolkit VS Code extension shows all possible Gulp tasks one may run on an SPFx project. Don't worry about remembering all the commands, just click on the task you want to run and the extension will do the rest.
 
 ![Gulp Tasks](../images/tasks.png)