Créer un package (makepkg.exe)

Crée des packages d’application, charge des packages vers Partner Center et effectue les opérations de création de packages associées. makepkg prend en charge les formats de package XVC, MSIXVC et MSIXVC2. Utilisez l’option /msixvc2 pour générer des packages au format MSIXVC2.

makepkg <command> [options]

Options globales

Option	Description
`/v`	Active la sortie détaillée dans la console.
`/?`, `/h`	Affiche l’aide et les informations d’utilisation.

Commandes

pack - Crée un nouveau package d’application à partir de fichiers sur disque.
upload - Charge un package ou un répertoire de fichiers vers Partner Center.
genkey - Génère une clé de chiffrement à utiliser avec pack /lk.
genid - Effectue la conversion entre un GUID d’ID de produit et un ID Store.
genmap - Génère un fichier XML de mappage à partir du contenu sur disque.
validate - Exécute la validation sans créer de package.
updatesubval - Met à jour SubmissionValidator.dll sans exécuter d’autre opération.
localize - Génère un fichier Resources.pri à partir du contenu sur disque.

pack

Crée un nouveau package d’application à partir de fichiers sur disque.

makepkg pack [options]

Exemple d’utilisation :

makepkg pack /msixvc2 /f layout.xml /d <sourcedir> /pc /pd <destinationdir>

Options

Option	Description
`/msixvc2`	Génère un package au format de package MSIXVC2. Sans cette option, un package MSIXVC est généré.
`/updcompat 3`	Utilise une granularité de mise à jour de contenu au niveau des sous-fichiers pour les packages XVC et MSIXVC. La seule valeur prise en charge est `3`.
`/d <sourcedir>`	(Obligatoire) Spécifie le répertoire source qui contient le contenu à empaqueter.
`/pd <destinationdir>`	(Obligatoire) Spécifie le répertoire de destination du package généré.
`/f <mapfile>`	Spécifie le fichier de mappage à utiliser pour la création du package. S’il est omis, une disposition par défaut à chunk unique est générée.
`/compress <method>`	Compresse la sortie. Les méthodes disponibles sont `Automatic` (par défaut) et `None`. `Automatic` utilise Brotli pour les packages MSIXVC2 et aucune compression pour les packages XVC ou MSIXVC.
`/pc`	Génère un package destiné à être utilisé sur PC.
`/contentid <contentid>`	Spécifie l’ID de contenu auquel ce package appartient.
`/gameos <gameos>`	Spécifie le fichier de système d’exploitation de jeu à incorporer dans le package.
`/l`	Chiffre le package avec une licence de contenu unique. Lorsque vous soumettez un package XVC ou MSIXVC à la certification, utilisez `/l` ou `/lk`, sauf indication contraire de l’équipe de certification.
`/lk <key.lekb>`	Chiffre le package avec une licence de contenu à l’aide d’un fichier de clé spécifié. Utilisez `genkey` pour générer le fichier de clé. Lorsque vous soumettez un package XVC ou MSIXVC à la certification, utilisez `/l` ou `/lk`, sauf indication contraire de l’équipe de certification.
`/productid <productid>`	Spécifie l’ID de produit auquel ce package appartient.
`/maxencryptionfragments <count>`	Spécifie le nombre de fragments de chiffrement à réserver dans les métadonnées du package. Cette option s’applique uniquement aux packages XVC et MSIXVC.
`/priorpackage <OldPackage.msixvc>`	Spécifie un package XVC, MSIXVC ou MSIXVC2 issu d’une opération pack antérieure pour la comparaison de la taille de la mise à jour de contenu.
`/loggable`	Supprime la sortie contenant des caractères de contrôle qui ne conviennent pas à un fichier journal.
`/usepublisherkey <publisherkeyname>`	Signe un package Publisher Content XVC ou MSIXVC, ou incorpore la clé publique de l’éditeur dans le package du jeu de base parent, à l’aide d’une clé CNG préinstallée identifiée par `publisherkeyname`. S’applique uniquement à XVC et MSIXVC.
`/publisherkeyprovider <publisherkeyprovider>`	Spécifie le fournisseur de stockage de clés CNG qui contient la clé d’éditeur nommée par `/usepublisherkey`. S’il n’est pas spécifié, Microsoft Software Key Storage Provider est utilisé. S’applique uniquement à XVC et MSIXVC.
`/usepublishercert <thumbprint\|certificate.cer>`	Spécifie l’empreinte numérique ou le chemin du fichier .cer du certificat utilisé pour signer un package Publisher Content MSIXVC2 ou pour l’autoriser à partir d’un package parent. Un fichier .cer est associé à sa clé privée dans le magasin de certificats. Nécessite `/msixvc2`.
`/publishercertstore <store>`	Spécifie le magasin de certificats qui contient le certificat d’éditeur nommé par `/usepublishercert`. S’il n’est pas spécifié, le magasin personnel CurrentUser est utilisé. Nécessite `/msixvc2`.
`/symbolpaths <symbolpaths>`	Spécifie des chemins supplémentaires pour la recherche de résolution des symboles lors du regroupement des symboles. Séparez les chemins par des points-virgules.
`/skipsymbolbundling`	Ignore le regroupement des symboles.
`/skipvalidation`	Ignore Submission Validator. N’utilisez pas cette option pour les builds susceptibles d’être soumises à la certification.
`/validationcritical`	Traite les échecs de Submission Validator comme des échecs critiques pour le processus `makepkg`.
`/openvalidationlog`	Ouvre le fichier journal de Submission Validator dans l’application XML par défaut après la validation.
`/validationlanguage <lang>`	Spécifie une langue supplémentaire pour le fichier journal de Submission Validator.
`/validationpath <path>`	Spécifie le répertoire à partir duquel charger SubmissionValidator.dll.
`/updatesubval`	Télécharge la dernière version de SubmissionValidator.dll avant la validation, sauf si la version installée est à jour. Utilisez `/validationpath` pour sélectionner un autre emplacement. Si la mise à jour échoue, la création du package ou la validation se poursuit avec la DLL installée. Pour effectuer la mise à jour sans autre opération, utilisez updatesubval.

Remarques

Par défaut, makepkg pack chiffre les packages XVC ou MSIXVC à l’aide d’une clé de chiffrement connue, reconnue par tous les kits de développement à des fins de test. Ces packages ne sont pas protégés par chiffrement. Pour une protection supplémentaire lors du chargement, les packages XVC et MSIXVC peuvent utiliser /l ou /lk. Les packages qui utilisent /l ne peuvent pas être installés sur un kit de développement ou un PC avant le chargement. Les packages qui utilisent /lk peuvent être installés sur un kit de développement avant le chargement. Quel que soit le mode de chiffrement du chargement, le service XBOX chiffre le package pour la distribution avec des clés de chiffrement gérées par Microsoft. Les packages MSIXVC2 n’utilisent pas de chiffrement côté client lors du chargement. Le service XBOX gère le chiffrement pour la distribution. Pour plus d’informations sur le schéma du fichier de mappage, consultez Schéma de package de déploiement.

upload

Charge un package vers Partner Center. Pour MSIXVC2 uniquement, la commande upload peut également empaqueter des fichiers libres et les charger en une seule opération lorsque /d est spécifié. Le chargement de fichiers libres nécessite l’option /msixvc2. Si aucune branche ni aucune version d’évaluation (flight) n’est spécifiée, le package est chargé dans la branche main. Le fichier EKB et le fichier journal de Submission Validator doivent se trouver dans le même répertoire que le package ; ils sont chargés automatiquement. Un groupe de symboles est également chargé lorsqu’il est présent. L’ID Store est extrait du package, mais il peut être fourni lorsque le package a été généré sans ID Store.

makepkg upload [options]

Exemple d’utilisation (charger un package prégénéré) :

makepkg upload /pd <package_directory> /branch <branch> /auth CacheableBrowser

Exemple d’utilisation (empaqueter et charger des fichiers libres) :

makepkg upload /d <sourcedir> /msixvc2 /pc /branch <branch>

Options de source du package

Option	Description
`/pd <package_directory>`	Spécifie le fichier de package ou son répertoire. Si le répertoire contient plusieurs packages, spécifiez le nom complet du fichier de package.
`/d <sourcedir>`	Spécifie le répertoire source à empaqueter et à charger en une seule opération.
`/f <mapfile>`	Spécifie le fichier de mappage à utiliser avec `/d`.
`/msixvc2`	Génère un package MSIXVC2 lorsqu’elle est utilisée avec `/d`.
`/compress <method>`	Compresse la sortie. Les méthodes disponibles sont `Automatic` (par défaut) et `None`.
`/pc`	Génère un package PC lorsqu’elle est utilisée avec `/d`.
`/productid <productid>`	Spécifie l’ID de produit auquel ce package appartient.

Options de destination

Option	Description
`/storeid <storeId>`	Spécifie l’ID Store. S’il est omis, l’ID Store est extrait du package.
`/branch <branch>`	Spécifie la branche dans laquelle effectuer le chargement. La valeur par défaut est `main` si aucune branche ni aucune version d’évaluation n’est spécifiée.
`/flight <flight>`	Spécifie la version d’évaluation (flight) dans laquelle effectuer le chargement. Cette option ne peut pas être utilisée avec `/branch`.
`/market <market>`	Spécifie le marché dans lequel effectuer le chargement. La valeur par défaut est `default`.
`/disclayout <path>`	Spécifie un fichier de disposition de disque pour un package distribué sur plusieurs disques.

Options d’authentification

Option	Description
`/auth <method>`	Spécifie la méthode d’authentification. La valeur par défaut est `CacheableBrowser`. Plusieurs méthodes sont disponibles uniquement pour les chargements MSIXVC2. Les chargements XVC et MSIXVC ne peuvent utiliser que `CacheableBrowser`. Pour une authentification avancée avec ces formats, utilisez Package Uploader.
`/tenantid <tenantId>`	Spécifie le locataire dans lequel effectuer le chargement. S’il est omis, le locataire par défaut de l’utilisateur est utilisé.
`/clientid <clientId>`	Spécifie l’ID client. Obligatoire pour `ManagedIdentity`, `ClientCertificate` et `ClientSecret`.
`/clientsecret <secret>`	Spécifie le secret client. Nécessite `/auth ClientSecret`.
`/certthumbprint <thumbprint>`	Spécifie l’empreinte numérique du certificat pour `ClientCertificate`.
`/certstore <store>`	Spécifie le nom du magasin de certificats. La valeur par défaut est `My`.
`/certlocation <location>`	Spécifie l’emplacement du certificat, par exemple `CurrentUser` ou `LocalMachine`. La valeur par défaut est `CurrentUser`.
`/certpassword <password>`	Spécifie le mot de passe d’un fichier de certificat protégé par mot de passe.
`/resourceid <resourceId>`	Spécifie l’ID de ressource Azure pour `ManagedIdentityFederated`.

Options de validation et de symboles

Option	Description
`/skipvalidation`	Ignore Submission Validator.
`/validationcritical`	Traite les échecs de Submission Validator comme des échecs critiques.
`/validationlanguage <lang>`	Spécifie une langue supplémentaire pour le fichier journal de Submission Validator.
`/validationpath <path>`	Spécifie le répertoire à partir duquel charger SubmissionValidator.dll.
`/updatesubval`	Télécharge la dernière version de SubmissionValidator.dll avant la validation. Consultez pack pour le comportement en cas d’échec.
`/symbolpaths <symbolpaths>`	Spécifie des chemins supplémentaires de résolution des symboles, séparés par des points-virgules.
`/skipsymbolbundling`	Ignore le regroupement des symboles.

Méthodes d’authentification

Méthode	Description
`CacheableBrowser`	Ouvre un navigateur pour une connexion interactive et met en cache les informations d’identification. Il s’agit de la méthode par défaut.
`Browser`	Ouvre un navigateur pour une connexion interactive sans mettre en cache les informations d’identification.
`AzureCli`	Utilise les informations d’identification Azure CLI.
`AzurePipelines`	Utilise la connexion de service Azure Pipelines.
`ManagedIdentity`	Utilise une identité managée Azure. Nécessite `/clientid`.
`ManagedIdentityFederated`	Utilise une identité managée fédérée. Nécessite `/clientid` et `/resourceid`.
`ClientSecret`	Utilise un ID client et un secret. Nécessite `/clientid` et `/clientsecret`.
`ClientCertificate`	Utilise un certificat client. Nécessite `/clientid` et `/certthumbprint`.
`Environment`	Utilise les informations d’identification provenant de variables d’environnement.
`Default`	Essaie plusieurs méthodes d’authentification successivement.

genkey

Génère un objet blob de clé local entiercé (LEKB) à utiliser avec pack /lk.

makepkg genkey [options]

Option	Description
`/ekb <ekbfile>`	Spécifie le chemin du fichier LEKB généré. Utilisez l’extension `.lekb` pour le distinguer du fichier `.ekb` généré par `makepkg pack`.

Fournissez le fichier LEKB à makepkg pack /lk pour utiliser une clé de chiffrement stable lors de la création du package. Cette clé :

Permet à packageutil compare de générer des estimations précises de la taille des mises à jour.
Permet des chargements delta sécurisés vers Partner Center à l’aide du même algorithme que celui utilisé par les consoles et les PC pour télécharger les mises à jour de contenu.
Produit des packages qui peuvent être installés sur des kits de développement.
Utilise des éléments de clé de chiffrement sécurisés qui ne peuvent être déchiffrés que dans des environnements spécifiques.

Le fichier LEKB contient des éléments de clé de chiffrement légèrement obscurcis. Toute personne disposant à la fois du fichier LEKB et du package peut déchiffrer le package ; sécurisez donc l’accès à ce fichier.

genid

Effectue la conversion entre un GUID d’ID de produit et un ID Store.

makepkg genid [options]

Option	Description
`/storeid <storeId>`	Spécifie l’ID Store à convertir.
`/productid <productId>`	Spécifie le GUID d’ID de produit à convertir.

genmap

Génère un fichier XML de mappage à partir du contenu sur disque. Le fichier généré contient un seul chunk et peut être modifié pour répartir le contenu en plusieurs chunks ou pour ajouter des balises Intelligent Delivery.

makepkg genmap /f <mapfile> /d <contentdirectory>

Option	Description
`/f <mapfile>`	Spécifie le chemin du fichier de mappage généré.
`/d <contentdirectory>`	Spécifie le répertoire dont le contenu est ajouté au fichier de mappage.

validate

Exécute la validation du package sans créer de package. Utilisez cette commande pour vérifier le contenu et la configuration avant une opération pack complète.

makepkg validate [options]

La commande validate accepte les mêmes options que pack.

updatesubval

Télécharge, vérifie et installe la dernière version de SubmissionValidator.dll sans créer, valider ni charger de package.

makepkg updatesubval [/validationpath <path>]

Options

Option	Description
`/validationpath <path>`	Spécifie le répertoire qui contient ou doit recevoir SubmissionValidator.dll. S’il est omis, la commande vérifie le répertoire de l’outil `makepkg`, puis le répertoire `%GameDK%\bin`.

Remarques

Si SubmissionValidator.dll est déjà à la dernière version, la commande signale qu’il est à jour et se termine correctement sans le télécharger. Si le fichier est manquant, la commande l’installe. En cas de réussite, la commande affiche la version de SubmissionValidator.dll présente sur le disque. Contrairement à l’option /updatesubval utilisée lors de la création du package ou de la validation, la commande autonome updatesubval renvoie un code de sortie différent de zéro si la mise à jour échoue. Lorsqu’elle est utilisée comme option, un échec de mise à jour n’est pas fatal et l’opération de création du package ou de validation se poursuit avec la version installée de SubmissionValidator.dll.

localize

Génère un fichier Resources.pri à partir du contenu sur disque.

makepkg localize /d <sourcedir> [options]

Option	Description
`/d <sourcedir>`	(Obligatoire) Spécifie le répertoire source qui contient le contenu à localiser.
`/resw <reswdir>`	Spécifie un répertoire, relatif au répertoire racine, qui contient les fichiers RESW.
`/pd <outputdir>`	Spécifie le répertoire de sortie de Resources.pri. S’il est omis, le fichier est placé dans le répertoire de contenu.
`/t <tempdir>`	Spécifie un répertoire temporaire pour la conversion de Resources.pri en XML.
`/gc <gameconfigpath>`	Spécifie le chemin de MicrosoftGame.config lorsque le fichier ne se trouve pas à la base du répertoire de contenu ou qu’il porte un autre nom.

Pour plus d’informations, consultez Localisation de MicrosoftGame.config.

Rubriques connexes

Vue d’ensemble de la création de packages MSIXVC2 Prise en main de MSIXVC2 pour PC Schéma de package de déploiement XBOX Game Package Manager Automatisation du chargement des packages

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Options globales

Commandes

pack

Options

Remarques

upload

Options de source du package

Options de destination

Options d’authentification

Options de validation et de symboles

Méthodes d’authentification

genkey

genid

genmap

validate

updatesubval

Options

Remarques

localize

Rubriques connexes

​Options globales

​Commandes

​pack

​Options

​Remarques

​upload

​Options de source du package

​Options de destination

​Options d’authentification

​Options de validation et de symboles

​Méthodes d’authentification

​genkey

​genid

​genmap

​validate

​updatesubval

​Options

​Remarques

​localize

​Rubriques connexes

Options globales

Commandes

pack

Options

Remarques

upload

Options de source du package

Options de destination

Options d’authentification

Options de validation et de symboles

Méthodes d’authentification

genkey

genid

genmap

validate

updatesubval

Options

Remarques

localize

Rubriques connexes