كيفية تثبيت Yarn على أوبونتو

Yarn هو مدير حزم JavaScript شائع يتيح لك تثبيت وإدارة حزم وتوابع JavaScript بسهولة لمشاريعك. في هذا الدليل الشامل، سأقوم بقيادتك خلال العملية الكاملة لتثبيت Yarn على أوبونتو. سأغطي تثبيت Yarn من خلال كل من مدير الحزم APT والتنزيلات المباشرة، واستكشاف الأخطاء وأفضل الممارسات للحفاظ على Yarn محدّثًا.

مقدمة عن Yarn

تم إنشاء Yarn من قبل فيسبوك في عام 2016 كبديل لمدير الحزم npm لـ Node.js. يهدف إلى توفير أداء وموثوقية أفضل من npm. بعض الميزات والفوائد الرئيسية لـ Yarn:

• تثبيتات أسرع وأكثر موثوقية – يقوم Yarn بتخزين كل حزمة يقوم بتنزيلها حتى لا يحتاج أبدًا إلى تنزيل نفس الحزمة مرة أخرى. يحسن هذا أوقات التثبيت بشكل كبير. كما يستخدم الموازاة لتعظيم استخدام الموارد أثناء التثبيتات.
• الوضع دون اتصال – إذا قمت بتثبيت حزمة من قبل، سيستخدم Yarn الإصدار المخزن مما يتيح لك الاستمرار في العمل دون اتصال.
• تثبيتات ثابتة – يستخدم Yarn ملفات تأمين وخوارزمية حتمية لضمان أن يؤدي التثبيت إلى نفس هيكل الملفات عبر جميع الأجهزة.
• آمن – يثبّت Yarn الحزم بأمان بشكل افتراضي مع HTTPS والتحقق التشفيري.
• متوافق مع npm – لا يزال Yarn يستخدم نفس هيكل package.json الخاص بـ npm ويمكنه العمل بسلاسة مع حزم npm المثبتة. ستعمل معظم أوامر npm لا تزال مع Yarn.

يوفر Yarn مدير حزم أداءً وموثوقيةً وأمانًا لمشاريع JavaScript. إنه اختيار رائع لإدارة التوابع عند بناء تطبيقات Node.js.

المتطلبات الأساسية

قبل تثبيت Yarn، ستحتاج إلى:

• أوبونتو 18.04 أو أعلى. يجب أن تعمل هذه التعليمات على أي إصدار حديث.
• حساب مستخدم غير جذري بامتيازات sudo.
• Node.js 10 أو أعلى.
• npm مثبّت. يأتي مثبتاً مسبقًا مع Node.js عادةً.

يمكنك التحقق من هذه المتطلبات الأساسية عن طريق تشغيل:

$ lsb_release -a

سيعرض هذا إصدار أوبونتو الخاص بك.

$ node -v 

للتحقق من إصدار Node.js الخاص بك.

$ npm -v

لإصدار npm الخاص بك.

إذا كنت بحاجة إلى تثبيت أو ترقية Node.js و npm، فإن أسهل طريقة هي استخدام أرشيفات حزم NodeSource. يمكنك تثبيت آخر إصدار LTS لـ Node.js باستخدام:

$ curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs 

مع استيفاء المتطلبات الأساسية، يمكننا الآن تثبيت Yarn.

تثبيت Yarn عبر APT

الطريقة الموصى بها لتثبيت Yarn على أوبونتو هي استخدام مدير الحزم APT. يتم تضمين Yarn في مستودعات أوبونتو الافتراضية ابتداءً من أوبونتو 18.04.

لتثبيت Yarn:

$ sudo apt update
$ sudo apt install yarn

سيقوم هذا بتثبيت آخر إصدار مستقر من Yarn من مستودعات الحزم.

تحقق من تثبيته بشكل صحيح:

$ yarn --version

إذا عرض رقم الإصدار، فقد تم تثبيت Yarn بنجاح.

استخدام التنزيلات المباشرة

يمكن أيضًا تثبيت Yarn عبر التنزيلات المباشرة من موقعهم الرسمي. يتيح لك هذا تثبيت إصدارات محددة.

أولاً، قم بتنزيل ملف .deb لإصدار أوبونتو الخاص بك:

$ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
$ sudo apt update
$ sudo apt install yarn

أو لإصدار محدد:

$ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
$ sudo apt update
$ sudo apt install yarn=1.22.19-1

سيتيح لك هذا تثبيت إصدار Yarn معين مثل 1.22.19 بدلاً من آخر إصدار فقط.

تحقق من تثبيته بشكل صحيح:

$ yarn --version

تعطيك التنزيلات المباشرة المزيد من التحكم في الإصدار الذي تقوم بتثبيته.

تثبيتات عامة مقابل محلية

افتراضيًا، يتم تثبيت Yarn على مستوى النظام بأكمله. يتيح لك هذا تشغيل الأمر yarn في أي مكان لإدارة حزم JavaScript.

يمكن أيضًا تثبيت Yarn محليًا داخل دلائل المشروع المحددة. يتيح لك هذا استخدام إصدارات Yarn مختلفة لمشاريع مختلفة.

لتثبيت Yarn محليًا، قم بتشغيل:

$ npm install --global yarn

داخل دليل المشروع. الآن سيكون لهذا المشروع فقط إمكانية الوصول إلى أمر yarn.

إن التثبيت العام أكثر ملاءمة ويُنصح به في معظم السيناريوهات. ولكن التثبيت المحلي يمنحك المزيد من التحكم في المشاريع الفردية.

تعيين دليل ذاكرة التخزين المؤقت لـ Yarn

