Vorbereiten Ihrer SharePoint-Framework-Anwendung für das Veröffentlichen auf dem Marketplace

  • Artikel

Bevor eine SharePoint-Framework-Anwendung auf dem Marketplace veröffentlicht wird, muss sie einen Genehmigungsprozess durchlaufen. Dieser Prozess wird von Microsoft kostenlos ausgeführt und soll sicherstellen, dass Ihre App ordnungsgemäß funktioniert und dass ihre Seite ihren Zweck und ihre Features klar beschreibt. Um Ihnen das Veröffentlichen Ihrer Anwendung auf dem Marketplace zu erleichtern, finden Sie im Folgenden eine Liste der Tests, die als Teil des Genehmigungsprozesses durchgeführt werden.

Voraussetzungen

Verwenden von SharePoint-Framework v1.11 oder höher

Zum Erstellen von Lösungen, die Sie auf dem Marketplace veröffentlichen möchten, müssen Sie SharePoint-Framework v1.11 oder höher verwenden. Ab Version 1.11 enthält das Lösungsmanifest von SharePoint-Framework zusätzliche Informationen über Ihre Organisation und Lösung, die für das Veröffentlichen Ihrer Anwendung auf dem Marketplace erforderlich sind.

Tipp

Wenn Ihre Anwendung mit einer älteren Version des SharePoint-Frameworks erstellt wurde, können Sie sie mit CLI für Microsoft 365 ganz einfach auf SharePoint-Framework v1.11 oder höher aktualisieren. Weitere Informationen finden Sie unter https://pnp.github.io/cli-microsoft365/cmd/spfx/project/project-upgrade/.

Testanwendung in Stamm- und Nicht-Stammwebsites durchführen

Wenn Sie Ihre Anwendung testen, überprüfen Sie, ob sie wie vorgesehen funktioniert, wenn sie sowohl in der Stammwebsitesammlung eines Mandanten als auch in Nicht-Stammwebsites installiert wird. So können Sie überprüfen, ob es keine Abhängigkeiten von bestimmten Website-URLs gibt.

Testen der Anwendung in den erforderlichen Browsern

Wenn Sie Ihre Anwendung anhand der im folgenden Abschnitt beschriebenen Tests testen, überprüfen Sie, ob sie mindestens unter Windows 10 in den neuesten Versionen von Microsoft Edge, Google Chrome, Firefox und Microsoft Teams Desktop Client wie erwartet funktioniert (wenn Ihre Anwendung Webparts in Teams freigibt).

Erforderliche Tests

Die folgenden Tests müssen bestanden werden. Wenn bei einer oder mehreren Prüfungen in dieser Kategorie ein Fehler aufgetreten ist, wird die Anwendung abgelehnt, und Sie werden angewiesen, die gemeldeten Probleme zu beheben.

Stellen Sie die Konformität mit dem SharePoint-Framework-Vertrag sicher

Ihr Webpart oder Anpassung darf nur das DOM-Element bearbeiten, das über die domElement-Eigenschaft bereitgestellt wird. Dieses Element und das bereitgestellte Kontextobjekt sind die einzigen genehmigten Möglichkeiten, den Funktionsumfang von Seiten über Ihre App zu erhöhen. Die direkte Bearbeitung des Seiten-DOM führt dazu, dass Ihre Lösung abgelehnt wird.

Die Lösung sollte unter normalen Bedingungen wie vorgesehen funktionieren.

Alle Komponenten (Webparts und Erweiterungen) sollten unter normalen Bedingungen in Ihrer Lösung wie vorgesehen funktionieren. Bevor Sie Ihre Anwendung zur Genehmigung einreichen, sollten Sie vorzugsweise überprüfen, ob sie wie erwartet bei mehreren Mandanten und unter Verwendung verschiedener Benutzerkonten funktioniert, um sicherzustellen, dass sie nicht von einer bestimmten Konfiguration abhängig ist. Wenn Ihre Lösung spezifische Einstellungen erfordert, erwähnen Sie dies ausdrücklich in der Beschreibung Ihrer Lösung.

