Schritt 3: Erstellen eines AppSource-Pakets für die App

Artikel
03/08/2023

Sie müssen ein AppSource-Paket (ZIP-Datei) erstellen, um die Lösungs- und Demodatendateien zusammen mit anderen erforderlichen Dateien zu integrieren. Ein AppSource-Paket besteht aus den folgenden Dateien:

Datei	Beschreibung
Paketdatei	Eine Paketdatei wird vom Package Deployer Tool verwendet, um Ihre Lösungen und Demokonfigurationsdaten in mehreren Sprachen bereitzustellen.
[Content_Types].xml	Datei, die MIME-Typinformationen zur Dateityperweiterungen im AppSource-Paket bereitstellt. Diese sind normalerweise .dll, .xml, .exe, und .config Dateitypen, aber Sie können fast jeden Dateityp hinzufügen, der von Windows unterstützt wird.
Symboldatei	Eine Bilddatei für das Appsource Paketsymbol; Größe sollte Pixel 32x32 sein. Gültige Bildformate sind PNG und JPG.
HTML-Datei	Datei, die die Lizenzbedingungen enthält.
Input.xml	Dateien, der die Anlagen in Ihrem AppSource-Paket beschreibt.

Erstellen Sie eine Paketdatei

Ein Paket können Sie in mehrere Dateien bündeln und bereitstellen, die gleichzeitig mit der App verknüpft sind.

Erstellt ein Dynamics 365 Paket , um die Lösungs- und Konfigurationsdatendateien zu integrieren, die Sie erstellt haben in Schritt 2: Erstellen einer verwalteten Lösung für Ihre App Ein benutzerdefinierter Code, der ausgeführt werden kann, bevor, während oder nachdem das Paket auf der Microsoft Dataverse-Instanz bereitgestellt wird. Ausführliche Informationen zum Erstellen einer Paketdatei finden Sie unter Erstellen von Paketen für Package Deployer.

Nachdem Sie ein Paket erstellt haben, besteht das Paket aus folgenden Ereignisse:
- <PackageName>-Ordner: Dieser Ordner enthält alle Lösungen, Konfigurationsdateien, Textdateien und Inhalte für Ihr Paket. Geben Sie beispielsweise PkgFolder ein.
- <PackageName>.dll: Die Assembly enthält den benutzerdefinierten Code für Ihr Paket. Beispiel: SamplePackage.dll.

Dann erstellen Sie eine [Content_Types].xml-Datei, die MIME-Typ-Informationen zu Dateityperweiterungen bereitstellt, die in Ihrem Paket enthalten sind. Dies ist getrennt von jener, die wieder im AppSource-Paket enthalten ist. Hier erhalten Sie Beispielinhalte einer [Content_Types].xml-Datei mit den aufgelisteten Dateitypen:

<?xml version="1.0" encoding="utf-8"?>
<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">
  <Default Extension="xml" ContentType="application/octet-stream" />
  <Default Extension="xaml" ContentType="application/octet-stream" />
  <Default Extension="dll" ContentType="application/octet-stream" />
  <Default Extension="zip" ContentType="application/octet-stream" />
  <Default Extension="jpg" ContentType="application/octet-stream" />
  <Default Extension="gif" ContentType="application/octet-stream" />
  <Default Extension="png" ContentType="application/octet-stream" />
  <Default Extension="htm" ContentType="application/octet-stream" />
  <Default Extension="html" ContentType="application/octet-stream" />
  <Default Extension="db" ContentType="application/octet-stream" />
  <Default Extension="css" ContentType="application/octet-stream" />
  <Default Extension="json" ContentType="application/octet-stream" />
  <Default Extension="msapp" ContentType="application/octet-stream" />
</Types>

Komprimieren (ZIP) Sie die folgenden Dateien in einer Datei mit dem Namen package.zip:
- Paketordner (ISVs Sie PkgFolder)
- Paket DLL (SamplePackage.dll)
- [Content_Types].xml
  
  Damit diese Dateien komprimiert werden können, navigieren Sie zum Ordner, in dem die Dateien vorhanden sind, wählen sie alle, machen Sie einen Klick mit der rechten Maustaste und wählen Sie Senden an > Komprimierter (gezippter) Ordner.
Benennen Sie die ZIP-Datei in package.zip um.

[Content_Types].xml erstellen

Sie können die [Content_Types].xml wieder verwenden, die Sie im vorherigen Abschnitt mit Schritt 2 erstellt haben.

Erstellen eines Symbols für das AppSource-Paket

Erstellen Sie eine Symboldatei der Größe 32x32 zur Anzeige zusammen mit dem bevorzugten Lösungsnamen und -Beschreibung im Dynamics 365 Admin Center-Portal. Gültige Dateiformate sind PNG und JPG.

Erstellen Sie eine HTML-Datei für Lizenzbedingungen

