Freigeben über

Verwenden Sie das Starter-Kit, um loszulegen.

Verwenden Sie diesen Schnellstart, um die HelloWorld-Workload auszuführen und in Fabric zu aktivieren. Es basiert auf den bewährten Methoden und optimiert die Schritte, um Sie schnell zum Codieren zu bringen.

Von Bedeutung

Stellen Sie sicher, dass Sie Zugriff auf einen Fabric-Arbeitsbereich haben und Ihr Mandant Entwicklerfeatures zulässt. Sie aktivieren den Fabric-Entwicklermodus vor dem Testen.

1. Klonen des Repositorys

Beginnen Sie, indem Sie das repositoryStarter-Kit Repo verschreiben und dann auf Ihren lokalen Computer klonen.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

2. Ausführen des Setupskripts

Das Setupskript automatisiert die meisten Konfigurationen (App-Registrierung, Standardwerte usw.).

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"
  • WorkloadName muss dem Muster "Organization.WorkloadName" folgen. Verwenden Sie Org.[YourWorkloadName] für die Entwicklung.
  • Wenn Sie eine vorhandene Microsoft Entra-App wiederverwenden, stellen Sie sicher, dass SPA-Umleitungs-URIs wie im Handbuch zum manuellen Einrichten von Repositorys konfiguriert sind.
  • Verwenden Sie pwsh auf macOS/Linux, um Skripts auszuführen.

3. Starten der Entwicklungsumgebung

Führen Sie den Entwicklungsserver (Front-End + APIs) aus, und registrieren Sie Ihre lokale Instanz über DevGateway bei Fabric.

# Terminal 1: start local dev server
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: start DevGateway to register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

4. Aktivieren von Entwicklerfunktionen in Fabric

Im Fabric-Portal:

  • Stellen Sie im Verwaltungsportal sicher, dass mandantenentwicklereinstellungen aktiviert sind, die für das Toolkit erforderlich sind.
  • Aktivieren Sie in den Entwicklereinstellungen den Fabric-Entwicklermodus für Ihr Konto.

5. Testen des HelloWorld-Elements

Sie können über den Workload-Hub auf die Arbeitslast zugreifen (suchen Sie nach Ihrem Arbeitslastnamen), oder direkt dorthin navigieren. Erstellen Sie dann ein Hello World-Element.

Schritte:

  1. Öffnen Sie den Fabric Workload Hub und suchen Sie Ihre Workload (z. B. Org.MyWorkload).
  2. Wählen Sie den Elementtyp "Hello World" und dann Ihren Entwicklungsarbeitsbereich aus.
  3. Der Editor wird geöffnet; bestätigen, dass das Element erwartungsgemäß funktioniert.

6. Beginnen Sie mit der Codierung

Ändern Sie das HelloWorld-Element, oder erstellen Sie ein neues Element:

  • Aktualisieren Sie den Editor: Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • Oder erstellen Sie ein Gerüst für ein neues Element mit dem Skript: ./scripts/Setup/CreateNewItem.ps1

Problembehandlung

  • PowerShell-Richtlinie: Vorübergehend die Ausführungsrichtlinie lockern, wenn Skripte nicht starten.
  • Neueste PowerShell: Installieren/Aktualisieren von PowerShell, wenn Setupfehler angezeigt werden.
  • Aufheben der Blockierung von Skripts: Wenn Sie dazu aufgefordert werden, lassen Sie die Ausführung von .ps1 Dateien zu.
  • Vorhandene Microsoft Entra-App: Konfigurieren von SPA-Umleitungs-URIs gemäß dem manuellen Leitfaden im Repository.
  • macOS/Linux: Verwenden Sie pwsh, um die Skripte auszuführen.
  • Last updated on