تتضمّن Jetpack مجموعة من مكتبات Android التي تدمج أفضل الممارسات وتوفّر التوافق مع الأنظمة القديمة في تطبيقات Android.
يقدّم دليل Jetpack لبنية التطبيقات نظرة عامة على أفضل الممارسات والبنية المقترَحة التي يجب مراعاتها أثناء إنشاء تطبيق Android.
توضّح الأقسام التالية كيفية بدء استخدام مكوّنات Jetpack.
استخدام مكتبة Jetpack في تطبيقك
تتوفّر جميع مكوّنات Jetpack في مستودع Maven من Google.
افتح ملف settings.gradle وأضِف مستودع google() في حزمة dependencyResolutionManagement { repositories {...}} كما هو موضّح أدناه:
أنيق
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() jcenter() } }
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() jcenter() } }
يمكنك بعد ذلك إضافة مكوّنات Jetpack، مثل مكوّنات البنية مثل LiveData وViewModel، في ملف build.gradle الخاص بالوحدة، كما هو موضّح هنا:
أنيق
dependencies { def lifecycle_version = "2.2.0" implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version" implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version" ... }
Kotlin
dependencies { val lifecycle_version = "2.2.0" implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version") implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version") ... }
توفّر العديد من مكتبات Jetpack إضافات Android KTX كما هو موضّح أعلاه مع lifecycle-livedata-ktx وlifecycle-viewmodel-ktx.
تعتمد إضافات KTX على واجهة برمجة التطبيقات المستندة إلى Java، وتستفيد من ميزات لغة Kotlin.
لمعرفة المزيد عن إصدارات مكتبة Jetpack الجديدة، يمكنك الاطّلاع على صفحة الإصدارات.
تتوفّر صفحات مرجعية لواجهة برمجة التطبيقات المستندة إلى Kotlin والمستندة إلى Java لجميع مكتبات Jetpack.
التحقّق من تبعيات Jetpack (اختياري)
اعتبارًا من يونيو 2023، يوقّع فريق Jetpack على مكتبات Jetpack. تتيح هذه التوقيعات للمطوّرين التحقّق من أنّ عناصر المكتبة تم إنشاؤها وتوقيعها من قِبل Google. تكون المكتبة مؤهَّلة للتحقّق من التوقيع بعد نشر تحديث.
إذا كان مشروع Android يتضمّن ميزة التحقّق من التوقيع، اتّبِع الخطوات التالية للتحقّق من تبعيات Jetpack في مشروع Gradle:
أضِف مفاتيح Google الموثوق بها إلى قسم
<trusted-keys>في$PROJECT_ROOT/gradle/verification-metadata.xml:<trusted-keys> <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b"> ... </trusted-key> <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2"> ... </trusted-key> <trusted-key id="0f06ff86beeaf4e71866ee5232ee5355a6bc6e42"> ... </trusted-key> <trusted-key id="0e225917414670f4442c250dfd533c07c264648f"> ... </trusted-key> ... </trusted-keys>أضِف إدخال
<trusting group>لكل مكتبة يستخدمها المشروع. في ما يلي مثال على مكتبتَيandroidx.fragmentوandroidx.emoji2:<trusted-keys> <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b"> <trusting group="androidx.fragment"/> <trusting group="androidx.emoji2"/> </trusted-key> <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2"> <trusting group="androidx.fragment"/> <trusting group="androidx.emoji2"/> </trusted-key> ... </trusted-keys>
إذا واجهت مشاكل في التحقّق من التبعيات، يمكنك الاطّلاع على دليل Gradle حول تحديد مشاكل التحقّق من التبعيات وحلّها.
أخيرًا، يمكن الاطّلاع على تفاصيل حول مفتاحنا الموثوق به على موقع خادم مفاتيح Ubuntu.
الاستفادة من Jetpack
يمكن استخدام مكتبات Jetpack بمفردها أو معًا لتلبية الاحتياجات المختلفة في تطبيقاتك.
- WorkManager لتلبية احتياجات الجدولة في الخلفية.
- Room لتخزين البيانات بشكل دائم
- التنقّل لإدارة مسار التنقّل في تطبيقك
- CameraX لتلبية احتياجات تطبيق الكاميرا
- يمكنك الاطّلاع على نظرة عامة على جميع مكتبات Jetpack.
يتم نشر مكتبات Jetpack في مساحة الاسم androidx. إذا كان مشروعك
يستخدم حاليًا "مكتبة دعم Android"، يمكنك الاطّلاع على كيفية النقل إلى
مساحة اسم androidx.
لمزيد من المعلومات حول استخدام Jetpack، يُرجى الاطّلاع على الصفحات التالية:
مراجع إضافية
تدريب على الإنترنت
- تطوير تطبيقات Android باستخدام لغة Kotlin (دورة تدريبية على Udacity)
نموذج التعليمات البرمجية
- يستخدم التطبيق التجريبي Sunflower العديد من مكوّنات Jetpack المختلفة لتوضيح أفضل ممارسات تطوير تطبيقات Android.