支援資料庫修訂版本封存檔

本頁提供舊版支援資料庫套件版本的詳細資訊。如需最新的支援資料庫版本,請參閱近期支援資料庫修訂版本

修訂版本 26.0.0 Beta 2

(2017 年 6 月)

請注意,26.0.0-beta2 是預先發布版。而且 API 介面隨時可能變更,而且不一定包含最新支援資料庫穩定版本的功能或錯誤修正。

重要事項:您現在可以透過 Google 的 Maven 存放區取得支援資料庫。您不需要從 SDK Manager 下載支援存放區。詳情請參閱支援程式庫設定

全新的 API

API 差異

修正錯誤

  • Android O SDK 推送會導致 TextView 中的斜體消失
  • 連線至 MediaBrowserServiceCompat 時出現空值指標例外狀況
  • TextInputLayout 必須在 onProvideAutofillStructure() 設定提示
  • 在 O 上使用 TextView 自動調整大小時,堆疊溢位

修訂版本 26.0.0 Beta 1

(2017 年 5 月)

請注意,26.0.0-beta1 是預先發布版。而且 API 介面隨時可能變更,而且不一定包含最新支援資料庫穩定版本的功能或錯誤修正。

重要事項:您現在可以透過 Google 的 Maven 存放區取得支援資料庫。您不需要從 SDK Manager 下載支援存放區。詳情請參閱支援程式庫設定

重要變更

  • 已移除 FragmentActivity.setSupportMediaController()FragmentActivity.getSupportMediaController()。請使用新的靜態 MediaControllerCompat.setMediaController()MediaControllerCompat.getMediaController() 方法。
  • 現在選取已選取的項目時,BottomNavigationView 會呼叫 onNavigationItemReselected(),而不是呼叫 onNavigationItemSelected()
  • findViewById() 方法的所有執行個體現在會傳回 <T extends View> T,而非 View。這項變更會造成以下影響:
    • 這可能會導致現有程式碼現在具有不明確的傳回類型,例如,如果 someMethod(View)someMethod(TextView) 都會接收對 findViewById() 的呼叫結果。
    • 使用 Java 8 原文語言時,如果傳回類型未受限 (例如 assertNotNull(findViewById(...)).someViewMethod())),就必須明確將層級轉換為 View
    • 非最終 findViewById() 方法 (例如 Activity.findViewById()) 的覆寫需要更新其傳回類型。

全新的 API

  • FragmentManagerFragment 提供 isStateSaved() 方法,允許查詢在沒有狀態遺失的情況下,系統是否允許交易。這種做法特別適合在執行任何交易前處理 onClick() 事件時進行檢查。
  • AnimatedVectorDrawableCompat 支援路徑動態。路徑動作可讓物件動畫工具根據一個路徑同時變更兩個屬性;路徑在動畫器的 XML 中會指定為 android:pathData
  • 以物理學為基礎的動畫
    • 新增 FlingAnimation,支援以初始速度製作動畫,並順暢執行速度。
    • DynamicAnimation 的子類別支援任何物件的自訂屬性。
    • SpringAnimationFlingAnimation 現在可以以浮點值建立動畫效果,而不必與 ViewObject 建立關聯。

    詳情請參閱「彈簧動畫」和「Fling 動畫」預覽頁面。

  • XML 格式的字型支援
    • ResourcesCompat.getFont 允許載入可與 TextView.setTypeface() 搭配使用的字型資源 (包括字型系列 XML)。
    • 使用 AppCompat 時,TextView 支援透過 android:fontFamily XML 屬性指定字型資源或字型系列 XML。
    • 使用 XML 字型系列建立具有樣式和粗細變化的字型系列。(如果您使用支援資料庫類別執行此動作,請使用 app: 屬性和 android: 屬性)。
  • 可下載的字型:
    • 新增的 FontsContractCompat 可讓您向字型供應程式要求字型,而不是在應用程式中隨附字型。
    • 您也可以在 XML 中要求字型並用於版面配置。
  • 表情符號相容性資料庫
    • EmojiCompat 可以處理指定的 CharSequence,並新增 EmojiSpans
    • EmojiTextView 和其他小工具以顯示表情符號。
    • FontRequestEmojiCompatConfig 可要求字型提供者提供的表情符號字型。
  • 「Autosizing TextView」
    • TextViewCompat 中的新方法以及 XML 屬性,用於控制 TextView 中的自動調整大小。
  • 支援跳轉功能並可使用 Leanback 播放控制項:
    • 新增 PlaybackTransportRowPresenter,可透過 SeekBar 算繪播放控制項。
    • 新增可與 PlaybackTransportRowPresenter 搭配使用且支援跳轉功能的新 PlaybackTransportControlGlue
    • 新的應用程式基礎類別 PlaybackSeekDataProvider,可為 PlaybackTransportControlGlue 提供搜尋縮圖。
  • Preferences Data Store:
    • PreferenceDataStore 現在可讓您實作自己的偏好設定儲存空間,並在 PreferencePreferenceManager 中使用新方法進行設定。

已知問題

  • 與 Google Play 服務整合的可下載字型和表情符號相容性僅適用於 Google Play 服務 11 以上版本。目前可透過 Google Play 服務 Beta 版計畫推出。

修正錯誤

  • MediaBrowserCompat.search() API 無法運作 (Android 開放原始碼計畫問題 262170)
  • ViewCompat.postInvalidateOnAnimation() 會擲回例外狀況 (Android 開放原始碼計畫問題 80146)
  • 針對已刪除 Activity 中的片段呼叫 onActivityCreated()
  • RecyclerView.isComputingLayout() 應在預先擷取期間傳回 true
  • Fade 轉換中斷並反向播放時,View 會從頭開始播放動畫。(修正從 Android 架構移植)。
  • Transition.Fade 會忽略 View 的初始 Alpha 版 (Android 開放原始碼計畫問題 221820)

修訂版本 26.0.0 Alpha 1

(2017 年 3 月)

請注意,26.0.0-alpha1 為預先發布版。而且 API 介面隨時可能變更,而且不一定包含最新支援資料庫穩定版本的功能或錯誤修正。

重要變更

注意:最低 SDK 版本已提高到 14。 因此,許多只有 API 小於 14 相容性的 API 已淘汰。這些 API 的用戶端應依據各個已淘汰 API 的參考資料頁面所述,改用對應的架構。

  • 已淘汰支援百分比模組。這個模組的用戶端應遷移至新的 ConstraintLayout 小工具,該小工具會在 SDK Manager 中做為獨立構件提供。
  • 支援片段模組不再是 support-media-compat 模組的依附元件。

全新的 API

