xbox upgrade vous indique si
une version plus récente est disponible. Une entrée marquée Corrigé est corrigée dans la dernière version, et elle est
retirée dans la suivante.
Si votre problème ne figure pas dans la liste
- Vérifiez que vous exécutez la dernière version avec
xbox upgrade. - Effectuez une recherche dans les problèmes existants.
- S’il n’a pas été signalé, signalez-le avec
xbox feedback, qui ouvre un rapport de bogue où les détails de votre environnement sont déjà remplis. Les problèmes sont publics; omettez donc tout ce que vous ne partageriez pas publiquement.
Mise à jour de la CLI
xbox upgrade échoue avec l’erreur HTTP 301
Corrigé
Le dépôt public de la CLI a été déplacé, et xbox upgrade dans la version v0.2.1 échoue
systématiquement avec HTTP 301: GitHub release metadata is unavailable.
Solution de contournement : téléchargez la dernière version en suivant Installation.
Connexion et autorisations
Certaines commandes ne fonctionnent pas encore avec un compte Microsoft personnel
Lorsque vous vous connectez avec un compte Microsoft personnel plutôt qu’avec un compte professionnel ou scolaire, les commandes relatives à la configuration des XBOX services, aux comptes de test, aux packages, aux tests de jeu et aux publics ne fonctionnent pas. Les commandes de configuration des XBOX services et de comptes de test échouent avec l’erreur HTTP 502, signalée comme une indisponibilité du service, mais réessayer ne règle pas le problème. Solution de contournement : joignez votre vendeur dans Partner Center avec un compte professionnel ou scolaire, et connectez-vous à la CLI avec ce compte.xbox game, xbox xbl et les commandes semblables n’acceptent pas encore les principaux de service
Un principal de service peut se connecter, mais les commandes audience, game, package, playtest, sandbox,
seller, test-account et xbl échouent avec une erreur d’autorisation lorsqu’il les exécute,
car le service qu’elles appellent n’accepte pas encore les principaux de service.
Solution de contournement : exécutez ces commandes en tant qu’utilisateur connecté. Les commandes xbox playfab fonctionnent avec un
principal de service une fois qu’une personne lui a accordé l’accès avec
xbox playfab service-principal set. Consultez
Authentification pour l’automatisation (principal de service).
Des commandes sont refusées pour certains vendeurs lorsque vous appartenez à plusieurs vendeurs
Si vous appartenez à plusieurs vendeurs Partner Center, les commandes relatives à la configuration des XBOX services, aux comptes de test, aux packages, aux tests de jeu et aux publics peuvent être refusées pour tous les vendeurs, sauf celui que vous avez sélectionné en dernier dans Partner Center. Solution de contournement : sélectionnez le vendeur voulu dans Partner Center, puis exécutez de nouveau la commande.xbox seller list omet parfois l’un de vos vendeurs
Si vous appartenez à plusieurs vendeurs Partner Center, xbox seller list
omet parfois l’un d’eux sans erreur, et l’exécution suivante peut le répertorier. Tant qu’il est
absent, les commandes pour ce vendeur, comme xbox audience list, peuvent
être refusées, et on ne sait pas si le sélectionner dans Partner Center aide.
Les commandes xbox game ignorent --seller-id
xbox game list, xbox game get et xbox game create utilisent le vendeur que vous avez
sélectionné en dernier dans Partner Center, et non celui que vous passez avec --seller-id ou que vous enregistrez dans le
contexte; game create peut donc créer le jeu chez un autre vendeur. Un
ID de vendeur qui n’est pas le vôtre, par exemple un ID mal saisi, ne les fait pas échouer; elles renvoient vos
propres jeux.
Solution de contournement : sélectionnez le vendeur voulu dans Partner Center, puis vérifiez que xbox game list
affiche ses jeux avant d’en créer un. Le changement peut prendre jusqu’à 15 minutes pour être pris en compte par la CLI.
Les commandes xbox sandbox affichent uniquement les sandboxes globaux
Lorsque le vendeur que vous passez avec --seller-id ou que vous enregistrez dans le contexte n’est pas
celui que vous avez sélectionné en dernier dans Partner Center,
xbox sandbox list et xbox sandbox get trouvent uniquement les sandboxes CERT,
CERT.DEBUG et RETAIL, sans échouer. xbox sandbox create crée le
sandbox chez le vendeur que vous avez sélectionné en dernier, et s’il s’agit d’un autre vendeur, la commande se termine avec le code 4, car elle
ne peut pas relire le sandbox. Ne le créez pas de nouveau.
Solution de contournement : sélectionnez le vendeur voulu dans Partner Center, puis exécutez de nouveau la commande avec
ce vendeur. Le changement peut prendre jusqu’à 15 minutes pour être pris en compte par la CLI.
Tests avec les tests de jeu et les publics
xbox audience list peut expirer
xbox audience list peut prendre suffisamment de temps pour que la requête
expire. --name n’aide pas, car cette option filtre la liste après la lecture de tous les publics.
Configuration des XBOX services
Certains documents XML téléchargés déclarent le mauvais encodage
Certains documents XML publiés qu’enregistrexbox xbl config download --view published, comme
mpsdtitleinfo.xml et titlename-localization.xml, déclarent encoding="utf-16", mais sont
encodés en UTF-8; un lecteur XML qui se fie à la déclaration ne parvient donc pas à les charger.
Solution de contournement : décodez le fichier en UTF-8 avant de l’analyser.
PlayFab
xbox playfab api /Admin/UpdatePolicy peut remplacer la stratégie sans confirmation
Avec "OverwritePolicy": true dans le corps de la requête, cet appel remplace l’ensemble de la stratégie d’accès aux API
du titre sans les mesures de protection de xbox playfab api-policy set --overwrite : il ne
nécessite pas --confirm, et il peut utiliser le titre du contexte enregistré ou de XBOX_PLAYFAB_TITLE_ID.
Une stratégie erronée peut bloquer l’accès au titre pour tous les joueurs.
Solution de contournement : utilisez plutôt xbox playfab api-policy set --overwrite,
qui nécessite --confirm et le titre passé avec --playfab-title-id.
playfab title-data delete et playfab player-data delete ne demandent pas de confirmation
Les autres commandes qui suppriment quelque chose demandent une confirmation avant de s’exécuter, ou refusent de s’exécuter sans --confirm. Ces
deux commandes suppriment immédiatement les clés que vous nommez.
--keys et --member-ids acceptent des listes séparées par des virgules
--keys pour xbox playfab title-data et xbox playfab player-data, et --member-ids pour
xbox playfab group member, acceptent des listes séparées par des virgules. Ces options
deviendront des options répétées; les scripts qui les utilisent devront donc être mis à jour.
D’ici là, --keys ne peut pas nommer une clé qui contient une virgule. Pour lire une telle clé, passez-la avec
--key, qui accepte le nom en entier, mais delete n’a que --keys.
Solution de contournement : pour supprimer la clé, appelez l’API qu’utilise delete avec
xbox playfab api. Pour les données de titre, définissez la valeur de la clé sur null,
avec plutôt /Admin/SetTitleInternalData pour les données de titre internes :
KeysToRemove, en utilisant l’API de mise à jour correspondant à la
visibilité des données dans Données de joueur :
Scripts et agents
La plupart des commandes se terminent avec le code 1 lorsqu’on ignore si une modification a été effectuée
Quelques commandes se terminent avec le code3 lorsqu’elles ne peuvent pas déterminer si une modification a été effectuée, par exemple lorsque la
requête expire après son envoi, et leurs pages l’indiquent. Toutes les autres commandes, y compris
toutes les commandes PlayFab, se terminent avec le code 1 pour tout échec; un script ne peut donc pas distinguer ce cas d’une
modification qui n’a pas été effectuée.
Solution de contournement : lorsqu’une commande qui modifie quelque chose échoue, vérifiez l’état actuel avant
de l’exécuter de nouveau.