> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Commande create > Commande create La commande `create` permet de créer le contenu source d'un ensemble d'adaptation tactile (ou ensemble décompressé, en abrégé), ou d'ajouter de nouvelles dispositions à un ensemble décompressé existant. Il s'agit d'un point d'entrée rapide pour commencer à ajouter l'adaptation tactile à un jeu. Le tableau suivant présente les différentes sous-commandes qui peuvent être utilisées avec la commande `create`. Notez que la commande `create` ne peut pas être utilisée seule et qu'une sous-commande doit être fournie. | Sous-commandes | Description | | - | - | | [`bundle`](#create-bundle) | Crée un nouvel ensemble d'adaptation tactile décompressé pour le développement | | [`layout`](#create-layout) | Crée une nouvelle disposition basée sur un modèle dans un ensemble d'adaptation tactile décompressé existant | ## Créer un ensemble La sous-commande `create bundle` permet de créer rapidement tout le contenu source requis pour un nouvel ensemble d'adaptation tactile. C'est un point de départ pour l'adaptation tactile s'il n'existe pas encore d'ensemble décompressé pour un jeu. Elle crée tous les répertoires et fichiers nécessaires pour commencer avec un nouvel ensemble. Cela comprend le répertoire racine des [dispositions](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#layouts), qui contient les fichiers de disposition JSON pour différentes langues, le répertoire racine des [ressources](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#assets), qui contient les ressources pour divers PPP par langue, le fichier de [configuration](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#configuration) racine de l'ensemble (`takxconfig.json`) qui décrit l'ensemble, ainsi qu'un fichier de [contexte](/fr-CA/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#context) vide pour l'état dynamique des dispositions et les définitions de dispositions réutilisables. ### Options Utilisez les options du tableau suivant pour configurer la création d'un ensemble d'adaptation tactile décompressé. | Options | Description | | - | - | | `--destination`
`--name` | OBLIGATOIRE. Chemin de destination où placer l'ensemble décompressé. Il peut s'agir d'un simple nom ou d'un chemin complet.
\[!NOTE] Si des fichiers ou des répertoires existent dans la destination, l'option `--overwrite-destination` doit être utilisée pour les supprimer d'abord.
\[!NOTE] Si un simple nom est utilisé au lieu d'un chemin, l'ensemble créé sera placé dans le répertoire de travail actuel. | | `--layouts-directory-name`
`--layouts-dir`
`--layouts` | Nom du sous-répertoire où stocker les dispositions de contrôles tactiles. Il s'agit du répertoire racine des dispositions.
Valeur par défaut : `layouts`. | | `--assets-directory-name`
`--assets-dir`
`--assets` | Nom du sous-répertoire où stocker les ressources des contrôles tactiles. Il s'agit du répertoire racine des ressources.
Valeur par défaut : `assets`. | | `--layout-languages` | Liste des balises de langue IETF à utiliser pour créer des répertoires de langue sous le répertoire racine des dispositions. `neutral` est toujours créé.
Valeur par défaut : liste vide. | | `--asset-languages` | Liste des balises de langue IETF à utiliser pour créer des répertoires de langue sous le répertoire racine des ressources. `neutral` est toujours créé.
Valeur par défaut : liste vide. | | `--version` | Version du contenu de l'ensemble.
Valeur par défaut : `1.0.0.0`. | | `--version-name` | Nom de la version du contenu de l'ensemble.
Valeur par défaut : chaîne vide. | | `--context-file-name`
`--context-file`
`--context` | Nom du fichier de contexte de l'ensemble.
Valeur par défaut : `context.json`. | | `--templates` | Liste d'un ou de plusieurs modèles de disposition à ajouter à l'ensemble lors de sa création. Les modèles sont toujours ajoutés au répertoire de langue de disposition `neutral`, ainsi qu'à tous les répertoires de langue correspondant aux langues spécifiées dans `--layout-languages`.
[Afficher la liste des modèles disponibles.](/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)
Valeur par défaut : `Blank`. | | `--no-templates` | N'ajoute aucun modèle à l'ensemble. Ne peut pas être utilisée si `--templates` est spécifiée.
Valeur par défaut : `false`. | | `--overwrite-destination`
`--overwrite` | Supprime tout contenu précédent dans la destination. Cette option est OBLIGATOIRE si la destination n'est pas vide.
Valeur par défaut : `false`. | ### Exemples Les exemples suivants montrent comment créer un nouvel ensemble d'adaptation tactile décompressé. *** Créer un nouvel ensemble décompressé simple avec le modèle vide par défaut ``` D:\CreateBundleExamples> tak create bundle --name SampleBundle Creating loose touch adaptation bundle 'SampleBundle'. Creating bundle config file. Creating layouts and assets directories. Creating language directories. Creating context file. Added 1 templates to bundle. Created loose touch adaptation bundle at 'D:\CreateBundleExamples\SampleBundle'. ``` Résultat : ``` D:. └───CreateBundleExamples └───SampleBundle │ context.json │ takxconfig.json │ ├───assets │ └───neutral │ ├───@1.0x │ ├───@1.5x │ ├───@2.0x │ ├───@3.0x │ └───@4.0x └───layouts └───neutral blank.json ``` *** Créer un nouvel ensemble sur un autre lecteur, avec quelques langues de disposition, des modèles et des noms de répertoires personnalisés ``` C:\> tak create bundle --destination D:\CreateBundleExamples\SomeFolder\AnotherFolder\SampleBundle --layout-languages fr fr-FR en-US --templates Menu Cinematic RacingBasic RacingAdvanced --layouts-dir touch-control-layouts --assets-dir touch-control-assets --context-file touch-control-context Creating loose touch adaptation bundle 'SampleBundle'. Creating bundle config file. Creating layouts and assets directories. Creating language directories. Creating context file. Added 4 templates to bundle. Created loose touch adaptation bundle at 'D:\CreateBundleExamples\SomeFolder\AnotherFolder\SampleBundle'. ``` Résultat : ``` D:. └───CreateBundleExamples └───SomeFolder └───AnotherFolder └───SampleBundle │ takxconfig.json │ touch-control-context.json │ ├───touch-control-assets │ └───neutral │ ├───@1.0x │ ├───@1.5x │ ├───@2.0x │ ├───@3.0x │ └───@4.0x └───touch-control-layouts ├───en │ └───en-US │ cinematic.json │ menu.json │ racing-advanced.json │ racing-basic.json │ ├───fr │ │ cinematic.json │ │ menu.json │ │ racing-advanced.json │ │ racing-basic.json │ │ │ └───fr-FR │ cinematic.json │ menu.json │ racing-advanced.json │ racing-basic.json │ └───neutral cinematic.json menu.json racing-advanced.json racing-basic.json ``` Dans la commande, le fait de spécifier à la fois 'fr' et 'fr-FR' avec l'option --layout-languages entraîne l'ajout des modèles dans chacun des répertoires correspondants. Cependant, comme seul 'en-US' est spécifié, les modèles sont ajoutés uniquement au répertoire 'en-US' et non au répertoire parent 'en'. Les modèles sont toujours ajoutés au répertoire neutral, quelles que soient ces spécifications. Le fichier de configuration de l'ensemble (`takxconfig.json`) produit reflétera une configuration correspondant aux paramètres passés à la commande `create bundle`. ```json theme={null} { "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/takxconfig/v1/takxconfig.json", "layouts": { "path": "touch-control-layouts" }, "assets": { "path": "touch-control-assets" }, "context": { "path": "touch-control-context.json" }, "version": "1.0.0.0", "versionName": "Initial" } ``` *** ## Créer une disposition La sous-commande `create layout` permet d'ajouter une nouvelle disposition à un ensemble décompressé existant. Le résultat produit par [`create bundle`](#create-bundle) peut servir d'entrée à `create layout` en fournissant le fichier `takxconfig.json` créé à la racine de l'ensemble décompressé comme valeur de l'option `--takx-config-file`. Comme pour [`create bundle`](#create-bundle), un modèle peut être utilisé pour créer la disposition dans cette commande, sinon `Blank` est utilisé par défaut. L'ajout de dispositions dans plusieurs répertoires de langue de disposition est également pris en charge, et les mêmes règles s'appliquent : le fichier ne doit pas exister, sinon `--overwrite` est requis. ### Options Utilisez les options du tableau suivant pour configurer la création d'une disposition dans un ensemble d'adaptation tactile décompressé. | Option | Description | | - | - | | `--takx-config-file`
`--takxconfig` | OBLIGATOIRE. Chemin vers le fichier de configuration de l'ensemble. Doit être nommé `takxconfig.json`. | | `--name` | Nom de la disposition. Ce sera également son nom de fichier.
Il est recommandé de nommer les dispositions de la façon qui convient le mieux au jeu.
Valeur par défaut : nom du modèle utilisé (p. ex., `shooter-basic.json`). | | `--languages` | Liste des balises de langue IETF pour lesquelles la disposition doit être ajoutée. La disposition est toujours ajoutée au répertoire de langue de disposition `neutral`, quelle que soit la valeur passée ici. Si une balise de langue est spécifiée ici alors qu'aucun répertoire correspondant n'est trouvé sous le répertoire racine des dispositions, le ou les répertoires seront créés.
Valeur par défaut : liste vide. | | `--all-languages`
`--all` | Crée la disposition dans tous les sous-répertoires de langue trouvés sous le répertoire racine des dispositions spécifié dans le fichier de configuration de l'ensemble (`takxconfig.json`).
Ne peut pas être définie à `true` lorsque `--languages` est spécifiée.
Valeur par défaut : `false` | | `--template` | Modèle à utiliser pour la disposition.
[Afficher la liste des modèles disponibles.](/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)
Valeur par défaut : `Blank` | | `--overwrite` | Remplace tous les fichiers de disposition existants portant le même nom.
Cette option est OBLIGATOIRE si des sous-répertoires de langue sous le répertoire racine des dispositions contiennent des fichiers JSON portant le même nom. Par exemple, si `--name` est `test`, que `--languages` est défini à `en-US`, et que le répertoire `en-US` ne contient pas de fichier nommé `test.json` alors que `neutral` en contient un, la commande ne s'exécutera pas sans que `--overwrite` soit spécifiée.
Valeur par défaut : `false` | | `--set-default`
`--default` | Définit la disposition créée comme disposition par défaut dans le fichier de configuration de l'ensemble (`takxconfig.json`).
Valeur par défaut : `false` | ### Exemples Les exemples suivants montrent comment créer une nouvelle disposition dans un ensemble d'adaptation tactile décompressé existant. *** Créer une nouvelle disposition simple à l'aide du modèle `Blank` par défaut. ``` D:\CreateLayoutExamples\SampleBundle> tak create layout --name sample-layout --takxconfig .\takxconfig.json Verifying bundle configuration file (takxconfig.json). Verification complete. 0 error(s), 0 warning(s) and 0 note(s) found. Created layout 'sample-layout' using template 'Blank' in 1 directories. ``` Résultat : ``` D:. └───CreateLayoutExample └───SampleBundle │ context.json │ takxconfig.json │ └───layouts └───neutral sample-layout.json ``` *** Créer une nouvelle disposition à l'aide d'un modèle précis pour plusieurs langues de l'ensemble. ``` D:\CreateLayoutExamples> tak create layout --takxconfig .\SampleBundle\takxconfig.json --template ShooterBasic --languages ja-JP en en-US Verifying bundle configuration file (takxconfig.json). Verification complete. 0 error(s), 0 warning(s) and 0 note(s) found. WARNING: A language directory for 'ja-JP' does not exist under the root layouts directory. It will be created, as well as any relevant parenting directories if applicable to the language. WARNING: A language directory for 'en' does not exist under the root layouts directory. It will be created, as well as any relevant parenting directories if applicable to the language. WARNING: A language directory for 'en-US' does not exist under the root layouts directory. It will be created, as well as any relevant parenting directories if applicable to the language. Created layout 'shooter-basic' using template 'ShooterBasic' in 4 directories. ``` Résultat : ``` D:. └───CreateLayoutExample └───SampleBundle │ context.json │ takxconfig.json │ └───layouts ├───en │ │ shooter-basic.json │ │ │ └───en-US │ shooter-basic.json │ ├───ja │ └───ja-JP │ shooter-basic.json │ └───neutral shooter-basic.json ``` La disposition a été créée dans le répertoire 'en', mais pas dans le répertoire 'ja', car le premier était le seul spécifié pour le paramètre '--languages'. *** Créer une nouvelle disposition pour toutes les langues ``` D:\CreateLayoutExamples> tak create layout --takxconfig .\SampleBundle\takxconfig.json --all-languages Verifying bundle configuration file (takxconfig.json). Verification complete. 0 error(s), 0 warning(s) and 0 note(s) found. Created layout 'blank' using template 'Blank' in 5 directories. ``` Résultat : ``` D:. └───SampleBundle │ context.json │ takxconfig.json │ └───layouts ├───en │ │ blank.json │ │ shooter-basic.json │ │ │ └───en-US │ blank.json │ shooter-basic.json │ ├───ja │ │ blank.json │ │ │ └───ja-JP │ blank.json │ shooter-basic.json │ └───neutral blank.json shooter-basic.json ``` *** ## Voir aussi [Outil de ligne de commande Touch Adaptation Kit (tak.exe)](/fr-CA/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line) ## Related topics - [Programme de services payants de certification](/fr/publishing/game-publishing/concepts/certification/certification-paid-services.md) - [Intégration des partenaires XBOX pour l'accès au GDK](/fr-CA/home/onboarding.md) - [Intégration des partenaires XBOX : accès et publication](/fr/home/onboarding.md) - [Compiler et exécuter votre premier titre console GDKX](/fr/home/build-first-title/first-console-title-walkthrough.md) - [Glossaire GDK des termes et acronymes](/fr/home/glossary.md)