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