import Update from "/snippets/cli/update.mdx";

NOTE

لترقية إصدار Bun CLI الخاص بك، راجع [`bun upgrade`](/ar/installation#upgrading).

لتحديث جميع التبعيات إلى أحدث إصدار:

bun update

لتحديث تبعية محددة إلى أحدث إصدار:

bun update [package]

--interactive

لتجربة تحديث أكثر تحكمًا، استخدم علامة --interactive لتحديد الحزم التي تريد تحديثها:

bun update --interactive
bun update -i

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

الواجهة التفاعلية

تعرض الواجهة الحزم المجمعة حسب نوع التبعية:

? Select packages to update - Space to toggle, Enter to confirm, a to select all, n to select none, i to invert, l to toggle latest

  dependencies                Current  Target   Latest
    □ react                   17.0.2   18.2.0   18.3.1
    □ lodash                  4.17.20  4.17.21  4.17.21

  devDependencies             Current  Target   Latest
    □ typescript              4.8.0    5.0.0    5.3.3
    □ @types/node             16.11.7  18.0.0   20.11.5

  optionalDependencies        Current  Target   Latest
    □ some-optional-package   1.0.0    1.1.0    1.2.0

الأقسام:

• يتم تجميع الحزم تحت عناوين أقسام: dependencies و devDependencies و peerDependencies و optionalDependencies
• يعرض كل قسم رؤوس أعمدة محاذاة مع بيانات الحزمة

الأعمدة:

• Package: اسم الحزمة (قد يكون له لاحقة مثل dev أو peer أو optional للوضوح)
• Current: الإصدار المثبت حاليًا
• Target: الإصدار الذي سيتم تثبيته (يحترم قيود semver)
• Latest: أحدث إصدار متاح

عناصر التحكم بلوحة المفاتيح

التحديد:

• Space: تبديل تحديد الحزمة
• Enter: تأكيد التحديدات والتحديث
• a/A: تحديد جميع الحزم
• n/N: إلغاء تحديد الكل
• i/I: عكس التحديد

التنقل:

• ↑/↓ مفاتيح الأسهم أو j/k: تحريك المؤشر
• l/L: التبديل بين الإصدار المستهدف وأحدث إصدار للحزمة الحالية

الخروج:

• Ctrl+C أو Ctrl+D: إلغاء دون تحديث

المؤشرات المرئية

• ☑ الحزم المحددة (سيتم تحديثها)
• □ الحزم غير المحددة
• > موضع المؤشر الحالي
• الألوان: أحمر (رئيسي)، أصفر (ثانوي)، أخضر (تصحيح) لتغييرات الإصدار
• تحته خط: هدف التحديث المحدد حاليًا

تجميع الحزم

يتم تنظيم الحزم في أقسام حسب نوع التبعية:

• dependencies - تبعيات وقت التشغيل العادية
• devDependencies - تبعيات التطوير
• peerDependencies - تبعيات النظير
• optionalDependencies - التبعيات الاختيارية

ضمن كل قسم، قد تحتوي الحزم الفردية على لواحق إضافية ( dev أو peer أو optional) لمزيد من الوضوح.

--recursive

استخدم علامة --recursive مع --interactive لتحديث التبعيات عبر جميع مساحات العمل في monorepo:

bun update --interactive --recursive
bun update -i -r

يعرض هذا عمود "Workspace" إضافيًا يوضح مساحة العمل التي تنتمي إليها كل تبعية.

--latest

بشكل افتراضي، سيقوم bun update بالتحديث إلى أحدث إصدار من التبعية يلبي نطاق الإصدار المحدد في package.json الخاص بك.

للتحديث إلى أحدث إصدار، بغض النظر عما إذا كان متوافقًا مع نطاق الإصدار الحالي، استخدم علامة --latest:

bun update --latest

في الوضع التفاعلي، يمكنك تبديل الحزم الفردية بين إصدارها المستهدف (مع احترام semver) وأحدث إصدار باستخدام مفتاح l.

على سبيل المثال، مع package.json التالي:

{
  "dependencies": {
    "react": "^17.0.2"
  }
}

• bun update سيحدث إلى إصدار يطابق 17.x.
• bun update --latest سيحدث إلى إصدار يطابق 18.x أو أحدث.

---