Site App Catalog: SharePoint Apps lokal testen - Die vollständige Anleitung

Was ist ein Site App Catalog?

Ein Site App Catalog ist ein spezieller App-Katalog, der nur für eine einzelne SharePoint Site Collection verfügbar ist. Im Gegensatz zum Tenant App Catalog, der Apps für den gesamten Tenant bereitstellt, ermöglicht der Site App Catalog das lokale Testen und Installieren von SharePoint Framework (SPFx) Lösungen und Add-ins in einer isolierten Umgebung.

Vorteile des Site App Catalogs

• Lokales Testen: Apps können in einer Site Collection getestet werden, ohne den Tenant zu beeinflussen
• Isolierte Umgebung: Perfekt für Entwicklung und Testing ohne Produktions-Risiko
• Schnelle Iteration: Apps können schnell aktualisiert werden ohne Tenant-weite Auswirkungen
• Delegierte Verwaltung: Site Collection Admins können Apps nach der Einrichtung selbst verwalten
• Mehrere Versionen: Verschiedene Versionen derselben App in unterschiedlichen Site Collections testen

Wichtiger Hinweis: Tenant Admin Rechte erforderlich!

Wichtig: Das Erstellen eines Site App Catalogs erfordert Tenant Administrator Rechte. Es gibt keine UI-Option in SharePoint Online - du musst PowerShell, PnP PowerShell oder die CLI für Microsoft 365 verwenden.

Nach der Einrichtung können Site Collection Administratoren Apps eigenständig im Site App Catalog verwalten.

Voraussetzungen

Bevor du beginnst, benötigst du:

1. Tenant Administrator Rechte in Microsoft 365
2. Site Collection Administrator Rechte auf der Ziel-Site Collection
3. Einen bereits existierenden Tenant App Catalog (muss einmalig im SharePoint Admin Center erstellt werden)
4. Eines der folgenden Tools:
   • SharePoint Online Management Shell (Windows)
   • PnP PowerShell (Windows, macOS, Linux)
   • CLI für Microsoft 365 (Cross-platform)

Methode 1: SharePoint Online Management Shell (Windows)

Installation

Öffne PowerShell als Administrator und installiere das Modul:

Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force

→ Offizielle Microsoft Dokumentation zur Installation

Site App Catalog erstellen

# Verbindung zum SharePoint Admin Center herstellen
Connect-SPOService -Url https://ihrtenant-admin.sharepoint.com

# Site App Catalog aktivieren
Add-SPOSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Wichtig: Ersetze ihrtenant mit deinem tatsächlichen Tenant-Namen und ihrsite mit deiner Site Collection URL.

Site App Catalog entfernen

Wenn du den Site App Catalog wieder deaktivieren möchtest:

Remove-SPOSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Hinweis: Dies deaktiviert nur den App Catalog - die “Apps for SharePoint” Bibliothek und deren Inhalte bleiben erhalten.

Methode 2: PnP PowerShell (Empfohlen - Cross-Platform)

PnP PowerShell ist die moderne, plattformübergreifende Alternative und funktioniert auf Windows, macOS und Linux.

Installation

# Installation (erfordert PowerShell 7.2 oder höher)
Install-Module -Name PnP.PowerShell -Force

→ PnP PowerShell Installation Guide

Site App Catalog erstellen

# Verbindung zum SharePoint Admin Center herstellen
Connect-PnPOnline -Url https://ihrtenant-admin.sharepoint.com -Interactive

# Site App Catalog aktivieren
Add-PnPSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Site App Catalog entfernen

Remove-PnPSiteCollectionAppCatalog -Site https://ihrtenant.sharepoint.com/sites/ihrsite

Alle Site App Catalogs auflisten

Hilfreich, um einen Überblick zu bekommen:

Get-PnPTenantSite -Filter "SiteCollectionAppCatalogEnabled eq 1"

Methode 3: CLI für Microsoft 365 (Cross-Platform)

Die CLI für Microsoft 365 ist eine Node.js-basierte Command Line Interface, die auf jeder Plattform läuft.

Installation

npm install -g @pnp/cli-microsoft365

→ CLI für Microsoft 365 Dokumentation

Site App Catalog erstellen

# Anmelden
m365 login

# Site App Catalog aktivieren
m365 spo site appcatalog add --siteUrl https://ihrtenant.sharepoint.com/sites/ihrsite

Site App Catalog entfernen

m365 spo site appcatalog remove --siteUrl https://ihrtenant.sharepoint.com/sites/ihrsite

Nach der Einrichtung: Apps hochladen und bereitstellen

Sobald der Site App Catalog aktiviert ist:

1. Apps-Bibliothek öffnen

1. Navigiere zu deiner Site Collection
2. Gehe zu Websiteinhalte (Site Contents)
3. Du siehst nun eine neue Bibliothek: “Apps for SharePoint”

2. App-Package hochladen

1. Öffne die “Apps for SharePoint” Bibliothek
2. Klicke auf Hochladen oder ziehe die Datei per Drag & Drop
3. Wähle deine .sppkg Datei (z.B. smarter-advent-calendar.sppkg)

3. App bereitstellen

Nach dem Hochladen erscheint ein Dialog:

1. Vertraust du dieser App? → Prüfe die angeforderten Berechtigungen
2. Wähle:
   • “Diese App für alle Sites in dieser Site Collection verfügbar machen” (empfohlen)
   • oder lasse es deaktiviert für eine einzelne Site
3. Klicke auf Bereitstellen

4. App zu einer Site hinzufügen

1. Gehe zur gewünschten Site in der Site Collection
2. Klicke auf Einstellungen (Zahnrad) → Eine App hinzufügen
3. Wähle “Von deiner Organisation” im Filter
4. Suche deine App und klicke darauf, um sie zu installieren

App aktualisieren

Um eine neue Version zu testen:

1. Laden Sie die neue .sppkg Datei in die “Apps for SharePoint” Bibliothek hoch
2. SharePoint erkennt automatisch, dass eine Datei mit gleichem Namen existiert
3. Bestätigen Sie: “Vorhandene Datei ersetzen”
4. Die App wird automatisch in allen Sites aktualisiert, die sie verwenden

Tipp: Verwenden Sie Versionsnummern im Dateinamen für bessere Nachvollziehbarkeit:

• smarter-advent-calendar-v1.0.0.sppkg
• smarter-advent-calendar-v1.1.0.sppkg

Troubleshooting

Problem: “Must have Manage Web Site permissions or be a tenant admin”

Ursache: Du hast keine Tenant Administrator Rechte.

Lösung:

1. Wende dich an einen Microsoft 365 Global Admin oder SharePoint Admin
2. Nur diese können Site App Catalogs erstellen
3. Nach der Einrichtung können Site Collection Admins Apps verwalten

Problem: App wird nach Installation nicht angezeigt

Lösung:

1. Prüfe, ob die App korrekt bereitgestellt wurde (Status in “Apps for SharePoint”)
2. Lösche den Browser-Cache (Strg + Shift + R)
3. Versuche einen InPrivate/Inkognito-Browser
4. Öffne die Browser Developer Tools (F12) und prüfe auf Fehler in der Console

Problem: Berechtigungsfehler beim Bereitstellen

Ursache: Die App benötigt API-Berechtigungen, die noch nicht gewährt wurden.

Lösung:

1. Öffne das SharePoint Admin Center
2. Gehe zu Advanced → API access
3. Genehmige ausstehende Berechtigungsanfragen
4. Nur Tenant Admins können API-Berechtigungen gewähren

Problem: App funktioniert nicht in anderen Sites der Site Collection

Lösung:

• Stelle sicher, dass du bei der Bereitstellung die Option “Diese App für alle Sites in dieser Site Collection verfügbar machen” aktiviert hast
• Anderenfalls musst du die App erneut hochladen und mit dieser Option bereitstellen

Best Practices

1. Testing-Umgebung strukturieren

Erstelle separate Site Collections für verschiedene Phasen:

