Freigeben über

Versionshinweise zu SharePoint-Framework Version 1.16

  • Artikel

In dieser Version werden Updates für die Features von Microsoft Viva, Microsoft Teams, Outlook, Office und SharePoint eingeführt.

Freigegeben: 15. November 2022

Wichtig

Auf dieser Seite werden Details zu einer bestimmten SPFx-Releaseversion erläutert. Es werden keine zusätzlichen SPFx-Voraussetzungen erläutert, die installiert werden müssen, um SPFx-Lösungen zu entwickeln, einschließlich Node.js, Yeoman und anderen Tools.

Informationen zu diesen Voraussetzungen finden Sie unter Einrichten Ihrer SharePoint-Framework-Entwicklungsumgebung.

Installieren der neuesten Version

Installieren Sie die neueste Version von SharePoint Framework (SPFx), indem Sie das @latest-Tag einfügen:

npm install @microsoft/generator-sharepoint@latest --global

Aktualisieren von Projekten von v1.15.2 auf v1.16

  1. Identifizieren Sie in der Datei package.json des Projekts alle SPFx v1.15.2-Pakete. Gehen Sie für jedes SPFx-Paket folgendermaßen vor:

    1. Deinstallieren Sie das vorhandene v1.15.2-Paket:

      npm uninstall @microsoft/{spfx-package-name}@1.15.2

    2. Installieren Sie das neue v1.16-Paket:

      npm install @microsoft/{spfx-package-name}@latest --save --save-exact

Tipp

Die CLI für Microsoft 365 bietet eine einfache schrittweise Anleitung zum Upgraden Ihrer Lösungen auf die aktuellste SharePoint-Framework-Version.

Neue Features und Funktionen

Veröffentlichen von Teams-Lösungen, die mit SPFx erstellt werden, in Outlook und Office

Da diese SPFx-Version das Teams JavaScript SDK v2 unterstützt, können Sie jetzt mit dem Erstellen von Umgebungen für Outlook und für Office.com (Microsoft 365-App) mit SharePoint-Framework (SPFx) beginnen. Dadurch kann dieselbe Lösung in Microsoft, Outlook, Office.com und in SharePoint ohne spezifische Codeänderungen verfügbar gemacht werden.

Sie können das Teams JavaScript SDK v2 verwenden, um den Host der Lösung zu erkennen, wie im folgenden Code gezeigt. Wenn leer this.context.sdks.microsoftTeams ist, wird Code in SharePoint ausgeführt.

// if running in Microsoft Teams, Outlook, or Office...
if (!!this.context.sdks.microsoftTeams) {
  const teamsContext = await this.context.sdks.microsoftTeams.teamsJs.app.getContext();
  switch (teamsContext.app.host.name.toLowerCase()) {
    case 'teams':
      // RUNNING IN MICROSOFT TEAMS
    case 'office':
      // RUNNING IN OFFICE / OFFICE.COM
    case 'outlook':
      // RUNNING IN OUTLOOK
    default:
      throw new Error('Unknown host');
  }
} else {
  // RUNNING IN SHAREPOINT
}

Weitere Informationen zu diesen Optionen finden Sie im folgenden Artikel.

Wichtig

Die Verwendung des Teams SDK v2 innerhalb der SharePoint-Framework Lösungen ist ab Version 1.16 allgemein verfügbar, sodass das Teams SDK v2 sofort verwendet werden kann. Die Unterstützung für die Veröffentlichung von Teams-Apps (einschließlich SPFx-Lösungen) in Outlook und in Office.com (Microsoft 365-App) befindet sich jedoch noch in der Vorschauphase und soll innerhalb der ersten Hälfte des Kalenderjahres 2023 sowohl für mobile als auch für Desktop-Umgebungen allgemein verfügbar sein.

Teams JavaScript SDK v2-Unterstützung

Diese Version unterstützt teams-js v2. this.context.sdks.microsoftTeams.teamsJs gibt Version 2 des SDK zurück. this.context.sdks.microsoftTeams.context gibt aus Gründen der Abwärtskompatibilität weiterhin v1-Kontext zurück.

Hinweis

teams-js v2 ist abwärtskompatibel mit teams-js v1. Wir werden weiterhin v1 für vorhandene Lösungen unterstützen.

Tipp

Teams JavaScript SDK v2 ermöglicht neue Szenarien für Entwickler. Weitere Details zu den Funktionen des Teams JS SDK v2 finden Sie in der folgenden Ankündigung: Microsoft Teams JS SDK v2 ist jetzt allgemein verfügbar.

