Appcompat

允許在舊版的 API 平台 (通常使用材質設計) 上存取新版 API。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2022 年 9 月 7 日 1.5.1 1.6.0-rc01 - -

宣告依附元件

如果要為 Appcompat 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區

在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:

Groovy

dependencies {
    def appcompat_version = "1.5.1"

    implementation "androidx.appcompat:appcompat:$appcompat_version"
    // For loading and tinting drawables on older versions of the platform
    implementation "androidx.appcompat:appcompat-resources:$appcompat_version"
}

Kotlin

dependencies {
    val appcompat_version = "1.5.1"

    implementation("androidx.appcompat:appcompat:$appcompat_version")
    // For loading and tinting drawables on older versions of the platform
    implementation("androidx.appcompat:appcompat-resources:$appcompat_version")
}

如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。發現新的問題或有改善這個程式庫的想法時,請告訴我們。建立新的問題之前,請先查看這個程式庫中的現有問題。只要按一下星號按鈕,即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件

1.6.0 版本

1.6.0-rc01 版本

2022 年 9 月 7 日

發布 androidx.appcompat:appcompat:1.6.0-rc01androidx.appcompat:appcompat-resources:1.6.0-rc011.6.0-rc01 版本包含以下修訂項目。

修正錯誤

  • AppCompatActivity 現在會設定 ViewTreeOnBackPressedDispatcherOwner,以便從檢視畫面中擷取調度工具。(I1a115b/235416503)
  • 已還原覆寫了傳遞至 onConfigurationChanged 的設定的修正錯誤,導致透過 onConfigurationChanged 插入自己的自訂設定的測試發生問題。

1.6.0-beta01 版本

2022 年 8 月 10 日

發布 androidx.appcompat:appcompat:1.6.0-beta01androidx.appcompat:appcompat-resources:1.6.0-beta011.6.0-beta01 版本包含以下修訂項目。

API 變更

  • DrawableWrapperDrawableContainerStateListDrawable Compat 類別移到公用 API (I37f3eb/227789566)。
  • 新增可進行非同步版面配置 inflater 的新工廠 (Ia657b)。

修正錯誤

  • Toolbar 現在會在顯示選單之前呼叫 onPrepareMenu(),不會在建立選單時無條件呼叫了 (I2a58db/232206677)。
  • AppCompat 現在明確依附於 Lifecycle 2.5.1SavedState 1.2.0 (I7e3e2)
  • 新增支援 AppCompatDelegate 返回叫用回呼及由 AppCompat 提供的工具列實作 (I24062)。
  • 完成 1.5.0-beta01 的 AppCompat API (I2a43db/236866227)
  • 完成 1.5.0-beta01 的 AppCompat API (I2a43db/236866227)

1.6.0-alpha05 版本

2022 年 6 月 15 日

androidx.appcompat:appcompat:1.6.0-alpha05androidx.appcompat:appcompat-resources:1.6.0-alpha05 發布。1.6.0-alpha05 版本以私人的預先發布分支版本開發,並無公開修訂項目。

API 變更

  • 更新可空值性,以便配合 Tiramisu Beta 3 SDK 最終定案的 API 介面
  • minCompileSdk 目前為 33,以便配合 Tiramisu Beta 3 SDK

1.6.0-alpha04 版本

2022 年 5 月 18 日

發布 androidx.appcompat:appcompat:1.6.0-alpha04androidx.appcompat:appcompat-resources:1.6.0-alpha04。這個程式庫是根據預先發布的分支版本開發而成,因此沒有修訂版本記錄。

API 變更

  • 新增 API 以覆寫 SwitchCompat 寬度限制,供 MDC-Android 使用

修正錯誤

  • 當 attachBaseConfig 外的設定變更時避免設定受到管理

1.6.0-alpha03 版本

2022 年 4 月 27 日

發布 androidx.appcompat:appcompat:1.6.0-alpha03androidx.appcompat:appcompat-resources:1.6.0-alpha03

這個版本必須使用 Android 13 Beta 1 進行編譯,而且不保證未來的開發人員預覽版可與執行階段相容。

新功能

  • 透過 AppCompatDelegate.setApplicationLocales() 支援全應用程式自訂語言選擇。在 API 33 以上版本中委派平台實作。

1.6.0-alpha01 版本

2022 年 2 月 23 日

