2.4 Composants et versions d'un projet

Composants nécessaires

La partie « Composants » liste les outils du kit dont le projet a besoin, chacun « installé » ou « à installer ». S'il manque quelque chose, « Installer ce qui manque » les installe et attend qu'ils aient terminé. La partie « Comment il a été reconnu » explique à partir de quels fichiers le kit a compris le type de projet, avec d'éventuels avertissements (par exemple « Dépendances non installées : exécutez d'abord npm install »).

Choisir les versions du projet

La partie « Versions » a deux groupes : « Langages actifs dans le projet », ouvert, et « Langages absents du projet », fermé, pour régler d'autres langages à utiliser dans le terminal ou dans les scripts.

1. Ouvrez le menu à côté du langage.
2. La première entrée, « La plus récente (…) », laisse le kit décider : il utilisera toujours la version la plus récente présente sur le disque.
3. Sous « Téléchargées » se trouvent les versions déjà dans le kit ; sous « À télécharger : 8.x » celles que la source propose et que le kit n'a pas encore.
4. Choisissez une version : si elle n'est pas téléchargée, le téléchargement démarre aussitôt (« Téléchargement de … en cours… »). Tant qu'elle n'est pas prête, le projet utilise la plus récente (« … n'est pas téléchargée : … est utilisée pour l'instant », avec « Télécharger » ou « Réessayer »).
5. Le bouton avec les flèches, « Chercher d'autres versions de … », redemande à la source la liste des versions.

Sous le menu, le kit peut afficher des suggestions : « Requis par package.json : >=20 » si le projet déclare une version, ou « D'après les conteneurs du projet (Compose ou Dockerfile) : php 8.3 » avec le bouton « Utiliser 8.3 ».

D'où viennent les versions de départ

• Un projet créé par l'application (vide ou avec un framework) fixe les versions les plus récentes présentes à ce moment-là : une future mise à jour du kit ne change pas sous ses pieds un projet qui fonctionne.
• Un projet cloné « Depuis une adresse Git » utilise les versions que son code demande, si le kit les reconnaît : .nvmrc, .node-version, .python-version, pyproject.toml, composer.json, .php-version, go.mod, global.json, .ruby-version, pom.xml et d'autres.
• Le récapitulatif de qui demande quoi se trouve dans la vue « Relations » de la page Outils : Vues d'ensemble : matrice, relations, extensions, prérequis (5.3).