
Andrew Hanna

Andrew Hanna

باختصار: الـUnmanaged Package في Salesforce حزمة metadata من الجيل الأول تثبّتها مرة واحدة ثم تملكها بالكامل: كل مكوّن يصبح قابلًا للتعديل في الـorg المستهدف، ومن غير namespace ولا حماية للملكية الفكرية ولا مسار ترقية. هي الأداة الصحيحة للقوالب وتطبيقات الأمثلة وعمليات النقل لمرة واحدة. أما أي شيء تنوي صيانته، فانقله إلى Unlocked Package.
الـUnmanaged Package وسيلة توزيع لمرة واحدة. تجمع مكونات مثل الـcustom objects والحقول وكلاسات Apex والـflows والـlayouts والتقارير، وترفعها من packaging org، ثم تشارك رابط تثبيت. وعند التثبيت تُفك المحتويات داخل الـorg المستهدف وتتصرف كأن الـadmin بناها هناك بنفسه.
ودي هي المعادلة كلها. اللي بيثبّت ياخد تحكم كامل، والناشر يتنازل عن أي طريقة لدفع إصلاحات لاحقًا. ولمقارنة النموذجين جنبًا إلى جنب، راجع الفرق بين الـManaged والـUnmanaged Packages في Salesforce.
لو كلمات زي إصدار أو ترقية أو subscriber موجودة في خطتك، فالـUnmanaged Package اختيار غلط.
قاعدة إلغاء التثبيت من أجل الترقية هي المكان الذي تخسر فيه الفرق بياناتها. قبل أن تزيل حزمة مثبّتة، احفظ حالة سليمة معروفة. في Serpent، واجهة Backups تفعل ذلك بالضبط، وتسترجع الـmetadata والسجلات المدعومة في الـorg، وتحتفظ بسجل Restore History. وهي مكمّلة للـrollback، والبيانات المحذوفة بالفعل يظل استرجاعها بنظافة أصعب، فاعمل backup الأول. الخطوات في دليل النسخ الاحتياطي والاستعادة.
ده الجزء اللي معظم الأدلة بتسيبه. لا يوجد تحويل مباشر في المكان، فأنت تعيد بناء الحزمة من الـsource:
package.xml لهذه
المكونات وشغّل
sf project retrieve start --manifest package.xml --target-org source.
دليلنا لـSalesforce CLI
يشرح الإعداد.
sf package create --package-type Unlocked --path force-app على الـDev
Hub، ثم أنشئ إصدارًا بـsf package version create --code-coverage.
الـApex يحتاج تغطية 75% على الأقل قبل الترقية.
للخطوة 6، يملأ Serpent بيانات نموذجية أو مُقنّعة أثناء إعداد البيئات وفي الـrelease pipelines، فترجع الـscratch orgs والـsandboxes المحدّثة ومعها بيانات من غير script يدوي. ولو بتبني لـAppExchange، فالوجهة هي Managed 2GP Package؛ اقرأ أسرار الـSecond-Generation Managed Package قبل البدء.
دعم تطوير الحزم في Serpent يبني ويرقّم ويشحن حزم 1GP و2GP والـManaged على كل الخطط، ويرسم الاعتماديات حتى تظهر تعارضات الإصدارات قبل أن يراها الـorg المستهدف. ومزيد من الأدلة العملية تجده في SF Guides.
هل يمكن ترقية Unmanaged Package؟
لا. يجب إلغاء تثبيت الإصدار القديم وتثبيت الجديد، وده بيحذف البيانات في الـcustom objects والحقول الخاصة بها.
هل للـUnmanaged Packages namespace؟
لا. المكونات تُثبّت في الـnamespace الافتراضي، ولهذا يمكن أن تتعارض الأسماء.
هل أقدر أعرض Unmanaged Package على AppExchange؟
لا. التوزيع التجاري على AppExchange يستخدم الـManaged Packages، التي تحمل namespace وتمر بمراجعة الأمان.
هل أقدر أحوّل Unmanaged Package إلى Unlocked Package؟
ليس في نفس المكان. استرجع الـmetadata إلى نظام التحكم في الإصدارات، ثم أنشئ منها Unlocked Package جديدة.
بدون التزام.