Das Webpart sollte in allen Hosts funktionieren, in denen es verfügbar gemacht wird.

Wenn Sie Webparts mit SharePoint-Framework erstellen, können Sie auswählen, wo Sie verfügbar gemacht werden sollen. Bevor Sie Ihre Anwendung zur Überprüfung einreichen, stellen Sie sicher, dass Ihr Webpart in all diesen Hosts wie vorgesehen funktioniert.

Das Lösungspaket muss gültige Entwickler-Metadaten enthalten

Das Manifest der Lösung (verwaltet in der Datei package-solution.json) muss einen neuen Abschnitt namens developer mit den folgenden Eigenschaften haben:

Attribut Beschreibung Erforderlich
name Der Name der Organisation, die die Anwendung erstellt hat Ja
websiteUrl URL einer Website mit weiteren Informationen zur Anwendung Ja
mpnId Microsoft Partner Network-ID (Weitere Informationen finden Sie unter MS Partner Network) Nein (aber sehr empfohlen, dies bereitzustellen)
privacyUrl URL zur Datenschutzerklärung Ja
termOfUseUrl URL zu Nutzungsbedingungen Ja

Die Einbeziehung dieser zusätzlichen Informationen ermöglicht es Ihnen, Ihren Benutzern Informationen über Ihre Anwendung klar und deutlich mitzuteilen und sollte Ihnen in Zukunft den Zugriff auf zusätzliche Nutzungsdaten ermöglichen.

Die Entwicklerinformationen werden angezeigt, wenn Webparts in Microsoft Teams installiert werden. Informationen über die Anwendung und den Entwickler, die auf dem Marketplace angezeigt werden, werden im Marketplace separat verwaltet.

Der Beschreibungstext Ihres Webparts in den Metadaten muss kurz die Funktionalität und den Wertbeitrag beschreiben

Stellen Sie sicher, dass die Beschreibung Ihres Webparts in den Metadaten aussagekräftig ist, damit die Benutzer verstehen, was der Zweck Ihres Webparts ist und was davon erwartet werden kann.

Die Beschreibung der Lösung muss die verschiedenen im Paket enthaltenen Komponenten klar beschreiben

Wenn Sie Ihr Paket auf dem Marketplace einreichen, stellen Sie sicher, dass Sie klar beschreiben, welche verschiedenen Komponenten (Webparts, Anwendungsanpasser usw.) in dem Paket enthalten sind, um die Erwartungen der Benutzer zu verwalten und ihnen zu helfen, die Auswirkungen der Nutzung Ihrer Anwendung zu verstehen.

Verwenden Sie keine Namen von Features in Teams und SharePoint im Namen Ihrer Lösung

Verwenden Sie in Ihrem Projektmappennamen nicht übereinstimmende Features in Microsoft Teams oder SharePoint, wie Chat, Kontakte, Kalender, Anrufe, Dateien, Besprechung, Aktivität, Teams, Apps, Hilfe, SharePoint, Liste, Seite usw. da diese Namen mit der Standardfunktionalität in Teams und SharePoint verwechselt werden könnten.

Verwenden Sie keine Namen von anderen Microsoft-Produkten im Namen Ihrer Lösung

Ihre Lösung wird zurückgewiesen, wenn Ihr Name einen Namen eines anderen Microsoft-Produkts enthält, wie Outlook, Word, Kalender, Aufgaben, Teams, Excel, PowerPoint, Visio usw.

