Power Apps-Komponententools
Wenn Sie eine Power Apps Codekomponente erstellen, verwenden Sie eine Kombination von Tools, um die erforderlichen Schritte von Anfang bis Ende zu optimieren.
| Schritt | Beschreibung | Tools |
|---|---|---|
| Erstellen | Erstellen und initialisieren Sie das Komponentenprojekt mit einer Vorlage. | Power Platform-Befehlszeilenschnittstelle (CLI) |
| Implementieren | Beschreiben und implementieren Sie das Verhalten und den Stil Ihrer Komponenten. | Code-Editor oder integrierten Entwicklungsumgebung (IDE) Ihrer Wahl |
| Erstellen | Validieren und transpilieren Sie TypeScript-Code und, passen Sie ein Komponentenmanifest an. | Power Platform-CLI oder Visual Studio Code |
| Debuggen | Überprüfen und beheben Sie das Verhalten von Komponenten, ohne sie in einer Dataverse-Umgebung bereitzustellen. | Power Platform CLI |
| Paket | Erstellen Sie eine Dataverse-Lösungsdatei und paketieren Sie die Komponente als Teil dieser Lösung. | Power Platform-CLI und Visual Studio msbuild |
Sehen wir uns einige der Tools an, die wir verwenden werden.
Power Platform CLI
Die Power Platform-CLI (Command-Line Interface) ist ein entwicklerorientiertes Kommandozeilen-Tool, das Befehle zum Erstellen von benutzerdefiniertem Code bereitstellt. Dies umfasst derzeit Codekomponenten und Plug-Ins. Das Tool verfügt auch über admin-Befehle für die Umgebung zum Verwalten von Umgebungen. Sie können auch die Befehle solution und package nutzen, um das Anwendungslebenszyklusmanagement mit Lösungen zu implementieren.
Die CLI benötigt nur wenige Schritte zur Installation. Sie können sicherstellen, dass Sie über die neueste Version verfügen, indem Sie den folgenden update-Befehl verwenden:
pac install latest
Wenn Sie mit dem Erstellen Ihrer Codekomponente beginnen, verwenden Sie die CLI, um Ihre ursprünglichen Dateien mithilfe einer Vorlage zu erstellen. Der folgende Befehl ist ein Beispiel zum Initialisieren einer Komponente mit der Feldvorlage angegeben:
pac pcf init --namespace Contoso --name Slider --template field
Eine der Voraussetzungen für die Installation der CLI ist die Installation des Node Package Managers (npm), mit dem Abhängigkeiten verwaltet und Ihre Codekomponente erstellt werden. Wenn Sie den Befehl „init“ verwenden, wird die Datei „package.json“ erstellt, die mit den Abhängigkeiten für Ihre Codekomponente und mehreren Befehlen wie „build“ konfiguriert ist, die Sie während der Entwicklung Ihrer Komponente verwenden werden. Der erste npm-Befehl, den Sie nach der Initialisierung der Komponente ausführen, lautet install. Durch diesen Befehl werden alle Bibliotheken heruntergeladen, die zur Unterstützung des Power Apps Component Framework benötigt werden.
npm install
Fügen Sie --run-npm-install Ihren Init-Befehlsoptionen hinzu, um anzufordern, dass bei der Initialisierung auch die npm-Installation ausgeführt wird.
pac pcf init --namespace Contoso --name Slider --template field --run-npm-install
Während Sie Ihre Codekomponente entwickeln, können Sie mit dem folgenden build-Befehl nach Codeproblemen suchen:
npm run build
Dadurch diesen Befehl wird Ihr Manifest überprüft, der TypeScript-Transpiler ausgeführt, und Sie werden über Probleme informiert.
Es ist auch eine Testumgebung verfügbar, mit der Sie Ihre Codekomponente lokal testen können, ohne sie in einer Umgebung bereitstellen zu müssen. Sie können die Testumgebung mit Ihrer Codekomponente mit dem folgenden start-Befehl starten:
npm start
Sie können auch den Aktivierungsmodus aktivieren, indem Sie den Befehl npm start watch verwenden. Wenn Sie im Überwachungsmodus Änderungen an Ihrem Code vornehmen, werden diese von der Testumgebung automatisch übernommen, ohne dass ein Neustart erforderlich ist.
Um das Testen von Codekomponenten zu beschleunigen, kann sich die CLI bei Ihrer Entwicklungsumgebung authentifizieren und Ihre Codekomponente zum Testen in reale Apps übertragen. Mit dem folgenden Befehl wird die neueste Version Ihrer Codekomponente erstellt und auf die aktuell konfigurierte Dataverse-Entwicklungsumgebung übertragen.
pac pcf push --publisher-prefix dev
Tools für Visual Studio Code
Die Power Platform-Erweiterung für Visual Studio Code ermöglicht der Power Platform-Befehlszeilenschnittstelle (CLI) die Arbeit im Kontext der Editorumgebung. Sie können die Erweiterung über den Visual Studio Marketplace installieren. Nach der Installation können Sie im Terminalfenster den Befehl „CLI pac“ verwenden.
Tools für Visual Studio
Sie installieren diese Tools entweder mithilfe der eigenständigen Installation oder als Teil der Installation von Visual Studio. Sie finden Sie unter Download Visual Studio 2022 für Windows & Mac.
Der Befehl msbuild wird verwendet, wenn Sie Ihre Komponente als Teil einer Power Apps-Lösung für die Bereitstellung in einer Dataverse-Umgebung paketieren. Mit den folgenden Befehlen wird beispielsweise eine neue Lösung für Ihre Komponente initialisiert und die Projektdatei msbuild erstellt, die das Erstellen der Ausgabelösungsdateien während eines Builds verwaltet.
pac solution init --publisher-name Contoso --publisher-prefix contoso ‑‑outputDirectory vssolution
Damit Ihre Codekomponente in der Lösung paketiert wird, müssen Sie Ihrer Komponente eine Referenz hinzufügen. Dadurch wird sichergestellt, dass Ihre Komponente beim Ausführen eines Builds in die generierte Ausgabelösung einbezogen wird. Der folgende Befehl fügt die Referenz hinzu:
pac solution add-reference --path \<path to your Power Apps component framework project\>
Sie können den Befehl „msbuild“ verwenden, um Lösungsdateien mit der konfigurierten Lösungsreferenz zu generieren. Der folgende Befehl führt den Build beim ersten Mal aus:
msbuild /t:build /restore
Tipp
Wenn Sie die Fehlermeldung erhalten, dass der Befehl „msbuild“ nicht erkannt wird, führen Sie den Befehl über die Developer-Eingabeaufforderung für Visual Studio aus. Diese Verknüpfung wird als Teil von Visual Studio oder der Tools für Visual Studio-Installation erstellt.
Nach dem ersten Build können Sie einfach den Befehl msbuild zum Generieren der Lösungsdateien ausführen. Die generierten Lösungsdateien befinden sich im Ordner \bin\debug\ (oder \bin\release), wenn das Build erfolgreich war. Sobald die Ausgabe-Zip-Datei fertig ist, können Sie entweder manuell die Lösung in Dataverse importieren, oder Sie automatisch mit den Microsoft Power Platform Build Tools bereitstellen.
Eine IDE auswählen
Wir empfehlen zum Schreiben Ihrer Komponenten die Verwendung von Visual Studio Code oder Visual Studio. Sie können jedoch jede beliebige IDE verwenden, um benutzerdefinierte Power Apps-Codekomponenten zu erstellen.