Bump version to 2.0.1, update deployment strategy for central SPFx deployment, and enhance error handling in PowerShell script

README.md

@@ -4,7 +4,7 @@ Barrierearme, dreistufige Portalnavigation auf Basis von SharePoint Managed Meta
 
 | Eigenschaft | Wert |
 |---|---|
-| Version | 2.0.0 |
+| Version | 2.0.1 |
 | SharePoint Framework | SPFx 1.4.1 |
 | Node.js | 8.17.0 |
 | Zieloberfläche | Moderne SharePoint-Seiten |
@@ -43,7 +43,7 @@ MegaMenuApplicationCustomizer
                           └── responsive Darstellung
 ```
 
-Das MegaMenu wird einmal pro Site Collection konfiguriert. PortalSettings speichert die zentrale Konfiguration im Property Bag des Root Webs und synchronisiert eine identische, web-scoped Runtime-Bindung auf das Root Web und alle vorhandenen Unterwebs. Das MegaMenu selbst enthält keine eigene Administrationsoberfläche.
+Das MegaMenu wird einmal pro Site Collection konfiguriert. Das Paket wird mit `skipFeatureDeployment: true` zentral über den App Catalog bereitgestellt, damit das SPFx-Bundle ohne eine App-Installation in jedem einzelnen Web verfügbar ist. PortalSettings speichert die zentrale Konfiguration im Property Bag des Root Webs. Eine Site-Collection-Action aktiviert das MegaMenu auf dem Root Web sowie auf vorhandenen und zukünftigen Unterwebs. Das MegaMenu selbst enthält keine eigene Administrationsoberfläche.
 
 ## Voraussetzungen
 
@@ -261,6 +261,12 @@ MegaMenu/
 
 ## Versionshistorie
 
+### 2.0.1
+
+- Zentrale SPFx-Bereitstellung mit `skipFeatureDeployment: true`.
+- Das MegaMenu-Paket muss nicht mehr als App in jedem Unterweb installiert werden.
+- Feature-Framework-Registrierung aus dem Paket entfernt; die Aktivierung erfolgt zentral über PortalSettings oder das Deploymentskript.
+
 ### 2.0.0
 
 - Neue Application-Customizer-ID `c0abbffb-355d-4d4e-bd38-9e15fb811506`, um alte On-Premises-Manifest- und Loader-Zuordnungen sicher zu umgehen.

config/package-solution.json

@@ -3,22 +3,9 @@
   "solution": {
     "name": "mega-menu-client-side-solution",
     "id": "f4660e06-ce08-43ee-bfb7-5c4464e01133",
-    "version": "2.0.0.0",
+    "version": "2.0.1.0",
     "includeClientSideAssets": true,
-    "skipFeatureDeployment": false,
+    "skipFeatureDeployment": true
-    "features": [
-      {
-        "title": "MegaMenu extension registration",
-        "description": "Registers the MegaMenu Application Customizer in the host web.",
-        "id": "1e4fdc74-8053-48b2-a15b-e975d61eb71f",
-        "version": "2.0.0.0",
-        "assets": {
-          "elementManifests": [
-            "elements.xml"
-          ]
-        }
-      }
-    ]
   },
   "paths": {
     "zippedPackage": "solution/mega-menu.sppkg"

deployment/add-megamenu.ps1

@@ -64,8 +64,15 @@ try {
 
     foreach ($web in $site.AllWebs) {
         try {
+            $webUrl = $web.Url
+            $userCustomActions = $web.UserCustomActions
+
+            if ($null -eq $userCustomActions) {
+                throw ('UserCustomActions konnten fuer das Web nicht geladen werden: ' + $webUrl)
+            }
+
             $actions = @(
-                $web.UserCustomActions |
+                $userCustomActions |
                     Where-Object {
                         $_.ClientSideComponentId -eq $componentId -or
                         $_.ClientSideComponentId -eq $legacyComponentId
@@ -88,7 +95,7 @@ try {
             }
 
             if (-not $currentAction) {
-                $currentAction = $web.UserCustomActions.Add()
+                $currentAction = $userCustomActions.Add()
                 $currentAction.Name = [Guid]::NewGuid().ToString('B')
                 $created++
             }
@@ -105,7 +112,7 @@ try {
             $currentAction.Update()
             $web.Update()
 
-            Write-Host ('MegaMenu synchronisiert: ' + $web.Url) -ForegroundColor Green
+            Write-Host ('MegaMenu synchronisiert: ' + $webUrl) -ForegroundColor Green
         }
         finally {
             $web.Dispose()

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "mega-menu",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mega-menu",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "private": true,
   "main": "lib/index.js",
   "engines": {

src/extensions/megaMenu/MegaMenuApplicationCustomizer.ts

@@ -40,7 +40,7 @@ export default class MegaMenuApplicationCustomizer
     const debug: boolean = this._isDebugEnabled();
     debugLog(debug, LOG_SOURCE, 'onInit started.', {
       componentId: UserCustomActionMegaMenuId,
-      version: '2.0.0',
+      version: '2.0.1',
       properties: this.properties || {},
       pageUrl: window.location.href,
       webUrl: this.context.pageContext.web.absoluteUrl,