استخدام CLI لـ bun publish

bun publish dist

خيارات النشر

--accessstring

يمكن استخدام الراية `--access` لتعيين مستوى وصول الحزمة التي يتم نشرها. يمكن أن يكون مستوى الوصول واحدًا من `public` أو `restricted`. الحزم غير المقيدة تكون دائمًا عامة، ومحاولة نشر حزمة غير مقيدة مع `--access restricted` ستؤدي إلى خطأ.

bun publish --access public

يمكن أيضًا تعيين --access في حقل publishConfig في package.json الخاص بك.

{
  "publishConfig": {
    "access": "restricted"
  }
}

--tagstring default: latest

تعيين علامة إصدار الحزمة التي يتم نشرها. افتراضيًا، العلامة هي `latest`. الإصدار الأولي للحزمة يُعطى دائمًا علامة `latest` بالإضافة إلى العلامة المحددة.

bun publish --tag alpha

يمكن أيضًا تعيين --tag في حقل publishConfig في package.json الخاص بك.

{
  "publishConfig": {
    "tag": "next"
  }
}

--dry-run=<val>string

يمكن استخدام الراية `--dry-run` لمحاكاة عملية النشر دون نشر الحزمة فعليًا. هذا مفيد للتحقق من محتويات الحزمة المنشورة دون نشر الحزمة فعليًا.

bun publish --dry-run

--gzip-levelstring default: 9

تحديد مستوى ضغط gzip المستخدم عند تعبئة الحزمة. ينطبق فقط على `bun publish` بدون وسيط مسار tarball. تتراوح القيم من `0` إلى `9` (الافتراضي هو `9`).

--auth-typestring default: web

إذا كان لديك مصادقة ثنائية مفعلة لحساب npm الخاص بك، فسيطلب منك bun publish كلمة مرور لمرة واحدة. يمكن القيام بذلك من خلال المتصفح أو CLI. يمكن استخدام الراية --auth-type لإخبار سجل npm بالطريقة التي تفضلها. القيم الممكنة هي web و legacy، مع web كافتراضي.

bun publish --auth-type legacy
...
تتطلب هذه العملية كلمة مرور لمرة واحدة.
أدخل OTP: 123456
...

--otpstring default: web

تقديم كلمة مرور لمرة واحدة مباشرة إلى CLI. إذا كانت كلمة المرور صالحة، فسيتم تخطي المطالبة الإضافية لكلمة المرور لمرة واحدة قبل النشر. مثال على الاستخدام:

bun publish --otp 123456

NOTE

يحترم `bun publish` متغير البيئة `NPM_CONFIG_TOKEN` الذي يمكن استخدامه عند النشر في GitHub Actions أو سير العمل الآلي.

تكوين السجل

سجل مخصص

--registrystring

تحديد عنوان URL للسجل، متجاوزًا .npmrc و bunfig.toml

bun publish --registry https://my-private-registry.com

شهادات SSL

--castring

تقديم شهادة توقيع سلطة شهادة

--cafilestring

مسار ملف شهادة سلطة شهادة

bun publish --ca "-----BEGIN CERTIFICATE-----..."

bun publish --cafile ./ca-cert.pem

خيارات النشر

إدارة التبعيات

-p, --productionboolean

عدم تثبيت تبعيات التطوير

--omitstring

استبعاد أنواع التبعيات: `dev` أو `optional` أو `peer`

-f, --forceboolean

طلب أحدث الإصدارات دائمًا من السجل وإعادة تثبيت جميع التبعيات

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

--ignore-scriptsboolean

تخطي نصوص دورة الحياة أثناء التعبئة والنشر

--trustboolean

إضافة الحزم إلى trustedDependencies وتشغيل نصوصها البرمجية

NOTE

**نصوص دورة الحياة** — عند تقديم tarball مُجهز مسبقًا، لا يتم تنفيذ نصوص دورة الحياة (prepublishOnly و prepack وما إلى ذلك). يتم تشغيل النصوص البرمجية فقط عندما يقوم Bun بتعبئة الحزمة بنفسه.

إدارة الملفات

--no-saveboolean

عدم تحديث package.json أو ملف القفل

--frozen-lockfileboolean

منع التغييرات على ملف القفل

--yarnboolean

إنشاء ملف yarn.lock (متوافق مع yarn v1)

الأداء

--backendstring

تحسينات المنصة: `clonefile` (الافتراضي) أو `hardlink` أو `symlink` أو `copyfile`

--network-concurrencynumber default: 48

الحد الأقصى للطلبات المتزامنة عبر الشبكة

--concurrent-scriptsnumber default: 5

الحد الأقصى لنصوص دورة الحياة المتزامنة

التحكم في الإخراج

--silentboolean

كتم جميع الإخراجات

--verboseboolean

إظهار التسجيل المفصل

--no-progressboolean

إخفاء شريط التقدم

--no-summaryboolean

عدم طباعة ملخص النشر