الصفحة الرئيسية>كود المصدر JSP>فئات أخرى
تنزيل

الفيلم متعدد الموديل يتكون من المبدأ التوجيهي

إتقان الهندسة المعمارية Android مع مواد متعددة

هذا المستودع هو رحلة إلى التسلسل الهرمي متعدد الوحدات المثالي ، المخلوطة مع أناقة Jetpack. يعرض هذا النظام الأساسي تنفيذ وقابلية التوسع للعمارة النظيفة وأنماط مستودع MVVM+، المخصب بأمثلة واقعية من خلال API TMDB.

قم بتسريع عملية تطوير الميزات الخاصة بك بوحدة قالب جاهزة للاستنباط وقابلة للتخصيص. مع كل طلب سحب ، يضمن CI جودة الكود من خلال عمليات الإنشاء الآلية وعمليات الإنشاء الآلية.

الغوص في هذا الدليل لاكتشاف الهيكل المعياري المثالي.

بيت التفاصيل

يتبنى مشروعنا بنية متعددة الوحدات لتسهيل تطوير الميزات السريعة والتعاون السهل في الفرق الكبيرة. تمثل كل وحدة وظيفة أو طبقة محددة ومصممة ليتم دمجها بإحكام مع بعضها البعض مع كونها أيضًا وحدات يمكن تطويرها بشكل مستقل.

الوحدات الرئيسية:

: التطبيق: يمثل نقطة الدخول للتطبيق ويجمع بين جميع وحدات الميزات والمكتبات الأخرى. : التنقل: يحتوي على منطق التنقل داخل التطبيق ويدير رسم بياني التنقل. : Core: يتضمن المكونات الأساسية للتطبيق ويوفر وظائف مشتركة تستخدمها جميع وحدات الميزات.

وحدات الميزة:

: الميزات:*: كل وحدة ميزة (: الميزات: الصفحة الرئيسية ،: الميزات: التفاصيل ، إلخ) ، تغطي واجهة المستخدم ومصادر البيانات وقواعد العمل. يتم فصل هذه الوحدات وفقًا للعمارة النظيفة وأنماط مستودع MVVM+. وحدات المكتبة المشتركة:

: CORE: UI ،: CORE: المجال ،: CORE: البيانات: يوفر فئات وواجهات أساسية لواجهة المستخدم ومنطق الأعمال وطبقات الوصول إلى البيانات. يسهل هذا النهج المعياري الصيانة وقابلية التوسع للتطبيق ، كما يقلل من التداخل أثناء عمل أعضاء الفريق على ذلك.

تحديث الرسوم البيانية للوحدة النمطية

في مشروع Multimodreelcompose ، يعد التسلسل الهرمي للوحدة ديناميكية. عندما يضيف المطورون وحدة نمطية جديدة أو تغييرات التسلسل الهرمي الحالي ، يتم استخدام سير عمل GRAPLE GRAPLE لتحديث الرسوم البيانية للاعتماد على الوحدة وتزويد أعضاء الفريق بفهم مرئي.

يتم تشغيل عملية CI عند إنشاء طلب سحب في فرع GitHub/Module-Graph. تقوم العملية تلقائيًا بإنشاء الرسوم البيانية للاعتماد على الوحدة النمطية ، وتوصيل الرسوم البيانية المحدثة بالملفات ذات الصلة ، وترتبط بالتغييرات في فرع GitHub/Module-Graph تلقائيًا. يتيح ذلك لأعضاء الفريق مراجعة تغييرات الرسم البياني ودمجها مع فرع تطوير إذا كان مناسبًا.

تفاصيل سير العمل:

  • يتم تثبيت أداة GraphViz لإنشاء الرسوم البيانية للوحدة.
  • يتم إنشاء الرسوم البيانية باستخدام نص ./generatemodulegraphs.sh.
  • عند اكتشاف الرسوم البيانية الجديدة أو المحدثة ، فإنها يتم ارتكابها مباشرة من خلال إجراءات GitHub.
  • تضمن هذه العملية الآلية أن يتم تمثيل البنية المعيارية للمشروع بشكل مستمر بدقة وحدث ، مما يوفر وقتًا لأعضاء الفريق.

