כיצד להתקין ולהשתמש במנהל החבילות Yarn עבור Node.js

הקדמה

Yarn הוא מנהל חבילות עבור Node.js שמתמקד במהירות, אבטחה ועקביות. הוא נוצר במקור כדי לטפל בכמה בעיות במנהל החבילות הפופולרי NPM. למרות ששני מנהלי החבילות התקרבו מאז מבחינת ביצועים ותכונות, Yarn נשאר פופולרי, בעיקר בעולם הפיתוח של React.

כמה מתכונותיו הייחודיות של Yarn הם:

• A per-project caching mechanism, that can greatly speed up subsequent installs and builds
• התקנות עקביות ודטרמיניסטיות שמבטיחות שמבנה הספריות שהותקנו תמיד יהיה זהה
• בדיקת אבטחה של כל החבילות כדי לוודא את תקינותן
• "Workspaces", שמקלים על שימוש ב-Yarn במונוריפו (פרויקטים מרובים שפותחים במאגר קוד מקור אחד)

במדריך זה, תתקין את Yarn באופן גלובלי, תוסיף את Yarn לפרויקט מסוים, ותלמד כמה פקודות בסיסיות של Yarn.

התקנה ושימוש במנהל החבילות Yarn עבור Node.js

1. התקנת Yarn באופן גלובלי
2. התקנת Yarn בפרויקט שלך
3. שימוש ב־Yarn

דרישות מראש

לפני התקנה ושימוש במנהל החבילות Yarn, יש לוודא שיש לך מותקן את Node.js. כדי לראות האם כבר קיימת התקנה של Node.js, הקלד את הפקודה הבאה בטרמינל המקומי שלך:

node -v

אם אתה רואה מספר גרסה, כגון v12.16.3, יודפס, יש לך Node.js מותקן. אם אתה מקבל שגיאת command not found (או תיאור דומה), יש להתקין את Node.js לפני המשך.

להתקין את Node.js, עקוב אחר המדריך שלנו עבור Ubuntu, Debian, CentOS, או macOS.

לאחר שתקינו את Node.js, המשיכו לשלב 1 כדי להתקין את מנהל החבילות Yarn.

שלב 1 — התקנת Yarn באופן גלובלי

Yarn מציע דרך ייחודית להתקנה והפעלה של עצמו בפרויקטי JavaScript שלך. תחילה, עליך להתקין את הפקודה yarn באופן גלובלי, ואז להשתמש בפקודה הגלובלית yarn כדי להתקין גרסה מקומית מסוימת של Yarn לתיקיית הפרויקט שלך. זה נחוץ כדי לוודא שכולם שעובדים על פרויקט (וכל כלי הבדיקה וההפצה האוטומטיים של הפרויקט) רצים על אותה גרסת yarn, כדי למנוע התנהגויות ותוצאות לא עקביות. יוצרי Yarn ממליצים על התקנת Yarn באופן גלובלי באמצעות מנהל החבילות NPM, שכל התקנות של Node.js כוללים אותו כברירת מחדל. השתמש בדגל -g עם npm install כדי לעשות זאת:

מנהלי ה-Yarn ממליצים להתקין את Yarn באופן גלובלי באמצעות מנהל החבילות NPM, שמכונה כברירת מחדל עם כל התקנות Node.js. השתמש בתו דגל -g עם npm install כדי לבצע זאת:

sudo npm install -g yarn

לאחר התקן החבילה, הפעל את הפקודה yarn כדי להדפיס את מספר גרסתו. זה יאשר שהתקנה נכונה:

yarn --version

Output
1.22.11

עכשיו, כשיש לך את הפקודה yarn מותקנת באופן גלובלי, אפשר להשתמש בה כדי להתקין את Yarn בפרויקט JavaScript ספציפי.

שלב 2 – התקנת Yarn בפרויקט שלך

אפשר לדלג על שלב זה אם אתה משתמש ב-Yarn לעבודה עם פרויקט קיים שמבוסס על Yarn. הפרויקט צריך כבר להיות מוגדר עם גרסה מקומית של Yarn וכל קבצי ההתקנה הנדרשים כדי להשתמש בו.

אם אתה מכין פרויקט חדש שלך, כדאי שתכין גרסה ספציפית של Yarn עכשיו.

ראשית, עבור אל תיקיית הפרויקט שלך:

cd ~/my-project

אם אין לך תיקיית פרויקט, אפשר ליצור אחת חדשה עם mkdir ואז לעבור אליה:

mkdir my-project
cd my-project

עכשיו השתמש בפקודה yarn set כדי להגדיר את הגרסה ל-berry:

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 יש מספר רב של תת-פקודות, אך אתה זקוק לכמה כדי להתחיל. בואו נבחן את התת-פקודות הראשונות שתרצה להשתמש בהן.

קבלת עזרה

כשמתחילים עם כל כלי חדש, זה שימושי ללמוד איך לגשת לעזרה מקוונת שלו. ב-Yarn, התאריך --help יכול להוסיף לכל פקודה כדי לקבל מידע נוסף:

yarn --help

זה ידפיס עזרה כוללת עבור הפקודה yarn. כדי לקבל מידע ספציפי יותר על פקודת תת-אזור, הוסף --help אחרי הפקודת התת-אזור:

yarn install --help

זה ידפיס פרטים על איך להשתמש בפקודה yarn install.

פתיחת פרויקט חדש של 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, עיין בתיעוד הפיצ'י של Yarn CLI הרשמי.

לקבלת עזרה נוסף בנוגע ל-Node.js ו-JavaScript, בבקשה פנה לדף התיוג שלנו עבור Node.js ו-JavaScript, שם תמצא מדריכים רלוונטיים, שיחות טכנולוגיה ושאלות ותשובות קהילתיות.