Depuis le GDK de mars 2022, Run from PC prend en charge le Priority File Set pour contrôler quels fichiers sont mis en cache avec la mise en cache des données — utilisez cette fonctionnalité pour une itération Run-from-PC prévisible lorsqu’elle est combinée avec DirectStorage.
Types de déploiement
Le déploiement peut varier selon l’identité (inscrit ou non inscrit) et selon la méthode :Déploiement Push
Utilisez Push lorsque vous voulez que le déploiement se présente et se comporte exactement comme une installation de vente au détail — le paquet réside entièrement sur le disque du kit de développement.Run from PC
Diffuse les fichiers sur le réseau (XBTP) ou via un partage SMB hérité. Deux variantes :- RfPC sur XBTP (recommandé) — nécessite la configuration du pare-feu et les services XrfsSvc / XbtpLinkSvc sur le PC.
- RfPC hérité basé sur un partage SMB.
Configuration du RfPC sur XBTP
- Activez RfPC dans les paramètres de déploiement de votre projet.
- Configurez le pare-feu (voir ci-dessous).
- Ajustez au besoin les paramètres de
XrfsSvcetXbtpLinkSvcpour les grandes équipes ou les machines de build partagées.
Configuration du pare-feu
Autorisez les processus XrfsSvc et XbtpLinkSvc dans le pare-feu Windows Defender sur votre PC de développement. Les ports pour XBTP sont couverts dans Configurer l’accès au réseau de développement.Mise en cache des données (kit de développement XBOX Series X)
La mise en cache des données met en miroir les fichiers servis par RfPC afin que le comportement des E/S corresponde étroitement à un déploiement Push — utile lorsque vous itérez sur des chemins de code DirectStorage.- Activez et gérez le cache à l’aide de DevHome ou de XBOX Manager.
- Le Priority File Set (GDK de mars 2022 et versions ultérieures) vous permet de pré-mettre en cache des fichiers spécifiques, ce qui améliore la prévisibilité. Les règles sont rédigées dans un schéma Priority File Set et peuvent être appliquées à partir de la ligne de commande ou de Visual Studio. La génération automatique est prise en charge.
RfPC hérité par partage SMB
Toujours pris en charge. Nécessite des partages SMB sur le PC de développement pointant vers la disposition de votre paquet. Les liens symboliques sont pris en charge pour rediriger des portions du paquet.Streaming Install
Installe le titre par blocs pendant son exécution — exerce les chemins de code Streaming Install que votre titre utilisera dans la version de vente au détail.Outils
XBOX Manager
- Default Deploy
- Assistant Deploy/Install Application
- Déploiement par glisser-déposer
- Déploiement via le Folder Explorer
- Lancement des titres déployés
- La liste Games & Apps affiche les types de déploiement (Push, RfPC, non inscrit).
Invite de commandes (xbapp)
Déployez et lancez à partir de scripts :
Visual Studio
Déployez et lancez à partir des cibles MSBuild intégrées au GDK. Choisissez le type de déploiement dans les propriétés du projet.Autres lanceurs
- XBOX Gaming Explorer — lancez les titres déployés directement depuis Visual Studio.
- DevHome — lancez les titres à partir de l’interface de la console.
Dossiers de superposition (overlay)
Superposez des fichiers individuels par-dessus un paquet installé pour une itération rapide — sans réempaquetage ni redéploiement. Consultez Débogage avec des dossiers de superposition.Améliorer la vitesse d’itération
Déployer via la NIC de débogage
La deuxième NIC du kit de développement (10 GbE) est nettement plus rapide que le port 1 GbE pour les déploiements. Prérequis- Une NIC 10 GbE dans votre PC de développement et un commutateur 10 GbE (ou un câble direct).
- Configurez la carte 10 GbE sur le PC de développement.
- Pointez votre espace de travail vers l’adresse IP de la NIC de débogage.
Déployer avec le XTD (XBOX Transfer Device)
Le XTD décharge les transferts en masse via Thunderbolt.- Tous les kits de développement ne prennent pas en charge le XTD; vérifiez donc la liste de compatibilité dans les spécifications matérielles des consoles XBOX de vente au détail et des kits de développement.
- Configurez le XTD sur votre PC de développement et branchez le câble Thunderbolt au kit de développement.
- Effectuez le dépannage à l’aide du flux de diagnostic standard (voir ci-dessous).
- Le XTD accélère également les captures et l’analyse PIX.
- Jumelez le XTD avec la NIC de débogage pour l’itération la plus rapide possible.
Changements avec le GDK
- Prise en charge des builds empaquetées côte à côte — plusieurs builds du même titre installées en même temps.
- Les titres XBOX One (ERA) se déploient via le chemin du GDK.
- Changements d’AUMID — vérifiez vos scripts de lancement si vous avez migré depuis le XDK.
- Mises à jour du scratch unifié — comportement de
TitleScratch/SystemScratchaffiné.
Dépannage du déploiement
Commencez par :- Analyser et diagnostiquer les erreurs
- Dépannage des problèmes courants du GDK
- Problèmes de la plateforme de déploiement (erreurs XTF, échecs d’installation non inscrite, diagnostics
xbtplink)