Android CI

تضمن عملية Android CI تجميع الرمز واختباره مع كل طلب سحب. هذا يضمن أن كل مساهمة في الفرع الرئيسي للتطبيق تلبي معايير محددة وخالية من الأخطاء.

سمات:

  • يجمع تلقائيًا الكود الخاص بك ويقوم بتشغيل الاختبارات.
  • يضمن بناء موثوق مع كل العلاقات العامة.

Detekt تحليل الكود الثابت

تقوم عملية تحليل الكود الثابت Detekt بتحليل رمز ثابت للحفاظ على جودة الرمز وتحسينها. هذا يساعد على تعزيز استدامة البرنامج ويحافظ على نظافة كود.

سمات:

  • يؤدي تحليل رمز ثابت مع detekt في PRS.
  • يضمن أن رمزك أكثر قابلية للقراءة وأسهل في الحفاظ عليه.
  • يكتشف الأخطاء المحتملة وقضايا النمط في مرحلة مبكرة.
  • تعتبر كلتا العمليتين CI ضروريين لضمان متانة التطبيق وسلاسة عملية التطوير. تراقب هذه الإجراءات الآلية باستمرار جودة الكود وتعزيز كفاءة فريق التطوير.

الإعداد والبدء

يوفر مشروع Multimodreelcompose للمطورين أساسًا قويًا لتطوير تطبيقات حديثة ومعيارية على منصة Android. اتبع هذه الخطوات لتثبيت وتشغيل المشروع في بيئة التطوير المحلية:

استنساخ المشروع: 

git clone https://github.com/ubuntuyiw/MultiModReelCompose.git

يستنسخ هذا الأمر المشروع إلى جهازك المحلي.

متطلبات:

  • JDK 17 أو الأحدث.
  • Android Studio Bumblebee (2021.1.1) أو الأحدث.
  • أحدث إصدار من أدوات Android SDK و Android SDK.

تثبيت التبعيات: قم بتشغيل الأمر التالي في دليل المشروع لتثبيت التبعيات اللازمة: 

./gradlew build

تكوين مفتاح API:

حدد مفتاح API الخاص بك المطلوب لاستخدام API TMDB في ملف المحلي. properties على النحو التالي: 

API_KEY= " YOUR_API_KEY_HERE "

فتح المشروع في Android Studio: في Android Studio ، افتح المشروع باستخدام خيار "فتح مشروع موجود". تشغيل التطبيق: ابدأ التطبيق بالنقر فوق زر التشغيل في Android Studio. ستقوم هذه الخطوات بإكمال عملية الإعداد المطلوبة للبدء في المساهمة في مشروع MultimodReelcompose.

المكتبات والمكونات الإضافية

المكتبات البارزة والمكونات الإضافية المستخدمة في مشروع Multimodreelcompose هي كما يلي:

ملحقات إضافية:

  • hilt: يستخدم الخنجر لحقن التبعية وتبسيط إدارة التبعية في مشاريع Android.
  • KSP: توفر معالجة رمز Kotlin معالجة شرح سريعة وفعالة لـ Kotlin.
  • Detekt: أداة تحليل التعليمات البرمجية الثابتة تساعد على تحسين جودة الكود والاتساق.
  • الوحدة النمطية: تستخدم لإنشاء وتحليل الرسوم البيانية للاعتماد على الوحدة النمطية.

الإضافات المخصصة:

هناك أيضًا ملحقات مخصصة مخصصة خاصة بالمشروع. تم تصميم هذه لوظائف محددة ودعم الهيكل المعياري للمشروع:

  • إبراهيمكورت-أندرويد-تطبيق
  • إبراهيمكورت-أندرويد بريك
  • Ibrahimkurt-android-compose
  • ibrahimkurt-jvm-library
  • Ibrahimkurt-Android-Library
  • Ibrahimkurt-Android-Library-COMPOSE
  • إبراهيم
  • إبراهيمكورت-أندرويد-إعادة التزجيج
  • إبراهيمكورت-JVM-detekt