Development Site Collection
   → Site App Catalog für Dev-Builds

Staging Site Collection
   → Site App Catalog für Test-Builds

Production Tenant
   → Tenant App Catalog für finale Releases

2. Dokumentation führen

Halte fest:

• Welche Site Collections haben einen Site App Catalog?
• Welche Apps sind wo installiert?
• Welche Versionen sind in welcher Umgebung?
• Bekannte Issues pro Version

3. Versionierung

Verwende konsequent semantische Versionierung:

• v1.0.0 - Erste stabile Version
• v1.1.0 - Neue Features
• v1.1.1 - Bugfixes

4. Automatisierung mit Scripts

Erstelle PowerShell-Scripts für häufige Aufgaben:

# Beispiel: App in mehrere Site Collections deployen
$sites = @(
    "https://tenant.sharepoint.com/sites/dev",
    "https://tenant.sharepoint.com/sites/staging"
)

foreach ($site in $sites) {
    Write-Host "Aktiviere Site App Catalog für $site"
    Add-PnPSiteCollectionAppCatalog -Site $site
}

Site App Catalog vs. Tenant App Catalog

Feature	Site App Catalog	Tenant App Catalog
Verfügbarkeit	Nur in der Site Collection	Tenant-weit, alle Sites
Erstellen	Tenant Admin via PowerShell	SharePoint Admin via UI oder PowerShell
Verwalten	Site Collection Admin	Tenant Admin
Verwendung	Testing, Entwicklung, isolierte Lösungen	Produktion, unternehmensweite Apps
Isolation	Hoch - keine Auswirkungen auf andere Sites	Niedrig - sichtbar für alle
Setup-Zeit	2-5 Minuten (PowerShell)	10-15 Minuten (UI Setup)
Anzahl	Mehrere pro Tenant möglich	Nur einer pro Tenant

Apps von Smarter Business Solutions testen

Alle unsere SharePoint Apps kannst du problemlos im Site App Catalog testen:

• Smarter Advent Calendar: Virtueller Adventkalender fürs Intranet
• Smarter Tombola: Verlosungen und Gewinnspiele in SharePoint
• Smarter Secret Santa: Digitales Wichteln für Teams
• Smarter Event Booking: Event-Management für Microsoft 365
• Smarter Navigation: Erweiterte Navigation für moderne SharePoint Sites

Package-Download anfordern

Besuche unsere Produktseiten und fordere einen Download-Link an:

1. Wähle “Test-Installation” als Installationsoption
2. Gib deine E-Mail-Adresse ein
3. Erhalte sofort:
   • Download-Link zur .sppkg Datei
   • Diese ausführliche Anleitung
   • Produkt-spezifische Setup-Hinweise

Weitere Ressourcen

Microsoft Dokumentation

• Site Collection App Catalog (Microsoft Learn)
• SharePoint Framework (SPFx) Overview
• SharePoint Online Management Shell

PowerShell Tools

• PnP PowerShell Documentation
• PnP PowerShell Installation Guide
• CLI für Microsoft 365

Community & Support

• SharePoint Dev Community (GitHub)
• PnP Community
• SBS Support

Fazit

Der Site App Catalog ist ein unverzichtbares Tool für SharePoint-Admins und Entwickler, die SharePoint Framework Lösungen sicher testen möchten. Obwohl die Einrichtung Tenant Admin Rechte erfordert und nur via PowerShell möglich ist, ist der Prozess in wenigen Minuten erledigt.

Wichtigste Erkenntnisse:

• Tenant Admin Rechte sind zwingend erforderlich
• PowerShell, PnP PowerShell oder CLI - keine UI-Option
• Nach Setup können Site Admins Apps selbst verwalten
• Perfekt für isoliertes Testing ohne Produktions-Risiko
• Schnelle Iteration und mehrere Versionen parallel möglich

Hast du Fragen zur Einrichtung oder Installation unserer Apps? Kontaktiere uns!

---

Tipp: Speichere diese Anleitung als Lesezeichen - als SharePoint Admin wirst du sie regelmäßig brauchen!