Schnellstart: Erstellen Ihrer ersten Code-App (Vorschau)

Hinweis

Previewfunktionen sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen sind vor einer offiziellen Veröffentlichung verfügbar, damit Kunden frühzeitig zugreifen und Feedback geben können.

Erstellen Sie in dieser Schnellstartanleitung eine Code-App, führen Sie sie lokal aus, und veröffentlichen Sie sie dann. Diese Anweisungen führen Sie zum Herunterladen einer Beispielcode-App und zur Nutzung von PAC CLI, um auf eine Power Platform-Umgebung abzuzielen und damit die App zu veröffentlichen. Anschließend veröffentlichen Sie die App, bevor Sie die in Power Platform gehostete App ausführen.

Voraussetzungen

Hinweis

Siehe die allgemeinen Code-App-Voraussetzungen: Voraussetzungen

Klonen des PowerAppsCodeApps-Repositorys

Dieses Repository enthält den Beginn einer TypeScript-App, die bereits das Power Platform SDK integriert. Später fügen wir Anleitungen hinzu, mit denen Sie ganz neu beginnen können, ohne diese Basis-App zu verwenden.

git clone https://github.com/microsoft/PowerAppsCodeApps.git
cd PowerAppsCodeApps

Öffnen des HelloWorld-Beispiels

Öffnen Sie das HelloWorld Beispiel mit Visual Studio Code.

cd samples\HelloWorld
code .

Dieses App-Projekt wurde mit Vite erstellt und verfügt über zwei wichtige Ergänzungen:

• package.json enthält einen Verweis auf das Power Apps SDK, das eine App beim Herstellen einer Verbindung mit Power Platform-Connectors unterstützt.
• PowerProvider.tsx enthält eine initialize() Funktion, die von der App verwendet wird, um dem Power Apps-Host mitzuteilen, dass die App zum Ausführen bereit ist.

PAC CLI authentifizieren und auf Ihre Entwicklungsumgebung verweisen

Öffnen Sie in Visual Studio Code ein neues Terminalfenster, und verwenden Sie den Befehl "Pac-Authentifizierung erstellen ", um ein Authentifizierungsprofil zu erstellen.

pac auth create --environment {environment id}

Alle Power Platform-Apps, -Flows und -Agents werden in einer Umgebung veröffentlicht. Der Authentifizierungsbefehl der PAC CLI fordert Sie auf, sich mit Ihrer Microsoft Entra-Identität zu authentifizieren und sicherzustellen, dass die Code-App, der Sie Verbindungen hinzufügen und in Power Platform veröffentlichen, in die angegebene Umgebung wechselt.

Installieren von Abhängigkeiten

Führen Sie im Terminalfenster die folgenden Befehle aus:

npm install
pac code init --displayName 'Hello World'

• npm install Installiert die abhängigen Bibliotheken in der package.json Datei.
• pac code init Initialisiert eine Code-App im aktuellen Verzeichnis.

Lokal ausführen

Führen Sie im Terminalfenster die folgenden Befehle aus:

npm run dev | pac code run

• npm run dev Führt die in der package.json Datei konfigurierten Skripte mit dem Schlüssel dev aus. In diesem Fall ist das Skript "concurrently \"vite\" \"pac code run\"".
• pac code run Startet einen lokalen Server für Verbindungen, die lokal in der App geladen werden.

Erstellen und Bereitstellen in Power Apps

Führen Sie im Terminalfenster die folgenden Befehle aus:

npm run build | pac code push

• npm run build Führt die in der package.json Datei konfigurierten Skripte mit dem Schlüsselwert build aus. In diesem Fall ist das Skript "tsc -b && vite build".
• Pac-Code-Push Veröffentlicht eine neue Version einer Code-App.

Bei erfolgreicher Ausführung sollte dieser Befehl eine Power Apps-URL zurückgeben, um die App auszuführen.

Optional können Sie Power Apps öffnen, um die App anzuzeigen. Sie können dort etwas abspielen, freigeben oder Details anzeigen.

Glückwunsch! Sie haben Ihre erste Code-App erfolgreich pusht!

Problembehandlung

Wenn Sie auf dem Ladebildschirm „Ihre App wird abgerufen“ hängen bleiben oder den Fehlerbildschirm „Timeout für App“ sehen, überprüfen Sie Folgendes:

• Dass Sie npm run build ausgeführt haben
• Es gibt keine Probleme in PowerProvider.tsx