androidx.appcompat:appcompat:1.6.0-alpha01androidx.appcompat:appcompat-resources:1.6.0-alpha01 發布。1.6.0-alpha01 版本以內部分支版本為基礎,且沒有可公開查看的修訂版本。

這個版本必須使用 Android Tiramisu DP1 進行編譯,而且不保證未來的開發人員預覽版可與執行階段相容。

新功能

  • 新增自訂應用程式語言代碼的支援。詳情請參閱 AppCompatDelegate.setApplicationLocales(LocaleListCompat)。針對 Android 13 中新推出的每種語言偏好設定 API,提供回溯相容性。

1.5.1 版本

1.5.1 版本

2022 年 9 月 7 日

發布 androidx.appcompat:appcompat:1.5.1androidx.appcompat:appcompat-resources:1.5.11.5.1 版本包含以下修訂項目。

依附元件更新

1.5.0 版本

1.5.0 版本

2022 年 8 月 10 日

發布 androidx.appcompat:appcompat:1.5.0androidx.appcompat:appcompat-resources:1.5.01.5.0 版本包含以下修訂項目。

自 1.4.0 版本以來的重要異動

  • 本穩定版本內含改善夜間模式穩定性的內容、修正錯誤,並為 AppCompat 支援的文字小工具提供複合可繪項目色調的支援功能,另外也改善了 API 的可用性。所有詳細的變更內容請參閱之前的 1.5.0 系列版本資訊。

1.5.0-rc01 版本

2022 年 7 月 27 日

發布 androidx.appcompat:appcompat:1.5.0-rc01androidx.appcompat:appcompat-resources:1.5.0-rc011.5.0-rc01 版本包含以下修訂項目。

修正錯誤

  • 修正了 AppCompat 的結構定義包裝函式重複使用應用程式結構定義的幕後資源實作問題,導致覆寫應用程式內容上的 uiMode (Idf9d5)。

1.5.0-beta01 版本

2022 年 7 月 13 日

發布 androidx.appcompat:appcompat:1.5.0-beta01androidx.appcompat:appcompat-resources:1.5.0-beta011.5.0-beta01 版本包含以下修訂項目。

API 變更

  • 新增可覆寫的標記,以停用預設的寬度切換調整項。(I37cb7)
  • @FloatRange 註解新增至 thumb position getter API (If524c)
  • 將缺少空值註解加入 AnimatedStateListDrawableCompat (Ieb4ec)

修正錯誤

  • 完成 1.5.0-beta01 的 AppCompat API (I2a43db/236866227)
  • 變更 ActionMenuItemViewclassName 值,將其視為 Button (I5ee1c)

1.5.0-alpha01 版本

2022 年 4 月 6 日

發布 androidx.appcompat:appcompat:1.5.0-alpha01androidx.appcompat:appcompat-resources:1.5.0-alpha011.5.0-alpha01 版本包含這些修訂版本。

API 變更

  • 新增一個 API,以便向子類別公開切換按鈕的拇指的位置 (I9bfb4)
  • 更新是否可為空值,以便比對 Tiramisu DP2 (I0cbb7)
  • 將複合可繪色調向後移植到 TextView 衍生小工具 (Idf98cb/165822337)
  • AppCompatDialog 現將 ComponentDialog 擴充至與 OnBackPressedDispatcher 相容 (Id9b91b/217620781)
  • SearchView.onQueryRefine() 現在擁有受保護的瀏覽權限,允許進行覆寫 (I6cce0b/212882845)

修正錯誤

  • AppCompat Toolbar 現在可以呼叫 MenuHostHelperonPrepareMenu() API。(I9b9b5b/227376894)
  • AppCompatEditTextAppCompatAutoCompleteEditTextAppCompatMultiAutoCompleteEditText 不會再對已在 XML 中設定的建構函式重設 clickable 或 longClickable (Ic5066b/221094907)
  • AppCompatEditTextAppCompatAutoCompleteTextViewAppCompatMultiAutoCompleteTextView 不會呼叫建構函式中被覆寫的 setKeyListener (I5c13ab/208480173)
  • Appcompat 不會包裝已傳遞至 setKeyListenerNumberKeyListener 執行個體,允許 TextView 正確設定 NumberKeyListeners 中的語言代碼 (Ibf113b/207119921)
  • 修正在 AppCompat 1.4.0 中引入且允許輸入非預期字元 (例如標點符號) 的所有 NumberKeyListener 子類別相關的問題 (Iede7ab/207119921)