المكتبات الرئيسية:

  • Androidx و Compose UI Libraries (Core-KTX ، وكفك النشاط ، وموظف التنقل ، والترحيل--KTX ، إلخ)
  • الشبكات (التعديل التحديثي ، ktorclientokhttp)
  • البرمجة غير المتزامنة (Kotlinx-coroutines-core)
  • التسلسل (kotlinx-serialization-json)
  • تحميل الصور (ملف ، coilcompose)

بناء المنطق:

يستخدم المشروع وحدة البناء-logic لمركزية وجعل التكوين قابلاً لإعادة الاستخدام. تحتوي هذه الوحدة على ملفات تكوين Gradle وتضمن سلوكيات بناء متسقة عبر جميع وحدات المشروع.

إنشاء وحدة ميزة جديدة

يمكنك إضافة وحدات ميزة جديدة بسرعة وسهولة إلى مشروعك باستخدام مهمة CreateFeatureModule Gradle. تأخذ هذه المهمة اسم الوحدة النمطية واكتبها كمعلمات ، وتنسخ الملفات من القوالب ذات الصلة ، وتحديث تكوين المشروع تلقائيًا.

خطوات استخدام المهمة:

  1. Open Terminal: افتح المشروع في دليل الجذر.
  2. إنشاء وحدة: اكتب الأمر التالي في المحطة الخاصة بك لإنشاء وحدة جديدة: 
./gradlew createFeatureModule -PmoduleName= < module_name > -PmoduleType= < module_type >
  • <Podule_Name>: اختر اسمًا لوحدتك الجديدة.
  • <Podule_type>: حدد نوع الوحدة التي تريد إنشاؤها (واجهة المستخدم أو البيانات أو المجال أو جميعها).

مثال: 

./gradlew createFeatureModule -PmoduleName=profile -PmoduleType=all

في هذا المثال ، سيتم إنشاء وحدة جديدة تسمى "ملف تعريف" ، وسيتم إضافة وحدات واجهة المستخدم ، والبيانات ، وحدات المجال.

الخطوات الأخيرة:

  • تحقق من الملفات: تحقق من ملفات الوحدة النمطية الجديدة ضمن دليل الميزات.
  • Sync Project: في Android Studio ، قم بمزامنة المشروع مع File> Sync Project مع ملفات Gradle للتعرف على التغييرات.

تتيح هذه العملية التكامل السريع للميزات الجديدة في المشروع مع الحفاظ على استقلال الوحدة النمطية والاستفادة من مرونة البنية المعيارية.

موارد ومراجع إضافية

فيما يلي العديد من الموارد الخارجية لمساعدتك على فهم مشروع Multimodreelcompose بشكل أفضل واكتساب معرفة متعمقة حول تطوير Android. يمكن أن تساعدك هذه الموارد في فهم كيفية تنظيم بعض أجزاء المشروع وأفضل الممارسات المتعلقة بعمارة Android.

المادة المتوسطة:

  • باستخدام Jetpack Compose and Modern Android Architecture - كتبها Rahmi Cemre ünal ، توفر هذه المقالة معلومات متعمقة حول Jetpack Compose and Modern Android.

مشاريع جيثب:

  • الآن في Android - مشروع عينة تم تطويره بواسطة Google ، مما يوضح كيفية تطوير التطبيقات باستخدام تقنيات Android الحديثة والهندسة المعمارية.
  • ملاحظة - تطبيق - تطبيق بسيط لتدوين الملاحظات تم تطويره بواسطة Rahmi Cemre ünal ، باستخدام بنيات تطبيق Android الحديثة.

وثائق مطوري Android الرسميين:

  • Android Architecture - الدليل الرسمي حول الأنماط المعمارية المختلفة والمناهج المستخدمة عند تصميم تطبيقات Android.

ستوجهك هذه الموارد من خلال عملية تطوير تطبيقات Android وتساعدك على التوافق بشكل أفضل مع الأنماط المعمارية للمشروع.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل