Étape 3 : Créer un package AppSource de votre application

  • Article

Vous devez créer un package AppSource (fichier .zip) pour inclure vos fichiers de données de solution et de démonstration avec d′autres fichiers requis. Un package AppSource inclut les fichiers suivants :

Fichier Description
Fichier de package Fichier de package utilisé par l′outil Package Deployer pour déployer vos données de configuration de solutions et de démonstration dans plusieurs langues.
[Content_Types].xml Fichier qui fournit des informations de type MIME aux extensions de fichier inclus dans le package AppSource. En général, ce sont des types de fichiers .config, .dll, .exe., xml, et .zip, mais vous pouvez ajouter presque tout type de fichier pris en charge par Windows.
Fichier icône Fichier image pour l′icône du package appsource. La taille doit être de 32x32 pixels. Les formats d′images valides sont PNG et JPG.
Fichier HTML Fichier contenant les conditions de votre licence.
Input.xml Fichiers décrivant les actifs de votre package AppSource.

Créer un fichier de package

Un package vous permet de regrouper et de déployer plusieurs fichiers associés à votre application simultanément.

  1. Créez un package Dynamics 365 pour inclure les fichiers de données de solution et de configuration que vous avez créés dans l′Étape 2 : Création d′une solution gérée pour votre application. Un package peut également inclure un code personnalisé pouvant s′exécuter avant, pendant ou après le déploiement du package sur l′instance Microsoft Dataverse. Pour plus d′informations sur la création d′un fichier de package, voir Créer des packages pour Package Deployer.

    Après avoir créé un package, celui-ci se compose des éléments suivants :

    • Dossier <PackageName> : Ce dossier contient toutes les solutions, les données de configuration, les fichiers plats et le contenu de votre package. Par exemple, PkgFolder.

    • <PackageName>.dll : l’assembly contient le code personnalisé pour votre package. Par exemple : SamplePackage.dll.

  2. Ensuite, créez un fichier [Content_Types].xml qui fournit des informations sur le type MIME aux extensions de fichier inclus dans votre package. Il est distinct de celui qui sera inclus de nouveau dans le package AppSource. Voici un exemple du contenu d’un fichier [Content_Types].xml avec les types de fichiers répertoriés :

    <?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>

  3. Compressez (zip) les fichiers suivants dans un fichier appelé package.zip :

    • dossier du package (PkgFolder)

    • dll du package (SamplePackage.dll)

    • [Content_Types].xml

      Pour compresser ces fichiers, accédez au dossier contenant ces fichiers, sélectionnez-les tous, cliquez avec le bouton droit et sélectionnez Envoyer vers>Dossier compressé (zippé).

      Compressez les fichiers pour un package.

  4. Renommez le fichier .zip en package.zip.

Créez [Content_Types].xml

Vous pouvez réutiliser le fichier [Content_Types].xml que vous avez créé dans la section précédente à l′étape 2.

Créez une icône pour votre package AppSource

Créez un fichier d′icône d′une taille de 32x32 pixels à afficher avec le nom et la description préférés de la solution dans le portail du Centre d′administration de Dynamics 365. Les formats de fichiers valides sont PNG et JPG.

Créez un fichier HTML pour les termes du contrat de licence

Créez un fichier HTML contenant les termes de votre contrat de licence. Vous pouvez avoir un fichier HTML par langue pour afficher les termes du contrat de licence dans la langue sélectionnée par l′utilisateur si votre application prend en charge plusieurs langues.

Créer un fichier Input.xml

Créez un fichier Input.xml qui fournit des informations sur votre package et son contenu. Voici le contenu d′un exemple de fichier Input.xml. Chaque élément est expliqué plus loin dans le tableau.

<?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>

Important

Tous les attributs des éléments XML sont sensibles à la casse.

Voici une description des éléments contenus dans le fichier Input.xml.

Élément Description
ProviderName Nom du fournisseur de solutions. Si elle a été créée par une équipe interne à Microsoft, spécifiez Microsoft.
PackageFile Nom du package (fichier .zip) pour l′outil Package Deployer. Ce fichier zip doit contenir l′assembly de package, le dossier de package avec vos composants d′application et le fichier Content_Types.xml. Par exemple, le fichier package.zip créé sous la section Créer un fichier de package.
SolutionAnchorName Nom du fichier zip de la solution dans le package qui est utilisé pour le nom complet et la description des actifs de la solution.
StartDate Date à laquelle l′application devient disponible sur AppSource. Le format de date est JJ/MM/AAAA.
Date de fin Date à laquelle l′application arrête d′être disponible sur AppSource. Le format de date est JJ/MM/AAAA.
SupportedCountries Liste séparée par des virgules des pays ou régions où l′application doit être disponible. Au moment de la rédaction de cet article, la liste des pays pris en charge est la suivante :
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 à la page des informations détaillées pour ce package.
Paramètres régionaux Instance de ce nœud pour chaque langue que vous voulez prendre en charge dans l′interface utilisateur de la solution favorite. Ce nœud contient les éléments enfants suivants :
- PackageLocale.Code : LCID de la langue de ce nœud. Exemple : L′anglais américain a le code 1033
  Remarque : Assurez-vous d’avoir les mêmes codes de paramètres régionaux dans les fichiers solution.xml et input.xml.
- PackageLocale.IsDefault : Indique la langue par défaut. Ceci est utilisé comme langue par défaut si la langue choisie par le client n′est pas disponible.
- Logo : Logo de votre package d′application. La taille de l′image doit être de 32x32 pixels. Les formats d′images valides sont PNG et JPG.
- Termes : Nom du fichier HTML contenant les termes de votre contrat de licence pour chaque langue.

Important

Pour l’élément SupportedCountries, assurez-vous de ne pas avoir d’espaces ni de mots clés de nouvelle ligne entre les codes de pays.

Ajouter des éléments à un package AppSource

L′étape finale consiste à ajouter tous les composants créés précédemment dans un fichier compressé unique (zip), qui sera votre package d′application source.

  1. Accédez au dossier contenant le fichier de package, le fichier [Content_Types].xml, l′icône, les termes du contrat de licence (HTML), sélectionnez-les tous, cliquez avec le bouton droit puis sélectionnez Envoyer vers>Dossier compressé (zippé).

    Package AppSource

    Important

    Vous devez suivre la structure du contenu précisément pour votre package, comme décrit ici. Sinon, votre package échouera lors de la certification. Certains problèmes courants entraînant une défaillance de la certification sont les noms de fichier incorrects ou une structure de fichiers imbriqués.

  2. Renommez le fichier correctement en fonction de votre application. Il est recommandé d′inclure le nom de votre société et de l′application. Par exemple : Microsoft_SamplePackage.zip.

Étape 4 : Stocker votre package AppSource sur Azure Storage et générer une URL avec la clé SAS