支援資料庫設定

注意：Android 9.0 (API 級別 28) 版本包含 新版支援資料庫 Jetpack 中的 AndroidX。 AndroidX 程式庫 包含現有的支援資料庫，並包含最新的 Jetpack 元件。

您可以繼續使用支援資料庫。 歷來構件 (包含 27 以下版本，並以 android.support.* 封裝) 繼續透過 Google Maven 存取不過，所有新的程式庫開發程序 AndroidX 程式庫建立。

建議您在所有新專案中使用 AndroidX 程式庫。建議您考慮 將現有專案遷移至 AndroidX。

如何在開發專案中設定 Android 支援資料庫，取決於功能 您想採用的 Android 平台版本，以及希望支援的 Android 平台版本範圍 應用程式。

這份文件會引導您下載支援資料庫套件及新增資料庫 部署至開發環境

現在可透過 Google 的 Maven 存取支援資料庫 Cloud Storage 也提供目錄同步處理功能我們不再支援透過 SDK 下載程式庫 ，且相關功能很快就會移除。

選擇支援資料庫

為應用程式新增支援資料庫之前，請決定要加入的功能 以及提供支援的最低 Android 版本如要進一步瞭解 不同程式庫提供的不同版本 支援資料庫功能。

新增支援資料庫

如要使用支援資料庫，您必須修改應用程式的 開發環境中的 classpath 依附元件。您必須為以下項目執行這項程序： 每個要使用的支援資料庫

如何在應用程式專案中新增支援資料庫：

1. 在專案的 settings.gradle 檔案。

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }
   

2. 針對您要使用支援資料庫的每個模組，在 模組 build.gradle 檔案的 dependencies 區塊。適用對象 例如，如要新增 v4 core-utils 程式庫，請新增下列程式碼：

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }
   

注意：使用動態依附元件 (例如 palette-v7:23.0.+)，可能導致未預期的版本更新作業， 以及迴歸不相容的問題建議您明確指定 程式庫版本 (例如 palette-v7:28.0.0)。

使用支援資料庫 API

支援現有架構 API 的支援資料庫類別通常有 名稱與架構類別相同，但位於 android.support 類別套件中。 或加上 *Compat 後置字串

注意：在應用程式專案中納入支援資料庫後， 強烈建議您縮減、模糊化及最佳化 發布應用程式。除了利用模糊處理來保護原始碼 從應用程式納入的任何程式庫中移除未使用的類別，防止 下載檔案大小

如需使用部分支援資料庫功能的進一步指南，請參閱 Android 開發人員 訓練課程 指南 樣本如要進一步瞭解各個支援資料庫類別和方法，請參閱 API 參考資料中的 android.support 套件。

資訊清單宣告變更

如果您要將現有應用程式的回溯相容性提高至 新版 Android API 及支援資料庫，請記得更新應用程式的 資訊清單。具體來說，您應該更新 android:minSdkVersion 的元素 <uses-sdk> 標記指派給新的較低版本號碼，例如 如下所示：

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

資訊清單設定會讓 Google Play 瞭解您的應用程式可以安裝在搭載 Android 的裝置上 4.0 (API 級別 14) 以上版本。

如果您使用的是 Gradle 建構檔案，則建構檔案中的 minSdkVersion 設定 會覆寫資訊清單設定。

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

在這種情況下，建構檔案設定會向 Google Play 指出應用程式的 應用程式，可以在搭載 Android 4.1 (API 級別 16) 以上版本的裝置上安裝。如要 有關建構變數的資訊，請參閱 建構系統總覽。

注意：如果您提供多個支援資料庫， 最低 SDK 版本必須為下列任一版本所需的最高版本： 指定的程式庫舉例來說，如果您的應用程式同時包含 v14 Preference Support Library 和 v17 Leanback 程式庫，最低需求 SDK 必須為 17 以上版本。