Einführung
Wenn Sie eine Canvas-App in Microsoft Power Apps Studio bearbeiten, wird eine visuelle Darstellung der App angezeigt.
Sie können ein Steuerelement per Drag & Drop auf den Bildschirm ziehen, die Bearbeitungsleiste verwenden, um Ihre Ausdrücke zu bearbeiten, und im Bereich Eigenschaften die Werte von Steuerelementeigenschaften bearbeiten. Die meisten Entwickler verwenden diese Tools, um Apps zu erstellen und zu ändern.
Sie können eine Kopie einer Canvas-App auf Ihrem Computer als einzelne Datei mit der Erweiterung .msapp speichern. Wenn die Canvas-App Teil einer Microsoft Dataverse-Lösung ist, können Sie mit der Microsoft Power Platform CLI (Befehlszeilenschnittstelle) die Lösung herunterladen und die App extrahieren. Die App-Datei ist eigenständig und stellt die gesamte App dar, darunter Bildschirme, Steuerelemente, Komponenten, Verbindungen, Formeln usw. Intern enthält die App jedoch viele separate Dateien, die jeweils einen Teil der App beschreiben. Sie können diese Dateien mit dem Befehl unpack von Power Platform CLI extrahieren. Nachdem die Dateien entpackt wurden, können Sie die meisten Dateien mit einem beliebigen Texteditor bearbeiten. Der folgende Screenshot zeigt ein Beispiel derselben App, die nach dem Entpacken in Microsoft Visual Studio Code geöffnet wurde.
Das Entpacken der Canvas-App in einzelne Textdateien ermöglicht die folgenden Szenarien, in denen Sie Folgendes durchführen können:
Bearbeiten Sie den Quellcode direkt in einem Texteditor anstelle eines visuellen Designers. Globales Suchen und Ersetzen ist zum Beispiel in einem Texteditor effizienter.
Speichern Sie einzelne Textdateien in der Quellcodeverwaltung, was eine genaue Verfolgung von Änderungen in einer App zulässt. Sie können beispielsweise neu bewerten, wann eine Beschriftung in der App von X in Y geändert wurde und wer die Änderung vorgenommen hat.
Verwenden Sie automatisierte Entwicklungstools, die auf Quellcode basieren, z. B. statische Codeanalyse, Codegeneratoren, Vorlagen usw.
Die Quelle Ihrer App wird durch eine Teilmenge von YAML, einer benutzerfreundlichen Sprache für die Serialisierung von Daten, dargestellt. Das Arbeiten mit YAML wird später in diesem Modul behandelt.
Power Platform CLI
Power Platform CLI (oder CLI) ist ein Befehlszeilentool, das Sie für viele Entwicklungs‑ und Verwaltungsaufgaben in Microsoft Power Platform verwenden können, z. B. Komponenten für das Power Apps component framework erstellen, Umgebungen verwalten, mit Lösungen und Portalen arbeiten usw. Sie können die CLI über eine einfache Eingabeaufforderung, als Teil eines automatisierten Builds, oder über das Terminal in Visual Studio Code verwenden.
Dieses Modul konzentriert sich auf die Canvas-App‑ und Lösungsfunktionen von Power Platform CLI. Weitere Informationen zu anderen Funktionen und ihrer Funktionsweise finden Sie in der Produktdokumentation. Sie können Power Platform CLI herunterladen und installieren. Wenn Sie die CLI bereits installiert haben, stellen Sie anhand des folgenden Befehls sicher, dass Sie über die neueste Version verfügen:
pac install latest
Befehl „unpack“ in Canvas
Wenn Sie eine Canvas-App aus der Cloud herunterladen, handelt es sich um eine einzelne Datei mit der Erweiterung .msapp. Der Befehl canvas unpack verwendet diese Datei als Eingabe und entpackt sie in mehrere Dateien, die die verschiedenen Teile der App darstellen. Beispielsweise verfügt jeder Bildschirm in der App über eine eigene Datei in der Ausgabe des Befehls.
Verwenden Sie den folgenden Befehl, um die .msapp-Datei einer Canvas-App zu entpacken:
pac canvas unpack --msapp "Account Manager.msapp" --sources src
Der Zielausgabeordner wird durch den Umschalter der Quelle identifiziert, indem die folgende Ordnerstruktur verwendet wird.
Befehl „pack“ in Canvas
Der Befehl canvas pack ist das Gegenteil des Befehls canvas unpack, wobei der Ordner, der einzelne Dateien enthält, in eine einzelne .msapp-Datei. gepackt wird. Verwenden Sie diesen Befehl, um die Anwendung so zu packen, dass sie zum Hochladen in die Cloud bereit ist, oder um sie in eine Lösung einzubinden:
pac canvas pack --msapp "Account Manager.msapp" --sources src
Lösungsbefehle
Sie können die .msapp-Datei für Ihre Canvas-App aus dem Entwicklerportal abrufen, indem Sie die jeweilige App herunterladen. Wenn Sie Lösungen verwenden, um Ihre Apps und Flows zu speichern, enthält die exportierte Lösung die .msapp-Datei für jede Canvas-App in der Lösung. Mit der CLI und dem Befehl solution unpack können Sie die einzelnen .msapp-Dateien aus der Lösung extrahieren. Das folgende Beispiel zeigt den Befehl solution unpack:
pac solution unpack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Der Ordner SampleSolutionUnpacked enthält den Unterordner CanvasApps, der die in Ihrer Lösung enthaltene .msapp-Datei für jede App enthält.
Analog zu canvas pack fügt der Befehl solution pack die Dateien zu einer Lösung zusammen, die Sie in eine Cloudumgebung importieren können. Das folgende Beispiel zeigt den Befehl solution pack:
pac solution pack --solution-zip C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.
Power Platform im Vergleich zur Code-Erweiterung
Mit der Microsoft Power Platform-Erweiterung können Sie Power Platform CLI in Visual Studio Code verwenden. Wenn Sie die Erweiterung installieren, wird die neueste Version von Power Platform CLI für die Nutzung in einem Terminalfenster von Visual Studio Code installiert.
Mit der Erweiterung können Sie Ihre Canvas-Apps packen und entpacken, ohne Visual Studio Code verlassen zu müssen. Verwenden Sie dieselben Befehle, die zuvor im Zusammenhang mit der eigenständigen CLI erläutert wurden.
Quellcodeverwaltung
Beim Entpacken einer Canvas-App werden viele Dateien erstellt, und Sie können die einzelnen Dateien für jede Änderung an die Quellcodeverwaltung committen. Diese Schritte können Teil Ihrer Gesamtstrategie für Application Lifecycle Management (ALM) mit Microsoft Power Platform werden. Das Committen der einzelnen Dateien an die Quellcodeverwaltung lässt eine genauere Verfolgung der von Ihnen vorgenommenen Änderungen zu. Insbesondere wenn Sie nur die .msapp-Datei committen, besteht der einzige zu beachtende Unterschied zwischen den Versionen darin, dass sich „etwas“ geändert hat. Das Entpacken und Committen der einzelnen Dateien ermöglicht eine zeilenweise Unterscheidung und die Hervorhebung der Änderungen in jedem Commit. In Kombination mit der Arbeitsaufgabenverfolgung wird auch eine Rückverfolgbarkeit der Anforderungen bis hin zu der Änderung ermöglicht, die zur Unterstützung der Arbeitsaufgabe vorgenommen wurde.
Im Rest dieses Moduls wird erläutert, wie Sie über Ihre Canvas-App mit der Quellcodeverwaltung arbeiten.