> ## 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 bundle d'adaptation tactile (ou bundle non empaqueté, pour faire court), ou d'ajouter de nouvelles dispositions à un bundle non empaqueté 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 disponibles avec la commande `create`. Notez que la commande `create` ne peut pas être utilisée seule : une sous-commande doit être fournie. | Sous-commandes | Description | | - | - | | [`bundle`](#create-bundle) | Crée un nouveau bundle d'adaptation tactile non empaqueté pour le développement | | [`layout`](#create-layout) | Crée une nouvelle disposition à partir d'un modèle dans un bundle d'adaptation tactile non empaqueté existant | ## Create Bundle La sous-commande `create bundle` permet de créer rapidement tout le contenu source requis pour un nouveau bundle d'adaptation tactile. Elle constitue un point de départ pour l'adaptation tactile s'il n'existe pas encore de bundle non empaqueté pour un jeu. Elle crée tous les répertoires et fichiers nécessaires pour démarrer avec un nouveau bundle. Cela comprend le répertoire racine [layouts](/fr/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#layouts), qui contient les fichiers de disposition JSON pour les différentes langues, le répertoire racine [assets](/fr/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#assets), qui contient les ressources pour différentes résolutions (DPI) par langue, le fichier de [configuration](/fr/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#configuration) racine du bundle (`takxconfig.json`) qui décrit le bundle, ainsi qu'un fichier de [contexte](/fr/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 disposition réutilisables. ### Options Utilisez les options du tableau suivant pour configurer la création d'un bundle d'adaptation tactile non empaqueté. | Options | Description | | - | - | | `--destination`
`--name` | OBLIGATOIRE. Chemin de destination où placer le bundle non empaqueté. 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 au préalable.
\[!NOTE] Si un simple nom est utilisé au lieu d'un chemin, le bundle est créé dans le répertoire de travail actuel. | | `--layouts-directory-name`
`--layouts-dir`
`--layouts` | Nom du sous-répertoire dans lequel stocker les dispositions des 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 dans lequel stocker les ressources des contrôles tactiles. Il s'agit du répertoire racine des ressources.
Valeur par défaut : `assets`. | | `--layout-languages` | Liste de 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 de 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 du bundle.
Valeur par défaut : `1.0.0.0`. | | `--version-name` | Nom de la version du contenu du bundle.
Valeur par défaut : chaîne vide. | | `--context-file-name`
`--context-file`
`--context` | Nom du fichier de contexte du bundle.
Valeur par défaut : `context.json`. | | `--templates` | Liste d'un ou plusieurs modèles de disposition à ajouter au bundle 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/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 au bundle. 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 nouveau bundle d'adaptation tactile non empaqueté. *** Créer un nouveau bundle non empaqueté 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'. ``` Sortie : ``` 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 nouveau bundle sur un autre lecteur, avec plusieurs 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'. ``` Sortie : ``` 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 cette 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. En revanche, 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 du bundle (`takxconfig.json`) produit reflète 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" } ``` *** ## Create Layout La sous-commande `create layout` permet d'ajouter une nouvelle disposition à un bundle non empaqueté existant. La sortie produite par [`create bundle`](#create-bundle) peut servir d'entrée à `create layout` en fournissant le fichier `takxconfig.json` créé à la racine du bundle non empaqueté 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 avec cette commande ; sinon, le modèle `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 concernant l'absence préalable du fichier ou l'obligation d'utiliser `--overwrite`. ### Options Utilisez les options du tableau suivant pour configurer la création d'une disposition dans un bundle d'adaptation tactile non empaqueté. | Option | Description | | - | - | | `--takx-config-file`
`--takxconfig` | OBLIGATOIRE. Chemin du fichier de configuration du bundle. Doit être nommé `takxconfig.json`. | | `--name` | Nom de la disposition. Il s'agit également de son nom de fichier.
Il est recommandé de nommer les dispositions de la manière la plus adaptée au jeu.
Valeur par défaut : nom du modèle utilisé (par exemple, `shooter-basic.json`). | | `--languages` | Liste de 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'existe sous le répertoire racine des dispositions, le ou les répertoires sont 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 du bundle (`takxconfig.json`).
Ne peut pas être définie sur `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/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)
Valeur par défaut : `Blank` | | `--overwrite` | Remplace tout fichier de disposition existant 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` vaut `test`, que `--languages` est défini sur `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écute 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 du bundle (`takxconfig.json`).
Valeur par défaut : `false` | ### Exemples Les exemples suivants montrent comment créer une nouvelle disposition dans un bundle d'adaptation tactile non empaqueté 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. ``` Sortie : ``` D:. └───CreateLayoutExample └───SampleBundle │ context.json │ takxconfig.json │ └───layouts └───neutral sample-layout.json ``` *** Créer une nouvelle disposition à l'aide d'un modèle spécifique pour plusieurs langues du bundle. ``` 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. ``` Sortie : ``` 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 seul le premier a été 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. ``` Sortie : ``` 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 en ligne de commande du Touch Adaptation Kit (tak.exe)](/fr/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)