Freigeben über

Abhängige Assembly-Plug-Ins (Vorschauversion)

[Dieses Thema ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Häufig ist es sinnvoll, eine weitere Assembly oder eine Ressourcendatei in ein Plug-In einzubinden. Beispielsweise möchten Sie möglicherweise Newtonsoft.Json.dll oder eine andere Assembly verwenden. Möglicherweise möchten Sie auf eine Liste lokalisierter Zeichenfolgen zugreifen.

Ohne abhängige Assemblys werden alle Plug-Ins als einzelne .NET Framework-Assemblys registriert. Die einzige Möglichkeit, eine andere Assembly einzuschließen, besteht darin, sie zu einer zu kombinieren mithilfe von ILMerge. Während ILMerge für viele funktioniert hat, wurde es von Dataverse noch nie unterstützt und es hat nicht immer funktioniert. ILMerge wird nicht mehr gepflegt.

Bei abhängigen Assemblys registrieren Sie nicht eine einzelne .NET-Assembly, sondern laden stattdessen ein NuGet-Paket hoch, das Ihre Plug-In-Assembly UND alle abhängigen Assemblys enthält. Diese NuGet-Paketdatei wird in einer neuen Tabelle namens PluginPackage gespeichert. Der Inhalt des NuGet-Pakets wird im Dateispeicher und nicht in SQL gespeichert.

Wichtig

  • Dies ist eine Vorschauversion.
  • Funktionen in der Vorschau sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

In diesem Dokument wurde zuvor ein Prozess beschrieben, um zusätzliche Dateien mit dem Plug-In-Paket einzuschließen, die in der Assembly-Laufzeit verfügbar wären. Diese Funktionalität wird nicht unterstützt. Wir können nicht garantieren, dass die Laufzeit den Zugriff auf diese Dateien zulässt.

Wenn Sie Ihr NuGet-Paket hochladen, werden alle Assemblys, die Klassen enthalten, welche die IPlugin-Schnittstelle implementieren, in der Tabelle PluginAssembly registriert und mit PluginPackage verknüpft. Während Sie Ihr Projekt entwickeln und pflegen, aktualisieren Sie weiterhin das PluginPackage. Änderungen an den zugehörigen Plug-In-Assemblys werden auf dem Server verwaltet.

Zur Laufzeit kopiert Dataverse den Inhalt des NuGet-Pakets aus der PluginPackage-Zeile und extrahiert ihn in die Sandbox-Laufzeit. Auf diese Weise sind alle für das Plug-In erforderlichen abhängigen Assemblys verfügbar.

Sie können die Plugin-Assemblies immer noch einzeln registrieren, aber die Verwendung von PluginPackage wird die empfohlene Vorgehensweise sein. Auch wenn Ihr aktuelles Plug-In-Projekt keinen Zugriff auf eine abhängige Assembly erfordert, können Sie bei Bedarf später eine abhängige Assembly hinzufügen, wenn Sie mit der Arbeit mit einem Projekt beginnen, das für die Unterstützung abhängiger Assemblys konfiguriert ist. Es wird nicht geplant, bestehende Plug-In-Assembly-Projekte zur Verwendung von PluginPackage zu konvertieren.

Feedback senden

Wenn Sie Fragen oder Probleme mit diesem Feature haben, können Sie sich an den technischen Support wenden. Wenn Sie Vorschläge haben, posten Sie diese im Power Apps Ideenforum.

Einschränkungen

Die folgenden Einschränkungen gelten für abhängige Assembly-Plug-Ins.

  • Workflowerweiterungen, auch bekannt als Workflow-Assemblys, Workflowaktivitäten oder benutzerdefinierte Workflowaktivitäten werden nicht unterstützt.
  • Plug-ins für virtuelle Tabellendatenanbieter werden nicht unterstützt. Das Importieren einer Lösung in eine Umgebung schlägt fehl, wenn die Lösung Plug-Ins (mit abhängigen Assemblys) enthält, die auf virtuellen Entitäten registriert sind.
  • Lokale Umgebungen werden nicht unterstützt.
  • Nicht verwalteter Code wird nicht unterstützt. Sie können keine Verweise auf nicht verwaltete Ressourcen einfügen.

Assemblys signieren

Sie sind nicht verpflichtet, in Plug-In-Paketen verwendete Plug-In-Assemblys zu signieren.

Wenn Sie einzelne Plug-In-Assemblys ohne die Funktion „Abhängige Assemblys“ registrieren, ist eine Signatur erforderlich, da dadurch ein eindeutiger Name für die Assembly bereitgestellt wird. Bei Plug-In-Assemblys innerhalb eines Plug-In-Pakets werden die Assemblys jedoch über einen anderen Mechanismus auf den Sandbox-Server geladen, sodass eine Signatur nicht erforderlich ist.

Hinweis

Wenn Sie Ihre Assemblys signieren, beachten Sie, dass signierte Assemblys keine Ressourcen verwenden können, die in unsignierten Assemblys enthalten sind. Wenn Sie Ihre Plug-In-Assemblys oder abhängige Assemblys signieren, müssen alle Assemblys, von denen diese Assemblys abhängen, signiert werden. Wenn signierte Assemblys von unsignierten Assemblys abhängen, erhalten Sie eine Fehlermeldung wie die folgende: Could not load file or assembly '<AssemblyName>, Version=<Version>, Culture=neutral, PublicKeyToken=null' or one of its dependencies. A strongly-named assembly is required.

Wenn Sie die Microsoft Power Platform-CLI (pac cli) verwenden, signieren die Standardeinstellungen die Assembly für Sie. Sie müssen sich von der Signierung abmelden, indem Sie den --skip-signing-Parameter verwenden. Weitere Informationen: Erstellen eines Visual Studio-Projekts.

Power Platform Tools signieren Ihre Plug-In-Assembly nicht für Sie.

Werkzeugoptionen

Sie können diese Funktion mit zwei Werkzeugoptionen verwenden:

Tools Überblick
PAC CLI und Plug-In-Registrierungstool (PRT) Microsoft Power Platform CLI ist eine einfache Entwickler-CLI aus einer Hand, die es Entwicklern und ISVs ermöglicht, verschiedene Vorgänge in Microsoft Power Platform in Bezug auf den Umgebungslebenszyklus, die Authentifizierung und die Arbeit mit Microsoft Dataverse-Umgebungen, Lösungspaketen, Portalen, Codekomponenten usw. auszuführen.

PRT ist eine Windows-Anwendung, mit der Sie die Registrierung von Plug-In-Assemblys verwalten und Plug-In-Schrittregistrierungen registrieren können.

Anweisungen finden Sie unter: PAC CLI und PRT verwenden
Power Platform Tools für Visual Studio verwenden Power Platform Tools für Visual Studio unterstützen das schnelle Erstellen, Debuggen und Bereitstellen von Plug-Ins. Weitere Funktionen umfassen die Entwicklung benutzerdefinierter Workflowaktivitäten, Webressourcen, Integrationstechnologien wie Azure Service-Endpunkte und Webhooks und mehr.

Anweisungen finden Sie unter: Power Platform Tools für Visual Studio verwenden

PAC CLI und PRT verwenden

Verwenden Sie PAC CLI zum Erstellen eines Visual Studio-Projekts und PRT, um Ihre Pakete zu verwalten und Schritte zu registrieren.

Anforderungen

Um diese Funktion mit PAC CLI und PRT zu verwenden, sollten Sie diese Tools und Anwendungen verwenden.

Tool/App Anweisungen
Microsoft Power Platform CLI Sie müssen Version 1.17 oder höher haben.
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.

Mehr Informationen: Was ist Microsoft Power Platform CLI?
PRT Sie sollten Version 9.1.0.184 oder höher verwenden.

Befolgen Sie diese Anweisungen, um die neueste Version zu installieren: Dataverse-Entwicklungswerkzeuge.
Visual Studio Wir verlangen 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

Hinweis

Es ist nicht mehr erforderlich, die Assemblys zu signieren, wenn abhängige Assemblys verwendet werden. Wenn Sie Ihre Assembly signieren, müssen alle abhängigen Assemblys ebenfalls signiert werden. Weitere Informationen: Assemblys signieren

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.

Eine abhängige Assembly mit NuGet hinzufügen

Sie können ein NuGet-Paket zu Ihrem Visual Studio-Projekt wie gewohnt hinzufügen. Nachdem Sie das Projekt erstellt haben, sollten Sie die Assembly im NuGet-Paket finden.

Sie können mit dem NuGet Package Explorer das NuGet-Paket 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. Eine Liste von verfügbaren Plug-In-Paketen ansehen.
  2. Ein NuGet-Paket als Plug-In-Paket registrieren.
  3. Ein Plug-In-Paket aktualisieren.
  4. Plug-In-Pakete löschen.

Eine Liste von verfügbaren Plug-In-Paketen ansehen

PRT hat eine neue Ansicht Nach Paket anzeigen, um alle zuvor importierten Plug-In-Pakete aufzulisten:

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

Ein NuGet-Paket als Plug-In-Paket registrieren

PRT hat einen neuen 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.

Ein Plug-In-Paket aktualisieren

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.

Anzeigen des Befehls „Aktualisieren“, 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.

Der Dialog zum Aktualisieren des Plug-In-Pakets.

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 manuell entfernen, die Plug-In-Assemblys oder Plug-In-Typen verwenden, die Sie mit Ihrem Update entfernen möchten.

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

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.

Anzeigen des Befehls „Registrierung aufheben“, 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.

Power Platform Tools für Visual Studio verwenden

Verwenden Sie Power Platform Tools für Visual Studio zum Erstellen eines Visual Studio-Projekts, um Ihre Pakete zu verwalten und Schritte zu registrieren.

Anforderungen

Um diese Funktion zu verwenden mit Power Platform Tools für Visual Studio, müssen Sie Visual Studio 2019 haben und Power Platform Tools für Visual Studio installieren.

Lesen Sie die folgenden Artikel zur Installation und Verwendung von Power Platform Tools für Visual Studio, um mit Plug-Ins zu arbeiten.

Im Allgemeinen verwenden Sie denselben Prozess zum Erstellen und Verwalten von Plug-Ins mit Power Platform Tools für Visual Studio. Allerdings ist das Signieren der Assemblys nicht mehr erforderlich. Weitere Informationen: Assemblys signieren

Plug-In-Pakete für Power Platform Tools aktivieren

Power Platform Tools für Visual Studio bietet mehrere Konfigurationsoptionen, wie in Power Platform Tools-Optionen beschrieben.

  1. In Visual Studio gehen Sie zu Tools > Optionen und suchen nach Power Platform Tools.

  2. Wählen Sie NuGet-Paket zum Bereitstellen von Plug-Ins für Dataverse verwenden aus.

    Wählen Sie „NuGet Paket zum Bereitstellen von Plug-Ins für Dataverse verwenden“ aus.

Hinweis

Wenn diese Option ausgewählt ist, werden alle Ihre Plug-In-Projekte mit Plug-In-Paketen bereitgestellt.

Eine abhängige Assembly mithilfe von NuGet mit Power Platform Tools hinzufügen

Sie können ein NuGet-Paket zu Ihrem Visual Studio-Projekt wie gewohnt hinzufügen. Nachdem Sie das Projekt erstellt haben, sollten Sie die Assembly im NuGet-Paket finden. Das NuGet-Paket befindet sich im Ordner bin\outputPackages.

Sie können mit dem NuGet Package Explorer das NuGet-Paket untersuchen.

Fügen Sie eine abhängige Assembly hinzu, ohne NuGet zu verwenden mit Power Platform Tools

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.

Plug-In-Pakete für Power Platform Tools bereitstellen

Klicken Sie im Lösungs-Explorer mit der rechten Maustaste auf das Plug-In-Projekt und wählen Sie im Kontextmenü Bereitstellen aus, um Ihr Plug-In-Paket bereitzustellen.

foo

Wenn Sie zum ersten Mal bereitstellen, sollten Sie im Ausgabefenster eine Meldung sehen, die Sie darüber informiert, dass das Plug-In-Paket erstellt wurde:

6/22/2022 3:03:17 PM : registration of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, 
at E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful. 
ID allotted was 06a20e15-77f2-ec11-bb3c-000d3a892245.

Jedes Mal, wenn Sie danach eine Bereitstellung durchführen, wird im Ausgabefenster eine Meldung angezeigt, die Sie darüber informiert, dass das Plug-In-Paket aktualisiert wurde.

6/22/2022 3:20:14 PM : update of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, at
E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful.

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 manuell entfernen, die Plug-In-Assemblys oder Plug-In-Typen verwenden, die Sie mit Ihrem Update entfernen möchten.

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

Plug-In-Pakete mit Power Platform Tools anzeigen

Im Power Platform Explorer können Sie verfügbare Plug-In-Pakete anzeigen.

Im Power Platform Explorer können Sie verfügbare Plug-In-Pakete anzeigen

Ein Plug-In-Paket mit Power Platform Tools löschen

Im Power Platform Explorer wählen Sie ein Plug-In-Paket und dann im Kontextmenü Löschen aus.

Wählen Sie ein Plug-In-Paket und dann im Kontextmenü „Löschen“ aus

Wichtig

Durch das Löschen eines Pakets werden das Paket, alle darin enthaltenen Assemblys, alle Plug-Ins innerhalb der Assembly und alle Plug-In-Schrittregistrierungen für die Plug-Ins gelöscht.

Ein Plug-In-Paket mit Power Platform Tools erstellen

Hinweis

Wie in Plug-In-Pakete für Power Platform Tools bereitstellen erwähnt, müssen Sie in der Regel kein Plug-In-Paket im üblichen Ablauf zum Erstellen eines Plug-Ins erstellen. Es wird automatisch erstellt, wenn Sie das Plug-In zum ersten Mal bereitstellen, während die Option NuGet-Paket zum Bereitstellen von Plug-Ins für Dataverse verwenden in Visual Studio festgelegt ist. Sie können jedoch mithilfe der folgenden Schritte ein neues Plug-In-Paket aus einem NuGet-Paket erstellen.

  1. Im Power Platform Explorer wählen Sie Plug-In-Pakete und dann im Kontextmenü Erstellen aus.

    Im Power Platform Explorer wählen Sie „Plug-In-Pakete“ und dann im Kontextmenü „Erstellen“ aus.

  2. Dieser Befehl öffnet den Dialog Neues Plug-In-Paket importieren.

    Der Dialog **Neues Plug-In-Paket importieren

    Wählen Sie das NuGet-Paket aus, und wählen Sie aus, zu welcher Lösung es hinzugefügt werden soll, oder erstellen Sie eine neue Lösung.

Ein Plug-In-Paket mit Power Platform Tools aktualisieren

Hinweis

Wie in Plug-In-Pakete für Power Platform Tools bereitstellen erwähnt, müssen Sie in der Regel kein Plug-In-Paket im üblichen Ablauf zum Erstellen eines Plug-Ins aktualisieren. Es wird automatisch jedes Mal aktualisiert, wenn Sie das Plug-In bereitstellen, während die Option NuGet-Paket zum Bereitstellen von Plug-Ins für Dataverse verwenden in Visual Studio festgelegt ist. Sie können jedoch mit den folgenden Schritten ein neues Plug-In-Paket aus einem NuGet-Paket aktualisieren.

Im Power Platform Explorer wählen Sie ein Plug-In-Paket und dann im Kontextmenü Aktualisieren aus.

Wählen Sie ein Plug-In-Paket und dann im Kontextmenü „Aktualisieren“ aus

Dieser Befehl öffnet ein Dialogfeld, in dem Sie ein NuGet-Paket auswählen können, um das Plug-In-Paket zu aktualisieren.

Anmerkungen zum Design

Hier einige Dinge, die Sie beim Erstellen von Plug-In-Paketen beachten sollten.

Generieren des NuGet-Designs

Das Visual Studio-Projekt, das mit dem pac plugin init erstellt wurde, nutzt Visual Studio-Funktionen, die das Generieren von NuGet-Paketen ermöglichen. Diese Methode verwendet das SDK-Stil-Projektformat. Power Platform Tools für Visual Studio nutzt das Nicht-SDK-Stil-Projektformat.

Sie müssen diese Tools nicht verwenden, um ein NuGet-Paket mit Ihren Plug-Ins zu generieren. Sie können zum Generieren eines NuGet-Pakets die Funktionen verwenden, die Sie bevorzugen. Allerdings müssen Sie zum Hochladen des Pakets auf Dataverse die verfügbaren Tools verwenden.

Weitere Informationen:

Was Sie nicht in Ihr Paket aufnehmen sollten

Beim Erstellen und Registrieren von Plug-In-Paketen kann es zu Problemen kommen, wo standardmäßig Dataverse-Assemblys in Ihr Paket aufgenommen werden, was zu einem Fehler zum Zeitpunkt der Paketregistrierung führt.

Wichtig

Nehmen Sie folgende Dataverse-Assemblys nicht in Ihr Paket auf. Dies führt zu einem Fehler bei der Registrierung des Pakets.

Microsoft.Crm.Sdk.Proxy.dll
Microsoft.Xrm.Sdk.dll
Microsoft.Xrm.Sdk.Workflow.dll
Microsoft.Xrm.Sdk.Data.dll
Microsoft.Crm.Sdk.dll

Das Einschließen einer dieser Assemblys in das Plug-In-Paket führt beim Registrieren des Plug-In-Pakets mit Dataverse zu der folgenden Fehlermeldung:

„PluginPackage darf keine Assemblys enthalten, die in den Nuget-Paketen Microsoft.CrmSdk.CoreAssemblies oder Microsoft.CrmSdk.Workflow enthalten sind.“

Sie können diese Situation beheben, indem Sie die Informationen im Artikel Steuern von Abhängigkeitsressourcen befolgen, sodass diese Abhängigkeitsressourcen nicht in Ihr Paket aufgenommen werden. Sie müssen die Assembly-Referenz mit dem <PrivateAssets>-Tag in der Projektkonfigurationsdatei (.csprog) markieren.

System.Text.Json verwenden

Wenn Sie System.Text.Json wenden, achten Sie besonders darauf, dass Sie dem System.Text.Json-NuGet-Paket einen Verweis hinzufügen.

Bei abhängigen Assemblys müssen Sie NuGet-Paketabhängigkeiten für alle von Ihnen verwendeten externen Bibliotheken einbeziehen. Das Einbeziehen dieser Abhängigkeiten ist erforderlich, damit Sie zur Entwurfszeit auf diese Typen verweisen können. Ihr Klassenbibliotheksprojekt muss auch einen Verweis auf das Microsoft.CrmSdk.CoreAssemblies-NuGet-Paket enthalten, damit Sie auf wichtige Schnittstellen zum Schreiben Ihres Plug-Ins verweisen können.

Da das Microsoft.CrmSdk.CoreAssemblies-NuGet-Paket eine Abhängigkeit von System.Text.Json aufweist, können Sie auf System.Text.Json-Typen zur Entwurfszeit verweisen, ohne das System.Text.Json-NuGet-Pakete explizit hinzufügen zu müssen. Aufgrund dieser indirekten Abhängigkeit ist das System.Text.Json-NuGet-Paket jedoch nicht in Ihrem Plug-In-Paket enthalten. Sie müssen es explizit als Abhängigkeit der ersten Ebene für Ihr Plug-In-Paket hinzufügen.

Derzeit ist System.Text.Json die einzige Abhängigkeit im Microsoft.CrmSdk.CoreAssemblies-NuGet-Paket. Diese Anleitung gilt, wenn in Zukunft weitere neue Abhängigkeiten hinzugefügt werden.

Häufig gestellte Fragen

F: Kann ich ILMerge weiterhin verwenden?

A: Wir haben ILMerge nie unterstützt. Dieses Feature für abhängige Assemblys bietet eine Lösung, die wir mit der gleichen Funktionalität und mehr unterstützen können. Aber sonst hat sich nichts geändert. Wenn ILMerge für Sie funktioniert, können Sie es weiterhin verwenden. Wir empfehlen die Verwendung abhängiger Assemblys, da wir diese Lösung unterstützen können.

Bekannte Probleme

Die folgenden bekannten Probleme sollten behoben werden, bevor abhängige Assemblys für Plug-Ins allgemein verfügbar werden.

Änderungen des benutzerdefinierten API-Exportschlüssels

Wenn Sie eine Lösung importieren, die eine Custom-API enthält, die ein Plugin-Paket verwendet, kann der folgende Fehler auftreten:

Lookup value <plugintypeexportkey>{guid value}</plugintypeexportkey> is not resolvable.

Dieser Fehler tritt nur bei Lösungen auf, die vor Mai 2023 exportiert bzw. generiert wurden. Das genaue Datum variiert je nach Region. Die Lösung für dieses Problem wurde in der Region Nordamerika am 26. Mai 2023 bereitgestellt.

Um dieses Problem zu beheben, müssen Sie das Plug-In-Paket aktualisieren, die Lösung exportieren bzw. generieren und neu installieren.

Weitere Informationen: Eine Beziehung zu einem Plug-In-Typ festlegen (optional)

Plug-In-Profiler

Um Plug-Ins zu debuggen, die Teil eines Plug-In-Pakets sind, müssen Sie Folgendes durchführen:

  1. Verwenden Sie die neueste Version des Plug-In-Registrierungstools (PRT). Version 9.1.0.184 oder höher.

    Verwenden Sie zum Aktualisieren den pac-CLI-Befehl pac tool prt mit dem --update-Schalter.

  2. Bearbeiten Sie im Ordner, der das PRT enthält, die appsettings.json-Datei. Setzen Sie LegacyPluginProfiler auf false.

    Wenn die Installation mithilfe von pac CLI erfolgt ist, sollte der Ordner wie folgt sein:

    C:\Users\<you>\AppData\Local\Microsoft\PowerPlatform\PRT\9.1.0.184\tools

Weitere Informationen:

Siehe auch

Verwenden von Plug-Ins zur Erweiterung von Geschäftsprozessen
PAC CLI – pac plugin init

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).