sfdx-project.json

ملف التهيئة في جذر كل مشروع بصيغة المصدر، يُصرِّح عن أدلة الحزم، ومساحة الاسم، وتبعيات الحزم.

التعريف

sfdx-project.json هو ملف التهيئة الذي يقرأه كل أمر في Salesforce CLI في جذر مشروع بصيغة المصدر. يُصرِّح عن أدلة الحزم (أين يقيم المصدر، وأيها الهدف الافتراضي للاسترجاع)، وsourceApiVersion، ومساحة الاسم المسجَّلة إن وُجدت، وبالنسبة لمشاريع 2GP، قائمة الحزم مع أسمائها المستعارة (aliases) وتبعياتها المُصرَّح عنها على إصدارات بعضها البعض. إنه ما يجعل مجلدًا قابلًا للتعرف كمشروع Salesforce بالنسبة لـ CLI وامتدادات VS Code وأدوات CI على حد سواء، وهو الملف الذي يتتبع أسماء الحزم المستعارة مع إنشاء إصدارات جديدة، بحيث يُطابَق اسم قابل للقراءة البشرية مع معرّف الإصدار الفعلي الذي تُخصِّصه Salesforce. يُعد ملف sfdx-project.json المشوَّه أو القديم مصدرًا شائعًا لأخطاء CLI المربكة، خاصة حول حل التبعيات. يغطي دليل Salesforce CLI الخاص بنا بنية الملف بمزيد من التفصيل.

من واقع الاستخدام

إزاي بيشتغل في Serpent

يقرأ Serpent ملف sfdx-project.json الخاص بالمشروع تلقائيًا لفهم بنية الحزمة وتبعياتها، ويُحدِّث أسماء الحزم المستعارة ومراجع الإصدارات مع حدوث البناءات والترقيات، بحيث لا يحتاج أحد لتعديل الملف يدويًا بعد كل إصدار. تعمل المستودعات متعددة الحزم ذات التبعيات المُصرَّح عنها بنفس طريقة المستودعات ذات الحزمة الواحدة، دون تهيئة إضافية. راجع امتداد Serpent لـ VS Code لمعرفة كيف تتزامن تهيئة المشروع مع التطوير المحلي.

أسئلة شائعة