Saltar al contenido principal
Este artículo proporciona los pasos que deben seguirse para configurar el TAK Editor. Se supone que ya ha instalado Visual Studio Code, descargado la CLI de TAK más reciente e instalado la extensión TAK Editor. Si aún no lo ha hecho, consulte la página de información general para obtener más información. A grandes rasgos, el proceso de configuración implica los pasos siguientes:
  1. Establecer la ruta de acceso de la CLI de TAK en la extensión.
  2. Abrir una carpeta o un área de trabajo en Visual Studio Code
    • Aquí es donde se crearán y editarán los paquetes.
Se puede acceder a la mayoría de las funciones de esta extensión mediante comandos ejecutados en la paleta de comandos de VS Code. Se puede acceder a la paleta de comandos presionando Ctrl+Shift+P en Windows o Cmd+Shift+P en macOS. Se recomienda familiarizarse con esta interfaz, ya que se usará con frecuencia a lo largo de esta guía.

​
Establecer la ruta de acceso de la CLI de TAK

Una vez que la CLI de TAK esté descargada en el equipo, su ruta de acceso debe establecerse en la configuración de la extensión. La extensión iniciará la CLI de TAK en segundo plano para realizar diversas operaciones, como la creación de paquetes. Esto se puede hacer ejecutando un comando en VS Code, o estableciendo manualmente la ruta de acceso en la configuración de usuario de VS Code (identificador de configuración: TAK.editor.commandLineTool.path). Para establecer la ruta de acceso mediante el comando:
  1. Abra la paleta de comandos (Ctrl+Shift+P en Windows o Cmd+Shift+P en macOS).
  2. Busque “Set TAK CLI” y seleccione el comando “Touch Adaptation Kit: Set TAK Command Line Tool (TAK CLI) Path”. Captura de pantalla de la selección del comando Set TAK CLI en la paleta de comandos
  3. Se abrirá un selector de archivos. Navegue hasta la ubicación donde está descargada la CLI de TAK y seleccione el archivo ejecutable (tak.exe en Windows, tak en macOS): Captura de pantalla del selector de archivos para seleccionar el ejecutable de la CLI de TAK

​
Abrir una carpeta o un área de trabajo

Debe abrirse una carpeta o un área de trabajo en Visual Studio Code para trabajar con paquetes. Considérela como el directorio principal que contendrá los paquetes de sus juegos. Para abrir una carpeta, haga clic en el menú “File” en la esquina superior izquierda de la ventana y seleccione “Open Folder”. Navegue hasta la ubicación donde desea crear paquetes (o una carpeta existente que contenga paquetes) y haga clic en “Select Folder”. Para abrir un área de trabajo, haga clic en “File” y, a continuación, seleccione “Open Workspace from File”. Tenga en cuenta que esto requerirá que exista un archivo de área de trabajo (con la extensión .code-workspace) en el equipo. Si no tiene un archivo de área de trabajo, puede crear uno seleccionando “Add Folder to Workspace…” en el menú “File” y agregando las carpetas deseadas. A continuación, puede guardar el área de trabajo haciendo clic en “File” y seleccionando “Save Workspace As…”.

​
Solución de problemas

Aparecerá un elemento de la barra de estado (con la etiqueta “TAK Editor”) en la esquina inferior izquierda de la ventana para indicar el estado de la extensión. Esto le permite identificar rápidamente si la ruta de acceso de la CLI de TAK está establecida correctamente y si la extensión puede comunicarse con la CLI. Si todo está configurado correctamente, el elemento de la barra de estado mostrará una marca de verificación y el número de paquetes de adaptación táctil encontrados en el área de trabajo, si los hay. Captura de pantalla del elemento de la barra de estado que indica el estado OK Si el elemento de la barra de estado muestra un error, puede mantener el puntero sobre él para ver más detalles sobre el error. Esto suele ir acompañado de una notificación que aparece en la esquina inferior derecha de la ventana con más información. Los problemas comunes incluyen:

​
La ruta de acceso de la CLI de TAK no está establecida

Captura de pantalla del elemento de la barra de estado que indica que la ruta de acceso de la CLI de TAK no está establecida Esto ocurre cuando la ruta de acceso de la CLI no está establecida en la configuración de la extensión. De hecho, la primera vez que se instala la extensión, este es el estado predeterminado. Para resolverlo, siga los pasos de la sección anterior para establecer la ruta de acceso. También puede hacer clic en el botón “Set TAK CLI” de la notificación, o hacer clic en el elemento de la barra de estado y seleccionar la opción “Set TAK Command Line Tool” para establecer la ruta de acceso.

​
La ruta de acceso de la CLI de TAK no existe

Captura de pantalla del elemento de la barra de estado que indica que la ruta de acceso de la CLI de TAK no existe Esto ocurre cuando la ruta de acceso proporcionada no existe. Puede suceder si la CLI se mueve o se elimina de la ubicación donde se estableció inicialmente, o si se escribió manualmente en la configuración y había un error tipográfico. Para resolverlo, vuelva a asignar la ruta de acceso siguiendo los pasos de la sección anterior.

​
La CLI de TAK no es ejecutable

Captura de pantalla del elemento de la barra de estado que indica que la CLI de TAK no es ejecutable Esto ocurre cuando la ruta de acceso proporcionada no corresponde a un archivo ejecutable. Puede suceder si se selecciona el archivo incorrecto en el selector de archivos, o si el archivo no está marcado como ejecutable (por ejemplo, sin permisos de ejecución en macOS). Para resolverlo, vuelva a asignar la ruta de acceso. macOS: si la ruta de acceso está establecida correctamente pero la CLI no está marcada como ejecutable, se deben asignar permisos de ejecución al archivo. Puede ser necesario reiniciar VS Code para que la extensión reconozca el cambio.

​
No se pudo determinar la versión de la CLI de TAK

Captura de pantalla del elemento de la barra de estado que indica que no se pudo determinar la versión de la CLI de TAK Esto puede ocurrir si la extensión no puede iniciar la CLI y determinar su versión, lo que puede deberse a que la versión de la CLI es demasiado antigua, o a que se seleccionó el ejecutable incorrecto como la CLI. Para resolverlo, asegúrese de que la versión más reciente de la CLI está descargada y restablezca la ruta de acceso.

​
La versión de la CLI de TAK está obsoleta

Captura de pantalla del elemento de la barra de estado que indica que la versión de la CLI de TAK está obsoleta Esto ocurre si la extensión puede iniciar y comprobar la versión de la CLI, pero la versión está obsoleta. Puede suceder si la extensión se actualizó recientemente y requiere una versión más reciente de la CLI de TAK. Para resolverlo, descargue la versión más reciente de la CLI y restablezca la ruta de acceso.

​
Paso siguiente

[!div class=“nextstepaction”] Crear un nuevo paquete de adaptación táctil
Última modificación el 20 de octubre de 2026