شروع کار با Android Jetpack

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

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

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

توجه: کتابخانه های Jetpack هیچ گونه اطلاعات کاربری را به هیچ نوع سرویس پشتیبان ارسال نمی کنند. این بدان معنی است که ادغام یک کتابخانه Jetpack در برنامه شما تأثیری بر فرم ایمنی داده برنامه شما در کنسول Play ندارد.

از کتابخانه 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()
    }
}

هشدار: مخزن JCenter در 31 مارس 2021 فقط خواندنی شد. برای اطلاعات بیشتر، به‌روزرسانی سرویس 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 (اختیاری)

توجه: تأیید امضا یک ویژگی انتخابی برای ساخت‌های Gradle است. در صورت نیاز، می توانید تأیید امضا را فعال کنید .

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

توجه: کتابخانه‌هایی که قبل از ژوئن 2023 منتشر شده‌اند، دارای امضا نیستند و تأیید امضا را تأیید نمی‌کنند.

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

• اجزای معماری اندروید
• لیست کامل اجزای Jetpack

منابع اضافی

آموزش آنلاین

• توسعه برنامه های اندروید با Kotlin (دوره Udacity)

کد نمونه

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

Codelabs

• چرخه های زندگی اندروید
• اتاق با چشم انداز

ویدیوها

• مونتاژ جت پک شما