Introductie
Yarn is een pakketbeheerder voor Node.js die zich richt op snelheid, beveiliging en consistentie. Het is oorspronkelijk gemaakt om enkele problemen aan te pakken met de populaire NPM pakketbeheerder. Hoewel de twee pakketbeheerders sindsdien zijn samengekomen qua prestaties en functies, blijft Yarn populair, vooral in de wereld van React-ontwikkeling.
Enkele unieke kenmerken van Yarn zijn:
- A per-project caching mechanism, that can greatly speed up subsequent installs and builds
- Consistente, deterministische installaties die garanderen dat de structuur van geïnstalleerde bibliotheken altijd hetzelfde is
- Checksumtesten van alle pakketten om hun integriteit te verifiëren
- “Workspaces”, die het gebruik van Yarn in een monorepo vergemakkelijken (meerdere projecten ontwikkeld in een enkel broncode-opslag)
In deze tutorial installeer je Yarn wereldwijd, voeg je Yarn toe aan een specifiek project, en leer je enkele basis Yarn-opdrachten.
Implementeer je frontend-applicaties vanuit GitHub met behulp van DigitalOcean App Platform. Laat DigitalOcean zich richten op het schalen van je app.
Installeren en Gebruiken van Yarn Pakketbeheerder voor Node.js
Vereisten
Voordat je de Yarn pakketbeheerder installeert en gebruikt, moet je Node.js geïnstalleerd hebben. Om te controleren of je Node.js al hebt geïnstalleerd, typ je het volgende commando in je lokale commandoregelterminal:
Als je een versienummer ziet, zoals v12.16.3 afgedrukt, dan heb je Node.js geïnstalleerd. Als je een command not found foutmelding (of vergelijkbare bewoording) krijgt, installeer dan eerst Node.js voordat je doorgaat.
Om Node.js te installeren, volg onze tutorial voor Ubuntu, Debian, CentOS, of macOS.
Zodra Node.js is geïnstalleerd, ga je naar Stap 1 om de Yarn package manager te installeren.
Stap 1 — Yarn Globaal Installeren
Yarn heeft een unieke manier om zichzelf te installeren en uit te voeren in je JavaScript-projecten. Eerst installeer je het yarn commando globaal, dan gebruik je het globale yarn commando om een specifieke lokale versie van Yarn in je projectdirectory te installeren. Dit is noodzakelijk om ervoor te zorgen dat iedereen die aan een project werkt (en alle geautomatiseerde test- en implementatietools van het project) dezelfde versie van yarn gebruikt, om inconsistente gedragingen en resultaten te voorkomen.-g vlag met npm install om dit te doen:
De onderhouders van Yarn raden aan om Yarn wereldwijd te installeren met behulp van de NPM-pakketbeheerder, die standaard is opgenomen bij alle Node.js-installaties. Gebruik de -g vlag met npm install om dit te doen:
Nadat het pakket is geïnstalleerd, laat de yarn opdracht zijn eigen versienummer afdrukken. Dit laat je zien of het correct is geïnstalleerd:
Output1.22.11
Nu je de yarn opdracht wereldwijd hebt geïnstalleerd, kun je deze gebruiken om Yarn te installeren in een specifiek JavaScript-project.
Stap 2 — Yarn installeren in je project
Je kunt deze stap overslaan als je Yarn gebruikt om te werken met een bestaand Yarn-project. Het project zou al moeten zijn ingesteld met een lokale versie van Yarn en alle configuratiebestanden die nodig zijn om het te gebruiken.
Als je een nieuw project van jezelf aan het instellen bent, wil je nu een projectspecifieke versie van Yarn configureren.
Navigeer eerst naar de map van je project:
Als je geen projectmap hebt, kun je er een nieuwe maken met mkdir en vervolgens erin verplaatsen:
Gebruik nu de yarn set opdracht om de versie in te stellen op berry:
Dit zal de huidige, actief ontwikkelde versie van Yarn – berry – downloaden, opslaan in een .yarn/releases/ map in je project en ook een .yarnrc.yml configuratiebestand opzetten:
OutputResolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!
Nu probeer de yarn --version opdracht opnieuw:
Output3.0.0
Je zult zien dat de versie 3.0.0 of hoger is. Dit is de nieuwste release van Yarn.
Opmerking: Als je cd buiten je projectdirectory en de yarn --version opdracht opnieuw uitvoert, krijg je weer de globale versienummer van Yarn, in dit geval 1.22.11. Elke keer dat je yarn uitvoert, gebruik je de wereldwijd geïnstalleerde versie van de opdracht. De globale yarn opdracht controleert eerst of het zich in een Yarn projectdirectory bevindt met een .yarnrc.yml bestand, en als dat zo is, draagt het de opdracht over aan de projectspecifieke versie van Yarn die is geconfigureerd in de project yarnPath instelling.
Je project is nu ingesteld met een projectspecifieke versie van Yarn. Vervolgens bekijken we enkele veelgebruikte yarn opdrachten om mee te beginnen.
Gebruik van Yarn
Yarn heeft veel subopdrachten, maar je hebt er slechts een paar nodig om te beginnen. Laten we eens kijken naar de eerste subopdrachten die je wilt gebruiken.
Hulp krijgen
Bij het starten met een nieuw hulpmiddel is het nuttig om te leren hoe je toegang kunt krijgen tot zijn online hulp. In Yarn kan de --help vlag aan elke opdracht worden toegevoegd om meer informatie te krijgen:
Dit zal algemene hulp weergeven voor de yarn opdracht. Om meer specifieke informatie over een subopdracht te krijgen, voeg --help toe na de subopdracht:
Dit zou details weergeven over het gebruik van de yarn install opdracht.
Het starten van een nieuw Yarn-project
Als je een project vanaf nul aan het starten bent, gebruik dan de init subopdracht om de Yarn-specifieke bestanden te creëren die je nodig hebt:
Dit zal een package.json configuratiebestand en een yarn.lock bestand toevoegen aan je directory. Het package.json bevat de configuratie en je lijst van moduledependenties. Het yarn.lock bestand lockt die afhankelijkheden naar specifieke versies, zorgen ervoor dat de afhankelijkheidsboom altijd consistent is.
Het installeren van alle afhankelijkheden van een project
Om alle afhankelijkheden in een bestaand Yarn-gebaseerd project te downloaden en te installeren, gebruik de install subopdracht:
Dit zal de modules downloaden en installeren die je nodig hebt om te beginnen.
Het Toevoegen van een Nieuwe Afhankelijkheid aan een Project
Gebruik de add subcommando om nieuwe afhankelijkheden aan een project toe te voegen:
Dit zal de module downloaden, installeren en uw package.json en yarn.lock bestanden bijwerken.
Het Bijwerken van Je .gitignore Bestand voor Yarn
Yarn slaat bestanden op in een .yarn map binnen je projectdirectory. Sommige van deze bestanden moeten worden opgenomen in versiebeheer en andere moeten worden genegeerd. De basisconfiguratie van .gitignore voor Yarn is als volgt:
.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*
Dit negeert de volledige .yarn directory en voegt vervolgens enkele uitzonderingen toe voor belangrijke mappen, waaronder de releases directory die je projectspecifieke versie van Yarn bevat.
Voor meer informatie over het configureren van Git en Yarn, verwijzen we u graag naar de officiële Yarn documentatie over .gitignore.
Conclusie
In deze tutorial heb je Yarn geïnstalleerd en heb je kennisgemaakt met een aantal yarn subcommando’s. Voor meer informatie over het gebruik van Yarn, neem een kijkje op de officiële Yarn CLI documentatie.
Voor meer algemene hulp met Node.js en JavaScript, bezoek onze Node.js en JavaScript tagpagina’s, waar je relevante tutorials, tech talks en community Q&A zult vinden.