Skip to main content
Cet article présente les étapes à suivre pour configurer l’éditeur TAK. On suppose que vous avez déjà installé Visual Studio Code, téléchargé la dernière version de l’interface CLI TAK et installé l’extension TAK Editor. Si ce n’est pas le cas, consultez la page Vue d’ensemble pour plus d’informations. De façon générale, le processus de configuration comprend les étapes suivantes :
  1. Définir le chemin de l’interface CLI TAK dans l’extension.
  2. Ouvrir un dossier ou un espace de travail dans Visual Studio Code
    • C’est à cet endroit que les ensembles seront créés et modifiés.
La plupart des fonctionnalités de cette extension sont accessibles au moyen de commandes exécutées dans la palette de commandes de VS Code. Vous pouvez ouvrir la palette de commandes en appuyant sur Ctrl+Shift+P sur Windows ou Cmd+Shift+P sur macOS. Il est recommandé de vous familiariser avec cette interface, car elle sera utilisée fréquemment tout au long de ce guide.

​
Définir le chemin de l’interface CLI TAK

Une fois l’interface CLI TAK téléchargée sur l’ordinateur, son chemin doit être défini dans les paramètres de l’extension. L’extension lance l’interface CLI TAK en arrière-plan pour effectuer diverses opérations, comme la création d’ensembles. Vous pouvez le faire en exécutant une commande dans VS Code ou en définissant manuellement le chemin dans les paramètres utilisateur de VS Code (ID du paramètre : TAK.editor.commandLineTool.path). Pour définir le chemin au moyen de la commande :
  1. Ouvrez la palette de commandes (Ctrl+Shift+P sur Windows ou Cmd+Shift+P sur macOS).
  2. Recherchez « Set TAK CLI » et sélectionnez la commande « Touch Adaptation Kit: Set TAK Command Line Tool (TAK CLI) Path ». Capture d'écran de la sélection de la commande Set TAK CLI dans la palette de commandes
  3. Un sélecteur de fichiers s’ouvre. Accédez à l’emplacement où l’interface CLI TAK a été téléchargée et sélectionnez le fichier exécutable (tak.exe sur Windows, tak sur macOS) : Capture d'écran du sélecteur de fichiers permettant de sélectionner l'exécutable de l'interface CLI TAK

​
Ouvrir un dossier ou un espace de travail

Un dossier ou un espace de travail doit être ouvert dans Visual Studio Code pour travailler sur des ensembles. Considérez-le comme le répertoire parent qui contiendra le ou les ensembles de votre ou vos jeux. Pour ouvrir un dossier, cliquez sur le menu « File » dans le coin supérieur gauche de la fenêtre, puis sélectionnez « Open Folder ». Accédez à l’emplacement où vous souhaitez créer des ensembles (ou à un dossier existant qui contient des ensembles), puis cliquez sur « Select Folder ». Pour ouvrir un espace de travail, cliquez sur « File », puis sélectionnez « Open Workspace from File ». Notez que cela nécessite qu’un fichier d’espace de travail existant (avec l’extension .code-workspace) soit présent sur l’ordinateur. Si vous n’avez pas de fichier d’espace de travail, vous pouvez en créer un en sélectionnant « Add Folder to Workspace… » dans le menu « File » et en ajoutant les dossiers souhaités. Vous pouvez ensuite enregistrer l’espace de travail en cliquant sur « File » et en sélectionnant « Save Workspace As… ».

​
Dépannage

Un élément de la barre d’état (portant l’étiquette « TAK Editor ») s’affiche dans le coin inférieur gauche de la fenêtre pour indiquer l’état de l’extension. Cela vous permet de déterminer rapidement si le chemin de l’interface CLI TAK est correctement défini et si l’extension est en mesure de communiquer avec l’interface CLI. Si tout est correctement configuré, l’élément de la barre d’état affiche un crochet et le nombre d’ensembles d’adaptation tactile trouvés dans l’espace de travail, le cas échéant. Capture d'écran de l'élément de la barre d'état indiquant un état OK Si l’élément de la barre d’état indique une erreur, vous pouvez pointer dessus pour afficher plus de détails sur l’erreur. Cela s’accompagne généralement d’une notification qui s’affiche dans le coin inférieur droit de la fenêtre avec plus d’informations. Les problèmes courants comprennent :

​
Chemin de l’interface CLI TAK non défini

Capture d'écran de l'élément de la barre d'état indiquant que le chemin de l'interface CLI TAK n'est pas défini Ce problème survient lorsque le chemin de l’interface CLI n’est pas défini dans les paramètres de l’extension. En fait, c’est l’état par défaut lors de la première installation de l’extension. Pour le résoudre, suivez les étapes de la section précédente pour définir le chemin. Vous pouvez aussi cliquer sur le bouton « Set TAK CLI » dans la notification, ou cliquer sur l’élément de la barre d’état et sélectionner l’option « Set TAK Command Line Tool » pour définir le chemin.

​
Le chemin de l’interface CLI TAK n’existe pas

Capture d'écran de l'élément de la barre d'état indiquant que le chemin de l'interface CLI TAK n'existe pas Ce problème survient lorsque le chemin fourni n’existe pas. Cela peut se produire si l’interface CLI a été déplacée ou supprimée de l’emplacement où elle avait été initialement définie, ou si le chemin a été saisi manuellement dans les paramètres avec une faute de frappe. Pour le résoudre, réattribuez le chemin en suivant les étapes de la section précédente.

​
Interface CLI TAK non exécutable

Capture d'écran de l'élément de la barre d'état indiquant que l'interface CLI TAK n'est pas exécutable Ce problème survient lorsque le chemin fourni ne correspond pas à un fichier exécutable. Cela peut se produire si le mauvais fichier a été sélectionné dans le sélecteur de fichiers, ou si le fichier n’est pas marqué comme exécutable (p. ex., aucune autorisation d’exécution sur macOS). Pour le résoudre, réattribuez le chemin. macOS : Si le chemin est correctement défini, mais que l’interface CLI n’est pas marquée comme exécutable, des autorisations d’exécution doivent être attribuées au fichier. Un redémarrage de VS Code peut être nécessaire pour que l’extension reconnaisse la modification.

​
Version de l’interface CLI TAK indéterminée

Capture d'écran de l'élément de la barre d'état indiquant que la version de l'interface CLI TAK est indéterminée Ce problème peut survenir si l’extension n’arrive pas à lancer l’interface CLI et à déterminer sa version, soit parce que la version de l’interface CLI est trop ancienne, soit parce que le mauvais exécutable a été sélectionné comme interface CLI. Pour le résoudre, assurez-vous que la dernière version de l’interface CLI est téléchargée et redéfinissez le chemin.

​
Version de l’interface CLI TAK obsolète

Capture d'écran de l'élément de la barre d'état indiquant que la version de l'interface CLI TAK est obsolète Ce problème survient si l’extension arrive à lancer l’interface CLI et à vérifier sa version, mais que cette version est obsolète. Cela peut se produire si l’extension a récemment été mise à jour et nécessite une version plus récente de l’interface CLI TAK. Pour le résoudre, téléchargez la dernière version de l’interface CLI et redéfinissez le chemin.

​
Étape suivante

[!div class=“nextstepaction”] Créer un nouvel ensemble d’adaptation tactile
Last modified on October 6, 2026