支援資料庫套件

注意:推出支援資料庫 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 程式庫

提供許多公用程式類別,例如 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 程式庫

向後移植 media 架構的某些部分 包括 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 執行檔 (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 程式庫

這個程式庫提供 MediaRouterMediaRouteProvider 以及相關的媒體類別, 支援 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,支援新增偏好設定物件,例如 CheckBoxPreferenceListPreference,為期 讓使用者修改使用者介面設定。

Preference 程式庫第 7 版新增了介面,例如: 「Preference.OnPreferenceChangeListener」和 「Preference.OnPreferenceClickListener」和「類別」 例如 CheckBoxPreferenceListPreference

這個程式庫的 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.OnPreferenceStartFragmentCallbackPreferenceFragment.OnPreferenceStartScreenCallback, 以及類別 MultiSelectListPreferencePreferenceFragment。如需詳細 如要進一步瞭解 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 介面和類別 BaseLeanbackPreferenceFragmentLeanbackPreferenceFragment。如需詳細 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 應用程式提供許多重要的小工具。以下列舉幾個熱門類別:

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