注意:Android 9.0 (API 級別 28) 推出後,支援資料庫的新版本「AndroidX」也隨之問世,並成為 Jetpack 的一部分。AndroidX 程式庫包含現有的支援程式庫,以及最新的 Jetpack 元件。
您可以繼續使用支援程式庫。
舊版構件 (27 以上版本,且封裝為 android.support.*
) 仍可在 Google Maven 上取得。不過,所有新程式庫開發作業都會在 AndroidX 程式庫中進行。
建議您在所有新專案中使用 AndroidX 程式庫。您也應考慮將現有專案遷移至 AndroidX。
在開發專案中設定 Android 支援程式庫的方式,取決於您想使用的功能,以及應用程式要支援的 Android 平台版本範圍。
本文將逐步說明如何下載支援程式庫套件,以及在開發環境中新增程式庫。
支援程式庫現已透過 Google 的 Maven 存放區提供。我們已停止支援透過 SDK 管理工具下載程式庫,這項功能即將移除。
選擇支援程式庫
將支援資料庫加入應用程式之前,請先決定要加入哪些功能,以及要支援的最低 Android 版本。如要進一步瞭解不同程式庫提供的功能,請參閱「支援程式庫功能」。
新增支援程式庫
如要使用支援程式庫,您必須在開發環境中修改應用程式專案的類別路徑依附元件。您必須針對要使用的每個支援程式庫執行這項程序。
如要在應用程式專案中新增支援程式庫,請按照下列步驟操作:
- 在專案的
settings.gradle
檔案中加入 Google 的 Maven 存放區。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' // } } }
- 如要在模組中使用支援程式庫,請在模組
build.gradle
檔案的dependencies
區塊中新增程式庫。舉例來說,如要新增 v4 核心公用程式庫,請新增下列項目: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
後置字元。
注意:使用支援程式庫中的類別時,請務必從適當的套件匯入類別。舉例來說,套用 ActionBar
類別時:
android.support.v7.app.ActionBar
時使用支援資料庫。android.app.ActionBar
,僅在開發 API 級別 11 以上版本時。
注意:在應用程式專案中加入支援程式庫後,強烈建議您縮減、混淆及最佳化應用程式,以便發布。除了使用模糊處理保護原始碼,縮減功能還會從您應用程式中包含的任何程式庫移除未使用的類別,盡可能縮減應用程式的下載大小。
如需使用部分支援資料庫功能的進一步指引,請參閱 Android 開發人員訓練課程、指南和範例。如要進一步瞭解個別支援程式庫類別和方法,請參閱 API 參考資料中的 android.support
套件。
資訊清單聲明異動
如果您要使用支援資料庫,將現有應用程式的回溯相容性提升至舊版 Android API,請務必更新應用程式的資訊清單。具體來說,您應將資訊清單中
<uses-sdk>
標記的 android:minSdkVersion
元素更新為較新的較低版本號碼,如下所示:
<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 程式庫和 v17 Leanback 程式庫,最低 SDK 版本就必須是 17 以上。