支援資料庫

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

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

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

開發支援多個 API 版本的應用程式時,您可能需要 在舊版 Android 或 優雅地改回使用同等功能與其建構程式碼 可以處理舊版平台,可以利用這些程式庫 為您提供相容性層另外,支援資料庫 提供其他便利類別和功能, 標準架構 API,可簡化多個應用程式的開發與支援作業 裝置。

Android 支援資料庫原本是應用程式單一二進位程式庫 開發成一系列程式庫 用於開發應用程式許多解決方案 如果應用程式並非必要,我們現在強烈建議你使用程式庫 。

本文件將概略說明支援資料庫可協助您 瞭解元件的元件,以及如何在應用程式中有效使用

注意:從支援資料庫 26.0.0 版開始 (2017 年 7 月),大多數支援程式庫支援的最低 API 級別 針對大多數的程式庫套件,已提高為 Android 4.0 (API 級別 14)。適用對象 詳情請參閱版本支援與套件 名稱

支援資料庫的用途

支援資料庫有幾種不同的用途。向後 適用於舊版平台的相容性類別只是 具體做法是指示 Kubernetes 建立並維護 一或多個代表這些 Pod 的物件以下更完整列出支援資料庫的使用方式 :

  • 適用於較新 API 的回溯相容性 - 大幅 支援資料庫可為較新的架構提供回溯相容性 各種類別和方法例如:Fragment 支援類別支援在執行版本的裝置上使用片段 Android 3.0 (API 級別 11) 以下版本。
  • 便利與輔助類別:支援程式庫提供 的輔助類別數量,特別是用於使用者介面開發。適用對象 例如,RecyclerView 類別可提供使用者 介面小工具,用於顯示及管理非常長的清單, API 級別 7 以上的 Android 版本。
  • 偵錯和公用程式:有許多功能 除了程式碼之外,還提供其他實用功能,包括 support-annotations 針對方法輸入改善程式碼 Lint 檢查功能,並支援 Multidex 支援, 可讓您透過超過 65,536 種方法設定及發布應用程式

使用 Support 與 Framework API

支援資料庫提供與以下項目相似的類別和方法: Android 架構發現這些資訊後,你可能會思考是否應該 使用 API 的架構版本或同等的支援資料庫。這裡 使用支援資料庫類別的時機 架構 API:

  • 特定功能的相容性:提供 近期的平台功能,在執行舊版 SDK 的裝置上 平台中運作,請使用支援資料庫中對等的類別和方法。
  • 相關程式庫功能的相容性 - 更精細 視支援的資料庫類別而定 程式庫類別,因此您應該針對這些類別使用支援資料庫類別 依附元件例如:ViewPager 支援類別應與 FragmentPagerAdapterFragmentStatePagerAdapter 支援類別搭配使用。
  • 一般裝置相容性 - 如果沒有適用的 您打算以回溯相容的方式使用應用程式平台功能 建議您在應用程式中使用支援資料庫類別。 舉例來說,您可以使用 ActivityCompat 取代架構 Activity 類別,以便使用新功能 比方說,納入 Android 6.0 (API 級別 23)。

支援資料庫類別,提供平台的相容實作 API 類別可能無法提供完整的功能 因為主機裝置具有限制,所以最新的版本提供 平台版本。在這些情況下,支援資料庫類別的設計宗旨就是 優雅降級,且可能無法提供 當前的平台 API因此,建議您查看參考檔案 程式庫類別和方法的說明文件,以及 執行測試,而且是在搭載最新支援平台版本的裝置上

注意:支援資料庫不提供同等項目 各個架構 API 的類別和方法在某些情況下,您可能需要 使用明確的 SDK 版本檢查來納入架構方法呼叫,並提供 用於處理裝置上不支援方法的替代程式碼。如要 若要瞭解如何在程式碼中使用版本檢查,請參閱支援不同的 平台版本

版本支援和套件名稱

部分支援資料庫套件含有用來指出 最低支援 API 級別 透過 v# 標記法 support-v4 套件的說明。自支援資料庫 26.0.0 版 (已推出 2017 年 7 月),支援的最低 API 級別已改為 Android 4.0 (API) 級別 14)。所以說 任何近期版本的支援資料庫,不應假設 v# 套件標記法表示最低 API 支援等級。 本次異動也意味著,包含 v4 的程式庫套件 和第 7 版基本上等於其支援的最低 API 級別。 舉例來說,support-v4 和 support-v7 套件都支援最低規格 API 級別為 14,適用於 26.0.0 以上版本的支援資料庫。

支援資料庫發布版本

24.2.0 或 25.0.1 版 與該程式庫中任何程式庫支援的最低 API 級別不同 版本編號。版本編號會指出平台的版本 也是以 API 為基礎建構而成,因此最近使用的 API 包含這個版本的程式庫

具體來說,是版本編號的第一部分,例如 中的 24 版,通常會與 推出時可以使用的平台 API發布版本的 支援資料庫指出,它結合了該 API 的部分功能 不過,請勿假定這種引擎可與 all 相容 新功能。

程式庫依附元件

Android 支援資料庫套件中大部分的程式庫都具備某些依附元件 一或多個程式庫例如,幾乎所有支援資料庫都有 support-compat 套件的依附元件。一般來說 不必擔心如何支援程式庫依附元件 這項工具會自動加入 相依程式庫

如果想查看哪些程式庫和程式庫依附元件 在應用程式開發的建構根目錄中執行下列指令 ,取得該專案的依附元件報表,包括 Android 支援資料庫和其他程式庫:

gradle -q dependencies your-app-project:dependencies

如要進一步瞭解如何為開發應用程式新增支援資料庫 專案。詳情請參閱「支援 程式庫設定。如要進一步瞭解如何使用 Gradle,請參閱 設定 您的版本

請注意,所有 Android 支援資料庫也依附於部分基礎等級 最新的版本為 Android 4.0 (API 級別 14) 或 更高。