بدء استخدام Android Jetpack

تضم Jetpack مجموعة من مكتبات Android التي تضم أفضل وتوفير التوافق مع الإصدارات القديمة في تطبيقات Android.

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

تتناول الأقسام التالية كيفية بدء استخدام مكوّنات Jetpack.

ملاحظة: لا ترسل مكتبات Jetpack أي بيانات مستخدمين إلى أي خدمة خلفية من أي لطيف. يعني ذلك أنّ دمج مكتبة Jetpack في تطبيقك لا يؤثر في أي وقت. في نموذج "أمان البيانات" لتطبيقك في Play Console.

استخدام مكتبة Jetpack في تطبيقك

تتوفّر جميع مكوّنات Jetpack في مستودع Google Maven.

افتح ملف settings.gradle وأضِف مستودع google() في كتلة dependencyResolutionManagement { repositories {...}} كما هو موضح أدناه:

Groovy

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

Kotlin

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

تحذير: أصبح مستودع JCenter للقراءة فقط في 31 آذار (مارس) 2021. لمزيد من المعلومات، يُرجى الاطّلاع على تحديث خدمة JCenter.

يمكنك بعد ذلك إضافة مكونات Jetpack، مثل مكونات البنية، مثل LiveData وViewModel، في وحدة نمط ملف build.gradle، كما هو موضح هنا:

Groovy

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 (اختياري)

ملاحظة: التحقّق من التوقيع هو ميزة اختيارية لإصدارات Gradle. إذا لزم الأمر، يمكنك تفعيل ميزة إثبات صحة التوقيع.

اعتبارًا من حزيران (يونيو) 2023، سيوقّع فريق Jetpack مكتبات Jetpack. هذه تتيح التوقيعات للمطورين التحقق من إنشاء عناصر المكتبة موقَّعة من قِبل Google. تكون المكتبة مؤهَّلة للتحقّق من التوقيع بعد نشر تحديث.

ملاحظة: لا تحتوي المكتبات التي تم إصدارها قبل حزيران (يونيو) 2023 على توقيعات ولا تحتوي على توقيعات. اجتياز عملية إثبات صحة التوقيع

إذا تم تفعيل ميزة "إثبات صحة التوقيع" في مشروع Android، اتّبِع الخطوات التالية: للتحقق من اعتماديات Jetpack في مشروع Gradle:

1. إضافة مفاتيح Google الموثوق بها إلى قسم <trusted-keys> في $PROJECT_ROOT/gradle/verification-metadata.xml:

   <trusted-keys>
       <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
           ...
       </trusted-key>
       <trusted-key id="a5f483cd733a4ebaea378b2ae88979fb9b30acf2">
           ...
       </trusted-key>
       ...
   </trusted-keys>
   

2. أضِف إدخال <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 لتلبية احتياجات الجدولة في الخلفية.
• غرفة لتثبيت البيانات في مساحة التخزين
• التنقل لإدارة تدفق التنقل في التطبيق.
• الكاميراX لتلبية احتياجات تطبيق الكاميرا
• اطّلِع على نظرة عامة في جميع مكتبات Jetpack.

يتم نشر مكتبات Jetpack في مساحة الاسم androidx. إذا كان مشروعك تستخدم حاليًا مكتبة دعم Android، يمكنك الاطّلاع على كيفية النقل إلى مساحة الاسم في androidx

لمزيد من المعلومات حول استخدام Jetpack، يمكنك الاطّلاع على الصفحات التالية:

• مكوّنات بنية Android
• القائمة الكاملة لمكوّنات Jetpack

مصادر إضافية

التدريب على الإنترنت

• تطوير تطبيقات Android باستخدام Kotlin (دورة Udacity التدريبية)

نموذج التعليمات البرمجية

• تطبيق Sunflower التجريبي العديد من مكوّنات Jetpack المختلفة لإثبات تطوير Android التقليدية.

الدروس التطبيقية حول الترميز

• مراحل نشاط Android
• غرفة مع إطلالة

الفيديوهات

• تجميع Jetpack