Ihre Lösung darf keine Microsoft Teams- oder SharePoint-Feature-spezifischen Schlüsselwörter wie Besprechung starten, Anruf tätigen, Datei hochladen, Chat starten usw. verwenden. Diese Schlüsselwörter werden in den Microsoft-Produkten verwendet, und die Verwendung der Schlüsselwörter in Ihrer Anwendung könnte Benutzer verwirren. Wenn Ihre Anwendung eine ähnliche Funktionalität bietet, fügen Sie den Namen Ihres Namens in die Aktion ein, z. B.: Zoom-Besprechung starten, Datei auf Dropbox hochladen, Freshdesk-Chat starten usw.

Lösung benennen

Wenn Ihre Lösung nach einem gebräuchlichen Wort benannt ist, wie z. B.Aufträge, müssen Sie auch den Namen Ihres Unternehmens angeben, um sie deutlich von anderen Lösungen auf dem Marketplace zu unterscheiden, z. B. Contoso-Aufträge. Contoso bezeichnet dabei den Namen des Unternehmens, das die Lösung einreicht.

Stellen Sie sicher, dass die Konfigurationsdatei package-solution.json einen verständlichen name-Eintrag hat, der auf der Grundlage des obigen Formats aktualisiert wurde, wie im folgenden Beispiel gezeigt.

Verwenden Sie in der Beschreibung und den Screenshots Ihrer App keine zusätzliche Werbung

Stellen Sie sicher, dass die Beschreibung Ihrer App, Screenshots, Text und Werbebilder, nur die App beschreiben und keine zusätzliche Werbung enthalten.

Alle Eigenschaften, die im Eigenschaftenbereich verfügbar gemacht werden, sollten funktionsfähig sein

Eigenschaften, die im Eigenschaftenbereich des Webparts verfügbar gemacht werden, sollten sinnvoll sein. Wenn Sie deren Einstellungen ändern, ändert sich das Verhalten des Webparts eindeutig.

Überprüfen, ob die Paketdatei fehlerfrei in den Anwendungskatalog hochgeladen werden kann

Überprüfen Sie, ob das Lösungspaket fehlerfrei in den Anwendungskatalog in Ihrem Mandanten hochgeladen werden kann.

Überprüfen, ob die Anwendung ohne Fehler bereitgestellt werden kann

Überprüfen Sie, ob Ihre Anwendung an einem bestimmten Speicherort installiert werden kann, aber auch, dass sie global und fehlerfrei an allen Speicherorten eingesetzt werden kann.

Bereitstellen von Begründungen für API-Anforderungen

Wenn Ihre Anwendung zusätzlichen API-Zugriff benötigt (z. B. zur Kommunikation mit Microsoft Graph), sollte sie diese im Lösungsmanifest anfordern. Bereiten Sie außerdem eine Begründung für den beantragten API-Zugriff vor, da wir bei der Prüfung Ihrer Anwendung danach fragen könnten.

Die Unterstützung von Endbenutzern beim Einfügen von Skripts ist nicht zulässig

Ihre Lösung kann Endbenutzern nicht ermöglichen, beliebige Skripts in SharePoint-Seiten einzubetten. Dies bedeutet, dass Lösungen, die klassische Skript-Editor- oder Inhalts-Editor-Szenarien in SharePoint ermöglichen, nicht im SharePoint Store veröffentlicht werden dürfen.

Dieses Modell ist im SharePoint Store nicht zulässig, da Sicherheitsbedenken bei normalen Endbenutzern hervorgerufen werden, die Skripts in das Portal einbetten. Sie können diese Art von Lösung nur Kunden außerhalb des von Microsoft gehosteten Store bereitstellen.

Alle URLs, die im Webpart angezeigt werden, müssen funktionieren

Wenn Ihr Webpart URLs anzeigt, müssen diese auf bestehende Ressourcen verweisen und dürfen nicht zu nicht existierenden oder fehlerhaften Seiten führen.

Die Anwendung reagiert nicht mehr

Wenn Sie Ihre Anwendung verwenden, sollte sie nicht aufhören, den Benutzern zu antworten. Wenn ein Vorgang durchgeführt werden muss, der einen Moment dauern kann, wird er dem Benutzer mitgeteilt.

