افزودن مؤلفه به پروژه

قبل‌از شروع، راهنمای معماری برنامه را برای اصول مفیدی که برای همه برنامه‌های Android اعمال می‌شود و برای راهنمایی درباره استفاده از مؤلفه‌های معماری باهم بخوانید.

مؤلفه‌های معماری از مخزن Maven متعلق به Google دردسترس است. برای استفاده از آن‌ها، مخزن را به پروژه‌تان اضافه کنید.

فایل settings.gradle را باز کنید و مخزن google() را اضافه کنید:

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

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

اعلام وابستگی‌ها

فایل build.gradle را برای برنامه یا واحدتان باز کنید و مصنوعات موردنیازتان را به‌عنوان وابستگی اضافه کنید. می‌توانید وابستگی‌ها را برای همه مؤلفه‌های معماری اضافه کنید یا زیرمجموعه‌ای را انتخاب کنید.

برای اعلام وابستگی‌ها برای هر مؤلفه معماری، دستورالعمل‌های موجود در یادداشت‌های انتشار را ببینید:

• Futures (موجود در androidx.concurrent)
• چرخه حیات (ازجمله ViewModel)
• پیمایش (ازجمله SafeArgs)
• صفحه‌بندی
• اتاق
• WorkManager

برای به‌روزترین شماره‌های نسخه هر مؤلفه، نسخه‌های AndroidX را ببینید.

برای کسب اطلاعات بیشتر درباره بازسازی کد AndroidX و نحوه تأثیر آن بر این شناسه‌های ماژول و بسته‌های کلاس، به انتقال به AndroidX مراجعه کنید.

کاتلین

پیمانه‌های افزونه Kotlin برای چندین وابستگی AndroidX پشتیبانی می‌شوند. این واحدها پسوند -ktx را در انتهای نامشان دارند. برای مثال:

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

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

مساوی است با

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

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

اطلاعات بیشتر، ازجمله اسناد مربوط به افزونه‌های Kotlin، را می‌توانید در اسناد KTX پیدا کنید.

توجه: برای برنامه‌های مبتنی بر Kotlin، مطمئن شوید که از kapt به‌جای annotationProcessor استفاده می‌کنید. همچنین باید افزایه kotlin-kapt را اضافه کنید.