Andrew Hanna

Andrew Hanna

sf package version create: دليل عملي لإصدارات الحزم في Salesforce

sf package version create: دليل عملي لإصدارات الحزم في Salesforce

الأمر sf package version create يبني إصدارًا جديدًا قابلًا للتثبيت من حزمة unlocked أو managed من الجيل الثاني داخل الـ Dev Hub، انطلاقًا من البيانات الوصفية في مشروعك. شغّله مع --code-coverage وبدون --skip-validation لو ناوي تعمل promote للإصدار ده في يوم من الأيام، وإلا سيبقى إصدار beta لن يصل إلى الإنتاج أبدًا.

ماذا يفعل sf package version create؟

يأخذ الأمر محتويات الحزمة من مجلد، أو اسم مستعار للحزمة أو معرّف 0Ho، وينشئ إصدار حزمة في الـ Dev Hub، كما يوضح مرجع Salesforce CLI. كل إصدار يحصل على معرّف فريد لإصدار حزمة المشترك يبدأ بـ 04t. وعندما ينتهي الأمر خلال وقت الانتظار، يكتب الـ CLI اسمًا مستعارًا جديدًا مثل [email protected] في قسم packageAliases داخل sfdx-project.json.

الإصدارات الجديدة تبدأ كـ beta. إصدارات beta تُثبَّت في الـ scratch orgs والـ sandboxes لكن ليس في الإنتاج، بينما الإصدارات المُرقّاة والمنشورة تُثبَّت في أي org، كما توضح وحدة Trailhead عن الحزم unlocked.

ماذا تحتاج قبل التشغيل؟

  • Dev Hub org مضبوط كافتراضي أو مُمرَّر عبر --target-dev-hub.
  • حزمة أُنشئت مرة واحدة باستخدام sf package create ومربوطة بمعرّف 0Ho الخاص بها في packageAliases.
  • مدخل package directory يحتوي على versionName وversionNumber. استخدام الكلمة NEXT، مثل 1.0.0.NEXT، يخلّي رقم البناء يزيد تلقائيًا.

لسه بتختار نوع الحزمة؟ مقال أسرار حزم Salesforce المُدارة من الجيل الثاني يشرح الموازنات، ولو ورثت حزمة قديمة، فمقال الحزم غير المُدارة وكيف تنتقل منها يوضح طريق الخروج.

كيف تنشئ إصدار حزمة خطوة بخطوة؟

  1. حدّد الإصدار. في sfdx-project.json، اضبط versionNumber على قيمة مثل 1.2.0.NEXT.
  2. أنشئ الإصدار. شغّل sf package version create --package MyPkg --installation-key-bypass --code-coverage --wait 30. لازم تمرّر إما --installation-key أو --installation-key-bypass.
  3. تابع الطلب. لو انتهى وقت الانتظار، شغّل sf package version create report --package-create-request-id 08c... لمعرفة الحالة وأي أخطاء ومعرّف 04t.
  4. اختبر الـ beta. ثبّته في scratch org أو sandbox باستخدام sf package install --package [email protected] --target-org MyScratchOrg --wait 10.
  5. رقِّ الإصدار. لما ينجح، شغّل sf package version promote --package [email protected]. الترقية لا يمكن التراجع عنها.

ما أهم خيارات sf package version create؟

  • --code-coverage: يشغّل اختبارات Apex الموجودة في الحزمة ويحفظ نسبة التغطية. ضروري للترقية، والترقية تتطلب 75 بالمئة على الأقل.
  • --skip-validation: يتخطى فحوصات الاعتماديات والإصدار السابق والبيانات الوصفية لتسريع البناء. الإصدارات المبنية بهذه الطريقة لا يمكن ترقيتها، ولا يمكن جمع الخيار مع --code-coverage.
  • --async-validation: يرجّع الإصدار قبل انتهاء التحقق، فيبدأ الاختبار أسرع في الـ CI.
  • --definition-file: ملف بنمط scratch org يحدد الميزات وإعدادات الـ org التي تعتمد عليها البيانات الوصفية.
  • --version-number و--version-name: يتجاوزان قيم sfdx-project.json لتشغيل واحد.
  • --branch و--tag: يسجّلان فرع المصدر ووسمًا على الإصدار.
  • --post-install-script و--uninstall-script: كلاسات Apex تعمل بعد التثبيت أو الترقية أو الإزالة، للحزم المُدارة فقط.

لماذا لا أستطيع ترقية إصدار الحزمة؟

ثلاثة أسباب وراء أغلب حالات فشل الترقية:

  • الإصدار اتبنى بـ --skip-validation. ابنِه من جديد بدونه.
  • التغطية غير موجودة أو أقل من 75 بالمئة. أضف اختبارات وابنِ من جديد مع --code-coverage. التغطية لا تُحسب للحزم unlocked المعتمدة على الـ org.
  • الرقم اتنشر قبل كده. يمكن ترقية إصدار واحد فقط لكل major.minor.patch، فزوّد الرقم وابنِ من جديد.

كيف تشغّل sf package version create في CI؟

قسّمه إلى مسارين. على فروع الميزات، --skip-validation أو --async-validation يخلّي الدورة قصيرة. وعلى فرع الإصدار، ابنِ مع --code-coverage وتحقق كامل، بحيث يكون الإصدار اللي بتختبره هو نفسه اللي تقدر ترقّيه. تابع الحصة اليومية للـ Dev Hub باستخدام sf limits api display وبند PackageVersionCreates، لأن البناء مع كل commit بيستهلكها بسرعة.

تثبيت إصدار beta مفيد فقط بقدر البيانات الموجودة في الـ org الذي يُثبَّت فيه. Serpent يعبّئ بيانات نموذجية أو مُخفاة كجزء من إعداد البيئة ومسارات الإصدار، فترجع الـ scratch orgs والـ sandboxes بعد التحديث ممتلئة بدون سكربت يدوي، ونشر البيانات متاح في كل الخطط، بما فيها خطة Essentials المجانية. راجع أسعار Serpent لمعرفة ما تتضمنه كل خطة.

بعد ترقية الإصدار، ينقله مسار الإصدار على AppExchange إلى ترقيات المشتركين. ولو فريقك لسه بيسلّم بـ change sets، ابدأ الأول بـ دليل الانتقال من change sets إلى التسليم المستمر.

FAQ

ما الفرق بين sf package create وsf package version create؟

sf package create يسجّل الحزمة مرة واحدة باسمها ونوعها. أما sf package version create فيبني كل إصدار قابل للتثبيت منها.

هل يمكن تثبيت إصدار beta في الإنتاج؟

لا. إصدارات beta تُثبَّت في الـ scratch orgs والـ sandboxes. رقِّ الإصدار إلى released قبل تثبيته في الإنتاج.

هل تحتاج الحزم unlocked إلى تغطية كود 75 بالمئة؟

للترقية، نعم. يمكنك بناء beta بدون تغطية، لكنه لن يُنشر أبدًا.

ماذا لو انتهت مهلة sf package version create؟

الطلب يستمر في العمل داخل الـ Dev Hub. تابعه باستخدام sf package version create report ومعرّف الطلب 08c.

المزيد من أدلة الحزم وCI/CD موجود في SF Guides.

مقالات ذات صلة

هل تريد معرفة كيف يمكنكم الشحن أسرع قبل البدء؟ لنتحدث

بدون التزام.