Gestion des packages (wdapp.exe) - XBOX Game Development Documentation

Utilisez cet outil pour inscrire de nouveaux emplacements, modifier les états de gestion de la durée de vie des processus (PLM), supprimer des packages et manipuler leurs paramètres sur les appareils de la plateforme Windows universelle (UWP).

Commande	Description
registernetworkshare	Inscrit une application située dans un dossier partagé sur le réseau
verifynetworkshare	Vérifie l’accès en lecture à un partage réseau
registerscratch	Inscrit un package à partir du lecteur temporaire
registertitlescratch	Inscrit un package à partir du lecteur temporaire du titre
launch	Lance une application
query	Interroge l’état d’exécution d’un package ou d’une application installés
terminate	Arrête toutes les applications d’un package spécifié
suspend	Simule la suspension d’une application
register	Inscrit une application
unregister	Désinscrit une application
registerdrive	Inscrit toutes les applications d’un lecteur
list	Répertorie les applications
move	Déplace une application
copy	Copie une application
movedrive	Déplace toutes les applications d’un lecteur
copydrive	Copie toutes les applications d’un lecteur
install	Installe une build empaquetée
uninstall	Désinstalle une application
applyconfig	Lance un Game OS avec les paramètres spécifiés
queryconfig	Affiche le numéro de version en quatre parties du Game OS en cours d’exécution
collectxip	Collecte la trace XIP
queryversioninfo	Interroge la version du Game OS d’un package spécifié
overlayfolder	Gère les opérations sur les dossiers de superposition

wdapp registernetworkshare

Inscrit une application située dans un dossier partagé sur le réseau. wdapp registernetworkshare <Network Path> [Username] [Password]

Option	Description
`Network Path`	Chemin du partage réseau.
`Username`	Nom d’utilisateur permettant d’accéder au partage réseau.
`Password`	Mot de passe permettant d’accéder au partage réseau.
`Verify`	Vérifie que les fichiers de l’emplacement réseau à ouvrir peuvent tous être lus.

wdapp verifynetworkshare

Vérifie l’accès en lecture à un dossier partagé sur le réseau. wdapp verifynetworkshare <Network Path>

Option	Description
`Network Path`	Chemin du partage réseau.

wdapp registerscratch

Inscrit une application située sur le lecteur temporaire. wdapp registerscratch <Relative folder path>

Option	Description
`Relative folder path`	Chemin relatif de l’application.

wdapp registertitlescratch

Inscrit une application située sur le lecteur temporaire du titre. wdapp registertitlescratch <Relative folder path>

Option	Description
`Relative folder path`	Chemin relatif de l’application.

wdapp launch

Lance l’application indiquée. Si le chemin d’un exécutable est fourni, l’application est inscrite si nécessaire avant le lancement. wdapp launch [/WaitToExit [:timeoutInSeconds]] <AppUserModelId/AUMID | exe | uri | unregv2>

Option	Description
`AUMID`	Application User Model ID (AUMID) de l’application à lancer.
`exe`	Exécutable du titre.
`uri`	URI d’un protocole personnalisé inscrit ou du protocole basé sur le titre, qui spécifie le titre à lancer et les arguments à lui transmettre. Par exemple, si l’ID de votre titre est 12345abcd, votre produit peut être lancé à l’aide du protocole basé sur le titre avec l’URI ms-xbl-12345abcd://default.
`unregv2:\{InstanceId}\{PackageAlias}\{AUMID}`	unregv2 permet de lancer un package non inscrit installé côte à côte avec d’autres packages partageant un ContentID. Utilisez wdapp list /d /u pour obtenir les valeurs instanceID et PackageAlias
WaitToExit [:timeoutInSeconds]	Lance l’application et bloque jusqu’à la fermeture du titre. Lorsque le titre se ferme, xbapp se ferme à son tour en renvoyant le code de sortie du titre. L’argument facultatif timeoutInSeconds peut être utilisé pour forcer la fermeture. Si le délai d’expiration est atteint avant la fermeture du titre, “The user specified /WaitToExit timeout was exceeded before the game exited.” est retourné.