Ist die Lösung komplett

Enthält Ihre Lösung alle in der Beschreibung und den Screenshots angekündigten Funktionen?

Ist die Benutzeroberfläche der Anwendung abgeschlossen

Der erste Eindruck, den die Benutzer von Ihrer Anwendung haben werden, wird der Blick auf die Benutzeroberfläche sein. Wenn es nicht perfekt aussieht, wenn einige Elemente falsch ausgerichtet sind, wenn es viele verschiedene Schriftarten verwendet oder wenn ein Platzhaltertext nicht durch seinen endgültigen Wert ersetzt wurde, könnte es den Eindruck erwecken, dass Ihre Anwendung noch nicht fertig ist und dass sie sie nicht verwenden sollten.

Tipp

Um eine nahtlose Integration mit SharePoint und Teams zu gewährleisten, empfehlen wir die Verwendung von Office UI Fabric, der Designsprache für Microsoft 365. Weitere Informationen dazu finden Sie im Abschnitt Design in dieser Dokumentation.

Die Anwendung sollte Benutzer nicht ohne explizite Interaktion auffordern

Ihre Anwendung sollte Benutzer nicht ohne explizite Interaktion ihrerseits auffordern.

Überprüfen, ob Browser Ihre Popups nicht blockieren

Wenn Ihre Anwendung Popups verwendet, überprüfen Sie, ob Browser mit Standardeinstellungen diese nicht blockieren und den Benutzerablauf unterbrechen.

Korrekter Einstieg in den ersten Start

Wenn möglich, sollte Ihre Anwendung funktionieren, wenn sie zum ersten Mal gestartet wird. Wenn sie zuerst konfiguriert werden muss, teilen Sie dem Benutzer die nächsten Schritte deutlich mit. Wenn die Konfiguration komplex ist oder zusätzliche Informationen erfordert, stellen Sie klare Anweisungen bereit, um den Benutzern bei der Einrichtung Ihrer Anwendung zu helfen.

Testen der Synchronisierung mit Teams

Wenn Ihre Anwendung Webparts enthält, die als Teams-Registerkarten oder persönliche Anwendungen angezeigt werden, überprüfen Sie, ob sie mit der Option Synchronisierung mit Teams im "App-Katalog" fehlerfrei für Teams bereitgestellt werden können. Vergewissern Sie sich nach der Synchronisierung der Konfiguration mit Teams, dass alle Webparts wie vorgesehen im "App-Katalog" von Teams verfügbar gemacht werden, installiert werden kann und wie erwartet funktioniert.

Vergewissern Sie sich, dass Links wie Nutzungsbedingungen, Datenschutzrichtlinie, Info usw. gültig sind, und verweisen Sie auf die korrekten Seiten.

Konto oder Lizenz erwerben

Wenn Ihre Lösung erfordert, dass Benutzer ein Konto oder eine Lizenz erwerben müssen, ist klar, wie sie dies tun können und wie sie die erhaltenen Informationen mit Ihrer Anwendung nutzen können?

Keine Demo-Inhalte, wenn eine kostenlose Testversion im Angebot enthalten ist

Wenn Ihr Angebot eine kostenlose Testversion Ihrer Anwendung umfasst, sollte Ihre Anwendung keine Demo-Inhalte enthalten.

Keinen böswilliger Code verwenden

Lösungen, die böswilligen Code enthalten, Links zu böswilligen Websites oder anderweitig rechtswidrige Ressourcen werden von der Veröffentlichung auf dem Marketplace abgelehnt.

Keine anfälligen Ressourcen verwenden

Überprüfen Sie, ob Ihr Code keine Sicherheitsanfälligkeiten enthält. Wenn Sie Abhängigkeiten von Drittanbietern verwenden

Stellen Sie sicher, dass Ihre Anwendung keine Ressourcen übermäßig beansprucht

