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

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

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

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

استخدام مكتبة 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()
    }
}

يمكنك بعد ذلك إضافة مكونات 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 (اختياري)

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

إذا تم تفعيل ميزة "إثبات صحة التوقيع" في مشروع 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، يمكنك الاطّلاع على الصفحات التالية:

مصادر إضافية

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

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

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

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

الفيديوهات