Freigeben über

Erstellen und registrieren Sie ein Plugin-Paket mit PAC CLI

  • Artikel

In diesem Artikel erfahren Sie, wie Sie ein Plug-In-Paket erstellen, es auf den Dataverse-Server hochladen und registrieren und einige andere Paketverwaltungsaufgaben ausführen. Sie verwenden PAC CLI zum Erstellen des Plug-In-Pakets und das Plug-In-Registrierungstool zum Hochladen und Registrieren des Pakets.

Dieser Artikel hilft Ihnen:

  • Ein Visual Studio-Plug-In-Projekt erstellen
  • Fügen Sie dem Projekt eine abhängige Assembly hinzu und erstellen Sie
  • Verwenden Sie das Plug-in-Registrierungstool, um Ihr Paket hochzuladen und zu registrieren
  • Verwenden Sie das Plug-in-Registrierungstool, um ein Paket zu aktualisieren und zu löschen

Weitere Informationen: Plug-In-Code erstellen und verpacken.

Anforderungen

  • Zugriff auf eine Dataverse-Umgebung
  • Ein Systembenutzerkonto mit der Rolle „Systemadministrator“ oder „Systemanpasser“ in der Zielumgebung
  • Die Tools werden in der nächsten Tabelle beschrieben
Tool/App Anweisungen
Microsoft Power Platform Befehlszeilenschnittstelle (CLI) Version 1.17 oder höher verwenden.
Die bevorzugte Installationsmethode ist die Verwendung von Visual Studio Code. Siehe Power Platform Tools.

Sie können die Windows-Version auch hier herunterladen und installieren: https://aka.ms/PowerAppsCLI.

Wenn Sie die Windows-Version bereits installiert haben, stellen Sie sicher, dass Sie pac install latest ausführen, um die neueste Version zu erhalten.

Weitere Informationen: Was ist Microsoft Power Platform CLI?
Plug-In-Registrierungstool (PRT) Version 9.1.0.184 oder höher verwenden.

Befolgen Sie diese Anweisungen, um die neueste Version zu installieren: Dataverse-Entwicklungswerkzeuge.
Visual Studio Microsoft Visual Studio 2019 oder neuer.

Ein Visual Studio-Projekt erstellen

Verwenden Sie den PAC CLI-Befehl pac plugin init, um ein Visual Studio-Projekt zu erstellen, das Ihren Entwicklungsprozess mit abhängigen Assemblys optimiert.

  1. Erstellen Sie einen Ordner für Ihr Plug-In-Projekt. Der Name dieses Ordners bestimmt den Namen des Visual Studio .NET Framework-Klassenbibliotheksprojekts Ihres Plug-Ins.

  2. Öffnen Sie ein PowerShell-Terminalfenster in Visual Studio Code, um zum Ordner zu navigieren, und führen Sie den Befehl pac plugin init aus. Für Plug-In-Pakete empfehlen wir die Verwendung des --skip-signing-Parameters, damit Ihre Plug-In-Assemblys nicht signiert werden.

    Beispiel:

    PS E:\projects\mypluginproject> pac plugin init --skip-signing

Anmerkung

Wenn Sie abhängige Assemblys verwenden, müssen Sie die Assemblys nicht signieren. Wenn Sie Ihre Assembly signieren, müssen alle abhängigen Assemblys ebenfalls signiert werden. Weitere Informationen: Signierte Assemblys sind nicht erforderlich

Der pac plugin init-Befehl hat eine Reihe von optionalen Parametern. Sie müssen den --skip-signing-Parameter verwenden, wenn Sie Ihre Plug-In-Assembly nicht signieren möchten.

Diese Befehle erstellen ein Visual Studio .NET Framework-Klassenbibliotheksprojekt, der auf dem Namen des Ordners basiert, in dem es erstellt wurde.

Je nach Ihrer Visual Studio Lösungskonfiguration wird beim Öffnen des Visual Studio Projekts in Visual Studio und beim Erstellen desselben ein NuGet Paket für das Projekt im Ordner bin\Debug oder bin\Release generiert. Dieses NuGet-Paket wird jedes Mal, wenn Sie Ihr Projekt erstellen, aktualisiert. Das NuGet-Paket ist die Datei, die Sie mit dem Plugin Registration Tool hochladen.

Fügen Sie eine abhängige Assembly zu Ihrem Projekt hinzu

Sie können ein NuGet-Paket zur Erfüllung der erforderlichen Referenzen zu Ihrem Visual Studio-Plugin-Projekt hinzufügen, wie Sie es normalerweise tun. Nachdem Sie das Projekt erstellt haben, sollten Sie Ihre Plugin-Assembly in dem generierten NuGet-Paket finden, das sich im bin\outputPackages-Ordner befindet.

