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

Artikel
10/16/2024

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, Konfigurationsdaten, Flatfiles und den Inhalt 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>

Wichtig

Bei allen Attributen der XML-Elemente wird zwischen Groß- und Kleinschreibung unterschieden.

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

Element	Beschreibung des Dataflows
ProviderName	Name des Lösungsanbieters. Falls es von einem Microsoft internen Team erstellt wurde, geben Sie es an Microsoft.
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: LCID der Sprache für diesen Knoten. Beispiel: US-Englisch ist 1033 Hinweis: Stellen Sie sicher, dass die Dateien „solution.xml“ und „Input.xml“ dieselben Gebietsschemacodes verwenden. - 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: Logo für Ihr App-Paket. Größe des Bilds muss 32x32 sein. Gültige Bildformate sind PNG und JPG. - Bedingungen: Name der HTML-Datei, die Ihre Lizenzbedingungen für jede Sprache enthält.

Wichtig

Stellen Sie für das SupportedCountries-Element sicher, dass zwischen den Ländercodes keine Leerzeichen und keine neuen Zeilenschlüsselwörter stehen.

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 Ihr AppSource Paket auf Azure Storage und generieren Sie eine URL mit SAS-Schlüssel

Freigeben über