新增許多類別、方法和常數,為 O 預覽版中新增的平台 API 提供回溯相容性。

  • IME_FLAG_NO_PERSONALIZED_LEARNING:針對具有私人模式的應用程式 (例如瀏覽器),IME 可以監聽「沒有學習」標記。這項功能可協助 IME 瞭解應用程式是否處於私人模式,因此當應用程式處於該模式時,就能停用學習或自動調整功能。

如需 25.2.0 至 26.0.0-alpha1 版本的完整 API 變更清單,請參閱支援資料庫 API 差異報告

修正錯誤

  • 在某些情況下,簡易 AutoTransition 動畫可能會被檢視區塊「跳躍」中斷。(AOSP 問題 221816)。

修訂版本 25.4.0

(2017 年 6 月)

重要事項:您現在可以透過 Google 的 Maven 存放區取得支援資料庫。您不需要從 SDK Manager 下載支援存放區。詳情請參閱支援程式庫設定

重要變更

  • FragmentManager 狀態變更期間,不允許使用 executePendingTransactions()commitNow()popBackStackImmediate() 和類似的交易呼叫。交易的註冊執行不安全,現在 FragmentManager 會在狀態變更期間強制執行此操作。
  • 與這個支援資料庫版本並行,我們也將發布 Multidex 1.0.2 版。這個版本包含下列重要變更:
    • 允許檢測 APK 的多重查詢。
    • 淘汰 MultiDexTestRunner (應改用 AndroidJUnitRunner)。
    • 針對應用程式的某些封存擷取管理作業提供更完善的防護。
    • 修正可能導致暫存檔案捨棄的錯誤。
    • 在並行程序進行時加快安裝速度。
    • 修正 API 19 和 20 的安裝錯誤。

全新和經過修改的 API

AnimatedVectorDrawableCompat 支援路徑變形和路徑內插。路徑變形可讓形狀從一個路徑 (指定為 android:valueFrom) 變更為其他路徑 (指定為 android:valueTo),以提供複雜且吸引人的視覺效果。路徑內插器可將 AnimatedVectorDrawableCompat 的內插器指定為路徑 (在內插器 XML 中指定為 android:pathData)。

API 差異

已修正問題

  • 連線至 MediaBrowserServiceCompat 時出現空值指標例外狀況
  • MediaBrowserCompat.search() API 無法運作 (Android 開放原始碼計畫問題 262170)
  • 瀏覽 Fragment onItemClicked 回呼在 25.3.0 中無效
  • 在 25.3.1 版中上下捲動 VerticalGridView 時出現 NullPointerException
  • SimpleArrayMap.allocArrays() 中的 ClassCastException

修訂版本 25.3.1

(2017 年 3 月)

已修正問題

  • SwitchCompat 需要 SDK 14 以上版本。(Android 開放原始碼計畫問題 251302)
  • 以物理為基礎的動畫 updateListener 會略過第一個影格。
  • BottomNavigationView 標籤動畫損毀。

修訂版本 25.3.0

(2017 年 3 月)

重要變更

透過 Gradle 建構時,支援資料庫版本中繼資料會自動新增至 AndroidManifest.xml,可簡化公開建構作業中的追蹤版本。例如:

<meta-data android:name="android.support.VERSION" android:value="25.3.0" />

淘汰項目

這個版本淘汰了多種方法和類別。這些已淘汰的 API 將在日後推出的版本中移除,且開發人員應進行遷移。如要進一步瞭解如何從特定 API 遷移,請參閱該 API 的說明文件。

ExifInterface
布林值方法 getLatLong(float[]) 已淘汰。請改用新方法 getLatLong(),這個方法不需要引數並傳回 double[]
mediacompat
PlaybackStateCompat.Builder.setErrorMessage(CharSequence) 已淘汰。請改用新的方法 setErrorMessage(int, CharSequence),系統會傳遞錯誤代碼和選填說明。
EXTRA_SUGGESTION_KEYWORDS 已淘汰,請改用 MediaBrowserCompat 搜尋功能。
v7.recyclerview
LinearLayoutManager.getInitialItemPrefetchCount() 已重新命名為 LinearLayoutManager.getInitialPrefetchItemCount()。系統仍支援舊名稱,但會在日後推出的版本中移除。

全新和經過修改的 API

appcompat-v7
新方法 ActionBarDrawerToggle.setDrawerSlideAnimationEnabled(boolean) 簡化了停用導覽匣切換圖示的動畫。
customtabs
新增訊息管道支援。詳情請參閱 CustomTabsService.requestPostMessageChannel()CustomTabsService.postMessage() 參考資料。
dynamic-animation
新的物理動畫程式庫提供一組 API,用於建構能動態回應使用者輸入內容的動畫。
leanback-v17
新增對視差背景的支援詳情請參閱 Parallax 參考資料。
新增 TimePicker 小工具,以便選取電視介面時間。
mediacompat
新增搜尋功能。詳情請參閱 MediaBrowserCompat.search()MediaBrowserServiceCompat.onSearch() 參考資料。
新增對隨機播放和重複模式的支援。詳情請參閱 MediaSessionCompat.setRepeatMode()setShuffleModeEnabled() 參考資料。

已修正問題

修訂版本 25.2.0

(2017 年 2 月)

重要異動

已修正問題

  • 此版本修正了嚴重的中介路由器問題:使用 A2DP 裝置和媒體轉送 API 可能會導致裝置無法回應,且必須重新啟動。
  • FragmentManager.FragmentLifecycleCallbacks 類別現在是靜態類別。

已修正問題

  • 顯示具有畫面鏡像的投影片簡報,造成裝置中斷 Wi-Fi 連線
  • 媒體按鈕未妥善處理未透過 setMediaButtonReceiver() 註冊的媒體應用程式
  • 字串資源發生 VectorDrawable 錯誤 (Android 開放原始碼計畫問題 232407)
  • 如果文字是透過 XML 設定,TextInputLayout 重疊提示和文字 (Android 開放原始碼計畫問題 230171)
  • MediaControllerCompat 中的記憶體流失 (Android 開放原始碼計畫問題 231441)
  • RecyclerViewLayoutTest.triggerFocusSearchInOnRecycledCallback() (異常終止)
  • 回收檢視容器時 RecyclerView 會當機 (Android 開放原始碼計畫問題 225762)
  • getAllowGeneratedReplies() 會針對 WearableExtender 內的動作錯誤傳回 false

修訂版本 25.1.1

(2017 年 1 月)

重要事項:支援資料庫 25.1.1 和 25.1.0 修訂版本的 android.support.v7.media.MediaRouter 類別中有一個已知錯誤。如果您的應用程式使用 7 版 MediaRouter,建議您更新至支援資料庫修訂版本 25.2.0,藉此修正這項錯誤。

