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

يتضمّن 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:

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

    <trusted-keys>
    <trusted-key id="8461efa0e74abae010de66994eb27db2a3b88b8b">
        ...
    </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-keys>

بالنسبة إلى المشاكل المتعلّقة بالتحقُّق من الاعتمادية، انتقِل إلى دليل Gradle عن تحديد مشاكل التحقُّق من الاعتمادية وحلّها.

أخيرًا، يمكن الاطّلاع على تفاصيل عن المفتاح الموثوق به على الموقع الإلكتروني لخادم مفاتيح نظام التشغيل Ubuntu.

الاستفادة من Jetpack

ويمكن استخدام مكتبات Jetpack بمفردها أو معًا لتلبية الاحتياجات المختلفة في تطبيقاتك.

  • WorkManager لاحتياجاتك المتعلقة بجدولة الخلفية.
  • غرفة استمرار تخزين البيانات
  • التنقل لإدارة تدفق التنقل في التطبيق.
  • CameraX لتلبية احتياجات تطبيق الكاميرا.
  • اطّلِع على نظرة عامة على جميع مكتبات Jetpack.

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

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

مراجع إضافية

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

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

  • يستخدم تطبيق Sunflower التجريبي العديد من مكونات Jetpack المختلفة لتوضيح أفضل الممارسات لتطوير Android.

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

الفيديوهات الطويلة