Empaquetado de paquetes MSIXBundle MSIX packages

En este artículo se describe el proceso de creación de un empaquetado después de convertir las versiones x86 y x64 de los instaladores de Windows mediante MSIX Packaging Tool.This article describes the process of creating a bundle after converting x86 and x64 versions of your Windows installers using the MSIX Packaging Tool.

Al empaquetar las distintas versiones de la arquitectura del instalador en una única entidad, solo el empaquetado se debe cargar en Store u otra ubicación de distribución.By bundling the multiple architecture versions of your installer into one entity, only the bundle needs to be uploaded to the Store or another distribution location. La plataforma de implementación de Windows 10 tiene en cuenta el tipo de paquete .msixbundle y solo descargará los archivos que sean aplicables a la arquitectura del dispositivo.The Windows 10 deployment platform is aware of the .msixbundle package type and will only download the files that are applicable for your device's architecture. Ten en cuenta que si decides distribuir un paquete .msixbundle para una aplicación en particular, no puedes volver a distribuir solo un paquete de MSIX.Keep in mind that if you decide to distribute an .msixbundle for a particular app, you cannot revert back to distributing just an MSIX package.

En la siguiente sección se presenta un enfoque paso a paso para compilar un paquete .msixbundle.The following section presents a step-by-step approach to build an .msixbundle. Se da por supuesto que ya has convertido las versiones x86 y x64 existentes del instalador de Windows a paquetes de MSIX.It assumes that you have already converted your existing x86 and x64 versions of the Windows installer to MSIX packages.

ConfigurarSetup

Necesitarás la siguiente configuración para compilar correctamente un empaquetado de MSIX:You will need the following setup to successfully build an MSIX bundle:

  • SDK de Windows 10 (versión 1809 o superior)Windows 10 SDK (version 1809 or above)
  • Paquetes de MSIX x64 y x86 convertidosConverted x64 and x86 MSIX packages

Paso 1: buscar MakeAppx.exeStep 1: Find MakeAppx.exe

MakeAppx.exe es una herramienta disponible en el SDK de Windows 10 que permite el empaquetado y la unión de paquetes de MSIX.MakeAppx.exe is a tool available in the Windows 10 SDK that allows for packaging and bundling of MSIX packages. Usa esta herramienta para empaquetar los dos paquetes de MSIX.You will use this tool to bundle the two MSIX packages together.

MakeAppx.exe se puede utilizar para extraer el contenido de archivos de un paquete de aplicación o empaquetado de Windows 10.MakeAppx.exe can be used to extract the file contents of a Windows 10 app package or bundle. También cifra y descifra los paquetes de aplicaciones y los empaquetados.It also encrypts and decrypts app packages and bundles.

Después de instalar el SDK de Windows 10, MakeAppx.exe se suele encontrar aquí:After the Windows 10 SDK is installed, MakeAppx.exe is usually found here:

  • [x86] - C:\Archivos de programa (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe[x86] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe
  • [x64] - C:\Archivos de programa (x86)\Windows Kits\10\bin\10.0.17763.0\x64\MakeAppx.exe[x64] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x64\MakeAppx.exe

Paso 2: empaquetar los paquetesStep 2: Bundle the packages

La forma más sencilla de empaquetar paquetes con MakeApp.exe es agregar todos los paquetes que desees empaquetar a una carpeta.The easiest way to bundle packages with MakeApp.exe is to add all the packages that you want to bundle together in one folder. El directorio no debe contener nada más que los paquetes que se van a empaquetar.The directory must be free of everything else except the packages that been to be bundled.

Mueve los paquetes de aplicaciones que desees empaquetar a un directorio, tal como se muestra en la captura de pantalla siguiente.Move the app packages that you want to bundle into one directory, as shown in the following screenshot.

Empaquetado de paquetes en un directorio

Nota

MakeAppx.exe solo empaqueta paquetes que tengan la misma identidad, lo que significa que el valor de AppID, publicador y versión debe ser el mismo.MakeAppx.exe only bundles packages that have the same identity, which means that the AppID, publisher, version needs to be the same. Solo puede ser diferente la arquitectura del procesador de paquetes para un paquete de aplicación.Only the package processor architecture for an application package can be different.

MakeAppx.exe tiene la siguiente sintaxis de línea de comandos.MakeAppx.exe has the following command line syntax.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe" bundle /d input_directorypath 
/p <filepath>.msixbundle

Este es un comando de ejemplo.Here is an example command.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe" bundle /d c:\AppPackages\ 
/p c:\MyLOBApp_10.0.0.0_ph32m9x8skttmg.msixbundle

Después de ejecutar el comando, se creará un archivo .msixbundle sin firmar en la ruta especificada.After running the command, an unsigned .msixbundle will be created in the path specified. No es necesario que los paquetes estén firmados antes de la agrupación.Packages do not need to be signed before bundling.

Paso 3: firmar la agrupaciónStep 3: Sign the bundle

Después de crear la agrupación, debe firmar el paquete para poder distribuir la aplicación a los usuarios o instalarla.After you create the bundle, you must sign the package before you can distribute the app to your users or install it.

Para firmar un paquete, necesita un certificado de firma de código general y debe usar el archivo SignTool.exe del SDK de Windows 10.To sign a package, you will need a general code signing certificate and use SignTool.exe from the Windows 10 SDK.

Es muy recomendable que use un certificado de confianza de la entidad de certificación, ya que esto permite distribuir e implementar el paquete en los dispositivos de los usuarios finales sin problemas.We strongly recommend that you use a trusted cert from certificate authority as that allows for the package to be distributed and deployed on your end users devices seamlessly. Una vez que tenga acceso al certificado privado (archivo .pfx), puede firmar el paquete tal y como se muestra a continuación.Once you have access to the private certificate (.pfx file), you can sign the package as shown below.

Nota

SignTool.exe está disponible en el mismo directorio que MakeAppx. exe en el SDK de Windows 10.SignTool.exe is available in the same directory as MakeAppx.exe in the Windows 10 SDK.

SignTool.exe tiene la siguiente sintaxis de línea de comandos.SignTool.exe has the following command line syntax.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\SignTool.exe" sign /fd <Hash Algorithm> /a 
/f <Path to Certificate>.pfx /p <Your Password> <File path>.msixbundle

Este es un comando de ejemplo.Here is an example command.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\SignTool.exe" sign /fd SHA256 /a 
/f c:\private-cert.pfx /p aaabbb123 c:\MyLOBApp_10.0.0.0_ph32m9x8skttmg.msixbundle

Para más información sobre la firma de paquetes de aplicaciones con SignTool.exe, consulta este artículo.For more information about signing app packages with SignTool.exe, see this article.

Después de firmar correctamente el paquete, ya puedes hospedarlo en un recurso compartido de red o en cualquier red de distribución de contenido para distribuirlo a los usuarios.After successfully signing the bundle, you are ready to host it on a network share or on any content distribution network to distribute it to your users.