2. Progetti

2.4 Componenti e versioni di un progetto

Gli strumenti che servono a un progetto, la versione di ogni linguaggio scelta solo per lui e come il kit la riconosce dai file del progetto.

Nell'app: «Progetti»

In breve

  • La sezione «Componenti» dice quali strumenti del kit servono al progetto e li installa con un clic.
  • In «Versioni» scegli, solo per questo progetto, la versione di ogni linguaggio: per esempio Node 20 qui e Node 24 altrove.
  • Un progetto nuovo tiene le versioni più recenti che c'erano quando è stato creato, finché non le cambi.
  • La scelta vale per azioni, terminale, agenti, editor e server web del progetto.
La sezione «Componenti»dati di esempio
La sezione «Componenti»

I componenti che servono al progetto, come è stato riconosciuto e le versioni dei suoi linguaggi.

Componenti che servono

La parte «Componenti» elenca gli strumenti del kit di cui il progetto ha bisogno, ciascuno «installato» o «da installare». Se manca qualcosa, «Installa ciò che manca» li installa e aspetta che abbiano finito. La parte «Come è stato riconosciuto» spiega da quali file il kit ha capito il tipo di progetto, con eventuali avvisi (per esempio «Dipendenze non installate: esegui prima npm install»).

Scegliere le versioni del progetto

La parte «Versioni» ha due gruppi: «Linguaggi attivi nel progetto», aperto, e «Linguaggi non presenti nel progetto», chiuso, per impostare altri linguaggi da usare nel terminale o negli script.

  1. Apri il menu accanto al linguaggio.
  2. La prima voce, «La più recente (…)», lascia decidere al kit: userà sempre la versione più recente presente su disco.
  3. Sotto «Scaricate» ci sono le versioni già nel kit; sotto «Da scaricare: 8.x» quelle che la fonte offre e il kit non ha ancora.
  4. Scegli una versione: se non è scaricata parte subito il download («Download di … in corso…»). Finché non è pronta il progetto usa la più recente («… non è scaricata: per ora si usa la …», con «Scarica» o «Riprova»).
  5. Il pulsante con le frecce, «Cerca altre versioni di …», chiede di nuovo alla fonte l'elenco delle versioni.

Sotto il menu il kit può mostrare dei suggerimenti: «Richiesto da package.json: >=20» se il progetto dichiara una versione, oppure «Dai container del progetto (Compose o Dockerfile): php 8.3» con il pulsante «Usa 8.3».

Da dove vengono le versioni di partenza

  • Un progetto creato dall'app (vuoto o con un framework) fissa le versioni più recenti presenti in quel momento: un aggiornamento futuro del kit non cambia sotto i piedi un progetto che funziona.
  • Un progetto clonato «Da un indirizzo Git» usa le versioni che il suo codice chiede, se il kit le riconosce: .nvmrc, .node-version, .python-version, pyproject.toml, composer.json, .php-version, go.mod, global.json, .ruby-version, pom.xml e altri.
  • Il riepilogo di chi chiede che cosa è nella vista «Relazioni» della pagina Strumenti: Panoramiche: matrice, relazioni, estensioni, requisiti (5.3).
Sotto il cofano
  • La scelta viene salvata in data\projects\<progetto>\dev-settings.json, alla voce versions; la prima voce del menu la toglie.
  • Il kit scrive anche versions.json e versions.txt nella stessa cartella: li leggono il profilo della PowerShell e quello di Git Bash per mettere nel PATH le versioni giuste quando un terminale si apre in quel progetto.
  • Oltre al PATH, il kit imposta JAVA_HOME, DOTNET_ROOT e CP_PHP sulle versioni scelte.
  • La versione del server di database del progetto si sceglie nella sezione «Database», non qui.