Introduction

Commençons par créer un environnement de travail propice à une expérience de développement optimale. Pour cela, nous allons utiliser VSCode, qui est l'outil le plus adapté pour utiliser TopModel. En effet, une extension a été développée spécialement pour cet IDE afin d'enrichir considérablement l'expérience de développement.

Prérequis

Avant de commencer, vous devez installer les éléments suivants :

1. VSCode : L'éditeur de code recommandé
2. L'extension TopModel : Pour l'autocomplétion, la validation et la navigation
3. Le SDK .NET : Version 8.0 ou supérieure
4. TopModel.Generator : Le générateur de code

Installation de TopModel.Generator

Installez le générateur avec la commande suivante :

dotnet tool install --global TopModel.Generator

Pour vérifier que l'installation a réussi :

modgen --version

Par la suite, pour mettre à jour TopModel :

dotnet tool update --global TopModel.Generator

💡 Astuce : L'extension VSCode propose également la commande Mettre à jour TopModel.Generator via F1.

Installation sous Linux / WSL

Si vous utilisez Linux ou WSL, suivez ces étapes supplémentaires :

1. Installer le SDK .NET sous Linux

2. Installer TopModel via dotnet :

   dotnet tool install --global TopModel.Generator

3. Ajouter le chemin des outils .NET au PATH en modifiant le fichier de profil :

   export PATH="$HOME/.dotnet/tools:$PATH"

4. Recharger le profil :

   source ~/.bashrc  # ou source ~/.zshrc pour zsh

5. Vérifier l'installation :

   modgen --version

Initialisation du fichier de configuration

Dans un nouveau dossier nommé "Projet", nous allons créer un fichier de configuration. Celui-ci permettra à l'extension TopModel de démarrer et de vous offrir les fonctionnalités d'auto-complétion, coloration syntaxique, etc.

💡 Note : Le fichier doit respecter le format topmodel*.config (par exemple topmodel.config ou topmodel.monapp.config)

Dans ce fichier de configuration (que l'on nommera "topmodel.config" dans le cadre de ce tutoriel), nous allons pour le moment nous contenter d'indiquer le nom de notre application.

topmodel.config

---
app: Hello World

Activer l'extension

Une fois le fichier de configuration créé :

1. Redémarrez VSCode pour que l'extension TopModel démarre
2. L'extension devrait maintenant être active et vous offrir :
   • L'autocomplétion dans les fichiers .tmd
   • La validation en temps réel
   • La navigation entre fichiers
   • La coloration syntaxique

✅ Vérification : Si l'extension fonctionne correctement, vous devriez voir l'icône TopModel dans la barre de statut de VSCode.

C'est parti ! Vous êtes maintenant prêt à créer votre premier modèle TopModel.