1.4.2 版本

1.4.2 版本

2022 年 6 月 1 日

androidx.appcompat:appcompat:1.4.2androidx.appcompat:appcompat-resources:1.4.2 發布。1.4.2 版本包含這些修訂版本。

修正錯誤

  • 修正 AppCompatDelegateImpl 在建立動作列之前對 ensureSubDecor 進行內部撥號 (aosp/2048349b/226648941) 時的當機問題。

1.4.1 版本

2022 年 1 月 12 日

androidx.appcompat:appcompat:1.4.1」和「androidx.appcompat:appcompat-resources:1.4.1」發布。1.4.1 版本包含這些修訂版本。

修正錯誤

  • AppCompatEditTextAppCompatAutoCompleteTextViewAppCompatMultiAutoCompleteTextView 在建構函式中不會呼叫覆寫的 setKeyListener。(I5c13ab/208480173)。
  • Emoji2 不會包含 NumberKeyListener 的執行個體,並可透過 textview 設定語言代碼。
    • Appcompat 不會包含 NumberKeyListener 的執行個體以傳遞至 setKeyListener 中,這可以保證 TextView 正確設定 NumberKeyListeners 的語言代碼。(Ibf113b/207119921)
  • 修正 appcompat 1.4.0 中導入且允許非預期字元 (如輸入標點符號) 的所有 NumberKeyListener 子類別發生的問題 (b/207119921) (Iede7ab/207119921)

1.4.0 版本

1.4.0 版本

2021 年 11 月 17 日

androidx.appcompat:appcompat:1.4.0androidx.appcompat:appcompat-resources:1.4.0 發布。1.4.0 版本包含以下修訂項目。

自 1.3.0 版之後的重要異動

  • 程式庫現已指定 Java 8 語言層級
  • 根據預設,系統會透過 androidx.emoji2 程式庫啟用可更新的表情符號支援
  • 已改善 Android Studio 版面配置檢查器中的屬性檢查功能。(I02d55)
  • 已新增在 AppCompat 資源載入向後移植中的巢狀著色資源和向量可繪項目支援。不過請注意,這表示啟用向後移植後,應用程式就無法覆寫自訂資源物件的 getDrawable()。(Ia6b03b/176129022)
  • 已向後移植 CheckedTextView 可著色背景及勾號。(I8575c)

1.4.0-rc01 版本

2021 年 10 月 27 日

androidx.appcompat:appcompat:1.4.0-rc01androidx.appcompat:appcompat-resources:1.4.0-rc01 發布。1.4.0-rc01 版本包含以下修訂項目。

1.4.0-beta01 版本

2021 年 9 月 29 日

androidx.appcompat:appcompat:1.4.0-beta01androidx.appcompat:appcompat-resources:1.4.0-beta01 發布。1.4.0-beta01 版包含這些修訂版本。

API 變更

  • AndroidX AppCompat Toolbar 現在是 MenuHost,可以管理 MenuProvider。(I5cd95)

修正錯誤

  • 已修正 AppCompatProgressBar 處理 layer-list 進度列的狀況。(I6ece3b/142004509)
  • 正確保留 AppCompatEditText 中的 android:digits,這樣做修正了 AppCompat 1.4.0-alpha03 導入的錯誤 193047889。(I4b4fcb/193047889)
  • 已整合 OnReceiveContentListener SDK 和支援程式庫 API。(Ic6914b/173814913)

1.4.0-alpha03 版本

2021 年 6 月 30 日

androidx.appcompat:appcompat:1.4.0-alpha03androidx.appcompat:appcompat-resources:1.4.0-alpha03 發布。1.4.0-alpha03 版包含這些修訂版本。

新功能

  • 程式庫現已指定 Java 8 語言層級
  • 新增 emoji2 支援,提供更多 TextView 子類別使用 (AppCompatMultiAutoCompleteTextViewAppCompatAutoCompleteTextViewAppCompatRadioButtonAppCompatCheckBox)。

