支援資料庫套件

注意:支援資料庫 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 版本應至少為 API 級別 14。部分套件需要更高的 API 級別,如下所示。

v4 支援資料庫

這些程式庫包含與其他程式庫相比,擁有最多的 API 組合,包括支援應用程式元件、使用者介面功能、無障礙功能、資料處理、網路連線和程式設計公用程式。

如需第 4 版支援資料庫類別和方法的完整詳細資訊,請參閱 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 類別。第 4 版 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

第 7 版資訊卡檢視畫面程式庫

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

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

com.android.support:cardview-v7:28.0.0

v7 格線版面配置程式庫

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

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

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter 程式庫

這個程式庫提供支援 Google CastMediaRouterMediaRouteProvider 和相關媒體類別。

一般來說,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

v7 recyclerview 程式庫

Recyclerview 程式庫會新增 RecyclerView 類別。這個類別支援 RecyclerView 小工具,提供有限的資料項目視窗,可讓您有效率地顯示大型資料集。

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

com.android.support:recyclerview-v7:28.0.0

v7 偏好設定支援資料庫

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

v7 Preference 程式庫新增對介面 (例如 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 類別。第 4 版 Fragment 類別是獨立的類別,可提供後續平台版本新增的錯誤修正,而 v13 FragmentCompat 類別可為 Fragment 類別的架構實作提供相容性缺口。

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

com.android.support:support-v13:28.0.0

v14 Preference 支援資料庫

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

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

com.android.support:preference-v14:28.0.0

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

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

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

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

v17 Leanback 程式庫

android.support.v17.leanback 套件提供的 API 可協助您在 TV 裝置上建構使用者介面。會提供多個適用於 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 中做為獨立構件使用。

百分比支援資料庫開始支援 PercentLayoutHelper.PercentLayoutParams 介面和各種類別,例如 PercentFrameLayout PercentRelativeLayout

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

com.android.support:percent:28.0.0

ExifInterface 支援資料庫

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

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

com.android.support:exifinterface:28.0.0

電視應用程式推薦支援資料庫

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

應用程式程式庫開始支援註解,例如 ContentRecommendation.ContentMaturity 和各種類別 (例如 ContentRecommendation 推薦擴充程式)。

這個套件需要 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