6. Account e impostazioni
6.4 Le istruzioni dei framework
Modificare le ricette di «Nuovo progetto»: basi, aggiunte, comandi, variabili .env, azioni. E provare una combinazione prima di usarla.
Nell'app: «Impostazioni»
In breve
- Le basi e le aggiunte di «Nuovo progetto» sono ricette: elenchi di comandi che puoi leggere e modificare.
- Le trovi in Impostazioni, nel riquadro «Framework».
- Puoi cambiare una ricetta ufficiale (e ripristinarla) o crearne di tue.
- «Prova una combinazione» mostra che cosa farebbe una base con delle aggiunte, prima di usarla.
Com'è fatta una ricetta
- StrumentiI componenti del kit che servono (Node.js, PHP…).
- CreaI comandi che creano il progetto, eseguiti nella cartella projects.
- PoiI comandi da eseguire nella cartella del progetto.
- ContornoDatabase, variabili .env, azioni del progetto.
Ogni riga è un comando eseguito con la PowerShell e gli strumenti del kit. {name} diventa il nome del progetto (tra virgolette), {package} com.example. seguito dal nome in minuscolo.
Il riquadro «Framework»
L'albero ha le «Basi», divise per gruppo, e sotto ogni base le aggiunte che vanno con lei; poi le «Aggiunte» per tipo; in fondo «Prova una combinazione». In cima, le icone «Aggiungi una base» e «Aggiungi un'aggiunta».
| Campo | Che cosa scrivere |
|---|---|
| Nome, Descrizione, Pagina ufficiale | Come compare nella procedura e il collegamento alla documentazione. |
| Strumenti del kit | I componenti da installare prima («Aggiungi uno strumento del kit»). |
| Crea il progetto (nella cartella projects) | Per esempio: npm create vite@latest {name} -- --template vanilla-ts |
| Poi, nella cartella del progetto | Per esempio: npm install |
| Database del kit per il progetto | Nessuno, MySQL o MongoDB. La password che la procedura genera per il database vince su una vuota della base (per esempio DB_PASSWORD= in .env.example). |
| Variabili del file .env (CHIAVE=valore) | Per esempio: APP_NAME={name} |
| Azioni del progetto (Nome: comando) | Per esempio: Avvia: npm run dev |
Un'aggiunta ha in più il «Gruppo» (due aggiunte dello stesso gruppo non vanno insieme), «Usala anche con» per le basi compatibili e, per ogni base, i comandi da aggiungere o «Crea il progetto al posto della base».
- Scegli una base o un'aggiunta nell'albero e modifica i campi.
- Le istruzioni si salvano da sole poco meno di un secondo dopo l'ultima modifica: la barra delle schede mostra «Salvataggio…», poi «Salvato.». Una ricetta ufficiale cambiata mostra «Modificata».
- Per tornare alla versione originale usa «Ripristina le istruzioni ufficiali»; una ricetta tua si toglie con «Togli».
Prova una combinazione
Scegli una base e delle aggiunte: la scheda mostra il piano completo che la procedura eseguirebbe (strumenti, comandi, database, .env, azioni), con le istruzioni come sono adesso, anche se l'ultima modifica non è ancora salvata. Non esegue niente.
Sotto il cofano
- Le ricette ufficiali sono nel catalogo del kit (tauri/catalog/frameworks.json): 63 basi e 18 aggiunte.
- Le tue modifiche sono in data\app\frameworks.json, che contiene solo le differenze dalle ricette ufficiali.
- Le basi salvate da un progetto con «Salva come base» sono nel gruppo «Le mie basi» (category «mine»): al posto dei comandi di «Crea il progetto» hanno il campo template, la cartella di data\frameworks\mine da copiare. Una base deve avere i comandi di creazione oppure un template valido. Togliendone una con «Togli», al salvataggio se ne va anche la sua cartella.
- Se quel file non si può leggere, il kit usa le ricette ufficiali e non lo tocca: «Le istruzioni in … non sono leggibili: uso quelle ufficiali e non modifico il file.»