بدء استخدام 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 الجديدة، يمكنك مراجعة صفحة الإصدارات.

تتوفّر الصفحات المرجعية لواجهة برمجة التطبيقات المستندة إلى 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.

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

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