Schnellstart: Erstellen einer Code-App von Grund auf mithilfe der neuen npm CLI (Vorschau)

Ab Power Apps Clientbibliothek für Code-Apps Version 1.0.4 enthält die Clientbibliothek eine npm-basierte CLI für Code-Apps. Diese neue CLI reduziert die Voraussetzungen für die Erstellung von Code-Apps und ersetzt die Befehle der Power Platform CLI pac code , die in einer zukünftigen Version veraltet sind.

In diesem Artikel wird erläutert, wie Sie die Power Apps-Clientbibliothek für Code-Apps installieren, eine leere App aus Vite einrichten und mithilfe der neuen npm-basierten CLI-Befehle in eine Power Apps-Code-App konvertieren.

Voraussetzungen

  • Power Platform-Umgebung mit aktivierten Code-Apps
  • Node.js (LTS-Version)
  • Git

Befehle

Die npm CLI der Code-Apps hat vier Befehle:

Befehl Beschreibung
init Initialisieren Sie Ihre Code-App.
run Startet einen lokalen Entwicklungsserver.
push Veröffentlicht eine neue Version der Code-App in Ihrer Umgebung.
find-dataverse-api Siehe Vorgehensweise: Hinzufügen einer Dataverse-Aktion oder -Funktion zu Ihrer Code-App

Erfahren Sie, wie Sie diese Befehle verwenden, indem Sie die Schritte in diesem Artikel ausführen.

Schritt 1: Projekt initialisieren

Öffnen Sie ein Terminal, und führen Sie den folgenden Befehl aus:

npx degit github:microsoft/PowerAppsCodeApps/templates/vite my-app
cd my-app

Erfahren Sie mehr über den Befehl "Degit ".

Schritt 2: Installieren von Abhängigkeiten und Initialisieren der Code-App

Installieren Sie die Projektabhängigkeiten und die Power Apps-Clientbibliothek für Code-Apps.

npm install

Initialisieren Sie Ihre Code-App. Sie können optionen entweder direkt bereitstellen oder interaktive Eingabeaufforderungen verwenden:

Option A: Interaktiver Modus (die CLI fordert Sie zur Eingabe der erforderlichen Informationen auf):

npx power-apps init

Option B: Optionen direkt übergeben:

npx power-apps init --display-name "App From Scratch" --environment-id <Your environment ID>

Wenn Sie den init Befehl ausführen, authentifiziert sich die CLI automatisch. Melden Sie sich mit Ihrem Power Platform-Konto an, wenn Sie dazu aufgefordert werden.

Schritt 3: Lokal testen

Führen Sie die Code-App lokal für die Entwicklung aus:

npm run dev

Dadurch wird ein lokaler Entwicklungsserver gestartet. Öffnen Sie die URL mit der Bezeichnung "Lokale Wiedergabe".

Wichtig

Öffnen Sie die URL im selben Browserprofil wie Ihr Power Platform-Mandant.

Hinweis

Einschränkungen für den Lokalen Netzwerkzugriff

Seit Dezember 2025 blockieren die Chrome- und Microsoft Edge-Browser standardmäßig Anforderungen von öffentlichen Ursprüngen an lokale Endpunkte.

Die App sollte wie folgt geöffnet werden:

Anzeigen der lokalen Wiedergabe der Test-App im Browser

Erstellen und Bereitstellen in Power Apps

Erstellen Sie Ihre App, und übertragen Sie sie an Ihre Power Apps-Umgebung:

npm run build
npx power-apps push

Befehlsdetails:

  • npm run build - Führt Skripte aus package.json. Führt aus tsc -b && vite build.
  • npx power-apps push – Veröffentlicht eine neue Version der Code-App in Ihrer Umgebung.

Wenn der Befehl erfolgreich abgeschlossen ist, wird eine Power Apps URL zurückgegeben, um die App auszuführen.

Wechseln Sie optional zu Power Apps, um App-Details anzuzeigen, wiederzugeben, zu teilen oder zu überprüfen.