> ## 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.

# Comando create

> Comando create

El comando `create` se usa para crear el contenido de origen de un lote de adaptación táctil (o lote desempaquetado, para abreviar), o para agregar nuevos diseños a un lote desempaquetado existente.
Es un punto de entrada rápido para comenzar a agregar adaptación táctil a un juego.

En la tabla siguiente se muestran los distintos subcomandos que están disponibles para su uso con el comando `create`. Tenga en cuenta que el comando `create` no se puede usar por sí solo y se debe proporcionar un subcomando.

| Subcomandos                | Descripción                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------- |
| [`bundle`](#create-bundle) | Crea un nuevo lote de adaptación táctil desempaquetado para el desarrollo                             |
| [`layout`](#create-layout) | Crea un nuevo diseño basado en una plantilla en un lote de adaptación táctil desempaquetado existente |

<a id="create-bundle" />

## Create bundle

El subcomando `create bundle` proporciona una creación rápida de todo el contenido de origen necesario para un nuevo lote de adaptación táctil. Es un punto de partida para la adaptación táctil si no existe un lote desempaquetado para un juego.

Crea todos los directorios y archivos necesarios para comenzar con un nuevo lote. Esto incluye el directorio raíz de [diseños](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#layouts), que contiene los archivos de diseño JSON para distintos idiomas; el directorio raíz de [recursos](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#assets), que contiene los recursos para varios valores de PPP por idioma; el archivo de [configuración](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#configuration) raíz del lote (`takxconfig.json`), que describe el lote, y un archivo de [contexto](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-bundle#context) vacío para el estado de diseño dinámico y las definiciones de diseño reutilizables.

<a id="create-bundle-options" />

### Opciones

Use las opciones de la tabla siguiente para configurar la creación de un lote de adaptación táctil desempaquetado.

| Opciones                                                         | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--destination`<br />`--name`                                    | OBLIGATORIO. Ruta de acceso de destino donde colocar el lote desempaquetado. Puede ser un nombre simple o una ruta de acceso completa.<br /> \[!NOTE] Si existen archivos o directorios en el destino, se debe usar primero la opción `--overwrite-destination` para eliminarlos.<br /> \[!NOTE] Si se usa un nombre simple en lugar de una ruta de acceso, el directorio de trabajo actual contendrá el lote creado.                                                                       |
| `--layouts-directory-name`<br />`--layouts-dir`<br />`--layouts` | Nombre del subdirectorio donde se almacenarán los diseños de controles táctiles. Este es el directorio raíz de diseños.<br />Valor predeterminado: `layouts`.                                                                                                                                                                                                                                                                                                                               |
| `--assets-directory-name`<br />`--assets-dir`<br />`--assets`    | Nombre del subdirectorio donde se almacenarán los recursos de controles táctiles. Este es el directorio raíz de recursos.<br />Valor predeterminado: `assets`.                                                                                                                                                                                                                                                                                                                              |
| `--layout-languages`                                             | Lista de etiquetas de idioma IETF que se usarán para la creación de directorios de idioma bajo el directorio raíz de diseños. `neutral` siempre se creará.<br />Valor predeterminado: lista vacía.                                                                                                                                                                                                                                                                                          |
| `--asset-languages`                                              | Lista de etiquetas de idioma IETF que se usarán para la creación de directorios de idioma bajo el directorio raíz de recursos. `neutral` siempre se creará.<br />Valor predeterminado: lista vacía.                                                                                                                                                                                                                                                                                         |
| `--version`                                                      | Versión del contenido del lote.<br />Valor predeterminado: `1.0.0.0`.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `--version-name`                                                 | Nombre de la versión del contenido del lote.<br />Valor predeterminado: cadena vacía.                                                                                                                                                                                                                                                                                                                                                                                                       |
| `--context-file-name`<br />`--context-file`<br />`--context`     | Nombre del archivo de contexto del lote.<br />Valor predeterminado: `context.json`.                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--templates`                                                    | Lista de una o varias plantillas de diseño que se agregarán al lote en el momento de la creación. Las plantillas se agregan siempre al directorio de idioma de diseños `neutral`, así como a los directorios de idioma correspondientes a los idiomas especificados en `--layout-languages`.<br />[Vea la lista de plantillas disponibles.](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)<br />Valor predeterminado: `Blank`. |
| `--no-templates`                                                 | No agrega ninguna plantilla al lote. No se puede usar si se especifica `--templates`.<br />Valor predeterminado: `false`.                                                                                                                                                                                                                                                                                                                                                                   |
| `--overwrite-destination`<br />`--overwrite`                     | Elimina cualquier contenido anterior del destino. Es OBLIGATORIO si el destino no está vacío.<br />Valor predeterminado: `false`.                                                                                                                                                                                                                                                                                                                                                           |

<a id="create-bundle-examples" />

### Ejemplos

Los siguientes ejemplos muestran cómo crear un nuevo lote de adaptación táctil desempaquetado.

***

Crear un nuevo lote desempaquetado sencillo con la plantilla en blanco predeterminada

```
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'.
```

Salida:

```
D:.
└───CreateBundleExamples
    └───SampleBundle
        │   context.json
        │   takxconfig.json
        │
        ├───assets
        │   └───neutral
        │       ├───@1.0x
        │       ├───@1.5x
        │       ├───@2.0x
        │       ├───@3.0x
        │       └───@4.0x
        └───layouts
            └───neutral
                    blank.json
```

***

Crear un nuevo lote en otra unidad, con algunos idiomas de diseño, plantillas y nombres de directorio personalizados

```
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'.
```

Salida:

```
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
```

<Note>En el comando, especificar tanto 'fr' como 'fr-FR' con la opción --layout-languages hace que las plantillas se agreguen a cada directorio correspondiente. Sin embargo, como solo se especifica 'en-US', las plantillas se agregan exclusivamente al directorio 'en-US' y no al directorio primario 'en'. Las plantillas se agregan de forma sistemática al directorio neutral independientemente de estas especificaciones.</Note>

El archivo de configuración del lote (`takxconfig.json`) generado reflejará una configuración que representa los parámetros pasados al comando `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"
}
```

***

<a id="create-layout" />

## Create layout

El subcomando `create layout` permite agregar un nuevo diseño a un lote desempaquetado existente. La salida generada por [`create bundle`](#create-bundle) se puede usar como entrada para `create layout` proporcionando el archivo `takxconfig.json` creado en la raíz del lote desempaquetado como valor de la opción `--takx-config-file`.

De forma similar a [`create bundle`](#create-bundle), se puede usar una plantilla para la creación del diseño en este comando, o de forma predeterminada `Blank`. También se admite agregar diseños a varios directorios de idioma de diseños, y se aplican las mismas reglas relativas a que el archivo no exista o a que se requiera `--overwrite`.

<a id="create-layout-options" />

### Opciones

Use las opciones de la tabla siguiente para configurar la creación de un diseño en un lote de adaptación táctil desempaquetado.

| Opción                                   | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--takx-config-file`<br />`--takxconfig` | OBLIGATORIO. Ruta de acceso al archivo de configuración del lote. Debe llamarse `takxconfig.json`.                                                                                                                                                                                                                                                                                                                                                                                     |
| `--name`                                 | Nombre del diseño. También será su nombre de archivo.<br />Se recomienda asignar a los diseños el nombre que mejor se adapte al juego.<br />Valor predeterminado: nombre de la plantilla usada (por ejemplo, `shooter-basic.json`).                                                                                                                                                                                                                                                    |
| `--languages`                            | Lista de etiquetas de idioma IETF para las que se debe agregar el diseño. El diseño siempre se agregará al directorio de idioma de diseños `neutral`, independientemente del valor que se pase aquí. Si se especifica aquí una etiqueta de idioma y no se encuentra ningún directorio coincidente para ella bajo el directorio raíz de diseños, se crearán los directorios correspondientes.<br />Valor predeterminado: lista vacía.                                                   |
| `--all-languages`<br />`--all`           | Crea el diseño en todos los subdirectorios de idioma que se encuentren bajo el directorio raíz de diseños especificado en el archivo de configuración del lote (`takxconfig.json`).<br />No se puede establecer en `true` cuando se especifica `--languages`.<br />Valor predeterminado: `false`                                                                                                                                                                                       |
| `--template`                             | Plantilla que se usará para el diseño.<br />[Vea la lista de plantillas disponibles.](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates)<br />Valor predeterminado: `Blank`                                                                                                                                                                                                                                                   |
| `--overwrite`                            | Sobrescribe cualquier archivo de diseño existente con el mismo nombre.<br />Es OBLIGATORIO si algún subdirectorio de idioma bajo el directorio raíz de diseños contiene archivos JSON con el mismo nombre. Por ejemplo, si `--name` es `test`, `--languages` se establece en `en-US` y el directorio `en-US` no contiene un archivo llamado `test.json` mientras que `neutral` sí, el comando no se ejecutará sin que se especifique `--overwrite`.<br />Valor predeterminado: `false` |
| `--set-default`<br />`--default`         | Establece el diseño creado como diseño predeterminado en el archivo de configuración del lote (`takxconfig.json`).<br />Valor predeterminado: `false`                                                                                                                                                                                                                                                                                                                                  |

<a id="create-layout-examples" />

### Ejemplos

Los siguientes ejemplos muestran cómo crear un nuevo diseño en un lote de adaptación táctil desempaquetado existente.

***

Crear un nuevo diseño sencillo con la plantilla `Blank` predeterminada.

```
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.
```

Salida:

```
D:.
└───CreateLayoutExample
    └───SampleBundle
        │   context.json
        │   takxconfig.json
        │
        └───layouts
            └───neutral
                    sample-layout.json
```

***

Crear un nuevo diseño con una plantilla específica para varios idiomas del lote.

```
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.
```

Salida:

```
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
```

<Note>El diseño se estableció en el directorio 'en' pero no en el directorio 'ja', ya que el primero fue el único especificado para el parámetro '--languages'.</Note>

***

Crear un nuevo diseño para todos los idiomas

```
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.
```

Salida:

```
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
```

***

## Consulte también

[Herramienta de línea de comandos del kit de adaptación táctil (tak.exe)](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line)


## Related topics

- [Referencia de la herramienta de línea de comandos del Touch Adaptation Kit (TAK)](/es/build/core-features/common/game-streaming/tak-command-line-tool/index.md)
- [Compilación de diseños de controles táctiles](/es/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-building-touch-layout.md)
- [Introducción a los diseños del paquete táctil](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-getting-started-with-sample-layouts.md)
- [Diseño de controles táctiles de lucha](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-fighter.md)
- [Diseño de controles táctiles de shooter en primera persona](/es/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-tak-sample-first-person.md)
