بناء الحزمة

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

تثبيت Salesforce CLI (sf)
المصادقة على مؤسسة Dev Hub
دليل العمل: جذر المشروع

حزمة Beta

بناء Beta جديد

sf package version create \
  --package FlexibleTeamShare \
  --definition-file config/package-scratch-def.json \
  --installation-key-bypass \
  --wait 30 \
  --code-coverage \
  --skip-ancestor-check

بناء Beta (مع كلمة مرور التثبيت)

sf package version create \
  --package FlexibleTeamShare \
  --definition-file config/package-scratch-def.json \
  --installation-key YOUR_PASSWORD \
  --wait 30 \
  --code-coverage \
  --skip-ancestor-check

حزمة الإصدار (المروّجة)

الخطوة 1: سرد الإصدارات الموجودة

sf package version list \
  --packages FlexibleTeamShare \
  --order-by CreatedDate \
  --verbose

الخطوة 2: ترويج beta إلى إصدار

استبدل 04t... بمعرف الإصدار الفعلي من الخطوة 1:

sf package version promote --package 04tXXXXXXXXXXXXXXX

أوامر مفيدة

التحقق من تفاصيل إصدار الحزمة

sf package version list \
  --packages FlexibleTeamShare \
  --order-by CreatedDate \
  --verbose

الحصول على رابط التثبيت

sf package version list \
  --packages FlexibleTeamShare \
  --order-by CreatedDate \
  --verbose --json

ابحث عن SubscriberPackageVersionId (يبدأ بـ 04t).

تنسيق رابط التثبيت:

https://login.salesforce.com/packaging/installPackage.apexp?p0=04tXXXXXXXXXXXXXXX

التحقق من تغطية الكود

sf package version report --package 04tXXXXXXXXXXXXXXX --verbose

حذف إصدار فاشل/غير مرغوب فيه

sf package version delete --package 04tXXXXXXXXXXXXXXX --no-prompt

ترقيم الإصدارات

مكوّن في sfdx-project.json:

الحقل	مثال	الوصف
`versionNumber`	`1.0.0.NEXT`	MAJOR.MINOR.PATCH.BUILD
`NEXT`	auto	يزيد رقم البناء تلقائيًا

زيادة الإصدار يدويًا

عدّل sfdx-project.json:

"versionNumber": "1.1.0.NEXT"

المشاكل الشائعة

”Ancestor version required”

أضف العلم --skip-ancestor-check أو اضبط ancestor في sfdx-project.json.

”Code coverage below 75%”

قم بتشغيل الاختبارات محليًا أولاً:

sf apex run test --code-coverage --result-format human --wait 10

“Translation languages not available”

تأكد من تعيين definitionFile في sfdx-project.json
تأكد من أن config/package-scratch-def.json لديه إصدار Enterprise وجميع إعدادات اللغة الثلاثة:

{
  "orgName": "Package Build Org",
  "edition": "Enterprise",
  "features": ["EnableSetPasswordInApi"],
  "settings": {
    "lightningExperienceSettings": {
      "enableS1DesktopEnabled": true
    },
    "languageSettings": {
      "enableTranslationWorkbench": true,
      "enableEndUserLanguages": true,
      "enablePlatformLanguages": true
    }
  }
}

مرجع سريع

الإجراء	الأمر
بناء beta	`sf package version create --package FlexibleTeamShare --definition-file config/package-scratch-def.json --installation-key-bypass --wait 30 --code-coverage --skip-ancestor-check`
سرد الإصدارات	`sf package version list --packages FlexibleTeamShare --order-by CreatedDate --verbose`
الترويج للإصدار	`sf package version promote --package 04tXXX...`
التحقق من التغطية	`sf package version report --package 04tXXX... --verbose`
حذف الإصدار	`sf package version delete --package 04tXXX... --no-prompt`