yarn install |
Installe |
Yarn |
Syntaxe
yarn install [paramètres]
|
Paramètres
Nom |
Description |
--check-cache |
Ce paramètre permet de récupérer toujours les paquets et s'assure que leurs sommes de contrôle sont cohérentes. |
--immutable |
Ce paramètre permet d'abandonner avec un code de sortie d'erreur si le fichier de verrouillage devait être modifié. |
--immutable-cache |
Ce paramètre permet d'abandonner avec un code de sortie d'erreur si le dossier de cache devait être modifié. |
--inline-builds |
Ce paramètre permet d'afficher de manière verbale la sortie des étapes de construction des dépendances. |
--json |
Ce paramètre permet de formater la sortie en tant que flux NDJSON. |
--skip-builds |
Ce paramètre permet de passer complètement l'étape de construction. |
Description
Cette commande permet d'installer les dépendances du projet.
Remarques
- La commande yarn install configure votre projet si nécessaire. L'installation est divisée en quatre étapes différentes ayant chacune leurs propres caractéristiques :
Étape |
Description |
Resolution |
Le gestionnaire de paquets résoudra d'abord vos dépendances. La manière exacte dont une version de dépendance est privilégiée sur une autre n'est pas standardisée en dehors des garanties de
semver régulières. Si un paquet ne répond pas à ce que vous attendez, vérifiez que toutes les dépendances sont correctement déclarées. |
Fetch |
Téléchargement de toutes les dépendances si nécessaire, et s'assure qu'elles sont toutes entreposées dans notre cache (vérifiez la valeur de cacheFolder dans yarn config pour voir
où sont entreposés les fichiers de cache). |
Link |
Envoie des informations de l'arborescence de dépendances aux plugiciels internes chargés de les écrire sur le disque sous une forme quelconque (par exemple en générant le fichier .pnp.js). |
Build |
Une fois l'arborescence de dépendances écrite sur le disque, le gestionnaire de paquets sera désormais libre d'exécuter les scripts de construction pour tous les paquets pouvant en avoir besoin,
dans un ordre topologique compatible avec la façon dont ils dépendent les uns des autres. |
- Notez que l'exécution de cette commande ne fait pas partie du flux de travail recommandé. La commande Yarn prend en charge les installations zéro, ce qui signifie que tant que vous
entreposez votre cache et votre fichier .pnp.js dans votre dépôt, tout fonctionnera sans nécessiter d'installation juste après le clonage de votre dépôt ou le changement de branche.
- Si le paramètre --immutable est définie, Yarn abandonnera avec un code de sortie d'erreur si le fichier de verrouillage devait être modifié (d'autres chemins peuvent être ajoutés
en utilisant le paramètre de configuration immutablePaths). Pour la compatibilité descendante, il existe un alias sous le nom de --frozen-lockfile, mais il sera supprimé dans une version ultérieure.
- Si le paramètre --immutable-cache est définie, Yarn abandonnera avec un code de sortie d'erreur si le dossier de cache devait être modifié (soit parce que des fichiers seraient
ajoutés, soit parce qu'ils seraient supprimés).
- Si le paramètre --check-cache est définie, Yarn récupérera toujours les paquets et s'assurera que leur somme de contrôle correspond à ce qui est 1 / décrit dans le fichier de
verrouillage 2 / à l'intérieur des fichiers de cache existants (si présents). Ceci est recommandé dans le cadre de votre flux de travail CI si vous suivez à la fois le modèle Zero-Installs et
acceptez les PR de tiers, car ils auraient autrement la possibilité de modifier les paquets enregistrés avant de les soumettre.
- Si le paramètre --inline-builds est définie, Yarn affichera de manière détaillés la sortie des étapes de construction de vos dépendances (au lieu de les écrire dans des fichiers
individuels). Ceci est probablement utile principalement à des fins de débogage uniquement lors de l'utilisation d'environnements de type Docker.
- Si le paramètre --skip-builds est définie, Yarn n'exécutera pas du tout les scripts de construction. Notez que cela est différent de définir enableScripts sur false car
ce dernier désactivera les scripts de construction et affectera ainsi le contenu des artefacts générés sur le disque, alors que le premier désactivera simplement l'étape de construction mais pas les scripts
eux-mêmes, ne fonctionnant tout simplement pas.
Exemples
L'exemple suivant permet d'installer le projet :
L'exemple suivant permet de valider un projet lors de l'utilisation de Zero-Installs :
yarn install --immutable --immutable-cache
|
L'exemple suivant permet de valider un projet lors de l'utilisation de Zero-Installs (légèrement plus sûr si vous acceptez les PR externes) :
yarn install --immutable --immutable-cache --check-cache
|
Dernière mise à jour : Mardi, le 15 Décembre 2020