API 變更

  • 已新增 API 來設定 InputConnection,以便使用 View.performanceReceiveContent 處理 InputConnection.commitContent 的 IME 呼叫。(I3a2ad)
  • 新增 EmojiCompat 支援至 AppCompatMultiAutoCompleteTextView。(Ifece0)
  • 新增 EmojiCompat 支援至 AppCompatAutoCompleteTextView。(Ia1f4b)
  • 新增 EmojiCompat 支援至 AppCompatRadioButton。(If08af)
  • 新增 EmojiCompat 支援至 AppCompatCheckBox。(I2b3bc)
  • 允許在 AppCompatEditText 中使用空值 KeyListener。這項操作會還原在 1.4-alpha01 中新增至 AppCompatEditText 的非空值註解,並在傳遞空值時還原先前的行為。(I21482b/189559345)。
  • 新增 PopupMenu.setForceShowIcon 以與平台 API 相同。(I43bb3b/182789798)

修正錯誤

  • 修正 AppCompatEditText 中的錯誤,這會重設 XML 中指定的 inputType 來移除變化版本。這項錯誤是在 AppCompat 1.4.0-alpha01 中導入。(I9df36b/191061070)

1.4.0-alpha02 版本

2021 年 6 月 2 日

androidx.appcompat:appcompat:1.4.0-alpha02androidx.appcompat:appcompat-resources:1.4.0-alpha02 發布。1.4.0-alpha02 版包含這些修訂版本。

API 變更

  • 已新增採用版面配置 ID 的 AppCompatDialogFragment 建構函式。(Icbf22b/188119987)
  • 已改善版面配置檢查器支援。(I02d55)
  • 已將 emoji2-views-helper 中的套件重新命名為 androidx.emoji2.viewsintegration。這是 AppCompat 1.4.0-alpha01 的破壞性變更,應用程式必須更新 AppCompat 依附元件,才能使用新的 emoji2 版本。(Ie8397)

修正錯誤

  • 已修正問題:停止的活動不會因為 AppCompat 檢測的夜間模式變更而收到設定變更。(I8fa8fb/188681415)
  • AppCompatEditText 中,即使 XML 中已指定 android:focusable="false" (AppCompat 1.4.0-alpha01 中引入的錯誤),檢視畫面仍可聚焦,這個問題已獲得修正 (Ib9412)

1.4.0-alpha01 版本

2021 年 5 月 18 日

androidx.appcompat:appcompat:1.4.0-alpha01androidx.appcompat:appcompat-resources:1.4.0-alpha01 發布。1.4.0-alpha01 版本包含以下修訂項目。

API 變更

修正錯誤

  • 已修正在設定視窗回呼之後呼叫 setSupportActionBar 會覆寫回呼的情境。(Ie43eeb/186791590)
  • 已新增 SDK 29 和 30 問題的變通方法:從可繪項目快取中複製的 ColorStateListDrawable 資源在收到狀態變更之前,無法載入預設顏色。(Iedb4b)
  • 在 AppCompat 支援的檢視畫面上處理空值自訂選取動作模式回呼時避免 NPE。(I033c7b/173435375)。

依附元件更新

外部貢獻

  • 向後移植 CheckedTextView 的可著色背景和勾號。(I8575c)

1.3.1 版本

1.3.1 版本

2021 年 7 月 21 日

androidx.appcompat:appcompat:1.3.1androidx.appcompat:appcompat-resources:1.3.1 發布。1.3.1 版隨附這些修訂版本。

依附元件更新

1.3.0 版本

1.3.0 版本

2021 年 5 月 18 日

androidx.appcompat:appcompat:1.3.0androidx.appcompat:appcompat-resources:1.3.0 發布。1.3.0 版隨附這些修訂版本。

自 1.2.0 版本以來的重要異動

  • 已修正 android:theme 屬性在 pre-Lollipop 裝置上跨 <include> 種版面配置的傳播問題
  • 已將許多 PNG 資源轉換為 VectorDrawables 來縮減程式庫的大小
  • 已新增使用 OnReceiveContentListener 將拖曳事件新增至 AppCompatEditText 的支援
  • 已更新,以支援 Android 11 視窗插邊處理功能的變更
  • 已新增含有圖示的選單項目中的 RTL 支援
  • 已新增在 AppCompatEditText 中插入多媒體內容 (例如貼上圖片) 的支援

  • 已更新依附元件appcompat已更新許多轉換依附元件,以支援新功能和修正:

1.3.0-rc01 版本