Wenn Sie Ihre Anwendung testen, überprüfen Sie, ob sie nicht zu einer merklichen oder anhaltenden Erhöhung der CPU-Nutzung führt, ob sie nicht viel Speicher verbraucht und ob sie nicht dazu führt, dass der Browser nicht mehr reagiert. Im Allgemeinen sollte Ihre Anwendung auf einem durchschnittlichen Desktopcomputer mit Internetzugang gut funktionieren. Außerdem sollte die Anwendung nicht länger als 10 Sekunden geladen werden.

Gezielte Lösungen von Microsoft Teams müssen auf den mandantenbezogen ein

SharePoint-Framework-Lösungen, die auch für die Verwendung in Microsoft Teams vorgesehen sind, müssenauf die Mandanten ausgerichtet sein. Diese Einstellung wird mit dem skipFeatureDeployment-Attribut in der package-solution.json-Konfigurationsdatei gesteuert. Die Einstellung sollte für jede Lösung, deren Komponenten auch auf Microsoft Teams ausgerichtet sind, true sein.

Es wird empfohlen, folgende Tests zu bestehen. Auch wenn ein fehlgeschlagener Test in dieser Kategorie Sie nicht daran hindert, Ihre Anwendung auf dem Marketplace zu veröffentlichen, könnte sich dies jedoch negativ auf die Erfahrung des Endbenutzers auswirken.

Das Webpart-Symbol sollte 64x64px mit transparentem Hintergrund sein

Es wird empfohlen, ein 64x64px-Bild mit transparentem Hintergrund für das Symbol Ihres Webparts zu verwenden. Dadurch kann es in den verschiedenen Benutzeroberflächenmodi in SharePoint korrekt angezeigt werden.

Microsoft Teams-Logos müssen korrekte Bildgrößen verwenden

Wenn Ihre Lösung Komponenten enthält, die für Microsoft Teams vorgesehen sind, wird davon ausgegangen, dass Sie die offiziellen Bildgrößen basierend auf die Anleitung für Microsoft Teams verwenden. Das Konturbild muss 32x32px und als koloriertes Bild 192x192px sein.

Das ganzseitige Bild muss ordnungsgemäß dimensioniert sein

Wenn die Lösung Komponenten enthält, die für die Darstellung als Einzelteil-App-Seiten vorgesehen sind, muss jede dieser Komponenten fullPageAppIconImageUrl Attribut mit spezifischem Bild aufweisen, das beim Erstellen einer neuen Seite in SharePoint verwendet werden soll. Dieses Bild muss so dimensioniert sein, dass es 193x158px ist.

Das Webpart sollte über einen im Eigenschaftenbereich konfigurierbaren Titel verfügen

Es wird empfohlen, dass alle Webparts über einen Titel verfügen, der die Informationen, die das Webpart darstellt, eindeutig beschreibt. Seitenautoren sollten in der Lage sein, diesen Titel über den Eigenschaftenbereich anzupassen, so dass, wenn das Webpart konfigurierbar ist, der Titel seinen Inhalt korrekt beschreiben kann.

Tipp

Sie können Ihrem Webpart einfach einen konfigurierbaren Titel hinzufügen, indem Sie das PnP Reusable React-Steuerelement WebPartTitle verwenden.

Unterschiedliche Designs ordnungsgemäß behandeln

Ihre Anwendung sollte helle und dunkle Designs ordnungsgemäß behandeln. Der Wechsel zwischen den verschiedenen Designs sollte sich nicht negativ auf die Nutzbarkeit Ihrer Anwendung auswirken. Auch wenn die Unterstützung von Designs nicht verhindert, dass Sie Ihre App auf dem Marketplace veröffentlichen, empfiehlt es sich, Sie zu unterstützen, um eine optimale Benutzererfahrung zu bieten.

Tipp

Weitere Informationen zur Verwendung von Designs in Ihrer Anwendung finden Sie im Artikel Design-Farben in Ihren SharePoint Framework-Anpassungen verwenden.