開始使用 Android Jetpack

Jetpack 包含一系列 Android 程式庫,這些程式庫都採用最佳做法,並在您的 Android 應用程式中提供回溯相容性。

Jetpack 應用程式架構指南 概略說明您在建構 Android 應用程式時應參考的最佳做法和建議架構。

以下各節將說明如何開始使用 Jetpack 元件。

在應用程式中使用 Jetpack 程式庫

所有 Jetpack 元件都可透過 Google Maven 存放區 存取。

開啟 settings.gradle 檔案,然後在 dependencyResolutionManagement { repositories {...}} 區塊中新增 google() 存放區,如下所示:

Groovy

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

Kotlin

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

接著,您可以在模組的 build.gradle 檔案中新增 Jetpack 元件(例如 LiveDataViewModel 架構元件),如下所示:

Groovy

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 程式庫提供的 Android KTX 擴充功能(如上所示)具有 lifecycle-livedata-ktxlifecycle-viewmodel-ktx。 KTX 擴充功能是以 Java 應用程式 API 為基礎建構,利用了 Kotlin 專屬語言功能。

如要瞭解新的 Jetpack 程式庫版本,請前往 版本 頁面。

所有 Jetpack 程式庫都支援 以 Kotlin 為基礎的以 Java 為基礎的 API 參考資料頁面。

驗證 Jetpack 依附元件 (選用)

自 2023 年 6 月起,Jetpack 團隊簽署了 Jetpack 程式庫。這些 簽章,可讓開發人員確認程式庫構件已建構完成,並 與 Google 簽約資料庫一旦完成即可進行簽章驗證 會發布更新。

如果您的 Android 專案已啟用簽名驗證功能,請按照下列步驟操作 驗證 Gradle 專案中的 Jetpack 依附元件:

  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.fragmentandroidx.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 的 排解依附元件驗證問題

最後,您可以前往 Ubuntu 的金鑰伺服器網站

充分利用 Jetpack

Jetpack 程式庫可以單獨使用,也可以搭配使用,以滿足應用程式的各種需求。

  • WorkManager 滿足您的背景排程需求。
  • 資料儲存持續性的 空間
  • 導覽 以管理應用程式導覽流程。
  • 符合相機應用程式需求的 CameraX
  • 請查看所有 Jetpack 程式庫的 總覽

Jetpack 程式庫發佈於 androidx 命名空間。如果您的專案目前使用 Android 支援資料庫,請參閱如何 遷移至 Androidx 命名空間 一文。

如要進一步瞭解如何使用 Jetpack,請參閱下列網頁:

其他資源

線上訓練

程式碼範例

  • Sunflower 試用版應用程式使用多種 Jetpack 元件來示範 Android 開發的最佳做法。

Codelab

影片