Depuis le GDK de mars 2022, Run from PC prend en charge 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, en combinaison avec DirectStorage.
Types de déploiement
Le déploiement peut se distinguer par identité (enregistré ou non enregistré) et par méthode :Déploiement Push
Utilisez Push lorsque vous voulez que le déploiement ressemble et se comporte exactement comme une installation commerciale — le package réside intégralement sur le disque du dev kit.Run from PC
Diffuse les fichiers sur le réseau (XBTP) ou via un partage SMB hérité. Deux variantes :- RfPC via 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 via XBTP
- Activez RfPC dans les paramètres de déploiement de votre projet.
- Configurez le pare-feu (voir ci-dessous).
- Ajustez éventuellement les paramètres
XrfsSvcetXbtpLinkSvcpour les grandes équipes ou les machines de build partagées.
Configuration du pare-feu
Autorisez les processus XrfsSvc et XbtpLinkSvc à traverser le Pare-feu Windows Defender sur votre PC de développement. Les ports utilisés par XBTP sont détaillés dans Configurer l’accès au réseau de développement.Mise en cache des données (XBOX Series X Dev Kit)
La mise en cache des données réplique les fichiers servis par RfPC afin que le comportement des E/S soit très proche d’un déploiement Push — utile lorsque vous itérez sur des chemins de code DirectStorage.- Activez / gérez le cache via DevHome ou XBOX Manager.
- Priority File Set (GDK de mars 2022 et versions ultérieures) vous permet de pré-mettre en cache des fichiers spécifiques, améliorant ainsi la prévisibilité. Les règles sont rédigées selon un schéma Priority File Set et peuvent être appliquées depuis la ligne de commande ou Visual Studio. La génération automatique est prise en charge.
RfPC hérité via partage SMB
Toujours pris en charge. Nécessite des partages SMB sur le PC de développement pointant vers la disposition de votre package. Les liens symboliques sont pris en charge pour rediriger certaines parties du package.Streaming Install
Installe par blocs pendant l’exécution du titre — exerce les chemins de code Streaming Install que votre titre utilisera en version commerciale.Outils
XBOX Manager
- Default Deploy
- Assistant Deploy/Install Application
- Drag deploy
- Déploiement via l’Explorateur de dossiers
- Lancement des titres déployés
- La liste Games & Apps affiche les types de déploiement (Push, RfPC, non enregistré).
Invite de commandes (xbapp)
Déployez et lancez depuis des scripts :
Visual Studio
Déployez et lancez depuis les 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 depuis l’interface de la console.
Dossiers de superposition
Superposez des fichiers individuels par-dessus un package installé pour une itération rapide — sans repackaging ni redéploiement. Consultez Débogage avec les dossiers de superposition.Améliorer la vitesse d’itération
Déployer via le NIC de débogage
La seconde carte réseau (NIC) du dev kit (10 GbE) est nettement plus rapide que le port 1 GbE pour les déploiements. Prérequis- Une carte NIC 10 GbE dans votre PC de développement et un commutateur 10 GbE (ou un câble direct).
- Configurez l’adaptateur 10 GbE sur le PC de développement.
- Faites pointer votre espace de travail vers l’adresse IP du NIC de débogage.
Déployer avec le XTD (XBOX Transfer Device)
Le XTD décharge les transferts volumineux via Thunderbolt.- Tous les dev kits ne prennent pas en charge le XTD ; vérifiez la liste de compatibilité dans les spécifications matérielles des consoles XBOX commerciales et des dev kits.
- Configurez le XTD sur votre PC de développement et branchez le câble Thunderbolt au dev kit.
- En cas de problème, suivez le flux de diagnostic standard (voir ci-dessous).
- Le XTD accélère également les captures et l’analyse PIX.
- Associez le XTD au NIC de débogage pour l’itération la plus rapide possible.
Changements avec le GDK
- Prise en charge des builds packagées côte à côte — plusieurs builds du même titre installées simultanément.
- Les titres XBOX One (ERA) se déploient via le chemin 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é.
Résoudre les problèmes de déploiement
Commencez par :- Analyser et diagnostiquer les erreurs
- Résoudre les problèmes GDK courants
- Problèmes de la plateforme de déploiement (erreurs XTF, échecs d’installation non enregistrée, diagnostics
xbtplink)