بدء استخدام 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 إضافات KTX لنظام التشغيل Android كما هو موضّح أعلاه مع 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-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.

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

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