wdapp query

Interroge l’état d’exécution d’un package ou d’une application installés. wdapp query <pfn>

Option	Description
`pfn`	Nom complet du package.

wdapp terminate

Arrête toutes les applications d’un package spécifié. wdapp terminate wdapp terminate <pfn>

Option	Description
`pfn`	(Facultatif) Nom complet du package.

wdapp suspend

Simule la suspension de toutes les applications d’un package spécifié. wdapp suspend wdapp suspend <pfn>

Option	Description
`pfn`	(Facultatif) Nom complet du package.

wdapp register

Inscrit l’application spécifiée située sur le lecteur spécifié. wdapp register <pfn> <drive>

Option	Description
`pfn`	Nom complet du package.
`drive`	Lecteur sur lequel inscrire le package.
`PackageAlias`	Alias du package que vous installez. Nécessaire lorsque vous installez plusieurs packages ayant le même ContentID.

wdapp unregister

Désinscrit l’application spécifiée. wdapp unregister <pfn>

Option	Description
`pfn`	Nom complet du package.

wdapp registerdrive

Inscrit toutes les applications actuellement non inscrites du lecteur spécifié. wdapp registerdrive <drive>

Option	Description
`drive`	Lecteur sur lequel inscrire les packages.

wdapp list

Répertorie toutes les applications ou spécifie divers indicateurs pour contrôler les applications énumérées. wdapp list [/unregistered] [/system] [/detail] [/drive=<drive>] [/JSON]

Option	Description
`unregistered`	Énumère les applications non inscrites.
`system`	Énumère les applications système.
`detail`
`drive`	Lecteur dont les applications doivent être énumérées.
`JSON`	Affiche uniquement l’objet JSON contenant les informations sur les packages

wdapp move

Déplace une application vers un autre lecteur. wdapp move <pfn> <destination drive> [new folder name]

Option	Description
`pfn`	Nom complet du package.
`destination drive`	Lecteur vers lequel déplacer l’application.
`new folder name`	Dossier vers lequel déplacer l’application.

wdapp copy

Copie une application vers un autre lecteur. wdapp copy <pfn> <destination drive> [new folder name]

Option	Description
`pfn`	Nom complet du package.
`destination drive`	Lecteur vers lequel copier l’application.
`new folder name`	Dossier vers lequel copier l’application.

wdapp movedrive

Déplace toutes les applications d’un lecteur vers un autre lecteur. wdapp movedrive <source drive> <destination drive>

Option	Description
`source drive`	Lecteur à partir duquel déplacer les applications.
`destination drive`	Lecteur vers lequel déplacer les applications.

wdapp copydrive

Copie toutes les applications d’un lecteur vers un autre lecteur. wdapp copydrive <source drive> <destination drive>

Option	Description
`source drive`	Lecteur à partir duquel copier les applications.
`destination drive`	Lecteur vers lequel copier les applications.

wdapp install

Diffuse une build empaquetée vers la console à partir d’un serveur Web, d’un partage réseau ou d’un chemin de fichier du système local.

wdapp install <package filepath> [/oddsim] [/drive=<drive>] [/<languages|devices|contenttypes|tags>=<semi-colon delimited specifier list>] [/PackageAlias:<alias>]

Option	Description
`package filepath`
`oddsim`
`drive`
`tags`
`PackageAlias`	Utilisez PackageAlias pour permettre l’installation côte à côte de packages ayant le même ContentID. L’alias correspond à l’emplacement physique du package. Cette valeur d’alias doit être globalement unique pour cette seule instance de ce package.

wdapp uninstall

Désinstalle l’application spécifiée. Utilisez les valeurs facultatives PackageAlias et InstanceID (utilisez wdapp list /d) pour désinstaller un package installé qui n’est pas actuellement inscrit. wdapp uninstall <pfn>

Option	Description
`pfn`	Nom complet du package de l’application. Par défaut, c’est le titre actuellement inscrit qui est désinstallé

wdapp applyconfig