2021 年 3 月 24 日

androidx.appcompat:appcompat:1.3.0-rc01androidx.appcompat:appcompat-resources:1.3.0-rc01 發布。1.3.0-rc01 版本包含以下修訂項目。

修正錯誤

  • 避免在處理 IME 內容插入時,提前撤銷權限

依附元件更新

外部貢獻

  • 已修正 android:theme 屬性在 pre-Lollipop 裝置上跨 <include> 種版面配置的傳播問題 (Opera 的 Simon Bergner)

1.3.0-beta01 版本

2021 年 1 月 13 日

androidx.appcompat:appcompat:1.3.0-beta01androidx.appcompat:appcompat-resources:1.3.0-beta01 發布。1.3.0-beta01 版包含這些修訂版本。

新功能

  • 主題層級動作模式可繪項目已用向量來源取代。 這可能會導致個別圖示的視覺外觀有些許變動。(I741a6)

API 變更

  • 已將 AppCompatEditText 中的拖曳 (放置事件) 和 OnReceiveContentListener 整合。(Ib26c9b/175343405)
  • 已更新 OnReceiveContentListener 和相關 API。詳情請參閱 androidx.core 程式庫異動。(Ib4616b/173814913)
  • 已將 widget.RichContentReceiverCompat 移至 view.OnReceiveContentListener。(Ifdab7b/173814913)。
  • 提供及擷取初始文字的 API 已向後移植至 EditorInfoCompat。可讓 IME 應用程式避免額外的 IPC 延遲。(Ie3809)

1.3.0-alpha02 版本

2020 年 8 月 19 日

androidx.appcompat:appcompat:1.3.0-alpha02androidx.appcompat:appcompat-resources:1.3.0-alpha02 發布。1.3.0-alpha02 版包含這些修訂版本。

修正錯誤

  • AppCompatRatingbar PNG 可繪項目已用向量來源取代。 這可能會導致個別星號的視覺外觀有些許變動。(I6b99d)
  • 將 WindowInsetsCompat 更新為 Android 11 API。(I3df9e)
  • 透過圖示支援選單項目中的 RTL。(I2f5c5)

依附元件更新

  • AppCompat 已將依附元件從片段 1.1.0 更新為片段 1.3.0-alpha08。強烈建議您詳閱 Fragment 1.2.0 版本資訊,瞭解先前的 Fragment 版本引入哪些重大異動。
  • AppCompat 已將依附元件從活動 1.0.0 更新為活動 1.2.0-alpha08。強烈建議您詳閱 Activity 1.1.0 版本資訊,瞭解先前的 Activity 版本引入哪些重大異動。
    • AppCompatActivity 現在使用 Activity 1.2.0-alpha08 中引入的 OnContextAvailableListener API,以設定 AppCompatDelegate。任何新增至 AppCompatActivity 子類別的事件監聽器,都會在此事件監聽器之後執行。(I513da)

1.3.0-alpha01 版本

2020 年 5 月 20 日

androidx.appcompat:appcompat:1.3.0-alpha01androidx.appcompat:appcompat-resources:1.3.0-alpha01 發布。1.3.0-alpha01 版包含這些修訂版本。

新功能

  • 新增 Lint 規則,標記在延伸 AppCompatActivity 的活動中進行的 setActionBar 呼叫
  • AppCompatActivity 當中使用 View 時,新增來自 Lifecycle 2.3.0-alpha01ViewTreeLifecycleOwner 支援、來自 Lifecycle 2.3.0-alpha03ViewTreeViewModelStoreOwner 支援,以及來自 SavedState 1.1.0-alpha01ViewTreeSavedStateRegistryOwner 支援。(b/151603528aosp/1300264)。
  • 新增用於插入多媒體內容 (例如貼上圖片) 的通用 API。新回呼提供單一 API,應用程式可透過實作這個 API 支援以各種方式插入多媒體內容。目前這個 API 僅新增至 AppCompatEditText,而且會在下列程式碼路徑中叫用:
    • 從剪貼簿貼上
    • 從 IME 插入內容 (InputConnection.commitContent) (I22bf7)

修正錯誤

  • AppCompat 1.2.0-rc01 起:AppCompat 不再使用 null 選單呼叫 onMenuOpened()。(b/142843126)
  • 呼叫 TextViewCompat.setTextAppearance 時使用的文字狀態樣式包含參照主題色彩屬性的清單時,可在舊版裝置上正確解析文字連結和提示顏色 (b/154702995)