重要異動

  • 您現在可以在交易內和跨交易間最佳化片段交易。最佳化片段交易作業可以消除取消的作業。舉例來說,假設同時執行兩項交易,一項會新增片段 A,第二項則將片段 A 替換為片段 B。在這種情況下,系統可能會取消第一項作業,只新增片段 B。這表示片段 A 可能無法執行建立/刪除生命週期。

    這項最佳化的缺點是,片段的狀態變更可能與預期順序不符。舉例來說,假設某項交易新增了 A 片段,第二個交易則新增 B 片段,而第三個交易則移除片段 A。如果沒有最佳化,片段 B 可以預期在建立片段時也會存在,因為新增片段 B 後,系統就會移除片段 A。透過最佳化作業,由於最佳化可能會移除片段 A 的建立和刪除作業,因此片段 B 無法確保建立 B 片段時確實存在。

    這項最佳化功能預設為停用。如要啟用最佳化功能,請呼叫 FragmentTransaction.setAllowOptimization(true)

  • 片段現在可以延遲轉換和動畫,直到可以使用 Fragment.postponeEnterTransition()Fragment.startPostponedEnterTransition() 為止。這個 API 類似於在活動轉換中使用的 Activity.postponeEnterTransition()Activity.startPostponedEnterTransition()

已修正問題

修訂版本 25.1.0

(2016 年 12 月)

重要事項:支援資料庫 25.1.1 和 25.1.0 修訂版本的 android.support.v7.media.MediaRouter 類別中有一個已知錯誤。如果您的應用程式使用 7 版 MediaRouter,建議您更新至支援資料庫修訂版本 25.2.0,藉此修正這項錯誤。

重要異動

  • 巢狀 RecyclerView 小工具的用戶端 (例如水平捲動清單的垂直捲動清單) 可以提示內部 RecyclerView 小工具的版面配置管理工具在畫面捲動前要準備的項目數量,藉此大幅提升效能。呼叫 LinearLayoutManager.setInitialPrefetchItemCount(N),其中 N 是每個內部項目可見的檢視畫面數量。舉例來說,如果您的內部水平清單一次顯示至少三個半項目檢視畫面,您可以呼叫 LinearLayoutManager.setInitialPrefetchItemCount(4) 改善效能。這樣做可讓 RecyclerView 盡早建立所有相關的檢視畫面,而外部 RecyclerView 需要捲動,藉此大幅減少捲動時的延遲。
  • FragmentActivity.setSupportMediaController()FragmentActivity.getSupportMediaController() 已淘汰。請使用新的靜態 MediaControllerCompat.setMediaController()MediaControllerCompat.getMediaController() 方法。
  • 當用戶端透過 appcompat 著色功能指定小工具色調 (例如 appcompat:buttonTint) 時,用戶端必須負責提供所有必要狀態 (例如「已停用」、「已按下」等)。這與使用架構色調時指定小工具色調的方式一致。

全新和經過修改的 API

已修正問題

  • 密碼瀏覽權限切換按鈕導致無障礙測試失敗。
  • Appcompat 在 L 之前版本的裝置上不會遵循 state_enabled
  • RecyclerView 中新增聚焦復原機制。此外,這也修正了使用 Android TV 裝置等 DPAD 導覽時,對前片段焦點失焦的支援功能。
  • Leanback:BrowseFragment 在停用標頭和空白轉接器時異常終止。
  • Appcompat:AlertDialog 太寬。
  • InputContentInfoCompat 會在應呼叫 releasePermission() 時呼叫 requestPermission()
  • MediaBrowserCompat 當機。
  • 當瀏覽權限設為 GONE 時,CoordinatorLayout 會測量/配置檢視畫面。
  • 無法在 API 級別 24 以下的層級上調整 AnimatedVectorDrawableCompat
  • Leanback 程式庫觸發了錯誤的 Lint 錯誤
  • 調色盤程式庫導致每個 API 級別的測試失敗
  • RecyclerView 個 Leanback 測試失敗
  • 回收檢視容器時 RecyclerView 會當機 (Android 開放原始碼計畫問題 225762)
  • 未針對返回堆疊中的片段呼叫 Fragment.onDestroy()
  • 收合時不會繪製 CollapsingToolbarLayout 紗罩
  • CoordinatorLayout.offsetChildByInset() 會擲回 IllegalArgumentException
  • RecyclerView 項目加上動畫效果會卸離內部 RecyclerView,防止日後預先擷取
  • 附加的 RecyclerView 項目無法設為巢狀預先擷取
  • 系統會在第一個版面配置期間捨棄巢狀 RecyclerView 項目的資料預先擷取資料
  • 如果兩個拖曳事件到達相同位置,RecyclerView 預先擷取作業就會失敗
  • RecyclerView 應在轉譯 RenderThread 時按推測性版面配置
  • 將夜間設定的顏色資源轉換為可繪項目,但不一定會從資源快取中正確清除
  • FloatingActionButton:透過程式輔助方式設定 BackgroundTintList 無法正常運作 (Android 開放原始碼計畫問題 227428)
  • TextInputLayout:未設定 ErrorView 的 Typeface (Android 開放原始碼計畫問題 227803)
  • TextInputLayout 一律會改回 API 23 以下的淺色錯誤顏色 (Android 開放原始碼計畫問題 221992)
  • 當指標離開時,FloatingActionButton 會顯示為按下

Android 開放原始碼計畫 Issue Tracker 提供了完整的公開錯誤修正清單。

淘汰項目

這個版本淘汰了多種方法和類別。這些已淘汰的 API 會在日後推出的版本中移除,且開發人員應進行遷移。如要進一步瞭解如何從特定 API 遷出,請參閱該 API 的說明文件。

修訂版本 25.0.1

(2016 年 11 月)

已修正問題

Android 開放原始碼計畫 Issue Tracker 提供了完整的公開錯誤修正清單。

修訂版本 25.0.0

(2016 年 10 月)

重要變更

  • ContextCompat 建構函式已受到保護。此類別不應公開例項化,但可能會透過指定較新 API 級別的支援資料庫來擴充該類別。
  • ActivityCompat 建構函式已受到保護。此類別不應公開例項化,但可能會透過指定較新 API 級別的支援資料庫來擴充該類別。
  • getReferrer(Activity) 已設定為靜態。
  • 已移除 android.support.design.widget.CoordinatorLayout.Behavior.isDirty(CoordinatorLayout, V)。這個方法的所有用戶端實作都應移除。
  • 已移除 android.support.v4.media.session.MediaSessionCompat.obtain(Context, Object)。應替換為更適當命名的方法 fromMediaSession()
  • 已移除 android.support.v4.media.session.MediaSessionCompat.QueueItem.obtain(Object)。應替換為更適當的命名方法 MediaSessionCompat.QueueItem#fromQueueItem
  • 已移除 android.support.v7.widget.Space。用法應替換為 android.support.v4.widget.Space

