نحوه نصب و استفاده از Yarn Package Manager برای Node.js

مقدمه

Yarn یک مدیریت بسته برای Node.js است که بر سرعت، امنیت و ثبات تمرکز دارد. در ابتدا برای رفع برخی مشکلات با مدیر بسته محبوب NPM ایجاد شد. اگرچه دو مدیر بسته از آن زمان از نظر عملکرد و ویژگی‌ها به هم نزدیک شده‌اند، Yarn همچنان محبوب است، به ویژه در دنیای توسعه React.

برخی از ویژگی های منحصر به فرد Yarn عبارتند از:

  • مکانیزم ذخیره سازی در هر پروژه، که می تواند سرعت نصب و ساخت بعدی را تا حد زیادی افزایش دهد.
  • نصب های ثابت و قطعی که ساختار کتابخانه های نصب شده را تضمین می کند همیشه یکسان است.
  • آزمایش جمع‌بندی تمام بسته‌ها برای تأیید صحت آنها
  • “Workspaces” که استفاده از Yarn را در monorepo تسهیل می کند (چند پروژه توسعه یافته در یک مخزن کد منبع واحد).

در این آموزش، Yarn را به صورت سراسری نصب می کنید، Yarn را به یک پروژه خاص اضافه می کنید و برخی از دستورات اولیه Yarn را یاد می گیرید.

پیش نیازها

قبل از نصب و استفاده از Yarn Package Manager، باید Node.js را نصب کرده باشید. برای اینکه ببینید آیا Node.js را قبلاً نصب کرده اید، دستور زیر را در ترمینال خط فرمان محلی خود تایپ کنید:

node -v

اگر شماره نسخه مانند v12.16.3 چاپ شده را مشاهده کردید، Node.js را نصب کرده اید. اگر با خطای command not found (یا عبارتی مشابه) مواجه شدید، لطفاً قبل از ادامه Node.js را نصب کنید.

مرحله 1 – نصب جهانی YARN

Yarn یک روش منحصر به فرد برای نصب و اجرای خود در پروژه های جاوا اسکریپت شما دارد. ابتدا دستور yarn را به صورت سراسری نصب می‌کنید، سپس از دستور global yarn برای نصب یک نسخه محلی خاص از Yarn در فهرست پروژه خود استفاده می‌کنید. این برای اطمینان از اینکه همه افرادی که روی یک پروژه کار می کنند (و تمام ابزارهای آزمایش و استقرار خودکار پروژه) از همان نسخه نخ استفاده می کنند، لازم است تا از رفتارها و نتایج ناسازگار جلوگیری شود.

نگهدارندگان Yarn توصیه می کنند که Yarn را به صورت سراسری با استفاده از مدیر بسته NPM نصب کنید، که به طور پیش فرض در تمام نصب های Node.js وجود دارد. برای انجام این کار از flag -g با نصب npm استفاده کنید:

sudo npm install -g yarn

پس از نصب بسته، دستور yarn را بخواهید که شماره نسخه خود را چاپ کند. این به شما امکان می دهد تأیید کنید که به درستی نصب شده است:

yarn --version
Output
1.22.11

اکنون که دستور yarn را به صورت سراسری نصب کرده اید، می توانید از آن برای نصب Yarn در یک پروژه جاوا اسکریپت خاص استفاده کنید.

مرحله 2 – نصب نخ در پروژه شما

اگر از Yarn برای کار با یک پروژه موجود مبتنی بر Yarn استفاده می کنید، می توانید از این مرحله صرف نظر کنید. پروژه از قبل باید با نسخه محلی Yarn و تمام فایل های پیکربندی لازم برای استفاده از آن تنظیم شده باشد.

اگر پروژه جدیدی را برای خود راه‌اندازی می‌کنید، اکنون می‌خواهید یک نسخه پروژه خاص از Yarn را پیکربندی کنید.

ابتدا به دایرکتوری پروژه خود بروید:

cd ~/my-project

اگر دایرکتوری پروژه ندارید، می توانید یک پوشه جدید با mkdir بسازید و سپس وارد آن شوید:

