支援資料庫套件

注意:自支援資料庫 28.0.0 推出後,android.support 封裝的程式庫已淘汰,並替換為分別封裝為 androidx 的獨立版本 Jetpack 程式庫。Jetpack 程式庫的初始 1.0.0 版本提供與支援資料庫 28.0.0 相同的功能,並提供從「遷移至」androidx 套件的起點。

現有的 android.support 封裝程式庫會繼續運作,但不會收到 28.0.0 以後的任何更新,也不會與新的 Jetpack 程式庫相容。 歷史構件 (27 以下版本,並封裝為 android.support 的版本) 仍會保留在 Google Maven。所有新構件都會封裝為 androidx,並需要從 android.support 遷移androidx

建議您在所有新專案中使用 androidx 程式庫。我們也建議您考慮遷移現有的專案,確保專案能持續收到錯誤修正項目和其他程式庫改善項目。

Android 支援資料庫包含多個程式庫套件,可納入您的應用程式中。這些程式庫都支援特定範圍的 Android 平台版本和功能組合。

如要使用下列任一程式庫,您必須將程式庫檔案下載到 Android SDK 安裝程序中。按照支援資料庫設定中下載支援資料庫的操作說明完成這個步驟。您必須採取額外步驟,在應用程式中加入特定的支援資料庫。請參閱下方每個程式庫部分的結尾,瞭解如何在應用程式中加入程式庫。

注意:所有支援資料庫套件的最低 SDK 版本至少為 14。部分套件需要更高的 API 級別,如下所示。

v4 支援資料庫

相較於其他程式庫,這些程式庫包含數量最多的 API 組合,包括應用程式元件、使用者介面功能、無障礙功能、資料處理、網路連線以及程式設計公用程式。

如想完整瞭解 v4 支援資料庫所提供的類別和方法,請參閱 API 參考資料中的 android.support.v4 套件。

注意:在支援資料庫修訂版本 24.2.0 之前,有一個 v4 支援資料庫。為了提高效率,這個程式庫分為多個模組。為了兼顧回溯相容性,如果您在 Gradle 指令碼中列出 support-v4,應用程式將包含所有 v4 模組。不過,為了縮減應用程式大小,建議您直接列出應用程式需要的特定模組。

v4 Compat 程式庫

為多個架構 API (例如 Context.obtainDrawable()View.performAccessibilityAction()) 提供相容性包裝函式。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-compat:28.0.0

v4 Core-utils 程式庫

提供多個公用程式類別,例如 AsyncTaskLoaderPermissionChecker

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-core-utils:28.0.0

v4 Core-ui 程式庫

實作各種 UI 相關元件,例如 ViewPagerNestedScrollViewExploreByTouchHelper

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-core-ui:28.0.0

v4 media-compat 程式庫

向後移植媒體架構的部分,包括 MediaBrowserMediaSession

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-media-compat:28.0.0

v4 片段程式庫

新增透過片段封裝使用者介面和功能的支援,讓應用程式提供可在小螢幕和大螢幕裝置間調整的版面配置。這個模組具有 compatcore-utilscore-uimedia-compat 的依附元件。

注意:v13 支援資料庫提供 FragmentCompat 類別。v4 Fragment 類別是獨立類別,可提供後續在後續平台版本中新增的錯誤修正項目,而 v13 FragmentCompat 類別則為 Fragment 類別的架構實作提供相容性規範。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-fragment:28.0.0

Multidex 支援資料庫

這個程式庫支援建構具有多個 Dalvik Executable (DEX) 檔案的應用程式。如果應用程式參照超過 65536 個方法,就必須使用 Multidex 設定。如要進一步瞭解如何使用 Multidex,請參閱「 使用超過 64K 方法建構應用程式」一文。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:multidex:1.0.0

v7 支援資料庫

這些程式庫提供特定的功能集,可獨立納入您的應用程式中。

v7 appcompat 程式庫 (Android Jetpack 的一部分)。

注意:appcompat 程式庫已遷移至 AndroidX 程式庫,這是 Android Jetpack 元件。請參閱 Sunflower 試用版應用程式,瞭解相關用途。

這個程式庫開始支援動作列使用者介面設計模式。這個程式庫支援質感設計使用者介面實作。

注意:此程式庫依附於 v4 支援資料庫。