Sie können NuGet-Paket-Explorer verwenden, um das erzeugte NuGet Paket zu untersuchen.

Fügen Sie eine abhängige Assembly hinzu, ohne NuGet zu verwenden

Wenn Sie über eine Assembly verfügen, die nicht als NuGet-Paket verteilt wird, können Sie sie wie gewohnt zu Ihrem Projekt hinzufügen. Klicken Sie rechts im Lösungs-Explorer auf Abhängigkeiten, und wählen Sie Assembly-Referenz hinzufügen .... Wählen Sie die Assembly aus, die Sie hinzufügen möchten.

Das Plug-in-Registrierungstool verwenden

Mit dem Plug-In-Registrierungstool (PRT) können Sie die folgenden Aufgaben ausführen:

  1. Liste der verfügbaren Plug-In-Pakete anzeigen
  2. Registrieren Sie ein NuGet Paket als Plug-In-Paket

Liste der verfügbaren Plug-In-Pakete anzeigen

Das PRT hat eine neue Anzeige nach Paket-Ansicht, um alle zuvor importierten Plug-In-Pakete aufzulisten:

Anzeigen einer Liste von Plug-In-Paketen mit dem Plug-In-Registrierungstool.

Registrieren Sie ein NuGet Paket als Plug-In-Paket

Das PRT verfügt über einen Befehl zum Auswählen eines NuGet-Pakets zum Importieren/Registrieren als Plug-In-Paket.

Befehl zum Registrieren eines Plug-In-Pakets mit dem Plug-In-Registrierungstool.

Dieser Befehl öffnet einen Dialog zur Auswahl des Plug-In-Pakets.

Sie können entweder eine bestehende Lösung auswählen oder eine neue erstellen.

Dialog zum Importieren eines neuen Plug-In-Pakets.

In der Ansicht Nach Paket anzeigen können Sie die Assembly und Registrierungsschritte auswählen.

Anzeigen eines neu hochgeladenen Plug-In-Pakets in der Ansicht „Nach Paket anzeigen“.

Die Assembly ist auch innerhalb der Ansicht Nach Assembly anzeigen verfügbar.

Zeigt die Plug-In-Paket-Assembly in der Ansicht „Nach Assembly anzeigen“ an.

Verwaltung von Plug-in-Paketen

Im Plug-In-Registrierungstool können Sie zusätzliche Vorgänge für Plug-In-Pakete ausführen, wie in den nächsten Abschnitten beschrieben.

Aktualisieren eines Plugin-Pakets

Während Sie die Liste der Plug-In-Pakete in der Ansicht Nach Paket anzeigen anzeigen, wählen Sie das Plug-In-Paket und dann den Befehl Aktualisieren aus.

Zeigt den Update-Befehl an, während ein Plug-In-Paket ausgewählt ist.

Dieser Befehl öffnet einen Dialog, in dem Sie das NuGet-Paket mit Änderungen auswählen können.

Das Dialogfeld „Plug-In-Paket aktualisieren“.

Wichtig

Wenn Ihre Aktualisierung Plug-In-Assemblys oder Typen entfernt, die in Plug-In-Schrittregistrierungen verwendet werden, wird die Aktualisierung abgelehnt. Sie müssen alle Schrittregistrierungen, die Plug-In-Assemblys oder Plug-In-Typen verwenden, die Sie mit Ihrem Update entfernen möchten, manuell entfernen.

Die Version des Plug-In-Pakets oder der Plug-In-Assembly spielt beim Upgrade-Verhalten keine Rolle. Sie können die Version der Plug-In-Assembly nach Bedarf aktualisieren.

Der Name und die Version des Plug-In-Pakets können nach der Erstellung nicht mehr geändert werden. Der Versuch, dies beispielsweise über einen API-Aufruf zu tun, führt zu einem Fehler.

Plug-In-Pakete löschen

Während Sie die Liste der Plug-In-Pakete in der Ansicht Nach Paket anzeigen anzeigen, wählen Sie das Plug-In-Paket und dann den Befehl Registrierung aufheben aus.

Zeigt den Unregister-Befehl an, während ein Plug-In-Paket ausgewählt ist.

Wichtig

Sie können die Registrierung eines Pakets nicht aufheben, das über Plug-In-Schrittregistrierungen für Plug-In-Assemblys im Paket verfügt. Sie müssen zunächst die Registrierung aller Schrittregistrierungen für die Assemblys im Paket aufheben, bevor Sie das Paket löschen können.

Siehe auch

Informationen zum Plug-In-Registrierungstool