افتراضيًا، يقوم Yarn بتخزين ذاكرة التخزين المؤقت للحزم على مستوى النظام بأكمله في ~/.cache/yarn. يمكن أن يستهلك هذا تدريجيًا مساحة القرص مع مرور الوقت مع تثبيت المزيد من الحزم.

إذا كنت تريد تغيير موقع ذاكرة التخزين المؤقت، يمكنك استخدام الأمر yarn config:

$ yarn config set cache-folder /new/cache/folder

سينقل هذا ذاكرة التخزين المؤقت إلى دليل جديد مثل /opt/yarn/cache أو إلى أقسام أخرى بمساحة تخزين أكبر.

يمكنك التحقق من المجلد الجديد لذاكرة التخزين المؤقت عن طريق التحقق من الإعداد:

$ yarn config get cache-folder 

يمكن أن يساعد تعيين دليل ذاكرة تخزين مؤقت مخصص في إدارة استخدام مساحة القرص.

أوامر Yarn الأساسية

الآن بعد تثبيت Yarn، يمكنك البدء في استخدامه لإدارة حزم JavaScript. وتشمل بعض الأوامر الشائعة:

• yarn init – يُنشئ مشروعًا جديدًا بما في ذلك ملف package.json.
• yarn install – يثبّت كل التوابع لمشروع بناءً على package.json.
• yarn add [package] – يضيف حزمة جديدة للاستخدام في المشروع.
• yarn remove [package] – يزيل حزمة موجودة من المشروع.
• yarn upgrade [package] – يرقّى حزمة مثبّتة إلى أحدث إصدار.
• yarn why [package] – يُظهر لماذا تم تثبيت حزمة ما وأي حزمة أخرى تعتمد عليها.
• yarn run – يشغّل سكريبت مُعرّف من package.json.

لبدء استخدام Yarn لمشروع جديد:

$ yarn init
$ yarn install

سيقوم هذا بتهيئة المشروع وتثبيت التوابع الحالية. ثم يمكنك بدء إضافة حزم إضافية حسب الحاجة.

راجع وثائق واجهة سطر الأوامر لـ Yarn للمزيد من تفاصيل الاستخدام.

ترقية Yarn

عند إصدار إصدارات جديدة من Yarn، قد ترغب في الترقية إلى آخر إصدار لإصلاح الأخطاء والميزات الجديدة.

إذا قمت بتثبيت Yarn باستخدام APT، قم بتشغيل:

$ sudo apt update
$ sudo apt install yarn

سيقوم هذا بترقية Yarn إلى آخر إصدار في المستودعات.

بالنسبة للتنزيلات المباشرة، أعد تثبيت ملف .deb للإصدار الجديد:

$ sudo apt install yarn=الإصدار_الجديد_هنا

يمكنك العثور على أحدث إصدار على موقع Yarn.

ستضمن ترقية Yarn الحصول على آخر إصلاحات الأخطاء والميزات. تحقق من ملاحظات الإصدار عند الترقية.

استكشاف المشاكل وإصلاحها

فيما يلي بعض المشاكل الشائعة والحلول عند تثبيت Yarn:

الأمر غير موجود – إذا أعاد أمر yarn “الأمر غير موجود”، تأكد من تثبيت Yarn ووجود ~/.npm-global/bin في متغير بيئة PATH.

أخطاء الصلاحيات – استخدم sudo عند التثبيت العام لـ Yarn. لا تشغل أمر yarn باستخدام sudo.

إصدار Node.js قديم – تأكد من تثبيت Node.js 10+ . قد لا تكون الإصدارات الأقل متوافقة.

فشل تثبيت الحزمة – تحقق من الشبكة وأي وكلاء. حاول تثبيت الحزمة يدويًا باستخدام npm بدلاً من ذلك.

تعذّر ترقية Yarn – قد يكون إصدار Yarn الحالي قديمًا جدًا بحيث لا يمكن ترقيته مباشرةً. حاول إزالة .yarnclean و ~/.cache/yarn ثم إعادة التثبيت.

لأي مشاكل أخرى، راجع دليل استكشاف الأخطاء وإصلاحها لـ Yarn. منتديات مجتمع Yarn أيضًا مكان جيد للعثور على حلول.

مع تغطية الأساسيات في هذا الدليل، يجب أن تتمكن من تثبيت وتهيئة واستخدام Yarn بنجاح لمشاريع JavaScript الخاصة بك على أوبونتو.

خلاصة

Yarn أداة قيّمة لمطوري واجهات الويب لإدارة توابع وحزم JavaScript بكفاءة. تعلّم كيفية تثبيت Yarn وتهيئته وترقيته بشكل صحيح يساعد على الاستفادة الكاملة من إمكاناته.

النقاط الرئيسية المشمولة في هذا الدليل:

• تثبيت Yarn عبر APT والتنزيلات المباشرة على أوبونتو
• التثبيتات العامة مقابل المحلية لإدارة الإصدارات
• تعيين موقع دليل ذاكرة التخزين المؤقت المخصص
• أوامر Yarn الأساسية للاستخدام اليومي
• ترقية Yarn إلى أحدث الإصدارات
• استكشاف المشاكل الشائعة وإصلاحها
• اتباع أفضل الممارسات للاستقرار والأداء

مع ضبط Yarn بشكل صحيح، يمكنك الاستفادة من:

• تثبيتات أسرع وأكثر موثوقية
• الوضع دون اتصال
• أمان محسّن

بالجمع بين معرفة واجهة سطر الأوامر لـ Yarn وأفضل الممارسات، يمكن