إضافة مكونات إلى مشروعك

قبل البدء، اقرأ دليل بنية التطبيقات للتعرّف على المبادئ المفيدة التي تنطبق على جميع تطبيقات Android وللحصول على إرشادات حول استخدام مكونات البنية معًا.

تتوفّر المكوّنات الهندسية في مستودع Maven من Google. لاستخدامها، أضف المستودع إلى مشروعك.

افتح ملف settings.gradle وأضِف مستودع google():

رائع

dependencyResolutionManagement {
   ...
    repositories {
        google()
        jcenter()
    }
}

Kotlin

dependencyResolutionManagement {
    ...
    repositories {
        google()
        jcenter()
    }
}

تعريف التبعيات

افتح ملف build.gradle لتطبيقك أو وحدتك وأضِف العناصر التي تحتاجها كتبعيات. يمكنك إضافة تبعيات لجميع مكونات البنية أو اختيار مجموعة فرعية.

يُرجى الاطّلاع على تعليمات الإعلان عن التبعيات لكل مكوِّن بنية في ملاحظات الإصدار:

يمكنك الاطّلاع على إصدارات AndroidX لمعرفة أحدث أرقام الإصدارات لكل مكوّن.

لمزيد من المعلومات حول أداة إعادة هيكلة AndroidX وكيفية تأثيرها في حزم الفئات ومعرّفات الوحدات هذه، يمكنك الاطّلاع على نقل البيانات إلى AndroidX.

Kotlin

تتوافق وحدات إضافات Kotlin مع العديد من تبعيات AndroidX. تحتوي هذه الوحدات على اللاحقة -ktx ملحقة بأسمائها. مثلاً:

رائع

implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version"

Kotlin

implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version")

يصبح

رائع

implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"

Kotlin

implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version")

يمكن العثور على مزيد من المعلومات، بما في ذلك المستندات الخاصة بإضافات Kotlin، في مستندات KTX.

ملاحظة: بالنسبة إلى التطبيقات المستندة إلى Kotlin، يُرجى التأكّد من استخدام kapt بدلاً من annotationProcessor. عليك أيضًا إضافة المكوّن الإضافي kotlin-kapt.