全新的 API

  • android.support.design.widget.BottomNavigationView 類別會實作 Material Design 規格的底部導覽模式。
  • 新的 android.support.v13.view.inputmethod 套件包含用於存取 API 級別 13 之後推出的 android.view.inputmethod.InputConnection 功能的類別。
  • android.v7.widget.RecyclerView.DividerItemDecoration 類別可為項目之間提供垂直或水平分隔線的基本實作。
  • android.support.v7.app.NotificationCompatDecoratedCustomViewStyleDecoratedMediaCustomViewStyle 中的裝飾新樣式,對應了平台 API 24 中新增的類別。

已修正問題

Android 開放原始碼計畫 Issue Tracker 提供了完整的公開錯誤修正清單。

修訂版本 24.2.1

2016 年 9 月

修正問題:

Android 開放原始碼計畫 Issue Tracker 提供了完整的公開錯誤修正清單。

修訂版本 24.2.0

2016 年 8 月

24.2.0 版包含下列變更:

注意:版本 24.2.0 移除對 Android 2.2 (API 級別 8) 以下版本的支援。僅用於提供這些系統版本的類別和方法現在會標示為已淘汰,因此不應再使用。日後推出的版本可能會移除這些已淘汰的類別和方法。

v4 支援資料庫分割畫面

在這個版本中,v4 支援資料庫已分割為幾個較小的模組:

support-compat
為新的架構 API 提供相容性包裝函式,例如 Context.getDrawable()View.performAccessibilityAction()
support-core-utils
提供多種公用程式類別,例如 AsyncTaskLoaderPermissionChecker
support-core-ui
實作各種 UI 相關元件,例如 ViewPagerNestedScrollViewExploreByTouchHelper
support-media-compat
向後移植「媒體」架構的部分,包括 MediaBrowserMediaSession
support-fragment
向後移植片段架構。這個模組具有 support-compatsupport-core-utilssupport-core-uisupport-media-compat 的依附元件。

為回溯相容性,如果在 Gradle 指令碼中列出 support-v4,APK 會包含這些模組。不過,為減少 APK 大小,建議您直接列出應用程式所需的特定模組。

API 更新

行為異動

  • 如果使用 appcompat 程式庫的「日/夜」功能,系統現在會在白天/夜間模式變更 (無論是因為時段,或呼叫 AppCompatDelegate.setLocalNightMode()) 時自動重新建立活動。
  • 如果狀態列是半透明,Snackbar 現在會在導覽列後方繪製。

MediaRouter 程式庫

藍牙裝置不再列為媒體路徑。將音訊轉送至藍牙裝置的功能現在只能在 Android 系統層級控管。

淘汰項目

日後推出的版本可能會移除已淘汰的類別和方法。建議您盡快停用這些 API。

  • 下列類別的幾個方法僅適用於 API 8 以下級別,因此不應再使用。請改用架構實作。
    • android.support.v4.view.KeyEventCompat:替換為 KeyEvent
    • android.support.v4.view.MotionEventCompat:使用 MotionEvent
    • android.support.v4.view.ViewCompat:使用 View
    • android.support.v4.view.ViewConfigurationCompat:使用 ViewConfiguration
  • AccessibilityServiceInfoCompat.getDescription() 已淘汰,並改用 AccessibilityServiceInfoCompat.loadDescription(),後者會傳回正確本地化的說明。
  • 請勿直接對 ActivityCompat 類別執行個體化。在即將發布的版本中,非靜態的 getReferrer(Activity) 方法會設為靜態方法。
  • CoordinatorLayout.Behavior.isDirty() 已淘汰,CoordinatorLayout 不會再呼叫。所有實作方式與對這個方法的呼叫都應移除。
  • MediaSessionCompat.obtain() 已淘汰,並替換為更適當的名稱方法 fromMediaSession()
  • MediaSessionCompat.QueueItem.obtain() 已淘汰,並替換為更適當的名稱方法 fromQueueItem()
  • 部分抽象類別已淘汰,並替換為能更忠實地反映架構對等項目的介面。
  • CustomTabsSession.setToolbarItem() 已淘汰,並替換為以 RemoteViews 為基礎的 setSecondaryToolbarViews()

修正錯誤

下列已知問題已在 24.2.0 版中修正:

Android 開放原始碼計畫 Issue Tracker 提供了完整的公開錯誤修正清單。

修訂版本 24.1.1

2016 年 7 月

修正問題:

  • 修正 24.1.0 版中影響支援資料庫共用資源 ID 的問題。這個問題會導致依附於支援資料庫 (例如設計和 appcompat) 的應用程式遇到資源 ID 不符所造成的問題。

修訂版本 24.1.0

2016 年 7 月

v4 支援資料庫異動:

修正問題:

修訂版本 24.0.0

2016 年 6 月

v4 支援資料庫異動:
  • 已為同步修訂版本新增 Fragment.commitNow()
  • 已為多方對話新增 NotificationCompat.MessagingStyle
  • 已新增 NotificationManagerCompat.areNotificationsEnabled()getImportance()
  • MediaSessionCompat 現已具備 MediaSession 的功能鏡像,不會再自動呼叫 setMediaButtonReceiver()

注意:只有 24.0.0 版中的 MediaBrowserServiceCompat 與 API 24 之後的未來 Android 版本具有前瞻相容性。如果您使用的是舊版,為確保相容性,請更新至這個版本。

第 7 版 appcompat 程式庫的變更:
設計支援資料庫相關變更:
17 Leanback 程式庫變更:
  • 新增了 OnboardingFragment,以提供首次執行的歡迎和設定流程
自訂分頁相關異動:
  • 開始支援為次要工具列提供 RemoteViews 階層
  • 已新增 CustomTabsClient.connectAndInitialize() 用於單行暖機

修訂版本 23.4.0

2016 年 5 月

v4 支援資料庫異動:
  • 修正問題:片段的新增順序有誤。(問題 206901)。
  • 修正應用程式列捲動畫面外後無法繪製的問題。(問題 178037)。
第 7 版 appcompat 程式庫的變更:
設計支援資料庫相關變更:
向量可繪項目程式庫的變更:

修訂版本 23.3.0

2016 年 4 月

v4 支援資料庫異動:
  • 新增了 AppLaunchChecker,協助您追蹤使用者過去如何啟動應用程式。hasStartedFromLauncher() 可讓您知道使用者是否從主畫面啟動應用程式,或只透過其他方式啟動應用程式 (例如查看特定網址)。
  • 修正 MediaBrowserServiceCompat.mConnections 中的記憶體流失問題。(問題 205220)。
  • 修正問題:切換頁面時,ViewPager 不會考量頁面邊界。(問題 203816)。
  • Fragment.onRequestPermissionsResult() 現已傳送至子項片段。
第 7 版 appcompat 程式庫的變更:
v7 Mediarouter 程式庫的變更:
v7 Preference 程式庫變更:
v7 recyclerview 程式庫變更:
設計支援資料庫相關變更:

