صيغة المصدر

تخطيط Salesforce CLI بمجلد لكل مكوّن، منظَّم للعمل بشكل طبيعي مع Git بدلاً من البنية الخام لـ Metadata API.

التعريف

صيغة المصدر هي تخطيط الملفات الذي يتوقعه Salesforce CLI في دليل force-app: بيانات وصفية منظَّمة حسب النوع ومقسَّمة أكثر بحيث يكون كل مكوّن (كائن، أو flow، أو فئة Apex وملفها الوصفي) ملفًا خاصًا به أو مجلدًا صغيرًا، بما يطابق أفضل طريقة يقارن بها Git التغييرات ويراجعها. يُحدَّد بواسطة sfdx-project.json في جذر المشروع، الذي يُصرِّح عن دليل حزمة واحد أو أكثر بهذا التخطيط. صيغة المصدر هي ما يجعل أوامر مثل sf project retrieve start وsf project deploy start قابلة للاستخدام دون بيان (manifest) مكتوب يدويًا، إذ يمكن لـ CLI استنتاج النطاق من الملفات التي تغيّرت. تفترض تقريبًا كل أدوات Salesforce الحديثة، وامتدادات VS Code، ومؤسسات scratch، وتجميع 2GP، صيغة المصدر كافتراضي. راجع دليل Salesforce CLI الخاص بنا لمعرفة كيف تتلاءم صيغة المصدر مع الاستخدام اليومي لـ CLI.

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

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

يقرأ Serpent ويكتب بيانات صيغة المصدر الوصفية أصليًا عبر امتداد VS Code وسير عمل المهام الخاص به، بحيث لا تحتاج بنية المشروع المحلية للمطور للتغيير أبدًا للعمل مع Serpent. تُحدَّد نطاق تغييرات كل مهمة إلى ملفات صيغة المصدر الفردية التي جرى المساس بها، وهو أيضًا ما يجعل إنشاء البيان التلقائي وعمليات النشر الجزئية (delta) في Serpent ممكنة. راجع امتداد Serpent لـ VS Code لمعرفة كيف يتزامن العمل المحلي بصيغة المصدر مع المهام.

أسئلة شائعة