Verpacken einer Codekomponente

Erfahren Sie, wie Sie eine Codekomponente in einer Lösungsdatei verpacken und in Microsoft Dataverse importieren, damit sie zur Laufzeit verfügbar ist. Außerdem erfahren Sie, wie Sie eine Verbindung mit einer Umgebung herstellen, Updates mit Microsoft Power Platform CLI bereitstellen und Komponenten aus einer Lösung entfernen.

Prozess

So erstellen und importieren Sie eine Lösungsdatei:

  1. Erstellen Sie einen neuen Ordner innerhalb des Beispielkomponentenordners, und benennen Sie ihn mit dem Befehl mkdir Solutions"Lösungen" (oder einen beliebigen von Ihnen ausgewählten Namen). Navigieren Sie mithilfe des Befehls cd Solutionsin das Verzeichnis.

  2. Erstellen Sie ein neues Lösungsprojekt mithilfe des Befehls "pac solution init ". Verwenden Sie das Lösungsprojekt, um die Codekomponente in eine Projektmappen-ZIP-Datei zu bündeln, die Sie in Dataverse importieren.

    pac solution init --publisher-name developer --publisher-prefix dev

    Anmerkung

    Die publisher-name- und publisher-prefix-Werte müssen in Ihrer Umgebung eindeutig sein.

  3. Nachdem Sie die neue Projektmappe erstellt haben, legen Sie den Ordner Solutions als Speicherort für die zu erstellende Beispielkomponente fest. Fügen Sie den Verweis mithilfe des Add-Reference-Befehls der Pac-Lösung hinzu . In dieser Referenz wird das Lösungsprojekt darüber informiert, welche Codekomponenten während des Builds hinzugefügt werden sollen. Sie können Verweise auf mehrere Komponenten in einem einzelnen Lösungsprojekt hinzufügen.

     pac solution add-reference --path c:\downloads\mysamplecomponent

  4. Um eine ZIP-Datei aus dem Lösungsprojekt zu generieren, wechseln Sie in das Verzeichnis Ihres Lösungsprojekts, und erstellen Sie das Projekt mit dem folgenden Befehl. Dieser Befehl verwendet MSBuild, um das Lösungsprojekt zu erstellen, wobei die NuGet-Abhängigkeiten im Rahmen der Wiederherstellung heruntergeladen werden. Verwenden Sie das Flag /restore nur beim ersten Erstellen der Projektmappe. Führen Sie für jeden Build danach den Befehl msbuildaus.

    msbuild /t:restore

    msbuild

    Oder wenn Sie das .NET SDK, Version 6 oder höher installiert haben:

    dotnet build

    Tipp

    • Wenn msbuild 15.9.* nicht im Pfad vorhanden ist, öffnen Sie die Entwickler-Eingabeaufforderung für VS 2017, um die msbuild Befehle auszuführen.
    • Das Erstellen der Lösung in der Debugging-Konfiguration generiert ein nicht verwaltetes Lösungspaket. Beim Erstellen der Lösung in der Releasekonfiguration wird ein verwaltetes Lösungspaket generiert. Sie können diese Einstellungen überschreiben, indem Sie die SolutionPackageType Eigenschaft in der cdsproj Datei angeben.
    • Legen Sie die msbuild-Konfiguration auf Release fest, um einen Produktionsbuild zu erstellen. Beispiel: msbuild /p:configuration=Release
    • Wenn beim Ausführen des -Befehls für Ihre Projektmappe eine Fehlermeldung mit dem Text msbuild angezeigt wird, stellen Sie sicher, dass der Name Ihrer Projektmappe und der Projektname nicht identisch sind.

  5. Nachdem der Build erfolgreich war, suchen Sie die generierten Lösungsdateien innerhalb des \bin\debug\ Ordners.

  6. Importieren Sie die Lösung manuell mithilfe des Webportals oder automatisch mithilfe der Microsoft Power Platform Buildtools in Dataverse.

Herstellen einer Verbindung mit Ihrer Umgebung