1.2.0 版本

1.2.0 版本

2020 年 8 月 5 日

androidx.appcompat:appcompat:1.2.0androidx.appcompat:appcompat-resources:1.2.0 發布。1.2.0 版本包含以下修訂項目。

自 1.1.0 版本以來的重大異動

  • 已修正設定覆寫用途的支援,包括自訂語言代碼和字型調整。請參閱這篇文章,瞭解如何使用 appcompat:1.2.0 正確導入覆寫值。
  • 已淘汰 AppCompatDelegate.attachBaseContext()。如果您要呼叫或覆寫這個方法,請改用 AppCompatDelegate.attachBaseContext2()
  • 已淘汰 CollapsibleActionView。不再需要這個介面,請使用平台提供的 android.view.CollapsibleActionView 介面。

1.2.0-rc02 版本

2020 年 7 月 22 日

androidx.appcompat:appcompat:1.2.0-rc02androidx.appcompat:appcompat-resources:1.2.0-rc02 發布。1.2.0-rc02 版包含這些修訂版本。

修正錯誤

  • 修正夜間模式相關問題,其中有時從對話方塊呼叫 AppCompatDelegate.setDefaultNightMode 可能無法重新建立活動並套用新模式。(aosp/1348308b/158923881)。

1.2.0-rc01 版本

2020 年 5 月 14 日

androidx.appcompat:appcompat:1.2.0-rc01androidx.appcompat:appcompat-resources:1.2.0-rc01 發布。1.2.0-rc01 版本包含以下修訂項目。

API 變更

  • AppCompatDelegate.setLocalNightMode 已被標示為必須使用 SDK 17 以上版本,因為平台設定在舊版 SDK 的活動之間有變更問題漏出

修正錯誤

  • 現在可以在 Activity.attachBaseContext 之前呼叫 AppCompatDelegate.setLocalNightMode
  • 已修正不正確使用快取插邊的 ActionBarOverlayLayout 插邊消耗
  • AppCompat 已不再使用 null 選單呼叫 onMenuOpened()。(b/142843126)

1.2.0-beta01 版本

2020 年 4 月 1 日

androidx.appcompat:appcompat:1.2.0-beta01androidx.appcompat:appcompat-resources:1.2.0-beta01 發布。1.2.0-beta01 版本包含以下修訂項目。

新功能

  • 已新增下列 Lint 規則,以便在下列情境中標記 AppCompat 的不正確使用:
    • 載入顏色狀態清單:建議使用 ContextCompatAppCompatResources API 確保回溯相容性
    • 載入可繪項目:建議使用 ContextCompatResourcesCompat API 確保回溯相容性
    • 使用具備 Alpha 版屬性的色彩狀態清單:旗標缺少 android:alpha 屬性,會導致某些平台版本的外觀不正確
    • 著色圖片檢視畫面:未使用 app:tint 的旗標會導致舊版平台的外觀不正確
    • 在文字檢視區塊上使用複合可繪項目和著色功能:建議使用 compat 屬性和 API 確保回溯相容性

修正錯誤

  • 已修正 ActionBarOverlayLayout (視窗裝飾動作) 無法正確調度 WindowInsets 的問題。
  • 已修正舊版平台上繪製可繪項目和文字外觀的問題
  • 已修正問題:長按 WebView 時 androidx.appcompat:appcompat:1.1.0 會觸發 WebView 異常終止。(b/141351441)
  • 針對基本結構定義操控及活動啟動期間擷取服務的問題導入修正方式

1.2.0-alpha03 版本

2020 年 3 月 4 日

androidx.appcompat:appcompat:1.2.0-alpha03androidx.appcompat:appcompat-resources:1.2.0-alpha03 發布。1.2.0-alpha03 版本包含以下修訂項目。

修正錯誤

  • 修正動作模式狀態 Guard 錯誤延伸至導覽列且顏色不對的問題。(Ia4a09)
  • 修正問題:停止的活動在 API 級別 23 及以下版本中無法重新啟用 (I45201)

1.2.0-alpha02 版本

2020 年 1 月 29 日

