Regrouper des packages MSIXBundle MSIX packages

Cet article décrit le processus de création de bundle après la conversion de versions x86 et x64 de vos programmes d’installation Windows à l’aide de 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.

Quand vous regroupez les différentes versions d’architecture de votre programme d’installation dans une même entité, seul le bundle a besoin d’être chargé vers le Store ou un autre emplacement de distribution.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 plateforme de déploiement Windows 10 reconnaît le type de package .msixbundle, et télécharge uniquement les fichiers qui s’appliquent à l’architecture de votre appareil.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. N’oubliez pas que si vous décidez de distribuer un .msixbundle pour une application particulière, vous ne pouvez pas revenir à la simple distribution d’un package 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.

La section suivante présente une approche étape par étape pour générer un .msixbundle.The following section presents a step-by-step approach to build an .msixbundle. Elle part du principe que vous avez déjà converti vos versions x86 et x64 existantes du programme d’installation de Windows en packages MSIX.It assumes that you have already converted your existing x86 and x64 versions of the Windows installer to MSIX packages.

Programme d’installationSetup

Vous aurez besoin de la configuration suivante pour créer un bundle MSIX :You will need the following setup to successfully build an MSIX bundle:

  • SDK Windows 10 (version 1809 ou ultérieure)Windows 10 SDK (version 1809 or above)
  • Packages MSIX x64 et x86 convertisConverted x64 and x86 MSIX packages

Étape 1 : Rechercher MakeAppx.exeStep 1: Find MakeAppx.exe

MakeAppx.exe est un outil disponible dans le SDK Windows 10 qui permet l’empaquetage et le regroupement des packages MSIX.MakeAppx.exe is a tool available in the Windows 10 SDK that allows for packaging and bundling of MSIX packages. Vous l’utiliserez pour regrouper les deux packages MSIX.You will use this tool to bundle the two MSIX packages together.

Vous pouvez utiliser MakeAppx.exe pour extraire le contenu des fichiers d’un bundle ou package d’application Windows 10.MakeAppx.exe can be used to extract the file contents of a Windows 10 app package or bundle. Il chiffre et déchiffre également les bundles et les packages d’applications.It also encrypts and decrypts app packages and bundles.

Une fois le SDK Windows 10 installé, MakeAppx.exe se trouve généralement à cet emplacement :After the Windows 10 SDK is installed, MakeAppx.exe is usually found here:

  • [x86] - C:\Program Files (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:\Program Files (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

Étape 2 : regrouper les packagesStep 2: Bundle the packages

Pour regrouper des packages avec MakeApp.exe, le plus simple consiste à ajouter tous les packages que vous souhaitez regrouper dans un même dossier.The easiest way to bundle packages with MakeApp.exe is to add all the packages that you want to bundle together in one folder. Le répertoire ne doit rien contenir d’autre que les packages devant être regroupés.The directory must be free of everything else except the packages that been to be bundled.

Déplacez les packages d’applications que vous souhaitez regrouper vers un même répertoire, comme illustré dans la capture d’écran suivante.Move the app packages that you want to bundle into one directory, as shown in the following screenshot.

Regrouper des packages dans un répertoire

Notes

MakeAppx.exe regroupe uniquement les packages qui ont la même identité, ce qui signifie que l’ID d’application, l’éditeur et la version doivent être identiques.MakeAppx.exe only bundles packages that have the same identity, which means that the AppID, publisher, version needs to be the same. Seule l’architecture de processeur du package peut être différente.Only the package processor architecture for an application package can be different.

MakeAppx.exe a la syntaxe de ligne de commande suivante.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

Voici un exemple de commande.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

Après l’exécution de la commande, un fichier .msixbundle non signé est créé dans le chemin spécifié.After running the command, an unsigned .msixbundle will be created in the path specified. Les packages n’ont pas besoin d’être signés avant de créer le bundle.Packages do not need to be signed before bundling.

Étape 3 : signer le bundleStep 3: Sign the bundle

Après avoir créé le bundle, vous devez signer le package avant de pouvoir distribuer l’application à vos utilisateurs ou l’installer.After you create the bundle, you must sign the package before you can distribute the app to your users or install it.

Pour signer un package, vous avez besoin d’un certificat de code de signature général et d’utiliser SignTool.exe du kit SDK Windows 10.To sign a package, you will need a general code signing certificate and use SignTool.exe from the Windows 10 SDK.

Nous vous recommandons vivement d’utiliser un certificat approuvé par une autorité de certification, ce qui permet de distribuer le package et de le déployer sur les appareils de vos utilisateurs finaux de façon fluide.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. Une fois que vous avez accès au certificat privé (fichier. pfx), vous pouvez signer le package comme indiqué ci-dessous.Once you have access to the private certificate (.pfx file), you can sign the package as shown below.

Notes

SignTool.exe est disponible dans le même répertoire que MakeAppx.exe dans le kit SDK Windows 10.SignTool.exe is available in the same directory as MakeAppx.exe in the Windows 10 SDK.

SignTool.exe présente la syntaxe de ligne de commande suivante.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

Voici un exemple de commande.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

Pour plus d’informations sur la signature des packages d’applications avec SignTool.exe, consultez cet article.For more information about signing app packages with SignTool.exe, see this article.

Une fois le bundle signé, vous êtes prêt à l’héberger sur un partage réseau ou sur n’importe quel réseau de distribution de contenu afin de le distribuer à vos utilisateurs.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.