修訂版本 23.2.1

2016 年 3 月

v4 支援資料庫異動:
第 7 版 appcompat 程式庫的變更:
  • 還原向量資產的依附元件,避免使用 appcompat 程式庫的開發人員強制使用 VectorDrawable 及其相關聯的建構旗標。
  • 修正夜間模式和 API 級別 23 的相容性問題。(問題 201910)。
  • 修正了 SwitchCompat 和 API 級別 7 的相容性問題。(問題 201942)。
  • 修正了以下問題:資源物件中的設定值傳播問題 問題 201928
  • 已修正 API 級別 21 以下版本的 android.support.v7.app.NotificationCompat.MediaStyle 取消按鈕不會顯示的相容性問題。(問題 202156)。
  • 已修正 API 級別 21 及以下級別中與 AppCompatSpinner 的相容性異常終止問題(問題 202246)。
  • 修正 app:textAllCaps = "false" 樣式無法運作的問題。(問題 202117)。
  • 修正還原 SearchView 時發生的異常終止問題(問題 201836)。
  • 修正使用 AppCompat 上繪製可繪製資源時發生的記憶體流失問題。(問題 202379)。
  • 已修正 API 級別 11 及以下級別的 KeyEvent 問題。(問題 202939)。
v7 Cardview 程式庫相關變更:
v7 recyclerview 程式庫變更:
v7 Mediarouter 程式庫的變更:
17 版 Leanback 程式庫變更:
  • 修正 GridLayout.onAddFocusables() 會導致選取錯誤項目的問題
  • 修正 GuidedStepFragment 動作在收合後消失的問題
設計支援資料庫相關變更:
VectorDrawableCompat 的變更:
  • 修正 android:tintMode 讀取了錯誤變數的錯誤。(問題 201907)。

修訂版本 23.2.0

2016 年 2 月

v4 支援資料庫相關異動:
  • 新增了 MediaBrowser 支援的 MediaBrowserCompat,並為 MediaBrowserService 支援新增 MediaBrowserServiceCompat。如要連結媒體應用程式的背景服務與使用者介面元件,而且不需要 API 級別 21 以上即可整合 Android Auto 和 Android Wear,這項功能就能派上用場。
  • 現在,系統會為巢狀 FragmentActivity 呼叫 onActivityResult()
第 7 版 AppCompat 程式庫的變更:
  • 在 API 級別 14 及以上級別新增夜間模式功能。根據時間或應用程式專屬設定,在 Material Light 和 Material 深色主題之間切換。
    • 可在這裡查看白天和夜晚的主題:<sdk>/extras/android/support/v7/appcompat/res/values/themes_daynight.xml
    • AppCompatDelegate.setDefaultNightMode():傳遞下列其中一個常數來設定應用程式的預設模式:
      • MODE_NIGHT_AUTO
      • MODE_NIGHT_NO
      • MODE_NIGHT_YES
      • MODE_NIGHT_FOLLOW_SYSTEM
    • AppCompatDelegate.setLocalNightMode():覆寫本機應用程式元件的夜間模式設定。
    • AppCompatDelegate.getDefaultNightMode():傳回預設的夜間模式。
v7 mediarouter 程式庫異動:
設計支援資料庫相關變更:
  • 開始支援底部功能表。互動外掛程式 BottomSheetBehavior 可讓 CoordinatorLayout 的子項檢視畫面做為底部功能表使用。基礎類別 BottomSheetCallback 提供回呼,用來監控底部功能表事件。
CustomTabs 支援資料庫的變更:
  • 除了現有的頂端動作按鈕以外,Chrome 自訂分頁現在也允許應用程式加入含有動作按鈕的底部列。
  • CustomTabsIntent.Builder.addToolBarItem():在自訂分頁中新增動作按鈕。可用來新增多個按鈕。
  • CustomTabsSession.setToolBarItem():更新工具列項目的視覺效果。唯有具備有效的 ID,且瀏覽器工作階段位於前景時,這個方法才能成功執行。
新增了 VectorDrawable 支援資料庫:
  • 新增類別:
    • VectorDrawableCompat
    • AnimatedVectorDrawableCompat
  • 對在 API 級別 7 或以上版本執行的應用程式新增 VectorDrawable 資產的支援。API 級別 11 以上也支援 AnimatedVectorDrawable 素材資源。向量素材資源可能比圖片素材資源小許多,有助於縮減應用程式大小,進而支援多種裝置螢幕所需的素材資源量。
  • 這個程式庫現在是 v7 AppCompat 程式庫的依附元件,可讓開發人員和 AppCompat 輕鬆使用向量可繪項目。如要在 ImageButtonImageView 中使用 VectorDrawableCompat,請使用 app:srcCompat XML 屬性或 setImageResource() 方法。
  • 如要在 API 級別 20 或以下級別中繼續參照屬性 ID,請在 build,gradle 檔案中加入以下 appt 標記:
    • 如要使用 Gradle 適用的 Android 外掛程式 1.5.0 以下版本進行建構,請在 build.gradle 檔案中加入以下內容:
    • android {
        defaultConfig {
          // Stops the Gradle’s automatic rasterization of vectors
          generatedDensities = []
        }
         // Flag that tells aapt to keep the attribute ids
        aaptOptions {
          additionalParameters "--no-version-vectors"
        }
      }
      
    • 如要使用 Gradle 適用的 Android 外掛程式 2.0.0 以上版本進行建構,請在 build.gradle 檔案中加入以下內容:
    • android {
        defaultConfig {
          vectorDrawables.useSupportLibrary = true
        }
      }
      
17 Leanback 程式庫變更:
  • GuidedStepFragment 新增功能,該元件可引導使用者做出一項決策或一系列的決策:
    • GuidedAction 中新增按鈕動作:
      • GuidedStepFragment.setButtonActions():設定使用者可從「動作」檢視畫面中選取的 GuidedAction 按鈕清單。
    • 說明欄位現在開放編輯:
      • GuidedAction.Builder.descriptionEditable():傳遞 true 時,將動作說明設為可供編輯。
      • GuidedAction.getEditDescription():會以 CharSequence 的形式傳回可編輯的說明。
    • 新增子動作的下拉式清單:
      • GuidedAction.setSubActions():將 GuidedAction 清單設為子動作的下拉式選單。
  • 已新增 DatePicker 功能的 GuidedDatePickerAction 小工具:
    • 您可以使用「年」、「月」和「日」資料欄選取日期,而且可以自訂範圍。
    • GuidedDatePickerAction.BuilderGuidedDatePickerAction 物件的建構工具類別。
    • GuidedDatePickerAction.Builder.datePickerFormat(String datePickerFormat):傳遞適當的三字元 String (例如 “YMD”“MDY”),藉此設定所需的日期格式。或者,您也可以使用 datePickerFormat XML 屬性。