androidx.appcompat:appcompat:1.2.0-alpha02androidx.appcompat:appcompat-resources:1.2.0-alpha02 發布。1.2.0-alpha02 版包含這些修訂版本

修正錯誤

  • 已修正長按時會觸發 appcompat 1.1.0 Webview 異常終止的問題。(b/141351441)
  • 已修正相對於 API 等級 23 中的複合可繪項目,TextView 上的可繪項目著色問題。(aosp/1172194)
  • 已確保基礎結構定義內容一律是包裝函式。(aosp/1194355)
  • 已新增一些改善項目,在修改基本結構定義設定時更聰明。(aosp/1204543)
  • 已為 Robolectric 停用 createConfigurationContext()。(aosp/1186218)

1.2.0-alpha01 版本

2019 年 12 月 4 日

androidx.appcompat:appcompat:1.2.0-alpha01androidx.appcompat:appcompat-resources:1.2.0-alpha01 發布。1.2.0-alpha01 版包含這些修訂版本

修正錯誤

  • 在啟用啟動版本檢查的嚴格模式中,呼叫 PackageManager.getActivityInfo 不會再造成異常終止
  • 已修正 AppCompatButton 上的可繪項目著色問題
  • 修正舊版平台中著色和文字外觀的問題

1.1.0 版本

1.1.0 版本

2019 年 9 月 5 日

發布 androidx.appcompat:appcompat:1.1.0androidx.appcompat:appcompat-resources:1.1.0。您可以前往這裡查看這個版本包含的修訂版本。

自 1.0.0 版以來的重要異動

  • 深色模式改善功能MODE_NIGHT_AUTO,以及根據目前時間切換深色/淺色模式的功能現已淘汰。請考慮使用明確設定,或是 MODE_NIGHT_AUTO_BATTERY
  • Activity 1.0AppCompatActivity 現在以轉換方式,透過 Fragment 1.1.0ComponentActivity Activity 1.0.0 延伸。請參閱相關的版本資訊,瞭解各程式庫的異動項目。
  • AppCompatActivity LayoutId 建構函式AppCompatActivity 的子類別現在可選擇呼叫 AppCompatActivity 上接受 R.layout ID 的建構函式,指出應將何種版面配置設為內容檢視畫面,作為在 onCreate() 中呼叫 setContentView() 的替代方案。這個動作不會改變子類別採用無引數建構函式的要求。

1.1.0-rc01 版本

2019 年 7 月 2 日

發布 androidx.appcompat:appcompat:1.1.0-rc01androidx.appcompat:appcompat-resources:1.1.0-rc01。您可以前往這裡查看這個版本包含的修訂版本。

修正錯誤

  • DayNight 現在可以正確遵守 configChanges。(aosp/981105)
  • 僅在已開始的活動上呼叫 onConfigurationChanged。(aosp/987483)

1.1.0-beta01 版本

2019 年 6 月 5 日

發布 androidx.appcompat:appcompat:1.1.0-beta01androidx.appcompat:appcompat-resources:1.1.0-beta01。您可以前往這裡查看這個版本包含的修訂版本。

修正錯誤

  • 請務必清除 AppCompatDialogs 中的接收器 (aosp/959376)
  • 新增工具列上的 buttonGravity=center_vertical 支援。(b/130361721)
  • 修正旋轉圖示水平偏移。(b/79477181)

1.1.0-alpha05 版本

2019 年 5 月 7 日

發布 androidx.appcompat:appcompat:1.1.0-alpha05androidx.appcompat:appcompat-resources:1.1.0-alpha05。您可以前往這裡查看這個版本包含的修訂版本。

新功能

修正錯誤

  • DayNight 模式的多項修正
  • 讓 ActionBar 所有背景變更的大綱失效
  • 修正旋轉圖示小工具的捲動
  • 修正 AlertDialog 中要覆寫的自訂設定視窗背景

1.1.0-alpha04 版本

2019 年 4 月 3 日

androidx.appcompat:appcompat:1.1.0-alpha04androidx.appcompat:appcompat-resources:1.1.0-alpha04 發布。您可以前往這裡查看這個版本包含的修訂版本。

新功能

  • 已新增 ThemeOverlay.AppCompat.DayNight 個主題系列。使用 DayNight 功能時才應使用。

