注意:支援資料庫 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 程式庫
提供多個公用程式類別,例如 AsyncTaskLoader
和 PermissionChecker
。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:support-core-utils:28.0.0
v4 Core-ui 程式庫
實作各種 UI 相關元件,例如 ViewPager
、NestedScrollView
和 ExploreByTouchHelper
。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:support-core-ui:28.0.0
v4 media-compat 程式庫
向後移植媒體架構的部分,包括 MediaBrowser
和 MediaSession
。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:support-media-compat:28.0.0
v4 片段程式庫
新增對使用者介面和片段封裝的支援功能,讓應用程式提供在小螢幕和大螢幕裝置之間調整的版面配置。這個模組具有 compat、core-utils、core-ui 和 media-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 Cast 的 MediaRouter
、MediaRouteProvider
和相關媒體類別。
一般來說,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,支援新增偏好設定物件 (例如 CheckBoxPreference
和 ListPreference
),方便使用者修改 UI 設定。
v7 Preference 程式庫新增對介面 (例如 Preference.OnPreferenceChangeListener
和 Preference.OnPreferenceClickListener
) 以及 CheckBoxPreference
和 ListPreference
等類別的支援。
這個程式庫的 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.OnPreferenceStartFragmentCallback
和 PreferenceFragment.OnPreferenceStartScreenCallback
等偏好設定介面,以及 MultiSelectListPreference
和 PreferenceFragment
等類別。如要進一步瞭解 v14 Preference 支援資料庫 API,請參閱 API 參考資料中的偏好設定套件。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:preference-v14:28.0.0
電視專用的 v17 偏好設定支援資料庫
android.support.v17.preference
套件提供可在電視裝置上提供偏好設定介面的 API,包括對 LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
介面和類別 (例如 BaseLeanbackPreferenceFragment
和 LeanbackPreferenceFragment
) 的支援。如要進一步瞭解 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 應用程式的重要小工具。部分重要類別包括:
BrowseFragment
- 建立用於瀏覽類別和媒體項目列的主要版面配置的片段。DetailsFragment
- Leanback 詳細資料畫面的包裝函式片段。PlaybackOverlayFragment
-DetailsFragment
的子類別,用來顯示播放控制項和相關內容。SearchFragment
- 處理搜尋的片段。片段會接收使用者的搜尋要求,並將該要求傳遞至應用程式提供的SearchResultProvider
。SearchResultProvider
會將搜尋結果傳回SearchFragment
,並算繪為RowsFragment
。
這個套件需要 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