v7 RecyclerView 程式庫變更:

修訂版本 23.1.1

2015 年 11 月

v7 recyclerview 程式庫變更:
  • 修正以下問題:執行 ItemTouchHelper 公用程式類別提供的滑動關閉動作,然後新增項目時會發生當機的情形。(問題 190500)。
v7 偏好設定資料庫變更:
17 版 Leanback 支援資料庫變更:
  • 修正這個程式庫中的一些內部問題。
設計支援資料庫相關變更:
  • 已將 getHeaderView 方法新增至 NavigationView 類別。
  • 修正在搭載 Android 4.0 (API 級別 15) 以下版本的裝置上,FloatingActionButton 物件的透明背景問題。(問題 183315)。

修訂版本 23.1.0

2015 年 10 月

v4 支援資料庫異動:
  • NestedScrollView 小工具新增 OnScrollChangedListener 介面支援。讓您在捲動 X 或 Y 位置變更時接收回呼。
  • 已新增 MediaButtonReceiver 類別,以便將收到的播放控制項轉送至管理 MediaSessionCompat 類別的服務。MediaSessionCompat 類別的建構函式可自動在資訊清單中尋找媒體按鈕接收器。媒體按鈕接收器是處理硬體或藍牙控制項的播放控制項的關鍵部分。
v7 appcompat 程式庫的變更:
  • 新增質感設計 SeekbarImageButton 小工具。
  • 已更新 ImageView 小工具以支援色調功能。
  • 已更新 SwitchCompat 小工具的外觀和風格。
v7 mediarouter 程式庫異動:
  • 已將下列功能新增至 MediaRouteChooserDialog 類別:
    • 在探索媒體路徑供應商時顯示載入頁面。
    • 加入裝置類型圖示,方便系統識別裝置。
    • 根據目前應用程式的使用頻率排序路線。
    • 支援橫向模式。
  • 已將下列功能新增至 MediaRouteControllerDialog 類別:
    • 識別螢幕投放功能,並提供適當的說明。
    • 支援各種專輯封面大小和顯示比例,並以非同步方式載入圖片。
    • 根據應用程式的主要顏色,自動選取內容顏色。
    • 根據裝置可用的螢幕空間調整對話方塊版面配置。
    • 支援橫向模式。
v7 調色盤程式庫的變更:
  • 新增了 setRegion() 方法,支援從 Bitmap 物件的特定區域擷取顏色。
v7 recyclerview 程式庫變更:
  • ItemAnimator 類別中加入改善的動畫 API,提供更佳的自訂功能:
    • 變更動畫不會再強制執行兩個 ViewHolder 物件副本,該物件會啟用項目內容動畫。此外,ItemAnimator 物件可決定是否重複使用相同的 ViewHolder 物件,或是建立新物件。
    • 新的資訊記錄 API 可讓 ItemAnimator 類別靈活地在版面配置生命週期的正確時間點收集資料。這項資訊稍後會傳遞至動畫回呼。
  • 針對這項回溯不相容的 API 變更,提供簡易的轉換計畫:
    • 如果您先前擴充了 ItemAnimator 類別,可以將基礎類別變更為 SimpleItemAnimator,程式碼應可照常運作。SimpleItemAnimator 類別會包裝新的 API,提供舊的 API。
    • 部分方法已從 ItemAnimator 類別中移除。以下程式碼將不再編譯:
    • Kotlin

      recyclerView.itemAnimator.supportsChangeAnimations = false
      

      Java

      recyclerView.getItemAnimator().setSupportsChangeAnimations(false)
      

      就可以替換為以下程式碼:

      Kotlin

      val animator: SimpleItemAnimator? = recyclerView.itemAnimator as? SimpleItemAnimator
      animator?.supportsChangeAnimations = false
      

      Java

      ItemAnimator animator = recyclerView.getItemAnimator();
      if (animator instanceof SimpleItemAnimator) {
         ((SimpleItemAnimator) animator).setSupportsChangeAnimations(false);
      }
      
v7v14v17 Preference 支援資料庫的變更:
  • 移除了用於控制 EditText 對話方塊的 API。
17 版 Leanback 支援資料庫變更:
  • 為支援資料庫新增 GuidedStepFragment 類別的版本 (擴充 android.support.v4.app.Fragment),並改善動畫和轉場效果。
  • 已更新 GuidedStepFragment 類別,使其可置於現有內容上方。
  • 新增在 SearchFragment 類別為不同類型的搜尋完成數加上註解的功能。
  • VerticalGridFragment 類別中新增交錯投影片轉場支援功能。
設計支援資料庫相關變更:
  • TextInputLayout 小工具新增 字元計數支援功能。
  • 透過新增 SCROLL_FLAG_SNAP 常數,為 AppBarLayout 類別新增邊緣貼齊支援。捲動結束時,如果檢視畫面只有部分顯示,系統會貼齊檢視畫面,並捲動至最接近的邊緣。
  • 使用 app:actionLayout 屬性或 MenuItemCompat.setActionView() 方法,在 NavigationView 類別中新增自訂檢視畫面的支援。
自訂分頁支援資料庫相關異動:
  • 已將 enableUrlBarHiding() 方法新增至 CustomTabsIntent 類別。可讓用戶端自訂是否要在向下捲動時自動隱藏網址列。
  • 已將 setActionButton() 方法新增至 CustomTabsSession 類別。可讓用戶端在已啟用的自訂分頁中變更自訂動作按鈕的圖示。
  • TAB_SHOWNTAB_HIDDEN 常數新增為 CustomTabsCallback 類別的 onNavigationEvent 方法的新事件。

修訂版本 23.0.1

2015 年 9 月

v7v14 偏好設定支援資料庫的變更:
  • 新增了質感設計版面配置和樣式檔案。(問題 183376)。
v7 appcompat 程式庫的變更:
  • 已透過限制使用硬體層至 Android 4.1 (API 級別 16) 以上版本,修正 Fragment 類別的當機問題。(問題 183896)。
  • 修正以下問題:當活動使用 setSupportActionBar() 方法,將 Toolbar 類別設為 ActionBar 時,硬體按鈕無法正常運作。(問題 183334)。
  • 已更新 AppCompatDialogFragment 類別,使其不再擲回 Windows feature must be requested before adding content 錯誤。 (問題 183186)。
設計支援資料庫相關變更:
自訂分頁支援資料庫相關異動:

修訂版本 23

2015 年 8 月

新增支援資料庫:

如需支援資料庫異動的完整清單,請參閱支援資料庫 API 差異報表

修訂版本 22.2.1

2015 年 7 月

