
Andrew Hanna

Andrew Hanna

الأمر sf package version create يبني إصدارًا جديدًا قابلًا للتثبيت من
حزمة unlocked أو managed من الجيل الثاني داخل الـ Dev Hub، انطلاقًا من البيانات
الوصفية في مشروعك. شغّله مع --code-coverage وبدون
--skip-validation لو ناوي تعمل promote للإصدار ده في يوم من الأيام، وإلا
سيبقى إصدار beta لن يصل إلى الإنتاج أبدًا.
يأخذ الأمر محتويات الحزمة من مجلد، أو اسم مستعار للحزمة أو معرّف 0Ho، وينشئ إصدار حزمة
في الـ Dev Hub، كما يوضح
مرجع Salesforce CLI. كل إصدار يحصل على معرّف فريد لإصدار حزمة المشترك يبدأ بـ 04t. وعندما ينتهي الأمر
خلال وقت الانتظار، يكتب الـ CLI اسمًا مستعارًا جديدًا مثل
[email protected] في قسم packageAliases داخل
sfdx-project.json.
الإصدارات الجديدة تبدأ كـ beta. إصدارات beta تُثبَّت في الـ scratch orgs والـ sandboxes لكن ليس في الإنتاج، بينما الإصدارات المُرقّاة والمنشورة تُثبَّت في أي org، كما توضح وحدة Trailhead عن الحزم unlocked.
--target-dev-hub.
sf package create ومربوطة بمعرّف 0Ho الخاص بها في
packageAliases.
versionName وversionNumber. استخدام الكلمة
NEXT، مثل 1.0.0.NEXT، يخلّي رقم البناء يزيد تلقائيًا.
لسه بتختار نوع الحزمة؟ مقال أسرار حزم Salesforce المُدارة من الجيل الثاني يشرح الموازنات، ولو ورثت حزمة قديمة، فمقال الحزم غير المُدارة وكيف تنتقل منها يوضح طريق الخروج.
sfdx-project.json، اضبط
versionNumber على قيمة مثل 1.2.0.NEXT.
sf package version create --package MyPkg --installation-key-bypass
--code-coverage --wait 30. لازم تمرّر إما --installation-key أو
--installation-key-bypass.
sf package version create report --package-create-request-id 08c...
لمعرفة الحالة وأي أخطاء ومعرّف 04t.
sf package install --package [email protected] --target-org MyScratchOrg --wait
10.
sf package version promote --package [email protected]. الترقية لا يمكن
التراجع عنها.
--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. ابنِه من جديد
بدونه.
--code-coverage. التغطية لا تُحسب للحزم unlocked المعتمدة على الـ
org.
قسّمه إلى مسارين. على فروع الميزات، --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 إلى التسليم المستمر.
ما الفرق بين 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.
بدون التزام.