شروع کار با Android Jetpack

Jetpack مجموعه‌ای از کتابخانه‌های Android را در بر می‌گیرد که بهترین روش‌ها را در خود جای داده و سازگاری با عقب را در برنامه‌های Android شما فراهم می‌کند.

راهنمای معماری برنامه Jetpack مروری بر بهترین شیوه ها و معماری توصیه شده برای در نظر گرفتن هنگام ساخت برنامه اندرویدی خود ارائه می دهد.

بخش‌های زیر نحوه شروع استفاده از اجزای Jetpack را شرح می‌دهند.

از کتابخانه Jetpack در برنامه خود استفاده کنید

تمام اجزای Jetpack در مخزن Google Maven موجود است.

فایل settings.gradle را باز کنید، مانند شکل زیر، مخزن google() را در بلوک dependencyResolutionManagement { repositories {...}} اضافه کنید:

شیار

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        jcenter()
    }
}

کاتلین

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"
    ...
}

کاتلین

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 بر اساس API مبتنی بر جاوا ساخته می شوند و از ویژگی های زبان مخصوص Kotlin بهره می برند.

برای اطلاع از نسخه های جدید کتابخانه Jetpack، صفحه Releases را بررسی کنید.

صفحات مرجع API مبتنی بر Kotlin و Java-based برای تمام کتابخانه های Jetpack در دسترس هستند.

بررسی وابستگی های Jetpack (اختیاری)

از ژوئن 2023، تیم Jetpack کتابخانه‌های Jetpack را امضا می‌کند. این امضاها به توسعه دهندگان این امکان را می دهد تا تأیید کنند که مصنوعات کتابخانه توسط Google ساخته و امضا شده است. یک کتابخانه پس از انتشار به‌روزرسانی، واجد شرایط تأیید امضا است.

اگر پروژه اندروید شما تأیید امضا را فعال کرده است، این مراحل را برای تأیید وابستگی‌های 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 در مورد عیب‌یابی تأیید وابستگی دیدن کنید.

در نهایت، جزئیات مربوط به کلید مورد اعتماد ما را می توان در سایت سرور کلید اوبونتو مشاهده کرد.

از Jetpack استفاده کنید

کتابخانه های Jetpack ممکن است به تنهایی یا ترکیبی برای رفع نیازهای مختلف در برنامه های شما استفاده شوند.

  • WorkManager برای نیازهای برنامه ریزی پس زمینه شما.
  • فضای ذخیره سازی داده ها
  • ناوبری برای مدیریت جریان ناوبری برنامه شما.
  • CameraX برای نیازهای برنامه دوربین شما.
  • نمای کلی تمام کتابخانه های Jetpack را ببینید.

کتابخانه های Jetpack در فضای نام androidx منتشر می شوند. اگر پروژه شما در حال حاضر از کتابخانه پشتیبانی Android استفاده می کند، نحوه انتقال به فضای نام androidx را بخوانید.

برای کسب اطلاعات بیشتر در مورد استفاده از Jetpack، این صفحات را بررسی کنید:

منابع اضافی

آموزش آنلاین

کد نمونه

  • برنامه نمایشی Sunflower از بسیاری از اجزای مختلف Jetpack برای نشان دادن بهترین شیوه های توسعه اندروید استفاده می کند.

Codelabs

ویدیوها