設計支援資料庫相關變更:
  • FloatingActionButton 類別中加入 hide()show() 方法,以便透過程式輔助方式觸發動畫。
  • 已將 LENGTH_INDEFINITE 常數新增至 Snackbar 類別,以便在關閉或顯示其他 Snackbar 前顯示 Snackbar。此外,已新增 setActionTextColor(int)setActionTextColor(ColorStateList) 方法。
  • 已將 getSelectedTabPosition() 方法新增至 TabLayout 類別,以擷取目前選取的分頁。
  • 為方法鏈的 android.support.v7.app.NotificationCompat.MediaStyle 類別提供功能完善的 API。
  • RecyclerView 中新增便利方法,用於批次插入項目。

如需支援資料庫異動的完整清單,請參閱支援資料庫 API 差異報表

修訂版本 22.2.0

2015 年 5 月

新增設計支援資料庫:
  • 已新增 TextInputLayout,可將 EditText 提示和錯誤文字顯示為浮動標籤。
  • 新增了 FloatingActionButton,以在介面中實作主要動作做為懸浮動作按鈕,並支援預設或最小尺寸。
  • 新增了 Snackbar,用於在動畫 Snackbar 中提供可選動作的輕量意見回饋。
  • 新增了 TabLayout,用於實作固定和可捲動的分頁,並能輕鬆與 ViewPager 整合。
  • 新增 NavigationView 以實作導覽匣內容,包括透過選單資源加載選單項目的功能。
  • 新增 CoordinatorLayout 這個一般用途的版面配置,用來建構同層級檢視畫面之間的依附元件,並透過 CoordinatorLayout.Behavior 輕鬆捲動不同元件之間的反應。許多設計程式庫元件皆仰賴 CoordinatorLayout 的子項。
  • 新增 AppBarLayout,用於 Toolbar 和其他檢視畫面 (例如 TabLayout) 的容器,用於對捲動事件做出回應,例如捲動螢幕外、因向下捲動而看到事件,或是在捲動畫面離開/開啟畫面前收合/取消收合。
  • 新增了 CollapsingToolbarLayout,用於控制 Toolbar 的收合方式工具列可能會透過下列方式收合:將元件固定在螢幕頂端,並導入 ImageView 等元件的視差捲動,或在檢視畫面部分收合時新增內容剪輯顏色。
v4 支援資料庫異動:
v7 appcompat 程式庫的變更:

如需支援資料庫異動的完整清單,請參閱支援資料庫 API 差異報表

修訂版本 22.1.0

2015 年 4 月

註解程式庫的變更:
  • 新增了註解程式庫,支援進階程式碼檢查功能。系統會將註解新增為中繼資料標記,您可以附加至變數、參數和回傳值,以檢查方法回傳值、傳遞的參數以及本機變數和欄位。
v4 支援資料庫異動:
v7 appcompat 程式庫的變更:
17 leanback 程式庫異動:
v7 recyclerview 程式庫變更:
v8Renderscript 程式庫的變更:

修訂版本 22

2015 年 3 月

v4 支援資料庫異動:
v7 appcompat 程式庫的變更:
17 leanback 程式庫異動:
v7 mediarouter 程式庫異動:
v7 recyclerview 程式庫變更:

修訂版本 21.0.3

2014 年 12 月

v4 支援資料庫異動:

修訂版本 21.0.2

2014 年 11 月

v4 支援資料庫異動:
v7 appcompat 程式庫的變更:
  • 新增了 PopupMenu 建構函式,以支援新的彈出式選單。
  • 新增對 Toolbar 類別中的「收合」圖示說明的支援。
  • 更新 SearchView 小工具以支援顯示 commitIcon
  • 已從 Toolbar 類別中移除 buttonGravity 屬性。
v7 Cardview 程式庫變更:
v7 recyclerview 程式庫變更:
17 leanback 程式庫異動:
  • 新增產生 v4 程式碼片段的支援功能。
  • 已變更 CardView 的次要文字顏色。

修訂版本 21.0.1

2014 年 11 月

新增 Multidex 支援資料庫,以便在 Android 5.0 以下版本中支援多個 Dalvik 執行檔 (DEX) 檔案,以便支援多 dex 檔案。

修訂版本 21

2014 年 10 月

v4 支援資料庫異動:
  • 針對搭載 Android 5.0 (API 級別 21) 的裝置新增 Fragment 轉換的支援。請注意,轉場效果不會影響搭載 Android 4.4 以下版本的裝置。
  • 新增了 DocumentFile,以便在處理文件樹狀結構時輕鬆從 File 轉場。不過,相較於 Android 4.4 (API 級別 19) 中新增的平台 DocumentsContract API,這個類別需要的處理負擔會更多。因此,在 Android 4.4 以上版本中執行時,應改用 DocumentsContract
v7 appcompat 程式庫的變更:
  • 開始支援質感設計使用者介面。
  • 新增 Toolbar,可將 ActionBar 的功能一般化,以便用於應用程式版面配置中。
  • 更新了 ActionBarDrawerToggle,其中包含選單箭頭動畫
  • 更新常見的使用者介面小工具,以便在 Android 5.0 之前的裝置中執行時,透過主題屬性進行色調
  • 新增 SwitchCompat,這是在 Android 4.0 (API 級別 14) 中新增的 Switch 小工具向後移植。
新增 v7 Cardview 程式庫
  • 新增 CardView 小工具,其提供與 Material Design 相容的實作,以便顯示資料項目。
新增 v7 recyclerview 程式庫
  • 新增 RecyclerView 小工具,提供彈性的清單檢視,以便為大型資料集提供有限的視窗。
新增 v7 調色盤程式庫
  • 新增了 Palette 類別,可讓您擷取圖片中的醒目顏色。
新增 v17 leanback 程式庫

修訂版本 20

2014 年 7 月

v4 支援資料庫異動:

修訂版本 19.1.0

2014 年 3 月

v4 支援資料庫異動:
  • 新增 SwipeRefreshLayout 類別,讓使用者可透過垂直滑動手勢重新整理檢視畫面的內容。
  • 修正導覽匣的無障礙功能問題。
v7 appcompat 程式庫變更:
  • 修正動作列的背景問題。

修訂版本 19.0.1

2013 年 12 月

v4 支援資料庫異動:
v7 mediarouter 程式庫的變更:
v8Renderscript 程式庫的變更
  • 新增了 RenderScript 特許層的錯誤傳播。

修訂版本 19

2013 年 10 月

v4 支援資料庫異動:
v7 mediarouter 程式庫的變更:
  • 新增對媒體播放待播清單的支援功能,並設定 HTTP 標頭值和媒體播放時間長度。
  • 新增明確的啟動、取得和結束工作階段動作,透過媒體路由器明確管理媒體播放工作階段。

修訂版本 18

2013 年 7 月

v4 支援資料庫異動:
新的 v7 appcompat 程式庫:
  • 新增了 ActionBar,允許將動作列使用者介面的設計模式導入回 Android 2.1 (API 級別 7) 以上版本。如要使用這個類別,您必須擴充新的 ActionBarActivity 類別來實作活動。