mkdir my-project
cd my-project

اکنون از دستور yarn set برای تنظیم نسخه بری استفاده کنید:

yarn set version berry

با این کار نسخه فعلی و توسعه‌یافته Yarn – berry – دانلود می‌شود – آن را در یک فهرست .yarn/releases/ در پروژه شما ذخیره می‌کند و یک فایل پیکربندی .yarnrc.yml را نیز تنظیم می‌کند:

Output
Resolving 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!

حالا دوباره دستور yarn –version را امتحان کنید:

yarn --version
Output
3.0.0

خواهید دید که نسخه 3.0.0 یا بالاتر است. این آخرین نسخه از Yarn است.

پروژه شما اکنون با یک نسخه پروژه خاص از Yarn تنظیم شده است. در مرحله بعد، ما به چند دستور پرکاربرد نخ برای شروع نگاه خواهیم کرد.

استفاده از Yarn

Yarn دستورات فرعی زیادی دارد، اما برای شروع فقط به تعدادی نیاز دارید. بیایید به اولین دستورات فرعی که می خواهید استفاده کنید نگاه کنیم.

هنگام شروع با هر ابزار جدیدی، یادگیری نحوه دسترسی به کمک آنلاین آن مفید است. در Yarn می توان پرچم –help را به هر دستوری اضافه کرد تا اطلاعات بیشتری به دست آورد:

yarn --help

با این کار کمک کلی برای دستور yarn چاپ می شود. برای دریافت اطلاعات دقیق تر در مورد یک دستور فرعی، پس از دستور فرعی –help را اضافه کنید:

yarn install --help

با این کار جزئیات مربوط به نحوه استفاده از دستور نصب yarn چاپ می شود.

شروع یک پروژه جدید YARN

اگر پروژه ای را از ابتدا شروع می کنید، از دستور فرعی init برای ایجاد فایل های مخصوص Yarn که نیاز دارید استفاده کنید:

yarn init

با این کار یک فایل پیکربندی package.json و یک فایل yarn.lock به دایرکتوری شما اضافه می شود. package.json شامل پیکربندی و لیست وابستگی های ماژول شما است. فایل yarn.lock آن وابستگی‌ها را به نسخه‌های خاصی قفل می‌کند و مطمئن می‌شود که درخت وابستگی همیشه سازگار است.

نصب تمام وابستگی های یک پروژه

برای دانلود و نصب تمام وابستگی ها در یک پروژه موجود مبتنی بر Yarn، از دستور فرعی install استفاده کنید:

yarn install

با این کار ماژول هایی که برای شروع نیاز دارید دانلود و نصب می شود.

افزودن یک وابستگی جدید به یک پروژه

از دستور فرعی add برای افزودن وابستگی های جدید به پروژه استفاده کنید:

yarn add package-name

این ماژول را دانلود، نصب می کند و فایل های package.json و yarn.lock شما را به روز می کند.

در حال به‌روزرسانی فایل .gitignore برای Yarn

Yarn فایل ها را در یک پوشه .yarn در دایرکتوری پروژه شما ذخیره می کند. برخی از این فایل ها باید در کنترل نسخه بررسی شوند و برخی دیگر باید نادیده گرفته شوند. پیکربندی اصلی .gitignore برای Yarn به شرح زیر است:

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

این کار کل فهرست yarn. را نادیده می‌گیرد و سپس برخی استثناها را برای پوشه‌های مهم اضافه می‌کند، از جمله دایرکتوری releases که حاوی نسخه پروژه خاص شما از Yarn است.

برای جزئیات بیشتر در مورد نحوه پیکربندی Git و Yarn، لطفاً به مستندات رسمی Yarn در .gitignore مراجعه کنید.

نتیجه

در این آموزش Yarn را نصب کردید و با چند دستور فرعی yarn آشنا شدید. برای اطلاعات بیشتر در مورد استفاده از نخ، به مستندات رسمی Yarn CLI نگاهی بیندازید.

[تعداد: 1   میانگین: 5/5]
دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

شاید دوست داشته باشید