Paso 3: Crear un paquete AppSource para la aplicación
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, datos de configuración, archivos planos y el contenido de su paquete. Por ejemplo: PkgFolder.
<PackageName>.DLL: El ensamblaje contiene el código personalizado para su 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>
Importante
Todos los atributos de elementos XML distinguen entre mayúsculas y minúsculas.
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, especifique Microsoft . 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 para 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 y 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. - Logotipo: Logotipo para el paquete de su 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. |
Importante
Para el elemento SupportedCountries asegúrese de no tener espacios ni palabras clave de nueva línea entre los códigos de país.
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í. De lo contrario, su paquete fallará 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.