Freigeben über

Quellcodedateien für Canvas-Apps anzeigen

Verwenden Sie den Quellcode für eine Canvas-App, um die von den Erstellenden in Power Apps Studio vorgenommenen Änderungen zu überprüfen. Der generierte Canvas-App YAML-Code ist schreibgeschützt und kann nicht geändert werden. Alle Änderungen an der Datei werden ignoriert und gehen möglicherweise verloren.

  • Das YAML-Schema befindet sich in aktiver Entwicklung, und der Inhalt ist möglicherweise unvollständig.
  • Das aktuelle statische Schema für *.pa.yaml-Dateien finden Sie hier.

Power Fx und YAML sind die Sprachen, die für Power Apps-Quellcode verwendet werden. YAML wird für sein für Menschen lesbares Format geschätzt und profitiert von einer breiten Palette von Editoren, Tools und Bibliotheken für die Bearbeitung.

Auf Quellcodedateien zugreifen

Wenn Sie die Dataverse-Git-Integration verwenden, haben Sie Zugriff auf die Quellcodedateien, sodass keine .msapp-Dateien erforderlich sind.

Power Apps Studio erstellt den Quellcode für Canvas-Apps, der als *.pa.yaml-Dateien in der .msapp-Datei gespeichert wird. Die .msapp-Datei ist eine Binärdatei, die eine Sammlung von Dateien enthält, einschließlich des Quellcodes.

Tipp

Um Application Lifecycle Management (ALM) effektiv zu nutzen, wird die Verwendung von Lösungen empfohlen. Das Canvas-Apps-Paket unterstützt das ALM nicht und sollte nur für grundlegende Import- und Exportfunktionen verwendet werden, wenn Dataverse nicht zur Verfügung steht.

Sie können die Quellcodedateien auch entweder über die .msapp-Datei oder mithilfe der Power Platform-CLI abrufen.

Die *.pa.yaml-Dateien befinden sich im \Src-Ordner der extrahierten .msapp-Datei.

Wichtig

Nur Dateien, die sich im \Src-Verzeichnis der extrahierten .msapp-Datei befinden, sind für die Verwendung mit der Quellcodeverwaltung vorgesehen. Die JSON-Dateien in der .msapp-Datei sollten nicht als Quellcode verwendet werden, da diese zwischen Speicher- und Ladezyklen nicht stabil sind.

Laden Sie die pa.yaml-Dateien mithilfe der Power Platform-CLI herunter und extrahieren Sie sie

Stellen Sie mithilfe der Power Platform-CLI eine Verbindung mit Ihrer Umgebung her und verwenden Sie dann die folgenden Befehle:

  1. Um die Canvas-Apps in Ihrer aktuellen Umgebung aufzulisten, verwenden Sie den Befehl: pac canvas list.
  2. Um die Quellcode-Dateien zu extrahieren, verwenden Sie den Befehl : pac canvas download mit dem Parameter -d.

Quellcodedateien aus einer .msapp-Datei extrahieren

Um Quellcodedateien aus einer .msapp-Dateizu extrahieren, haben Sie zwei Möglichkeiten:

  1. Sie können die .msapp-Datei manuell entpacken.
  2. Alternativ können Sie die folgenden Befehle verwenden:
 Expand-Archive -Path "C:\path\to\yourFile.msapp" -DestinationPath "C:\path\to\destination"

Dateistruktur für eine .msapp-Datei

Bei älteren .msapp-Dateien ohne den \src-Ordner gehen Sie wie folgt vor, um Quellcodedateien zu generieren:

  1. Importieren Sie die neue .msapp-Datei in Power Apps Studio, speichern Sie sie erneut und laden Sie sie herunter.
  2. Danach können Sie die Quellcodedateien extrahieren.

Der \src-Ordner enthält die folgenden Dateien und Ordner:

  • App.pa.yaml: Stellt die App dar.
  • [Bildschirmname].pa.yaml: Eine Datei für jeden Bildschirm, die den Bildschirm darstellt.
  • \Component: Ein Ordner, der eine Datei für jede Komponente enthält, dargestellt als [Komponentenname].pa.yaml.

Nur *.pa.yaml-Dateien im \src-Dateien können als Quellcode verwendet werden. Alle anderen Dateien sollten nicht als Quellcode verwendet werden.

Power Apps-YAML-Schemaversionen

Derzeit gibt es drei Schemaversionen des Power Apps-Quellcodes:

Formatname Dateierweiterung Beschreibung
Experimentell *.fx.yaml Version, die von der experimentellen Power Apps-Git-Versionskontrolle und pac canvas unpack verwendet wird; nicht mehr in Entwicklung.
Erste Vorschau - Die Version, die von der Codeansicht sowie dem Kopieren und Einfügen von Code verwendet wird. Dieses Schema enthält keine Versionsinformationen und ist daher nicht für die Versionskontrolle geeignet. Wenn die Codeansicht allgemein verfügbar (GA) ist, wird auf das Quellcodevorschauformat umgestellt.
Quellcode *.pa.yaml-Dateien Enthält Verbesserungen und Versionsdetails für die Quellcodeverwaltung und befindet sich in aktiver Entwicklung.