新的 v7 mediarouter 程式庫:

新增支援 Google Cast 開發人員預覽版的 mediarouter 程式庫。 v7 mediarouter 程式庫 API 提供一種方式,可控制從目前裝置將媒體管道和串流到外部螢幕、喇叭和其他目的地裝置的路徑,且可回溯相容於 Android 2.1 (API 級別 7)。詳情請參閱 V7 mediarouter 程式庫

支援資料庫 r18 中導入的 v7 mediarouter 程式庫 API 隨時可能會變更支援資料庫的修訂版本。目前,建議您只使用與 Google Cast 開發人員預覽版相關的程式庫。

修訂版本 13

2013 年 5 月

v4 支援資料庫異動:
新的 v7 格線版面配置程式庫:
  • 新增了 GridLayout,以支援 GridLayout 版面配置物件。
  • 新增了 android.support.v7.widget.Space,可用於在 GridLayout 版面配置物件內建立空白區域。

修訂版本 12

2013 年 2 月

v4 支援資料庫異動:
  • 改善 ViewPager 的互動行為。
  • 修正可能導致 ViewPager 選取錯誤頁面的錯誤。
  • 已修正 ViewPager 版面配置期間使用 removeView() 方法的問題。
  • 已修正 SearchViewCompat 的問題:使用返回按鈕關閉無法清除搜尋文字的問題。這項修正僅適用於主機 API 級別 14 以上級別。

修訂版本 11

2012 年 11 月

v4 支援資料庫異動:

修訂版本 10

2012 年 8 月

v4 支援資料庫異動:
  • 已新增 Android 4.1 (API 級別 16) 中導入的通知功能支援,並加入 NotificationCompat

修訂版本 9

2012 年 6 月

v4 支援資料庫異動:

修訂版本 8

2012 年 4 月

v4 支援資料庫異動:
  • 已修正 TaskStackBuilder 產生的 PendingIntent 物件的意圖旗標。
  • 從格線版面配置程式庫專案中移除未使用的屬性,確保可以使用 API 級別 7 及以上版本建構程式庫。
  • 為格線版面配置程式庫專案新增 .classpath.project 檔案。

修訂版本 7

2012 年 3 月

v4 支援資料庫異動:
  • 新增了 ShareCompat,提供用於傳送和接收社群媒體分享應用程式內容的輔助類別,包括將共用資料歸因至來源應用程式的新中繼資料。這個類別也提供與 Android 4.0 版中新 ShareActionProvider 的相容整合。
  • 新增了 NavUtilsTaskStackBuilder,以支援針對導覽實作 Android 設計指南。這些新增項目包括在不同版本之間實作動作列「Up」按鈕的方法。如需這個模式的範例實作,請參閱 (<em><sdk></em>/samples/<em><platform></em>/AppNavigation) 中的 AppNavigation 範例。
  • 新增了 NotificationCompat.Builder,以提供 Android 3.0 Notification.Builder 輔助類別的相容性實作,用來建立標準化系統通知。

修訂版本 6

2011 年 12 月

注意:現在提供支援資料庫 API 的參考資料並附上架構參考資料,例如:android.support.v4.app

v4 支援資料庫異動:
  • ViewPager 異動:
    • 已新增對 ViewPager 的額外裝飾檢視支援。裝飾性檢視畫面可以做為 XML 版面配置中 Pager 的子項檢視畫面。
    • 新增了 PagerAdapter.getPageTitle(),提供網頁的標題字串,但預設為沒有每個網頁的標題。
    • 新增 PagerTitleStrip,這是非互動式的標題列,可新增為 ViewPager 的子項。開發人員可以提供文字外觀和顏色,以及版面配置大小和重力資訊。
    • 更新了 PagerAdapter 方法,以接受 ViewGroup 物件 (而非 View),避免在轉接程式實作過程中進行類別轉換。
    • 已更新 ViewPager,以便使用啟動器樣式的快速滑過行為。
    • 修正使用者介面互動和測試自動化的錯誤。
  • 支援片段:
    • 已將 setStartDeferred() 方法變更為 setUserVisibleHint(boolean)
    • 針對畫面外頁面新增延遲啟動功能,以改善效能。
  • 支援 Accessibility API:

修訂版本 5

2011 年 12 月

v4 支援資料庫異動:

修訂版本 4

2011 年 10 月

v4 支援資料庫異動:
  • 新增了 EdgeEffectCompat 以支援 EdgeEffect
  • 新增了 LocalBroadcastManager,可讓應用程式輕鬆在單一應用程式中註冊及接收意圖,而不必在全域播送意圖。
  • 已在 ViewCompat 中新增支援功能,用於在 Android 2.3 以上版本中檢查及設定 View 的過度捲動模式。
  • Fragment API 的變更:
    • 新增了可控制新選單顯示設定的 API。
    • 新增了自訂動畫 API。
    • FragmentActivity 中新增 API,以便保留非設定的自訂執行個體資料。
    • 修正多項錯誤。
  • 修正 Loader 錯誤,該錯誤在 Froyo 和舊版平台中執行時,導致取消 AsyncTask 時發生問題。支援程式碼現在會使用自有版本的 AsyncTask,以便在所有平台版本上保留相同的行為。

修訂版本 3

2011 年 7 月

v4 支援資料庫異動:
  • 新增對 Fragment.SavedState 的支援
  • 新增 MotionEventCompat 以支援較新的 MotionEvent API
  • 新增 VelocityTrackerCompat 以支援較新的 VelocityTracker API
  • 新增 ViewConfigurationCompat 以支援較新的 ViewConfiguration API
  • 所有新的 API (僅適用於支援資料庫) 可讓您建立具有水平分頁的 UI,讓使用者能在內容檢視畫面之間左右滑動。支援的類別包括:
    • ViewPager:管理子檢視畫面版面配置的 ViewGroup,使用者可在其中滑動。
    • PagerAdapter:在 ViewPager 中填入代表各頁面的檢視畫面的轉接程式。
    • FragmentPagerAdapterPagerAdapter 的擴充功能,用於切換片段。
    • FragmentStatePagerAdapterPagerAdapter 的擴充功能,用於在使用程式庫支援的 Fragment.SavedState 片段之間切換。
新的 v13 支援資料庫:
  • 包含支援橫向分頁的 FragmentPagerAdapterFragmentStatePagerAdapter

    這些 API 與新增至 v4 支援資料庫的 API 完全相同,但需依賴 Android 3.2 中的其他平台元件。如果您開發的是 Android 3.2 及以上版本,請使用這個程式庫,而非 v4 (API 級別 13 均提供 v4 程式庫中的所有其他 API)。

修訂版本 2

2011 年 5 月

第 4 版程式庫變更:

修訂版本 1

2011 年 3 月

包含 v4 程式庫的初始版本。