Node.js-pakketbeheer met Yarn in ServBay

ServBay is een krachtige lokale webontwikkelomgeving met ingebouwde ondersteuning voor Node.js. Yarn is een snel, betrouwbaar en veilig pakketbeheerder ontwikkeld door Facebook. Net als npm, maar met snellere installatie, betere offline ondersteuning en betrouwbaardere afhankelijkheidsresolutie. Door Yarn te gebruiken binnen de Node.js-omgeving van ServBay, kunnen ontwikkelaars efficiënter projectafhankelijkheden beheren en hun workflow versnellen.

Vereisten

Voordat je Yarn gebruikt, zorg ervoor dat Node.js al geïnstalleerd en geactiveerd is in ServBay. Met de pakketbeheerfunctie van ServBay kun je verschillende Node.js-versies eenvoudig installeren en schakelen.

Yarn installeren en activeren

De Node.js-pakketten die via ServBay geïnstalleerd worden, bevatten meestal standaard Corepack. Dit is een experimentele Node.js-tool om package managers zoals npm, Yarn en pnpm te beheren en verspreiden. Corepack zorgt er doorgaans voor dat je het yarn-commando kunt gebruiken en begeleidt je bij het installeren van de juiste Yarn-versie indien nodig.

Controleren of Yarn geïnstalleerd is

Controleer of Yarn beschikbaar is in je ServBay-omgeving voordat je aan de slag gaat. Open je terminal en voer het volgende commando uit om het Yarn-versienummer weer te geven:

yarn -v

Als Yarn correct geïnstalleerd is en in je systeem-PATH staat, zie je een output zoals het volgende versienummer:

1.22.19

Of een hoger nummer.

Yarn installeren of updaten via Corepack

Bij het eerste gebruik van het yarn-commando, kan Corepack detecteren dat een specifieke Yarn-versie geïnstalleerd moet worden. Dan krijg je mogelijk deze prompt:

$ yarn -v
! Corepack is about to download https://registry.yarnpkg.com/yarn/-/yarn-1.22.22.tgz
? Do you want to continue? [Y/n]

Dit betekent dat Corepack vraagt of het de opgegeven versie van Yarn mag downloaden en installeren. Typ Y en druk op Enter om verder te gaan met de installatie. Na afronding gebruikt Corepack automatisch de gedownloade versie van Yarn en toont het versienummer:

1.22.22

Yarn handmatig installeren of bijwerken via npm

Zie je de Corepack-melding niet, of wil je handmatig Yarn als globale tool installeren of updaten, gebruik dan het volgende commando:

npm install -g yarn

Hiermee wordt Yarn wereldwijd geïnstalleerd of bijgewerkt via de globale npm.

Controleer na installatie of update opnieuw het versienummer om zeker te zijn dat alles succesvol is verlopen:

yarn -v

Met deze stappen weet je zeker dat Yarn correct geïnstalleerd en up-to-date is. Je kunt het nu gebruiken om Node.js-projecten te beheren binnen ServBay.

Voordelen en kerngebruik van Yarn

Belangrijkste voordelen van Yarn zijn de snelle pakketinstallatie, sterke offline mogelijkheden en betrouwbare afhankelijkheidsresolutie. Deze kerncommando’s zijn het belangrijkst:

Een nieuw project initialiseren

Initialiseer met Yarn een nieuw Node.js-project in de hoofdmap van je project en maak het bestand package.json aan:

yarn init

Dit begeleidt je door het invullen van projecteigenschappen en genereert uiteindelijk een package.json.

Afhankelijkheden van een project installeren

Installeer alle vermeldde afhankelijkheden uit het package.json-bestand in de projectmap:

yarn install

Hiermee worden op basis van package.json en yarn.lock alle noodzakelijke pakketten in de node_modules-map geplaatst.

Nieuwe afhankelijkheden toevoegen

Voeg een nieuwe productie-afhankelijkheid toe (komt in dependencies):

yarn add lodash

Voeg een nieuwe ontwikkelafhankelijkheid toe (komt in devDependencies):

yarn add --dev jest

Voeg een globaal beschikbare afhankelijkheid toe (gebruik liever npx of globale tools, wordt meestal afgeraden):

yarn global add <package-name>

Afhankelijkheden verwijderen

Verwijder een afhankelijkheid uit het project:

yarn remove lodash

Dit verwijdert het lodash-pakket en werkt zowel package.json als yarn.lock bij.

Projectafhankelijkheden bijwerken

Werk alle afhankelijkheden bij tot de nieuwste versie die overeenkomt met de specificaties uit je package.json:

yarn upgrade

Wil je updaten naar de allernieuwste major, minor of patch-versies, gebruik dan bijvoorbeeld yarn upgrade --latest of een tool als yarn-upgrade-all.

Projectscripts uitvoeren

Yarn laat je zelf scripts definiëren in het "scripts"-veld van je package.json. Hiermee voer je eenvoudig specifieke taken uit, zoals het starten van de ontwikkelserver, tests draaien, of je project bouwen.

Bijvoorbeeld, volgende scripts in package.json:

"scripts": {
  "start": "node app.js",
  "test": "jest",
  "build": "webpack --config webpack.config.js"
}

Voer deze scripts uit met de volgende commando’s:

yarn start
yarn test
yarn build

Andere veelgebruikte Yarn-commando’s

• Globale pakketten installeren:

  yarn global add <package-name>

  Bijvoorbeeld, installeer de globale create-react-app generator:

  yarn global add create-react-app

• Globale pakketten weergeven:

  yarn global list

• Cache opschonen: Yarn slaat gedownloade pakketten in cache op voor snellere herinstallatie. Bij cacheproblemen kun je deze schoonmaken:

  yarn cache clean

  In Yarn v2 of nieuwer kunnen de cache-opruimcommando’s verschillen; raadpleeg dan de documentatie van jouw versie.

Samenvatting

Door Yarn juist te installeren en gebruiken binnen de Node.js-omgeving van ServBay, kun je als ontwikkelaar je afhankelijkheidsbeheer sneller en betrouwbaarder maken. Of je nu een nieuw project opzet, afhankelijkheden installeert of bijwerkt, of custom scripts draait: Yarn biedt een vlotte en stabiele workflow – onmisbaar voor moderne Node.js-ontwikkeling. Dankzij de gemak van ServBay gecombineerd met de krachtige features van Yarn, loopt jouw lokale ontwikkelproces soepeler dan ooit.