Sie können die Codekomponenten direkt über die Microsoft Power Platform-CLI bereitstellen, indem Sie eine Verbindung mit der Dataverse-Umgebung herstellen und die aktualisierten Komponenten verschieben.

Führen Sie die Schritte in der folgenden Liste aus, um das Authentifizierungsprofil zu erstellen, eine Verbindung mit Dataverse herzustellen und die aktualisierten Komponenten zu übertragen.

  1. Erstellen Sie Ihr Authentifizierungsprofil mithilfe des Befehls "Pac-Authentifizierung erstellen ".

    pac auth create --url https://xyz.crm.dynamics.com

  2. Wenn Sie zuvor ein Authentifizierungsprofil erstellt haben, zeigen Sie alle vorhandenen Profile mithilfe des Pac-Authentifizierungslistenbefehls an.

     pac auth list

  3. Wechseln Sie zwischen zuvor erstellten Authentifizierungsprofilen, indem Sie den Befehl pac auth select verwenden.

     pac auth select --index <index of the active profile>

  4. Erhalten Sie grundlegende Informationen über die Umgebung, indem Sie den Befehl pac org who verwenden. Die Verbindung verwendet das Standardauthentifizierungsprofil.

    pac org who

  5. Löschen Sie ein bestimmtes Authentifizierungsprofil mithilfe des Pac-Authentifizierungslöschbefehls mit der pac auth delete --index <index of the profile> Syntax.

  6. Löschen Sie alle Authentifizierungsprofile von Ihrem lokalen Computer, indem Sie den Befehl "Pac-Authentifizierung löschen" verwenden . Diese Aktion ist irreversibel, da sie die Datei authprofile.json und die Token-Cachedatei auf Ihrem lokalen Computer endgültig löscht.

Codekomponenten bereitstellen

Nachdem Sie ein Authentifizierungsprofil erstellt haben, beginnen Sie, die Codekomponenten mit allen neuesten Änderungen an die Dataverse-Instanz zu übertragen.

Die push Funktion beschleunigt die Entwicklung des inneren Entwicklerzyklus, da sie die Anforderungen für die Codekomponentenversionsverwaltung umgeht und nicht erfordert, dass Sie Ihre Lösung (cdsproj) erstellen, um die Codekomponente zu importieren.

Führen Sie die folgenden Schritte aus, um die push Funktion zu verwenden:

  1. Stellen Sie sicher, dass Sie über ein gültiges Authentifizierungsprofil verfügen.

  2. Wechseln Sie zum Verzeichnis, in dem sich die Beispielkomponentendatei befindet.

  3. Führen Sie den pac pcf push-Befehl aus.

    pac pcf push --publisher-prefix <your publisher prefix>

    Anmerkung

    Das Herausgeberpräfix, das Sie mit dem push Befehl verwenden, sollte dem Herausgeberpräfix Ihrer Lösung entsprechen, in dem Sie die Komponenten einschließen.

Entfernen von Komponenten aus einer Lösung

Wenn Sie eine Codekomponente aus einer Lösungsdatei entfernen möchten:

  1. Bearbeiten Sie die Datei cdsproj im Projektverzeichnis der Lösung und entfernen Sie die Referenzen auf die Komponente. Hier ist ein Beispiel für einen Komponentenverweis:

    <ItemGroup>
    <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
      <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
      <Name>pcf_component</Name>
      <Targets>Build</Targets>
      <referenceOutputAssembly>false</referenceOutputAssembly>
      <OutputItemType>Content</OutputItemType>
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Projectreference>
</ItemGroup>

  2. Führen Sie mit dem folgenden Befehl einen Neuaufbau (oder eine Bereinigung) durch:

    msbuild /t:rebuild

Siehe auch

Hinzufügen von Code-Komponenten zu einer Spalte oder Tabelle in modellbasierten Apps
Hinzufügen von Komponenten zu einer Canvas-App
Power Apps component framework-API-Referenz
Übersicht über das Power Apps-Komponentenframework
Microsoft Power Platform CLI-Befehlsgruppen

  • Last updated on