● مجتمع
dpconde
⚡ فوري
claude-android-skill
بواسطة dpconde · dpconde/claude-android-skill
تعليم Claude Code بناء تطبيقات Android حديثة بطريقة Google — العمارة النظيفة، Compose، Hilt، Room، Flow، بدون اتصال أولاً، متعدد الوحدات حسب الميزة.
مهارة تشفر أفضل الممارسات الحديثة في Android (تعكس مرجع NowInAndroid) في Claude Code: العمارة النظيفة مع طبقات UI/Domain/Data، MVVM + UDF، Jetpack Compose للواجهة، Hilt لحقن الاعتماديات، Room للحفاظ على البيانات، Kotlin Flow للتدفقات التفاعلية، Retrofit للشبكات، وهيكل مشروع متعدد الوحدات موجه نحو الميزات.
لماذا تستخدمه
الميزات الأساسية
- العمارة النظيفة: طبقات UI / Domain / Data مع حدود صارمة
- MVVM + تدفق البيانات أحادي الاتجاه
- مكدس Compose + Hilt + Room + Flow + Retrofit
- معمارية بدون اتصال أولاً مدمجة
- متعدد الوحدات حسب الميزة — كل ميزة مستقلة ذاتياً مع واجهة برمجية واضحة
عرض مباشر
كيف يبدو في الممارسة
claude-android-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: claude-android-skill
متى تستخدمه: أنت تبدأ تطبيقاً جديداً ولا تريد ارتكاب أخطاء معمارية ستصححها في غضون 6 أشهر.
الخطوات
-
اطلب من Claude بناء هيكل الوحدة
استخدم claude-android-skill. قم بإنشاء تطبيق Android متعدد الوحدات يسمى 'HabitTracker' مع ميزات: الصفحة الرئيسية، التتبع، الإعدادات. واجهة مستخدم Compose، حقن اعتماديات Hilt، قاعدة بيانات Room، بدون اتصال أولاً.✓ تم النسخ
→ تم إنشاء الوحدات :app, :core:database, :core:ui, :feature:home…
-
إضافة أول ميزة من البداية إلى النهاية
تطبيق ميزة التتبع: طبقة البيانات مع كيان Room، طبقة المجال مع حالات الاستخدام، واجهة المستخدم مع Compose و ViewModel. تضمين اختبارات الوحدة.✓ تم النسخ
→ الملفات عبر 3 طبقات + جميع الاختبارات تترجم
النتيجة: تطبيق عامل يتبع أنماط على نمط NowInAndroid.
المزالق
- الإفراط في هندسة تطبيق صغير إلى 8 وحدات — أخبر المهارة بوضوح: 'وحدة واحدة مناسبة هنا' للمشاريع البسيطة
متى تستخدمه: لديك شاشة XML وتريد Compose بدون إعادة كتابة كل شيء في مرة واحدة.
الخطوات
-
تحليل الشاشة الموجودة
إليك Fragment + XML لشاشة SettingsScreen. خطط لترحيل Compose مع الحفاظ على ViewModel سليماً.✓ تم النسخ
→ خطة الخطوات: الالتفاف حول ComposeView، نقل Views، تنظيف XML
-
تطبيق الترحيل
تطبيق الخطوة 1 — إضافة ComposeView ونقل رأس الصفحة إلى Compose.✓ تم النسخ
→ تعمل الشاشة المختلطة؛ الخطوات اللاحقة معدة
النتيجة: شاشة Compose مع الحفاظ على عقد ViewModel.
المزالق
- فقدان الحالة أثناء الترحيل — احتفظ بنفس ViewModel؛ فقط طبقة الواجهة تتغير
متى تستخدمه: لديك ميزة Retrofit فقط وتريد سلوك مخزن مؤقت / في قائمة الانتظار.
الخطوات
-
تقديم Room + مستودع
استخدم claude-android-skill لتحويل ميزة الملف الشخصي إلى بدون اتصال أولاً. أضف كيان Room، مستودع يُرجع Flow، وعامل مزامنة.✓ تم النسخ
→ تم إعادة هيكلة طبقة البيانات، المستودع هو المصدر الوحيد للحقيقة
-
ربط الواجهة بـ Flow
تحديث ViewModel للجمع من Flow المستودع؛ معالجة حالات التحميل/الفارغة/الخطأ في Compose.✓ تم النسخ
→ تعمل الواجهة بدون اتصال عند الإطلاق الأول بعد المزامنة
النتيجة: ميزة تعمل في وضع الطائرة.
المزالق
- نسيان حل التضارب — قرر الاستراتيجية مقدماً: LWW، server-wins، أو merged — ستطلب منك المهارة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
فتح PR لكل ميزة للحفاظ على قابلية المراجعة
إنشاء ميزة الصفحة الرئيسية وفتح GitHub PR بتلك الملفات فقط.✓ تم النسخ
تحرير عبر عدة وحدات في جلسة واحدة
تطبيق ترحيل Hilt عبر كل وحدة :feature:*.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء من المهارة؛ Android SDK مجاني
- الرموز لكل استدعاء
- كبير — يمكن للـ scaffold + tests أن يعمل بـ 20k+ tokens
- التكلفة المالية
- مجاني
- نصيحة
- قم بـ scaffold مرة واحدة، ثم كرر ميزة تلو الأخرى — تجنب طلبات 'توليد التطبيق بالكامل'
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: تذهب مفاتيح API في local.properties + BuildConfig، لا تُرسل أبداً
نقل البيانات الخارجي: لا شيء من المهارة نفسها
- راجع الاعتماديات المُولدة للقيود الإصدارية — قد تقترح المهارة إصدارات حالية وقت الكتابة.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
Hilt compile error: missing @HiltAndroidApp
تأكد من أن فئة التطبيق مُشروحة وموضحة في manifest
تحقق: grep -r '@HiltAndroidApp' app/src/
Room schema mismatch on migration
إما توفير Migration، أو تعيين fallbackToDestructiveMigration في dev
Compose preview won't render
أضف اعتماد معاينة Compose وشرح @Preview بشكل صحيح
البدائل
claude-android-skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| مستودع Google's NowInAndroid | تريد فقط مشروع مرجعي للنسخ منه | ثابت — لا يولد الكود لك |