Paso 3: Crear un paquete AppSource para la aplicación

Artículo
03/14/2023

Debe crear un paquete AppSource (archivo .zip) para incluir los archivos de datos de demostración y de la solución junto con otros archivos necesarios. Un paquete AppSource consta de los archivos siguientes:

Archivo	Descripción
Archivo de paquete	Un archivo de paquete utilizado por la herramienta Package Deployer para implementar las soluciones y los datos de la configuración de prueba en varios idiomas.
[Content_Types].xml	Archivo que proporciona información de tipo MIME sobre las extensiones de tipos de archivo en el paquete AppSource. Normalmente son tipos de archivos .config, .dll, .exe, .xml y .zip, pero se puede agregar prácticamente cualquier tipo de archivo que sea compatible con Windows.
Archivo de icono	Un archivo de imagen para el icono de paquete appsource; el tamaño debería ser de 32 x 32 píxeles. Los formatos de imagen válidos son PNG y JPG.
Archivo HTML	Archivo que contiene los términos de licencia.
Input.xml	Archivos que describen el activos del paquete AppSource.

Crear un archivo de paquete

Un paquete le permite agrupar y distribuir varios archivos relacionados con la aplicación a la vez.

Crear un paquete de Dynamics 365 para incluir los archivos de datos de configuración y la solución que haya creado en Paso 2: crear una solución administrada para su aplicación. Un paquete también puede contener código personalizado que puede ejecutarse antes, durante o después de que se implemente el paquete en la instancia de Microsoft Dataverse. Para obtener más información sobre la creación de archivos de paquete, consulte Crear paquetes para el Package Deployer.

Después de crear un paquete, el paquete constará de lo siguiente:
- Carpeta <PackageName>: esta carpeta contiene todas las soluciones, los datos de configuración, los archivos planos y el contenido para el paquete. Por ejemplo: PkgFolder.
- <PackageName>.dll: el conjunto incluye el código personalizado del paquete. Por ejemplo: SamplePackage.dll.

A continuación, cree un archivo [Content_Types].xml que proporcione información de tipo MIME de las extensiones de tipos de archivo que se incluyen en su paquete. Esto es independiente del archivo que se volverá a incluir en el paquete AppSource. Aquí tiene contenido de ejemplo de un archivo [Content_Types].xml con tipos de archivo enumerados:

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

Comprima (zip) los archivos siguientes en un archivo denominado package.zip:
- Carpeta de paquete (PkgFolder)
- Paquete de dll (SamplePackage.dll)
- [Content_Types].xml
  
  Para comprimir estos archivos, vaya a la carpeta donde estos archivos están presentes, selecciónelos todos, haga clic con el botón derecho del mouse y seleccione Enviar a > carpeta comprimida (zip).
Cambie el nombre del archivo .zip por package.zip.

Crear [Content_Types].xml

Puede volver a utilizar el archivo [Content_Types].xml que ha creado en la sección anterior en el paso 2.

Cree un icono para el paquete AppSource

Cree un archivo de icono del tamaño de 32 x 32 para mostrar junto con el nombre de la solución preferida y la descripción en el portal del centro de administración de Dynamics 365. Los formatos de archivo válidos son PNG y JPG.

Cree un archivo HTML para términos de licencia

Cree un archivo HTML que contiene los términos de licencia. Puede tener un archivo HTML por idioma para mostrar los términos de licencia en el idioma de usuario seleccionado si la aplicación admite varios idiomas.

Cree el archivo Input.xml

Cree un archivo Input.xml que proporciona información sobre el paquete y el contenido del paquete. Aquí se muestra el contenido de un archivo Input.xml de muestra; cada elemento se explica más adelante en la tabla.

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

Aquí tiene una descripción de los elementos del archivo Input.xml.

Elemento	Description
ProviderName	Nombre del proveedor de soluciones. Si lo crea un equipo interno de Microsoft, especifique Microsoft.
PackageFile	Nombre de paquete (archivo .zip) para la herramienta Package Deployer. Este archivo zip debería contener el conjunto de paquete, la carpeta de paquete con los activos de la aplicación y el archivo Tipos_contenido.xml. Por ejemplo, el archivo package.zip creado en la sección crear un archivo de paquete.
SolutionAnchorName	Nombre del archivo zip de la solución en el paquete que se usa para el nombre y la descripción de los activos de la solución.
StartDate	Fecha en la que la aplicación comienza a estar disponible en AppSource. El formato es DD/MM/AAAA.
Fecha de finalización	Fecha en la que la aplicación deja de estar disponible en AppSource. El formato es DD/MM/AAAA.
SupportedCountries	Lista separada por comas de países o regiones donde la aplicación debería estar disponible. En el momento de escribir este artículo, la lista de países admitidos es la siguiente: 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	Dirección URL de la página de información detallada de este paquete.
Locales	Instancia de este nodo para cada idioma que desee que se admita en la interfaz de usuario de soluciones preferidas. Este nodo contiene los elementos secundarios siguientes: - PackageLocale.Code: LCID del idioma de este nodo. Ejemplo: el inglés de Estados Unidos es 1033 Nota: Asegúrese de tener los mismos códigos de configuración regional en los archivos solution.xml e input.xml. - PackageLocale.IsDefault: indica el idioma predeterminado. Se usa como idioma de reserva por si el idioma que el cliente elige no está disponible. - Logo: logotipo para el paquete de la aplicación. El tamaño de la imagen debe ser 32 x 32. Los formatos de imagen válidos son PNG y JPG. - Términos: nombre del archivo HTML que contiene los términos de licencia para cada idioma.

Agregue los elementos a un paquete AppSource

El último paso consiste en agregar todos los componentes que haya creado previamente en un archivo único comprimido (zip), que será el paquete de origen de la aplicación.

Desplácese a la carpeta que contiene el archivo de paquete [Content_Types].xml, el icono, el archivo de términos de la licencia (HTML), selecciónelos todos, haga clic con el botón derecho del mouse en y seleccione Enviar a > Carpeta comprimida (zip).

Importante

Debe seguir la estructura de contenido precisamente para su paquete tal y como se indica aquí o de lo contrario el paquete generará un error durante la certificación. Algunos problemas comunes que dan lugar a un error de certificación son nombres de archivo incorrectos o una estructura de archivo anidada.
Cambie el nombre del archivo correctamente en función de la aplicación. Se recomienda incluir el nombre de su compañía y el nombre de la aplicación. Por ejemplo: Microsoft_SamplePackage.zip.

Paso 4: Almacenar el paquete AppSource en Azure Storage

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).