Experimentelles Format (*.fx.yaml)

Dieses Schema beschreibt ein experimentelles Format, das von der Power Platform CLI verwendet wird, um Canvas-Apps zu verarbeiten und in ein Quellcodeformat zu konvertieren. Dieses Format wird nicht mehr aktiv weiterentwickelt.

Sie können *.fx.yaml-Dateien nicht direkt in die neuen Formate konvertieren. Um ältere Apps zu konvertieren, verpacken Sie die Canvas-App als .msapp-Datei , und importieren Sie sie in Power Apps Studio.

Vorschauversion

Diese Version wird von der Codeansicht während des Vorschauzeitraums verwendet. Sie wurde entwickelt, um Canvas-Apps in Power Apps Studio zu erstellen, sodass Sie Steuerelemente einfach kopieren und einfügen können. In dieser Version wird der Quellcode in Power Apps Studio verwendet und nicht wie beim experimentellen Format konvertiert.

Das Format während der Vorschauversion war temporär und wird nicht mehr verwendet. Sie können Code aus dem Vorschauformat einfügen.

Die folgenden Änderungen wurden im Vergleich zum experimentellen Format vorgenommen:

  1. Entfernen der ZIndex-Eigenschaft: Die ZIndex-Eigenschaft wird entfernt. Stattdessen wird ein Bildschirm als ein Array von Steuerelementen dargestellt. Die Reihenfolge der Steuerelemente bestimmt ihre Stapelreihenfolge. Normale Steuerelemente werden in aufsteigender Reihenfolge angeordnet, responsive Steuerelemente dagegen in absteigender Reihenfolge.
  2. Austausch der JSON-Objektdarstellung: Die „As“-Syntax wird nicht mehr verwendet, um den Steuerelementtyp festzulegen. Stattdessen bleibt die linke Seite des Bezeichners des Steuerelements eindeutig. Nur Eigenschaften, die von den Standardwerten abweichen, werden serialisiert. Zwei neue Eigenschaften definieren den Steuerelementtyp und die Standardwerte:
  • Steuerelement: Stellt den Steuerelementtyp in YAML dar.
  • Variante: Identifiziert eine Variante eines Steuerelementtyps, die Standardeigenschaftswerte ändern, Eigenschaften hinzufügen oder entfernen oder das Verhalten oder Layout des Steuerelements ändern könnte.

Diese Eigenschaften werden zum Instanziieren von Steuerelementen verwendet und akzeptieren keine Power Fx-Ausdrücke.

Quellcode (*.pa.yaml)

Wichtig

  • Der YAML-Quellcode für Canvas-Apps wird aktiv weiterentwickelt. Der Inhalt kann unvollständig sein und sich ändern.
  • Die .pa.yaml-Dateien sind schreibgeschützt und sollten nur zum Überprüfen Änderungen verwendet werden, die in Power Apps Studio vorgenommen wurden. Diese Dateien werden nicht verwendet, wenn eine App geladen wird.
  • Externes Bearbeiten, Zusammenführen und Konfliktlösung werden nicht unterstützt.

Dieses Schema wurde für Quellcodeverwaltungszwecke entwickelt und ermöglicht die Verwendung einer einzelnen YAML-Datei.

Zu den Aktualisierungen gegenüber dem vorherigen Format gehören:

  1. Gruppierung von Elementen des obersten Knotens:
    • Die Schlüsselwörter der obersten Ebene „App“ und „Bildschirme“ sind Beispiele dafür, wie Elemente jetzt in Knoten der obersten Ebene gruppiert werden.
  2. Spezifikation der Steuerungsversion:
    • Sie können jetzt die Version eines Steuerelements angeben, indem Sie das Schlüsselwort des Steuerelements gefolgt vom @-Operator verwenden. Wenn keine Version angegeben ist, wird die aktuellste Version des Steuerelements verwendet. Die Version wird verwendet, um die Eigenschaften des Quellcodes zu deserialisieren. Die Laufzeitversion des Steuerelements wird durch die Erstellungsversion definiert.
  3. Vereinfachte Variantennamen:
    • Nicht alle Steuerelemente erfordern eine Variante.
  4. Konsistentes ZIndex für alle Steuerelemente:
    • Alle Steuerelemente verwenden jetzt eine aufsteigende Reihenfolge, um den ZIndex-Wert zu bestimmen, beginnend mit 1. Dieses Verhalten entspricht der CSS 2-Spezifikation.