以下是 v7 Appcompat 程式庫所含的一些重要類別:

  • ActionBar:提供動作列使用者介面模式的實作方式。如要進一步瞭解如何使用動作列,請參閱「動作列」開發人員指南。
  • AppCompatActivity - 新增應用程式活動類別,用來做為使用支援資料庫動作列實作的活動的基礎類別。
  • AppCompatDialog - 新增對話方塊類別,可用來做為 AppCompat 主題對話方塊的基礎類別。
  • ShareActionProvider:支援可納入動作列的標準化分享動作,例如電子郵件或發布至社交應用程式。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:appcompat-v7:28.0.0

v7 Cardview 程式庫

這個程式庫新增了 CardView 小工具支援,可讓您在任何應用程式中顯示外觀一致的資訊卡。這些資訊卡適合質感設計實作,且廣泛用於 TV 應用程式的版面配置。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:cardview-v7:28.0.0

第 7 版格線版面配置程式庫

您下載 Android 支援資料庫後,這個程式庫會新增對 GridLayout 類別的支援,讓您可以使用矩形儲存格格線排列使用者介面元素。如要進一步瞭解 v7 格線版面配置程式庫 API,請參閱 API 參考資料中的 android.support.v7.widget 套件。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter 程式庫

這個程式庫提供 MediaRouterMediaRouteProvider 以及支援 Google Cast 的相關媒體類別。

一般來說,v7 mediarouter 程式庫中的 API 可讓您控制媒體管道和串流從目前裝置傳送到外部螢幕、喇叭和其他目的地裝置的轉送方式。這個程式庫提供 API,可用於發布應用程式專屬的媒體路徑供應商,用於探索及選取目的地裝置、檢查媒體狀態等等。如要進一步瞭解 v7 mediarouter 程式庫 API,請參閱 API 參考資料中的 android.support.v7.media 套件。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:mediarouter-v7:28.0.0

支援資料庫 r18 中導入的 v7 mediarouter 程式庫 API 可能會隨支援資料庫的後續修訂版本變更。目前,我們建議您僅與 Google Cast 搭配使用程式庫。

v7 調色盤資料庫

v7 調色盤支援資料庫包含 Palette 類別,可讓您從圖片擷取顯眼顏色。舉例來說,音樂應用程式可以使用 Palette 物件從專輯封面擷取主要顏色,然後使用這些顏色建立配色的歌名卡。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:palette-v7:28.0.0

第 7 版 Recyclerview 程式庫

recyclerview 程式庫會新增 RecyclerView 類別。這個類別支援 RecyclerView 小工具,這個檢視畫面可提供有限的資料項目,有效顯示大型資料集。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:recyclerview-v7:28.0.0

v7 偏好設定支援資料庫

preference 套件提供的 API 支援新增偏好設定物件 (例如 CheckBoxPreferenceListPreference),可讓使用者修改 UI 設定。

v7 偏好設定資料庫開始支援介面 (例如 Preference.OnPreferenceChangeListenerPreference.OnPreferenceClickListener),以及 CheckBoxPreferenceListPreference 等類別。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:preference-v7:28.0.0

v8 支援資料庫

這個程式庫提供特定的功能集,可獨立納入您的應用程式中,獨立於其他程式庫。

v8 轉譯指令碼程式庫

這個程式庫新增對 RenderScript 運算架構的支援。這些 API 包含在 android.support.v8.renderscript 套件中。請注意,在應用程式中加入這些 API 的步驟與其他支援資料庫 API 完全不同。如要進一步瞭解如何在應用程式中使用這些 API,請參閱 RenderScript 開發人員指南。

注意:Android Studio 和以 Gradle 為基礎的版本支援將 RenderScript 與支援資料庫搭配使用。轉譯指令碼程式庫位於 build-tools/$VERSION/renderscript/ 資料夾。

以下範例顯示這個程式庫的 Gradle 建構指令碼屬性:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 支援資料庫

這個程式庫透過 (FragmentCompat) 類別和其他片段支援類別新增對 Fragment 使用者介面模式的支援。若要進一步瞭解片段,請參閱片段開發人員指南。如要進一步瞭解 v13 支援資料庫 API,請參閱 API 參考資料中的 android.support.v13 套件。

