- Establecer la ruta de acceso de la CLI de TAK en la extensión.
- 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:
-
Abra la paleta de comandos (
Ctrl+Shift+Pen Windows oCmd+Shift+Pen macOS). - Busque “Set TAK CLI” y seleccione el comando “Touch Adaptation Kit: Set TAK Command Line Tool (TAK CLI) Path”.
-
Se abrirá un selector de archivos. Navegue hasta la ubicación donde está descargada la CLI de TAK y seleccione el archivo ejecutable (
tak.exeen Windows,taken macOS):
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. 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
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
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
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
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
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