Teams-js v2-Typisierungsunterstützung

Ab dieser Version weist die context.sdks.microsoftTeams.teamJs Eigenschaft im Webpart den Typ teams-js SDK v2 auf. Dies ermöglicht die Verwendung der neuen Features des Teams-js SDK v2, einschließlich neuer Hosts: Outlook und Office 365-App (zuvor office.com genannt).

Hinweis

context.sdks.microsoftTeams.context -Eigenschaft ist als veraltet markiert. Es wird v1-Kontext anstelle von v2 zurückgegeben. Verwenden Sie context.sdks.microsoftTeams.teamJs.app.getContext stattdessen .

Support für React 17

SPFx unterstützt jetzt standardmäßig React 17 (Gerüst als Teil der Lösung).

Möglichkeit zum Festlegen von dataVersion im Webpartmanifest

Legen Sie eine Datenversion für diesen vorkonfigurierten Eintrag fest. Dies ist optional und kann in Fällen verwendet werden, in denen das SPPKG unabhängig vom Code aktualisiert wird (z. B. in einem CDN gehostet). Webparts können diesen Wert aus Gründen der Abwärtskompatibilität mit veralteten Standardeigenschaften lesen.

Möglichkeit zur Verwendung von Tasks und Middleware in Microsoft Graph v3

Ab dieser Version können Entwickler installieren @microsoft/microsoft-graph-client , um auf Aufgaben oder Middleware aus dem SDK zu verweisen, z. B LargeFileUploadTask. . SPFx externalisiert die Abhängigkeit automatisch und lädt sie aus dem CDN.

Hinweis

Informationen dazu, welche Version des MS Graph SDK installiert werden soll, finden Sie unter Überprüfen unterstützter Versionen .

MSGraphClientFactory ermöglicht jetzt das Übergeben Options von Parametern beim Initialisieren des Clients. Außerdem enthält sie eine neue Methode getClientWithMiddleware zum Initialisieren des Clients mit Middleware. Entwickler können die MS Graph-Clientinstanz auch mithilfe der MSGraphClientV3.client -Eigenschaft abrufen. Diese Instanz kann verwendet werden, um MS Graph-Aufgaben wie das Hochladen großer Dateien aufzurufen.

Der EULA-Ordner wurde aus den Modulen entfernt.

Der EuLA-Ordner wurde aus den Modulen entfernt. Die Lizenzinformationen sind jetzt hier verfügbar. Diese Änderung verringerte die Größe aller SPFx-Module, die während des Gerüstbaus geladen wurden.

Möglichkeit, unterstützte Versionen von MS Graph und Teams SDK zu überprüfen

.yo-rc.json -Datei enthält sdksVersions jetzt die -Eigenschaft. Diese Eigenschaft enthält die Liste der unterstützten Versionen von MS Graph und Teams SDK.

quietDeps-Parameter für SASS

Jetzt können Entwickler die Eigenschaft in config\sass.json auf automatische Veraltungswarnungen aus den Abhängigkeiten festlegenquietDeps.

Fähigkeit zum asynchronen Rendern von ACE

Ähnlich wie bei Webparts kann der ACE-Entwickler angeben, ob die Kartenerweiterung asynchron gerendert wird.

/* BaseAdaptiveCardExtension */
protected get isRenderAsync(): boolean {
  return false;
}

public renderCompleted(didUpdate: boolean): void { /* ... */ }

Adaptive Kartenerweiterungs-Bildkartenansicht, um Text für Barrierefreiheit zu erhalten alt

Durch Das Hinzufügen einer neuen optionalen Eigenschaft imageAltText für IImageCardParameters wird dem html-Element des Bilds ein Text-Attribut hinzugefügt alt .

Neue Kontexteigenschaften des Formularanpassungs-Kontexts

Werte von Elementfeldern auflisten

Der Formularanpassungskontext für Formulare bearbeiten und anzeigen enthält jetzt die Werte der Listenelementfelder im Standardformat odata .

IFormCustomizerContext.item?: IListItem;

Json-Formatierungskonfiguration für Listenformulare

Der Kontext des Formularanpassungers enthält Informationen zur json-Formatierung des angewendeten Listenformulars. Verwenden Sie contentType die -Eigenschaft, um auf die Konfiguration zuzugreifen.

IFormCustomizerContext.contentType.ClientFormCustomFormatter: string | undefined;

Entfernen der Unterstützung für NodeJS v12 und v14

