يتضمّن Jetpack مجموعة من مكتبات Android التي تدمج أفضل الممارسات وتوفِّر توافقًا مع الأنظمة القديمة في تطبيقات Android.
يوفّر دليل Jetpack لبنية التطبيق نظرة عامة على أفضل الممارسات والبنية المُقترَحة التي يجب مراعاتها أثناء إنشاء تطبيق Android.
توضّح الأقسام التالية كيفية بدء استخدام مكوّنات Jetpack.
استخدام مكتبة Jetpack في تطبيقك
تتوفّر جميع مكوِّنات Jetpack في مستودع Google Maven.
افتح ملف 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 الجديدة، يمكنك الاطّلاع على صفحة الإصدارات.
تتوفّر الصفحات المرجعية لواجهة برمجة التطبيقات المستندة إلى Kootlin والمستندة إلى 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-keys>
أضِف إدخال
<trusting group>
لكل مكتبة يستخدمها المشروع. في ما يلي مثال على مكتبتَيandroidx.fragment
وandroidx.emoji2
:<trusted-keys> <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b"> <trusting group="androidx.fragment"/> <trusting group="androidx.emoji2"/> </trusted-key> ... </trusted-keys>
بالنسبة إلى المشاكل المتعلّقة بالتحقُّق من الاعتمادية، انتقِل إلى دليل Gradle عن تحديد مشاكل التحقُّق من الاعتمادية وحلّها.
أخيرًا، يمكن الاطّلاع على تفاصيل عن المفتاح الموثوق به على الموقع الإلكتروني لخادم مفاتيح نظام التشغيل Ubuntu.
الاستفادة من Jetpack
ويمكن استخدام مكتبات Jetpack بمفردها أو معًا لتلبية الاحتياجات المختلفة في تطبيقاتك.
- WorkManager لاحتياجاتك المتعلقة بجدولة الخلفية.
- غرفة استمرار تخزين البيانات
- التنقل لإدارة تدفق التنقل في التطبيق.
- CameraX لتلبية احتياجات تطبيق الكاميرا.
- اطّلِع على نظرة عامة على جميع مكتبات Jetpack.
يتم نشر مكتبات Jetpack في مساحة الاسم androidx
. إذا كان مشروعك يستخدم حاليًا "مكتبة دعم Android"، يمكنك الاطّلاع على كيفية نقل البيانات إلى مساحة الاسم androidx.
لمعرفة المزيد من المعلومات حول استخدام Jetpack، يمكنك الاطّلاع على الصفحات التالية:
مراجع إضافية
تدريب على الإنترنت
- تطوير تطبيقات Android باستخدام لغة Kotlin (دورة تدريبية من Udacity)
نموذج التعليمات البرمجية
- يستخدم تطبيق Sunflower التجريبي العديد من مكونات Jetpack المختلفة لتوضيح أفضل الممارسات لتطوير Android.