Lance un Game OS spécifié, lance le Game OS spécifié par un fichier game.config, ou lance le dernier Game OS utilisé avec les paramètres par défaut. wdapp applyconfig [game.config | gameos.xvd]

Option	Description
`game.config`	Fichier game.config utilisé pour spécifier le Game OS à lancer.
`gameos.xvd`	Game OS à lancer.

wdapp installkey

Installe l’EKB de console (CEKB) spécifiée sur la console à partir d’un partage réseau ou d’un chemin de fichier du système local. wdapp installkey [ekb filepath]

Option	Description
`ekb filepath`	Fichier EKB généré lors de l’exécution de makepkg.exe sur le titre.

wdapp queryconfig

Affiche le numéro de version en quatre parties du Game OS en cours d’exécution. Si aucun Game OS n’est en cours d’exécution, une erreur est retournée. wdapp queryconfig

wdapp collectxip

Si une ERA XBOX One est en cours d’exécution, collecte la trace XIP et rend la trace actuelle disponible sur le partage des fichiers de développement sous le nom <output name> ou <guid>.pfm. wdapp collectxip ["Output file name"]

Option	Description
`output name`	Nom de sortie de la trace XIP.

wdapp queryversioninfo

Interroge la version du Game OS associé au package spécifié. Tente aussi de vérifier si le système d’exploitation correspond aux informations inscrites dans l’exécutable du jeu. Spécifiez /b pour afficher uniquement la version du Game OS sans autre sortie. Vous ne pouvez interroger qu’un package inscrit; si plusieurs packages ayant le même ContentID sont installés, vous devez inscrire le package avant d’interroger ses informations de version. wdapp queryversioninfo <pfn> [/b]

Option	Description
`pfn`	Nom complet du package à interroger.
`/b`	Affiche uniquement la version du Game OS sans autre sortie.

wdapp overlayfolder

Définit ou efface un dossier de superposition pour un nom complet de package spécifié, ou utilisez /R pour effacer tous les dossiers de superposition. wdapp overlayfolder [/R | <pfn> [/r | <overlay folder path>]]

Option	Description
`/R`	Efface tous les dossiers de superposition.
`pfn`	Nom complet du package dont le dossier de superposition doit être défini ou effacé.
`/r`	Efface le dossier de superposition spécifié.
`path`	Chemin du dossier de superposition à définir.

xbapp lastgamedetails

Récupère certains détails sur le dernier jeu exécuté, notamment son nom, la version du système d’exploitation et le code de sortie

Colonne 1
xbapp lastgamedetails [/X[:]address[+`<accesskey>`]]

Option	Description
`/X[:]*address[<accesskey>]`	- Utilisez cette option pour spécifier le nom d’hôte ou l’adresse (affichée en tant que Tools IP sur la console) d’une console cible sans modifier la console par défaut. Pour plus de renseignements sur la définition d’un nom d’hôte pour une console, consultez Définir un nom d’hôte pour l’adresse IP de la console. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - Définissez la clé d’accès à l’aide de la commande xbconfig accesskey=your-key, puis redémarrez votre console pour que la clé d’accès prenne effet. - Pour accéder à une console configurée avec une clé d’accès, ajoutez un signe plus (+) suivi de la clé d’accès après l’adresse IP ou le nom d’hôte de la console. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus de renseignements sur les clés d’accès, consultez Configuration (xbconfig.exe).

Voir aussi

Outils en ligne de commande de la console Erreurs de transport XTF

​wdapp registernetworkshare

​wdapp verifynetworkshare

​wdapp registerscratch

​wdapp registertitlescratch

​wdapp launch

​wdapp query

​wdapp terminate

​wdapp suspend

​wdapp register

​wdapp unregister

​wdapp registerdrive

​wdapp list

​wdapp move

​wdapp copy

​wdapp movedrive

​wdapp copydrive

​wdapp install

​wdapp uninstall

​wdapp applyconfig

​wdapp installkey

​wdapp queryconfig

​wdapp collectxip

​wdapp queryversioninfo

​wdapp overlayfolder

​xbapp lastgamedetails

​Voir aussi