6. Compte et paramètres
6.4 Les instructions des frameworks
Modifier les recettes de « Nouveau projet » : bases, ajouts, commandes, variables .env, actions. Et essayer une combinaison avant de l'utiliser.
Dans l'application: «Paramètres»
En bref
- Les bases et les ajouts de « Nouveau projet » sont des recettes : des listes de commandes que vous pouvez lire et modifier.
- Vous les trouvez dans Paramètres, dans le panneau « Frameworks ».
- Vous pouvez modifier une recette officielle (et la rétablir) ou créer les vôtres.
- « Essayer une combinaison » montre ce que ferait une base avec des ajouts, avant de l'utiliser.
Comment est faite une recette
- OutilsLes composants du kit nécessaires (Node.js, PHP…).
- CréerLes commandes qui créent le projet, exécutées dans le dossier projects.
- EnsuiteLes commandes à exécuter dans le dossier du projet.
- ComplémentsBase de données, variables .env, actions du projet.
Chaque ligne est une commande exécutée avec PowerShell et les outils du kit. {name} devient le nom du projet (entre guillemets), {package} com.example. suivi du nom en minuscules.
Le panneau « Frameworks »
L'arbre contient les « Bases », réparties par groupe, et sous chaque base les ajouts qui vont avec elle ; puis les « Ajouts » par type ; tout en bas « Essayer une combinaison ». En haut, les icônes « Ajouter une base » et « Ajouter un ajout ».
| Champ | Quoi écrire |
|---|---|
| Nom, Description, Page officielle | Comment elle apparaît dans l'assistant et le lien vers la documentation. |
| Outils du kit | Les composants à installer d'abord (« Ajouter un outil du kit »). |
| Créer le projet (dans le dossier projects) | Par exemple : npm create vite@latest {name} -- --template vanilla-ts |
| Ensuite, dans le dossier du projet | Par exemple : npm install |
| Base de données du kit pour le projet | Aucune, MySQL ou MongoDB. Le mot de passe que l'assistant génère pour la base de données l'emporte sur un mot de passe vide de la base (par exemple DB_PASSWORD= dans .env.example). |
| Variables du fichier .env (CLÉ=valeur) | Par exemple : APP_NAME={name} |
| Actions du projet (Nom : commande) | Par exemple : Démarrer : npm run dev |
Un ajout a en plus le « Groupe » (deux ajouts du même groupe ne vont pas ensemble), « L'utiliser aussi avec » pour les bases compatibles et, pour chaque base, les commandes à ajouter ou « Créer le projet à la place de la base ».
- Choisissez une base ou un ajout dans l'arbre et modifiez les champs.
- Les instructions s'enregistrent toutes seules un peu moins d'une seconde après la dernière modification : la barre des onglets affiche « Enregistrement… », puis « Enregistré. ». Une recette officielle modifiée affiche « Modifiée ».
- Pour revenir à la version d'origine, utilisez « Rétablir les instructions officielles » ; une recette à vous se retire avec « Retirer ».
Essayer une combinaison
Choisissez une base et des ajouts : l'onglet montre le plan complet que l'assistant exécuterait (outils, commandes, base de données, .env, actions), avec les instructions telles qu'elles sont maintenant, même si la dernière modification n'est pas encore enregistrée. Il n'exécute rien.
Sous le capot
- Les recettes officielles sont dans le catalogue du kit (tauri/catalog/frameworks.json) : 63 bases et 18 ajouts.
- Vos modifications sont dans data\app\frameworks.json, qui ne contient que les différences par rapport aux recettes officielles.
- Les bases enregistrées depuis un projet avec « Enregistrer comme base » sont dans le groupe « Mes bases » (category « mine ») : à la place des commandes de « Créer le projet », elles ont le champ template, le dossier de data\frameworks\mine à copier. Une base doit avoir les commandes de création ou un template valide. Quand on en retire une avec « Retirer », son dossier s'en va aussi à l'enregistrement.
- Si ce fichier ne peut pas être lu, le kit utilise les recettes officielles et n'y touche pas : « Les instructions de … sont illisibles : j'utilise les officielles et je ne modifie pas le fichier. »