Erstellen Sie eine HTML-Datei, die die Lizenzbedingungen enthält. Sie können eine HTML-Datei pro Sprache haben, um die Lizenzbedingungen in der vom Benutzer ausgewählten Sprache anzeigen, falls die App mehrere Sprachen unterstützt.

Input.xml-Datei erstellen

Erstellen Sie eine Input.xml-Datei, die Informationen über das Paket und die Inhalte des Pakets bereitstellt. Hier sind die Inhalte eines Dateibeispiels Input.xml; jedes Element wird weiter unten in der Tabelle veranschaulicht.

<?xml version="1.0" encoding="utf-8"?>
<PvsPackageData>
  <ProviderName>Microsoft</ProviderName>
  <PackageFile>package.zip</PackageFile>
  <SolutionAnchorName>SampleSolution.zip</SolutionAnchorName>
  <StartDate>12/01/2017</StartDate>
  <EndDate>01/01/2031</EndDate>
  <SupportedCountries>US,CA</SupportedCountries>
  <LearnMoreLink>https://www.microsoft.com</LearnMoreLink>
  <Locales>
    <PackageLocale Code="1033" IsDefault="true">
      <Logo>logo32x32.png</Logo>
      <Terms>
        <PackageTerm File="TermsOfUse.html" />
      </Terms>
    </PackageLocale>
  </Locales>
</PvsPackageData>

Hier finden Sie eine Beschreibung der Elemente in der Datei Input.xml.

Element	Beschreibung des Dataflows
ProviderName	Name des Lösungsanbieters. Wenn Sie ein Team als Microsoft werden, geben Sie Microsoft an.
PackageFile	Name des Pakets (.zip-Datei) für das Package Deployer Tool. Dies sollte die Paketassembly, den Paketordner mit Ihren App-Anlagen und die Content_Types.xml-Datei enthalten. Die package.zip-Datei wird unter dem Abschnitt Erstellen einer Paketdatei erstellt.
SolutionAnchorName	Name der Lösungs ZIP Datei im Paket, die für den Anzeigenamen und die Beschreibung der Lösungsanlagen verwendet wird.
StartDate	Datum, an dem die App für AppSource verfügbar ist. Das Datumsformat ist TT/MM/JJJJ.
Enddatum	Datum, an dem die App für AppSource nicht mehr verfügbar ist. Das Datumsformat ist TT/MM/JJJJ.
SupportedCountries	Dies ist eine durch Trennzeichen getrennte Liste mit Ländern oder Regionen, in denen die App verfügbar sein soll. Zur Zeit werden die folgenden Länder unterstützt: AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BR, BS, BT, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, ST, SV, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZW
LearnMoreLink	URL zur Seite mit ausführlichen Informationen für dieses Paket.
Gebietsschema	Eine Instanz dieses Knotens für jede Sprache, die Sie in der bevorzugten Lösung der Benutzeroberfläche sichern möchten. Dieser Knoten enthält die folgenden untergeordneten Elemente: - PackageLocale.Code: Die LCID der Sprache für den Knoten. Beispiel: US-Englisch ist 1033 Hinweis: Achten Sie darauf, dass in den Dateien solution.xml und input.xml dieselben Gebietsschema-Codes verwendet werden. - PackageLocale.IsDefault: Gibt die Standardsprache an. Diese wird als Ausweichsprache genutzt, wenn die Sprache, die vom Kunden ausgewählt wurde, nicht verfügbar ist. - Logo: Wählen Sie ein Logo für Ihre App. Größe des Bilds muss 32x32 sein. Gültige Bildformate sind PNG und JPG. - Bedingungen: Name der HTML-Datei, die Lizenzbedingungen für alle Sprachen enthält.

Einem AppSource-Paket die Elemente hinzufügen

Letzter Schritt besteht darin, alle Komponenten hinzufügen, die Sie zuvor nach einer komprimierten Datei (ZIP) einzeln erstellen, die Ihr App-Quellpaket sein wird.

Navigieren Sie zum Ordner, der die Paketdatei, [Content_Types].xml, das Symbol und die Lizenzbedingungsdatei (HTML) enthält, wählen Sie alle Datenbanken aus, klicken Sie mit der rechten Maustaste und wählen Sie dann den Ordner Senden an > ZIP-komprimierten Ordner aus.

Wichtig

Sie müssen der Inhaltsstruktur für Ihr Paket genau folgen, wie hier beschrieben. Sonst erzeugt das Paket während der Zertifizierung Fehler. Einige allgemeine Probleme, die zu Zertifizierungsfehler führen, beibehalte falsche Namen oder eine geschachtelte Dateistruktur.
Benennen Sie die Datei gemäß der App um. Es ist empfehlenswert, den Kontonamen und App-Namen einzuschließen. Beispiel: Microsoft_SamplePackage.zip.

Schritt 4: Speichern Sie das AppSource-Paket auf Azure Storage

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).

Freigeben über