注意:v4 片段程式庫提供 Fragment 類別。v4 Fragment 類別是獨立類別,可提供後續在後續平台版本中新增的錯誤修正項目,而 v13 FragmentCompat 類別則為 Fragment 類別的架構實作提供相容性規範。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-v13:28.0.0

v14 偏好設定支援資料庫

android.support.v14.preference 套件提供 API,可用於新增 PreferenceFragment.OnPreferenceStartFragmentCallbackPreferenceFragment.OnPreferenceStartScreenCallback 等偏好設定介面的支援,以及 MultiSelectListPreferencePreferenceFragment 等類別。如要進一步瞭解 v14 Preference 支援資料庫 API,請參閱 API 參考資料中的 preference 套件。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:preference-v14:28.0.0

適用於電視的 v17 偏好設定支援資料庫

android.support.v17.preference 套件提供 API,可用於在電視裝置上提供偏好設定介面,包括支援 LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener 介面和類別,例如 BaseLeanbackPreferenceFragmentLeanbackPreferenceFragment。如要進一步瞭解 v17 偏好設定支援資料庫 API,請參閱 API 參考資料中的 preference 套件。

這個套件需要 API 級別 17 或以上版本。這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

 com.android.support:preference-leanback-v17:28.0.0 

v17 Leanback 程式庫

android.support.v17.leanback 套件提供 API,支援在 TV 裝置上建構使用者介面。為電視應用程式提供了一些重要的小工具。以下列舉幾個值得注意的類別:

這個套件需要 API 級別 17 或以上版本。這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:leanback-v17:28.0.0

向量可繪項目程式庫

支援靜態向量圖形。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-vector-drawable:28.0.0

動畫向量可繪項目程式庫

支援動畫向量圖形。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:animated-vector-drawable:28.0.0

註解支援資料庫

Annotation 套件提供 API,可讓您在應用程式中新增註解中繼資料。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:support-annotations:28.0.0

設計支援資料庫

設計套件提供的 API 可協助您在應用程式中加入質感設計元件和模式。

設計支援資料庫新增各種質感設計元件和模式的支援,供應用程式開發人員進行建構,例如導覽匣、懸浮動作按鈕 (FAB)、Snackbar 和分頁

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:design:28.0.0

自訂分頁支援資料庫

自訂分頁套件提供 API,支援在應用程式中新增及管理自訂分頁。

自訂分頁支援資料庫開始支援各種類別,例如自訂分頁服務自訂分頁回呼

這個套件需要 API 級別 15 以上。這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:customtabs:28.0.0

Percent 支援資料庫

Percent 套件提供的 API 支援在應用程式中新增及管理百分比維度。

注意:自 26.0.0 版起,Percent 支援資料庫已不適用。這個模組的用戶端應改用新的 ConstraintLayout 小工具,這個小工具會在 SDK Manager 中以獨立構件提供。

Percent 支援資料庫新增了 PercentLayoutHelper.PercentLayoutParams 介面和各種類別的支援,例如 PercentFrameLayout PercentRelativeLayout

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:percent:28.0.0

ExifInterface 支援資料庫

Exif 標記會直接將螢幕方向、日期和時間、相機資訊,以及位置等資訊直接儲存在 JPEG 或 RAW 檔案中。ExifInterface 類別取消套裝組合支援從 JPEG 和原始 (DNG、CR2、NEF、NRW、ARW、RW2、ORF、PEF、SRW 和 RAF) 格式檔案讀取 Exif 資訊,並在 JPEG 圖片檔設定 Exif 資訊。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:exifinterface:28.0.0

TV 應用程式推薦支援資料庫

應用程式推薦套件提供 API,支援在 TV 裝置上執行的應用程式新增內容推薦。

應用程式程式庫新增了對註解的支援 (例如 ContentRecommendation.ContentMaturity) 和各種類別,例如 ContentRecommendation RecommendationExtender

這個套件需要 API 級別 21 或以上版本。這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:recommendation:28.0.0

Wear UI 資料庫

這個程式庫的 API 可用於為 Wear 應用程式建構使用者介面。 android.support.wear.widget 套件提供的 API 會取代穿戴式裝置支援資料庫中的對應 API。

詳情請參閱「 使用 Wear UI 程式庫」。

這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:

com.android.support:wear:28.0.0