Node.js v12 & v14 werden nicht mehr unterstützt. SPFx v1.16 erfordert Node.js v16.

Hinweis

Node.js v18-Unterstützung ist für die erste Hälfte des Kalenderjahres 2023 geplant.

Vorschau von Features und Funktionen

Die folgenden Features befinden sich als Teil der Version 1.16 noch im Vorschaustatus und sollten nicht in der Produktion verwendet werden. Wir planen, sie als Teil der kommenden Version 1.17 offiziell zu veröffentlichen.

Webpart– Top-Aktionen

Mit top actions können Entwickler der Befehlsleiste des Webparts benutzerdefinierte Aktionen hinzufügen. Das Feature ähnelt Steuerelementen im Eigenschaftenbereich, basiert jedoch auf einem übersichtlicheren Benutzeroberflächenansatz.

Hinweis

Top Actions wird als Vorschauversion als Teil der Version 1.16 veröffentlicht.

Wichtigste Aktionen

Um Top-Aktionen hinzuzufügen, können Entwickler die getTopActionsConfiguration -Methode verwenden.

BaseWebPart.getTopActionsConfiguration(): ITopActions | undefined;

ITopActions -Schnittstelle definiert die Konfiguration der wichtigsten Aktionen.

export type ActionConfiguration = IPropertyPaneField<any>;

export interface ITopActions {
  readonly topActions: ActionConfiguration[];
  onExecute(actionName: string, newValue: any): void;
}

Hinweis

Obwohl es sich um den Typ der Top-Aktionskonfiguration handelt IPropertyPaneField<any> , unterstützen wir derzeit nur Schaltflächen und Auswahlgruppen. Dies bedeutet, dass Sie entweder PropertyPaneChoiceGroup(...) und PropertyPaneButton(...)verwenden oder ihre eigenen Konfigurationen angeben können, die in IPropertyPaneField<IPropertyPaneChoiceGroupProps> und aufgelöst werden. IPropertyPaneField<IPropertyPaneButtonProps>

Weitere Informationen zur Anleitung auf Codeebene finden Sie im folgenden Artikel.

Veraltete Funktionen

  • Veraltetes @microsoft/office-ui-fabric-react-bundle Paket. Verwenden Sie @fluentui/react stattdessen .
  • context.sdks.microsoftTeams.context ist veraltet. Verwenden Sie stattdessen context.sdks.microsoftTeams.teamJs.app.getContext.

Behobene Probleme

Hier finden Sie eine Liste der spezifischen Probleme, die im Zusammenhang mit SharePoint-Framework seit der vorherigen öffentlichen Version behoben wurden.

August-November Zeitrahmen

  • #8146 – SPFX Application Customizer unterbricht anonyme Links für PDF-Dateien
  • #8266 – SPFx 1.15: Formularanpassung funktioniert in „Verlauf anzeigen“ nicht
  • #8272 – SPFx 1.15 – Fehler beim Anzeigen eines vorhandenen Listenelements im klassischen Modus mithilfe von form customier
  • #8279 – Neue Symbole in Produktionsumgebungen
  • #8301 – Fehler beim erneuten Aufrufen der benutzerdefinierten Teams-App „?app=portals“
  • #8372 – Anwenden von Berechtigungen für den Formularanpassunger
  • #8379 – SPFx ListViewCommandSet - this.context.listView.selectedRows ist in gruppierten Listen falsch
  • #8467 – Schaltflächen (onClick Ereignisse) in BaseDialog funktionieren nicht mehr – ListView-Befehlssatz
  • #8483 – Mehrseitige Webpart-Eigenschaftenbereiche – Paginierung funktioniert nicht wie erwartet, hindert Benutzer am Zugriff auf Seiten
  • #8484 – Webpart-Eigenschaftenbereich umbricht bei Verwendung von React und office-ui-fabric-react in der Feldbeschriftung des Eigenschaftenbereichs
  • #8482 – React Versionskonflikt führt dazu, dass SPFX-Listenerweiterungen in O365 fehlschlagen
  • #8487 – SharePoint React 17 Upgrade verursacht fehler "Ungültiger Hookaufruf" im SPFx-Webpart
  • #7324 : DIE SPFx-Lizenz lässt keine kommerzielle Verwendung zu
  • #8331 – Mechanismus zum Versionieren der vorkonfiguriertenEntries im Manifest
  • #8510 – SPFx plötzlich minimierter React Fehler #321
  • #8496 – React Versionskonflikt führt dazu, dass der Eigenschaftenbereich nicht angezeigt wird