API 變更

  • AppCompatActivity 現在包含第二種建構函式;該函式採用 @LayoutRes int,將 AppCompatActivity 類別註解的先前行為替換成 @ContentView。這個方法適用於應用程式和程式庫模組。(b/128352521)

修正錯誤

  • 盡可能於穩定版釘選內部依附元件
  • 已修正下拉式選單中的 AppCompatSpinner捲動。(b/124274573)
  • 只有在 DayNight 需要時才呼叫 applyOverrideConfiguration()

1.1.0-alpha03 版本

2019 年 3 月 13 日

androidx.appcompat:appcompat:1.1.0-alpha03androidx.appcompat:appcompat-resources:1.1.0-alpha03 發布。這是 appcompat-resources 的第一個版本。您可以前往這裡查看這個版本包含的修訂項目完整清單。

新功能

  • 新的 appcompat-resources 程式庫內含的 API,可讓應用程式載入舊版平台上的著色可繪項目 (包括向量可繪項目)。這與先前的 appcompat 模組部分提供的功能相同,但現在可在不產生質感設計完整 appcompat 向後移植 (包括小工具、對話方塊、夜間模式等) 負載的情況下提供。
  • 支援 DayNight 模式的重要修正
  • DayNight 模式的 MODE_NIGHT_AUTO_BATTERY 新選項
  • AppCompatTextView 中的可繪項目著色
  • 工具列溢位現在可以使用主題顏色狀態清單確立樣式
  • 選單圖示現在可以使用參照主題屬性的顏色
  • 可以在工具列上設定新的 app:menu 屬性,以便在程式碼膨脹時提供選單內容

修正錯誤

  • 已修正版本 21 中 ImageView 的預設著色模式
  • 已修正在裝置旋轉時無法正確關閉的旋轉圖示彈出式視窗
  • 已修正 DayNight 未在資訊清單中遵循 configChanges 的問題
  • 已修正切換至 MODE_NIGHT_FOLLOW_SYSTEM 無法作用的問題。 (b/111345020)
  • 已修正 WebView 重設 DayNight 資源的問題 (b/37124582)

1.1.0-alpha02 版本

2019 年 2 月 7 日

androidx.appcompat:appcompat 1.1.0-alpha02 發布。

新功能

  • 將資源專屬的可繪項目處理擷取至掛鉤。(aosp/870976)
  • 允許工具列 titleTextColorsubtitleTextColor 使用 ColorStateList,並新增 setTitleTextColorsetSubtitleTextColor 方法的 ColorStateList 超載。(aosp/867489)

修正錯誤

  • 修正 fontFamily 在 API 24 之前版本中無法運作的問題 (aosp/807054)
  • 已修正活動從 AppCompatActivity 延伸後 textFontWeight 無法正常運作的問題。(aosp/847640)
  • 修正會導致旋轉圖示小工具彈出式視窗中的標題文字 (使用對話方塊模式) 不使用 fontFamily 中指定字型的錯誤 (aosp/789994)
  • 修正導致小工具 AppCompatCheckBoxAppCompatRadioButton 無法變更背景著色的錯誤。(aosp/825160)
  • 已修正 AppCompat 未覆寫 android: list styles 的錯誤。(aosp/862350)

1.1.0-alpha01 版本

2018 年 12 月 3 日

新功能

  • AppCompatTextView 現已支援 app:drawableLeftCompatapp:drawableTopCompatapp:drawableRightCompatapp:drawableBottomCompatapp:drawableStartCompatapp:drawableEndCompat 複合可繪項目,支援建立向後移植的可繪項目類型,例如 VectorDrawableCompat

  • AppCompatCheckBoxAppCompatRadioButton 的預設可繪項目現在會為檢查狀態變更建立動畫。

API 變更

  • aosp/740385:ActionBarOverlayLayout 現已導入 NestedScrollingParent2 和 NestedScrollingParent3,使其具備巢狀捲動 3 的最新功能。如果開發人員程式碼目前覆寫 ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int),則可能不會再呼叫,而應改為覆寫 ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int, int, int[])

1.0.2 版本

1.0.2 版本

2018 年 11 月 7 日

修正 core-1.0.1appcompat-1.0.2 的版本。

修正錯誤

  • 修正 PrecomputedTextCompat 與 RTL AppCompatTextView 搭配使用時異常終止的錯誤。b/113070424

1.0.0 版本

1.0.0 版本

2018 年 11 月 7 日

新功能