注意:推出支援資料庫 28.0.0 版後,android.support
中已封裝
程式庫已淘汰,並由個別版本的 Jetpack 取代
封裝為 androidx
的程式庫初始 1.0.0
發布的 Jetpack 程式庫與支援資料庫 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 組合 包括支援應用程式元件、使用者介面功能 無障礙功能、資料處理、網路連線和程式設計 其他公用程式
如需
請參閱 API 參考資料中的 android.support.v4
套件。
注意:支援資料庫 24.2.0 之前的版本之前
單一 v4 支援資料庫這個程式庫分為多個模組
提高效率為了顧及回溯相容性
Gradle 指令碼中的 support-v4
,您的應用程式將包含所有
第 4 版的模組不過,如要縮減應用程式大小,建議您只列出
應用程式所需的特定模組
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 程式庫
向後移植 media 架構的某些部分
包括 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 執行檔 (DEX) 檔案的應用程式。 如果應用程式參照超過 65536 個方法,就必須使用 Multidex 設定。適用對象 如要進一步瞭解如何使用 Multidex,請參閱 使用超過 64,000 種方法建構應用程式
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:multidex:1.0.0
v7 支援資料庫
這些程式庫會提供特定的功能組合,您可以將其納入您的應用程式中 彼此獨立
7 版 appcompat 程式庫 Android Jetpack 的一部分。
注意:appcompat 程式庫已遷移至 AndroidX 程式庫,Android Jetpack 元件。請參閱 Sunflower 試用版應用程式。
這個程式庫新增對 動作列使用者 介面設計 模式。這個程式庫包含 Material Design 使用者介面 。
注意: 這個程式庫依附於 v4 支援資料庫。
以下是 v7 appcompat 程式庫中的幾個主要類別:
ActionBar
:提供動作列的實作。 使用者介面模式。如要 有關使用動作列的資訊,請參閱 動作列開發人員指南。AppCompatActivity
- 新增可傳送該活動的應用程式活動類別 用做支援資料庫動作列的活動基礎類別 。AppCompatDialog
- 新增可做為基礎的對話方塊類別 AppCompat 主題對話方塊的類別。ShareActionProvider
- 新增標準化的支援功能 可納入 動作列。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:appcompat-v7:28.0.0
第 7 版 cardview 程式庫
這個程式庫新增對 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 程式庫
這個程式庫提供 MediaRouter
、MediaRouteProvider
以及相關的媒體類別,
支援 Google Cast。
一般來說,v7 mediarouter 程式庫中的 API 提供
控制從目前裝置導向到媒體頻道和串流內容的方式
外接螢幕、喇叭和其他目標裝置程式庫包括
用於發布應用程式專屬媒體路徑供應商,以及探索和
選擇目的地裝置及檢查媒體狀態等如需詳細
第 7 版 Mediarouter 程式庫 API 的詳細資訊,請參閱
API 中的 android.support.v7.media
套件
參照。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:mediarouter-v7:28.0.0
支援資料庫導入的 v7 mediarouter 程式庫 API r18 日後可能會修訂支援資料庫修訂版本。在此 建議您只在搭配 Google Cast 時才使用程式庫。
第 7 版調色盤程式庫
第 7 版調色盤支援資料庫包含
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 Preference 支援資料庫
偏好
套件提供 API,支援新增偏好設定物件,例如
CheckBoxPreference
和
ListPreference
,為期
讓使用者修改使用者介面設定。
Preference 程式庫第 7 版新增了介面,例如:
「Preference.OnPreferenceChangeListener
」和
「Preference.OnPreferenceClickListener
」和「類別」
例如 CheckBoxPreference
和
ListPreference
。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:preference-v7:28.0.0
第 8 版支援資料庫
這個程式庫提供特定功能集,可以加到應用程式中 獨立於其他程式庫中
第 8 版 Renscript 程式庫
這個程式庫新增對
RenderScript 運算
這個架構的重點在於這些 API 包含在 android.support.v8.renderscript
套件中。個人中心
請注意,在應用程式中加入這些 API 的步驟十分簡單
與其他支援資料庫 API 不同進一步瞭解如何使用這些 API
請參閱
RenderScript
開發人員指南
注意:Android 支援透過支援資料庫使用 RenderScript
以 Studio 和 Gradle 為基礎的建構。
RenScript 程式庫位於 build-tools/$VERSION/renderscript/
資料夾中。
以下範例顯示這個程式庫的 Gradle 建構指令碼屬性:
defaultConfig { renderscriptTargetApi 18 renderscriptSupportModeEnabled true }
v13 版支援資料庫
這個程式庫新增支援
適用於 Fragment 使用者介面模式
具有 (FragmentCompat
) 類別和其他片段支援
類別如需進一步瞭解片段,請參閱
片段開發人員指南。如需詳細
請參閱 API 參考資料中的 android.support.v13
套件,瞭解第 13 版支援資料庫 API 的相關資訊。
注意: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 Support Library API,請參閱
偏好
封裝於 API 參考資料中
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:preference-v14:28.0.0
適用於電視的 v17 Preference 支援資料庫
android.support.v17.preference
套件提供用於提供偏好設定的 API
介面,包括
LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
介面和類別
BaseLeanbackPreferenceFragment
和
LeanbackPreferenceFragment
。如需詳細
v17 Preference Support Library API 的詳細資訊,請參閱
偏好
封裝於 API 參考資料中
這個套件需要 API 級別 17 以上的版本。Gradle 建構指令碼 這個程式庫的依附元件 ID 如下:
com.android.support:preference-leanback-v17:28.0.0
17 版 Leanback 程式庫
android.support.v17.leanback
套件提供支援的 API
建立使用者介面
在電視上觀看能為 TV 應用程式提供許多重要的小工具。以下列舉幾個熱門類別:
BrowseFragment
- 的片段 建立瀏覽類別和媒體列的主要版面配置 項目。DetailsFragment
- 包裝函式 Leanback 詳細資料畫面的片段。PlaybackOverlayFragment
至 ADetailsFragment
的子類別 顯示播放控制項和相關內容。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
註解支援資料庫
註解 套件提供 API,支援將註解中繼資料新增至應用程式。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:support-annotations:28.0.0
設計支援資料庫
設計套件 提供的 API,支援將 Material Design 元件和模式新增至應用程式。
Design Support 程式庫新增支援各種 Material Design 元件和模式, 要建構的應用程式開發人員,例如導覽匣、懸浮動作按鈕 (FAB)。 Snackbar 和分頁。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:design:28.0.0
自訂分頁支援資料庫
自訂分頁 套件提供 API,支援在應用程式中新增和管理自訂分頁。
自訂分頁支援資料庫現在支援各種類別,例如 自訂分頁 服務 和 自訂分頁 回呼。
這個套件需要 API 級別 15 以上級別。 這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:customtabs:28.0.0
百分比支援資料庫
百分比 套件提供的 API 支援新增及管理百分比 應用程式內的尺寸
注意:百分比支援資料庫已自 26.0.0 版起淘汰。
此模組的用戶端應遷移至新版 ConstraintLayout
小工具,在 SDK Manager 中以獨立成果的形式提供。
Percent 支援資料庫新增 PercentLayoutHelper.PercentLayoutParams 介面 和各種類別 PercentFrameLayout 和 PercentRelativeLayout。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:percent:28.0.0
ExifInterface 支援資料庫
Exif 標記儲存方向、日期和時間、相機等資訊
然後直接在 JPEG 或 RAW 檔案中儲存位置。ExifInterface
類別取消套裝組合支援從 JPEG 讀取 EXIF 資訊
以及採用 raw (DNG、CR2、NEF、NRW、ARW、RW2、ORF、PEF、SRW 和 RAF) 的格式
檔案,以及在 JPEG 圖片檔中設定 EXIF 資訊。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:exifinterface:28.0.0
電視應用程式推薦支援資料庫
應用程式 建議 套件提供 API,可讓您為在 TV 裝置上執行的應用程式新增內容推薦。
應用程式程式庫新增註解支援,例如 ContentRecommendation.ContentMaturity 和各種類別,例如 內容推薦 和 建議延伸器。
這個套件需要 API 級別 21 以上版本。 這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:recommendation:28.0.0
Wear UI 程式庫
這個程式庫含有可用來為 Wear 應用程式建構使用者介面的 API。 您可以在 android.support.wear.widget 套件, 取代穿戴式裝置支援資料庫中對應的 API。
若需更多資訊,請參閲 使用 Wear UI 程式庫。
這個程式庫的 Gradle 建構指令碼依附元件 ID 如下:
com.android.support:wear:28.0.0