إذا كنت تكتب رمز Compose لتطبيقك أو تنشئ مكتبات Compose وواجهات برمجة تطبيقات، اتّبِع أفضل الممارسات لجعل الرمز قابلاً للتوسّع وأكثر كفاءة ومتوافقًا مع بقية المنظومة المتكاملة.
تقدّم المستندات التالية إرشادات لأي شخص يكتب رمزًا برمجيًا يستخدم Compose:
- إرشادات واجهة برمجة التطبيقات في Jetpack Compose: توضّح الأنماط وأفضل الممارسات وإرشادات الأسلوب التوجيهي لأي نظام يستخدم المكوّن الإضافي لبرنامج تجميع Jetpack Compose ووقت التشغيل. ويتضمّن المواضيع التالية:
- إرشادات أسلوب Kotlin في Compose، استنادًا إلى قواعد الترميز في Kotlin
- إرشادات حول دوالّ
@Composableوواجهات برمجة التطبيقات التي تستند إلى إمكانات وقت التشغيل في Compose - إرشادات لواجهات برمجة التطبيقات التي تستخدم مجموعة أدوات واجهة المستخدم في Compose وتوسّع نطاقها
- أنماط لمعالجة حالات الاستخدام عند تصميم واجهة برمجة تطبيقات Compose
- إرشادات واجهة برمجة التطبيقات لمكوّنات
@Composableفي Jetpack Compose: توفّر مجموعة من الإرشادات والنصائح لإنشاء مكوّنات واجهة المستخدم في@Composableواستخدامها، بما في ذلك المواضيع التالية:- إنشاء المكونات ووضعها في طبقات
- تسمية مكوّن جديد
- التعبير عن تبعيات المكوّنات
- المَعلمات في مكوّنات
@Composable - اتّباع الأنماط الصحيحة لإنشاء الفئات والدوال ذات الصلة بالمكوّنات
- توثيق مكوّنات
@Composable - تحسين أدوات تسهيل الاستخدام للمكوّنات
- تعديل واجهات برمجة التطبيقات للمكوّنات مع الحفاظ على التوافق مع الأنظمة القديمة
الجمهور
تمت كتابة هذه الإرشادات للجمهور الثلاثة التالية:
- المطوّرون الذين ينشئون تطبيقات مستندة إلى Jetpack Compose أنت ضمن هذه المجموعة إذا كنت تستخدم Jetpack Compose في جزء من تطبيقك.
- المطوّرون الذين يعملون على تطوير إطار عمل Jetpack Compose أنت ضمن هذه المجموعة إذا كنت تساهم في مكتبات
androidx.compose. - المطوّرون الذين ينشئون مكتبات استنادًا إلى Jetpack Compose: أنت في هذه المجموعة إذا كنت تنشئ واجهات برمجة تطبيقات Compose أو مكتبات لعناصر في واجهة المستخدم في Compose. قد تكون مكتبات مكوّنات Compose هذه متاحة للجميع أو محلية لشركتك أو فريقك.
استنادًا إلى المجموعة التي تنتمي إليها، لديك مستويات مختلفة من الصرامة لكل إرشادات الأسلوب. على سبيل المثال، يلتزم تطوير إطار عمل Jetpack Compose بشكل عام بهذه الإرشادات بشكل صارم.
لمزيد من المعلومات حول متطلبات كل فئة من المطوّرين، يُرجى الاطّلاع على RFC2119.
المساهمة في إطار العمل والإرشادات
نرحّب بالمساهمات في مكتبات محدّدة في قاعدة الرموز البرمجية androidx وإرشادات الأسلوب (إرشادات Compose API وإرشادات مكوّنات @Composable) نفسها.
للمساهمة، يُرجى اتّباع التعليمات الواردة في androidx دليل المساهمة.