Core

指定最新的平台功能和 API，同時支援舊裝置。

下表列出 androidx.core 群組的所有構件。

構件 穩定版 候選版 Beta 版 Alpha 版
Core 1.17.0 - - -
core-animation 1.0.0 - - -
core-google-shortcuts 1.1.0 - - 1.2.0-alpha01
core-performance 1.0.0 - - -
core-remoteviews 1.1.0 - - -
core-role 1.1.0 - - -
core-splashscreen 1.0.1 1.2.0-rc01 - -
本程式庫上次更新日期：2025 年 10 月 22 日

宣告依附元件

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

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

Groovy

dependencies {
    def core_version = "1.17.0"

    // Java language implementation
    implementation "androidx.core:core:$core_version"
    // Kotlin
    implementation "androidx.core:core-ktx:$core_version"

    // To use RoleManagerCompat
    implementation "androidx.core:core-role:1.1.0"

    // To use the Animator APIs
    implementation "androidx.core:core-animation:1.0.0"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0"

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation "androidx.core:core-performance:1.0.0"

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation "androidx.core:core-google-shortcuts:1.1.0"

    // Optional - to support backwards compatibility of RemoteViews
    implementation "androidx.core:core-remoteviews:1.1.0"

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation "androidx.core:core-splashscreen:1.2.0-rc01"
}

Kotlin

dependencies {
    val core_version = "1.17.0"

    // Java language implementation
    implementation("androidx.core:core:$core_version")
    // Kotlin
    implementation("androidx.core:core-ktx:$core_version")

    // To use RoleManagerCompat
    implementation("androidx.core:core-role:1.1.0")

    // To use the Animator APIs
    implementation("androidx.core:core-animation:1.0.0")
    // To test the Animator APIs
    androidTestImplementation("androidx.core:core-animation-testing:1.0.0")

    // Optional - To enable APIs that query the performance characteristics of GMS devices.
    implementation("androidx.core:core-performance:1.0.0")

    // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google
    implementation("androidx.core:core-google-shortcuts:1.1.0")

    // Optional - to support backwards compatibility of RemoteViews
    implementation("androidx.core:core-remoteviews:1.1.0")

    // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12
    implementation("androidx.core:core-splashscreen:1.2.0-rc01")
}

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

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Core-Backported-Fixes 1.0 版

1.0.0-beta01 版

2025 年 9 月 24 日

發布 androidx.core:core-backported-fixes:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。

1.0.0-alpha01 版

2025 年 8 月 13 日

發布 androidx.core:core-backported-fixes:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

  • 您可以使用 Core Backported Fixes 程式庫，檢查裝置是否已套用重大錯誤修正。因為錯誤修正檔可能需要很長時間才能在所有裝置上推出，而這個 API 可讓您瞭解何時能安全使用需要修正檔的功能，因此非常實用。

    val fixManager = BackportedFixManager()
    if (fixManager.isFixed(KnownIssues.KI_1234)) {
      Offer_experience_that_needs_fix()
    } else {
      Offer_experience_that_avoids_the_bug()
  }

這個版本包含

  • KnownIssues.KI_398591036：在部分 Pixel 裝置上拍攝 JPEG-R 影像時，出現異常色調。請使用 JPEG 輸出內容修正問題，直到這個 KI 解決為止。

Core-Viewtree 1.0 版

1.0.0 版本

2025 年 2 月 26 日

androidx.core:core-viewtree:1.0.0 已升級為第一個穩定版，與先前的 RC 版相比沒有任何變更。

這個程式庫導入了「檢視區塊可以有不相交的父項」的概念。檢視區塊的不相交父項是獨立的 View 物件，可做為檢視區塊的父項，但不會透過 View.parent 屬性設定。舉例來說，具有不相交父項的檢視區塊包括 ViewOverlays、彈出式視窗和對話方塊，這些都會顯示在主要檢視區塊階層之外。如果檢視區塊沒有透過平台 View.parent 資源直接連結的父項，就只能有不相連的父項。目前，androidx 只會為 Transition 1.6.0-alpha01 以上版本建立的 ViewOverlays 設定不相交的父項。您也可以為檢視區塊指定自己的不相交父項。詳情請參閱說明文件。

1.0.0-rc01 版

2025 年 2 月 12 日

發布 androidx.core:core-viewtree:1.0.0-rc01，該版本與 Beta 版沒有差別。

1.0.0-beta01 版

2025 年 1 月 29 日

發布 androidx.core:core-viewtree:1.0.0-beta01，該版本與 Alpha 版沒有差別。1.0.0-beta01 版包含這些修訂項目。

1.0.0-alpha01 版

2024 年 12 月 11 日

發布 androidx.core:core-viewtree:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。

新功能

  • core-viewtree 的初始版本，由 androidx 核心間接公開。

  • 這個初始版本導入了「檢視區塊可以有不相連的父項」的概念。檢視區塊的不相交父項是獨立的 View 物件，可做為檢視區塊的父項，但不會透過 View.parent 屬性設定。舉例來說，具有不相交父項的檢視區塊包括 ViewOverlays、彈出式視窗和對話方塊，這些都會顯示在主要檢視區塊階層之外。如果檢視區塊沒有透過平台 View.parent 資源直接連結的父項，就只能有不相連的父項。目前，androidx 只會為轉場效果建立的 ViewOverlays 設定不相交的父項。您也可以為檢視區塊指定自己的不相交父項。詳情請參閱說明文件。

API 變更

  • 新增 ViewParent.getParentOrViewTreeDisjointParent() 和 ViewParent.setViewTreeDisjointParent(View, ViewParent?) 方法 (Ib2950)

Core-i18n 1.0 版

1.0.0 版本

2025 年 4 月 9 日

發布 androidx.core:core-i18n:1.0.0。

這個元件可協助您輕鬆建立適當的國際化應用程式，主要著重於兩個領域：

  • 日期和時間格式化功能遵循目前最佳做法，尊重使用者自訂設定，並提供可在新舊 Android 版本正常運作的統一 API。
  • 向後移植的 android.icu.text.MessageFormat，適用於舊版 API。不過，由於新版 Android 整合了上述日期 / 時間格式設定，因此仍相當實用。這項功能會採用使用者設定，但 android.icu.text.MessageFormat 不會。

這個元件將做為媒介，用來回溯移植新的 i18n API、新增 i18n 功能或修正項目，以及簡化國際化作業。

1.0.0-rc01 版

2025 年 3 月 26 日

發布 androidx.core:core-i18n:1.0.0-rc01，該版本與上一個 Beta 版沒有差別。1.0.0-rc01 版包含這些修訂項目。

1.0.0-beta01 版

2025 年 3 月 12 日

發布 androidx.core:core-i18n:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。

新功能

  • 這是 core-i18n 元件的第一個版本。這個元件可協助您輕鬆建立適當的國際化應用程式，主要著重於兩個領域：
    • 日期和時間格式化功能遵循目前最佳做法，尊重使用者自訂設定，並提供可在新舊 Android 版本正常運作的統一 API。
    • 向後移植的 android.icu.text.MessageFormat，適用於舊版 API。不過，由於新版 Android 整合了上述日期 / 時間格式設定，因此仍相當實用。這項功能會採用使用者設定，但 android.icu.text.MessageFormat 不會。
    • 這個元件將做為媒介，用來回溯移植新的 i18n API、新增 i18n 功能或修正項目，以及簡化國際化作業。

1.0.0-alpha01 版

2023 年 7 月 26 日

發布 androidx.core:core-i18n:1.0.0-alpha01。1.0.0-alpha01 版本包含以下修訂項目。

Core-location-altitude 1.0 版。

1.0.0-alpha03 版本

2024 年 10 月 16 日

發布 androidx.core:core-location-altitude:1.0.0-alpha03、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha03 和 androidx.core:core-location-altitude-proto:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

安全性修正

  • 自這項變更起，androidx 會針對 protobuf 4.28.2 進行編譯，以解決 CVE-2024-7254。將 androidx.core:core-location-altitude-proto 和 androidx.core:core-location-altitude-external-protobuf 的依附元件升級至 1.1.0-alpha03，以解決安全漏洞風險。

修正錯誤

  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)

1.0.0-alpha02 版

2024 年 6 月 12 日

發布 androidx.core:core-location-altitude:1.0.0-alpha02、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha02 和 androidx.core:core-location-altitude-proto:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。

修正錯誤

  • 修正因重新封裝 proto 程式庫而導致的 ProGuard 失敗問題。

外部貢獻

  • 上述錯誤修正是由 andrekir@pm.me 提供

1.0.0-alpha01 版

2023 年 7 月 26 日

發布 androidx.core:core-i18n:1.0.0-alpha01 和 androidx.core:core-location-altitude:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 新增 AltitudeConverterCompat 類別，其中包含單一靜態方法 addMslAltitudeToLocation(Context, Location) (I11168)。

Core-telecom 1.1 版

1.1.0-alpha01 版本

2025 年 10 月 8 日

發布 androidx.core:core-telecom:1.1.0-alpha01。1.1.0-alpha01 版包含這些修訂項目。

新功能

  • 應用程式現在可以要求系統不要將特定通話儲存到通話記錄中，即使應用程式一般會選擇儲存通話記錄也一樣。這項功能僅適用於搭載 Build.VERSION.SDK_INT_FULL >= Build.VERSION_CODES_FULL.BAKLAVA_1 的裝置。

API 變更

  • 在 CallAttributesCompat 資料類別中導入選用的 isLogExcluded 布林值屬性。如果設為 true，系統會要求將通話從通話記錄中排除。在舊版平台上，這個屬性不會生效。請注意，根據預設，系統不會將 VoIP 通話記錄到系統通話記錄中。開發人員必須先明確選擇加入系統呼叫記錄，應用程式才能參與這項計畫。這項作業需要在應用程式的資訊清單中宣告 android.telecom.action.CALL_BACK 的意圖處理常式。對於已啟用這項整合功能的應用程式，新的 isLogExcluded 屬性提供每次通話的排除選項。(d14695)

Core-telecom 1.0 版。

1.0.1 版

2025 年 8 月 27 日

發布 androidx.core:core-telecom:1.0.1。1.0.1 版是錯誤修正版本，包含以下改良項目 (詳情請參閱這些修訂項目)。

修正錯誤

  • 音訊路由和端點處理
    • 修正問題：使用者選取的通話前音訊端點 (例如耳機) 無法在通話期間使用。視訊通話開始時，系統會錯誤地將聽筒切換為喇叭。程式庫現在可確保維持使用者偏好的音訊路徑。(8fa4ba7、71d7be8)
    • 改善音訊切換邏輯，避免通話自動從藍牙耳機切換至喇叭，尤其是在藍牙裝置需要一段時間才能連線時。這項檢查需要 BLUETOOTH_CONNECT 權限，才能區分裝置類型。(de83f3e)
    • 為沒有藍牙裝置的使用者，最佳化視訊通話的自動揚聲器功能。現在，程式庫會在要求 BLUETOOTH_CONNECT 權限前，先執行干擾較少的藍牙裝置檢查，提升非藍牙使用者的體驗。(721f4e2)
  • 穩定性與當機修正
    • 修正音訊端點處理期間可能發生的 NullPointerException 異常終止問題。程式庫現在可正確處理 PreCallEndpointsUpdater 中不一致的狀態管理，並從系統的 AudioDeviceInfo 陣列中篩除空值元素，以提升穩定性。(23dd075、03eb616)

1.0.0 版本

2025 年 5 月 7 日

發布 androidx.core:core-telecom:1.0.0。1.0.0 版包含這些修訂項目。

1.0.0 的主要功能

  • 核心電信 API 的初始穩定版本，著重於 CallsManager API 介面，可將 VoIP 通話整合至 Android 平台。

1.0.0-rc01 版

2025 年 4 月 9 日

發布 androidx.core:core-telecom:1.0.0-rc01。1.0.0-rc01 版包含這些修訂項目。

新功能

新的實驗性 API 呼叫擴充功能。這個版本新增的實驗性擴充功能包括：

  • 支援會議摘要遠端擴充功能，可讓遠端裝置從連線的 VoIP 應用程式接收會議摘要資訊 (目前發言者和參與者人數)。(7cf095f)
  • 支援通話圖示擴充功能，可讓 VoIP 應用程式將圖示 URI 傳送至遠端 InCallService (自動、錶面等)。通話期間可以更新圖示，且可使用相同的 URI 值。(8e1813e)

1.0.0-beta01 版

2024 年 12 月 11 日

發布 androidx.core:core-telecom:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。

新功能

下列新功能推出 Beta 版：

  • 在新增通話前擷取可用的音訊端點。應用程式開發人員現在可以在發起通話前顯示所有可用的端點，讓使用者順暢地選取偏好的音訊端點，並最佳化設定。這樣一來，通話開始時就不必調整音量，提供更順暢的體驗。
  • 實驗性 API 支援 VOIP 應用程式來電額外資訊。應用程式可透過通話擴充功能提供進行中通話的更多詳細資料，例如群組通話或會議的參與者清單。Android Auto 等支援的遠端介面隨後會向使用者顯示這項資訊，並允許使用者與支援的擴充功能互動。這個版本新增的實驗性擴充功能包括：
    • 支援顯示群組通話或會議的參與者，並說明哪位參與者正在發言。支援對參與者執行下列選用動作：
      • 舉手和放下參與者的手。
      • 踢除參與者。
    • 支援通話靜音功能，可讓遠端裝置將 VoIP 通話設為靜音，但不會將麥克風設為全域靜音。

API 變更

  • 將「addLocalSilenceExtension」重新命名為「addLocalCallsilenceExtension」(If4a9c)
  • 將 preferredStartingCallEndpoint 從 var 變更為 val。(Iab6b7)
  • 新增本機通話靜音 API (I29dd0)
  • 為 CallEndpointCompat 類別實作 compareTo 函式 (Ia06b7)
  • 新增實驗性應用程式動作 API。(Ifb796)
  • 新增 CallsManager API getAvailableStartingCallEndpoints (Ia8bcf)
  • 請更新 ExperimentalAppActions 註解，確保系統能準確追蹤實驗性功能的所有使用情況。(Id5ea5)

修正錯誤

  • 為 Android API 級別 28 到 33 新增全域靜音狀態接收器。(I75e66)
  • 修正只有最新連線的 InCallService 能夠傳送動作事件的問題 (I39599)
  • 為 VoIP 應用程式動作實作 ICS 擴充功能 API。(I1274c)
  • 在 API 級別 34 之前的版本中拒絕通話時，系統現在會正確終止 Telecom 中的通話。(I635b7)
  • addCall 現在會透過 API 正確擲回例外狀況，而不是透過父項協同程式 (I83334)
  • 在額外項目組合中新增預留位置值 (Iebf7f)
  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
  • 為 CallsManager#addCall 新增擴充功能的實驗性支援。(I24d92)
  • 如果平台因例外狀況、達到通話次數上限等原因而無法新增通話，Core-Telecom 現在會擲回 CallException (I41f27)。

1.0.0-alpha03 版本

2024 年 4 月 17 日

發布 androidx.core:core-telecom:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

修正錯誤

  • 重構 JetpackConnectionService，修正 SDK 33 以下版本中，傳入的地址為空白時發生的問題。重構的 JetpackConnectionService 也可抵禦 Telecom 平台 API 傳回的非預期 NULL 值。
  • 改善 addCall/CallControlScope API 說明文件。
  • 測試可靠性改善措施。

1.0.0-alpha02 版

2023 年 10 月 4 日

發布 androidx.core:core-telecom:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

API 變更

  • 針對傳回布林值的方法，重新設計 API 簽章，指出作業成功/失敗，改為傳回結果類別，清楚指出作業成功或失敗的原因。
  • 將 CallControlCallback 方法做為 lambda 引數移至 addCall，以便在呼叫範圍中移除明確提供回呼的需求。

修正錯誤

  • 修正 ConnectionService 相容性層中的錯誤，此錯誤會導致在舊版 SDK 上執行時沒有通話音訊。
  • 改善 API 說明文件。

1.0.0-alpha01 版

2023 年 5 月 10 日

發布 androidx.core:core-telecom:1.0.0-alpha01。這個版本是在內部分支版本中開發而成，應搭配 Android 14 Beta 版 2 使用。

新功能

  • 介紹 CallsManager API，VoIP 應用程式可使用此 API 與裝置上的 Telecom 架構整合。平台通知的通話可享有前景執行優先順序、藍牙、穿戴式裝置和車輛裝置的顯示功能，以及簡化的音訊路徑。

    CallsManager API 會為搭載舊版 Android 的裝置包裝舊版 ConnectionService API。

Core 和 Core-ktx 1.17 版

1.17.0 版

2025 年 8 月 13 日

發布 androidx.core:core:1.17.0、androidx.core:core-ktx:1.17.0 和 androidx.core:core-testing:1.17.0。1.17.0 版包含這些修訂項目。

自 1.16.0 版以來的重要異動

  • 核心程式庫已更新為以 Kotlin 2.0 語言層級為目標，因此必須使用 Kotlin Gradle 外掛程式 2.0.0 以上版本。

1.17.0-rc01 版

2025 年 7 月 30 日

發布 androidx.core:core:1.17.0-rc01、androidx.core:core-ktx:1.17.0-rc01 和 androidx.core:core-testing:1.17.0-rc01。1.17.0-rc01 版沒有任何變更，與先前的 Beta 版相同。

1.17.0-beta01 版

2025 年 7 月 2 日

發布 androidx.core:core:1.17.0-beta01、androidx.core:core-ktx:1.17.0-beta01 和 androidx.core:core-testing:1.17.0-beta01。1.17.0-beta01 版自前一個 Alpha 版起沒有任何異動。

1.17.0-alpha01 版

2025 年 6 月 18 日

發布 androidx.core:core:1.17.0-alpha01、androidx.core:core-ktx:1.17.0-alpha01 和 androidx.core:core-testing:1.17.0-alpha01。1.17.0-alpha01 版包含這些修訂項目。

新功能

  • 核心程式庫已更新為以 Kotlin 2.0 語言層級為目標，因此必須使用 Kotlin Gradle 外掛程式 2.0.0 以上版本。(Idb6b5)

API 變更

  • 新增 NotificationCompat.ProgressStyle 及 NotificationCompat.Builder.setRequestPromotedOngoing()。詳情請參閱「以進度為主的通知」和「即時更新」一文。

  • 新增 Parcel.use 擴充功能函式，可安全地處理 Parcel 資源。(I436da)

Core 和 Core-ktx 1.16 版

1.16.0 版

2025 年 4 月 9 日

發布 androidx.core:core:1.16.0、androidx.core:core-ktx:1.16.0 和 androidx.core:core-testing:1.16.0。1.16.0 版包含這些修訂項目。

自 1.15.0 版以來的重要異動

  • 這個程式庫現在使用 JSpecify 空值註解，這些註解屬於型別用途。Kotlin 開發人員應使用下列編譯器引數，強制執行正確用法：-Xjspecify-annotations=strict (這是 Kotlin 編譯器 2.1.0 版的預設值)。(Iaf3e1、b/326456246)

1.16.0-rc01 版

2025 年 3 月 26 日

發布 androidx.core:core:1.16.0-rc01、androidx.core:core-ktx:1.16.0-rc01 和 androidx.core:core-testing:1.16.0-rc01。1.16.0-rc01 版沒有任何變更，與先前的 Beta 版相同。

1.16.0-beta01 版

2025 年 3 月 12 日

發布 androidx.core:core:1.16.0-beta01、androidx.core:core-ktx:1.16.0-beta01 和 androidx.core:core-testing:1.16.0-beta01。1.16.0-beta01 版包含這些修訂項目。

API 變更

  • 修正插邊防護 API (I7050d)
  • 新增索引鍵，以取得未放大視窗座標中的字元界限。(If7a06)
  • 新增布林值屬性，代表 AccesibilityNodeInfo 是否為必填欄位。(I4fd2d)
  • 將 View.transformMatrixToGlobal 向後移植至 ViewCompat (If17e2)

1.16.0-alpha02 版

2025 年 1 月 29 日

發布 androidx.core:core:1.16.0-alpha02、androidx.core:core-ktx:1.16.0-alpha02 和 androidx.core:core-testing:1.16.0-alpha02。1.16.0-alpha02 版包含這些修訂項目。

API 變更

  • 新增 BuildCompat.isAtLeastB，用於檢查 Baklava 中新增的 API 是否可用 (I0f89c)
  • 新增實驗性 API，以取得內建螢幕清單。(Idda4d)
  • 新增一組與確保系統資訊列對比度相關的 API (I9849c)

修正錯誤

  • 修正問題：在 SDK < 26 上，getLaunchDisplayId() 會傳回不正確的預設值 0。(Icd679)
  • 這個程式庫現在使用 JSpecify 空值註解，這些註解屬於型別用途。Kotlin 開發人員應使用下列編譯器引數，強制執行正確用法：-Xjspecify-annotations=strict (這是 Kotlin 編譯器 2.1.0 版的預設值)。(Iaf3e1、b/326456246)

1.16.0-alpha01 版

2024 年 12 月 11 日

發布 androidx.core:core:1.16.0-alpha01、androidx.core:core-ktx:1.16.0-alpha01 和 androidx.core:core-testing:1.16.0-alpha01。1.16.0-alpha01 版包含這些修訂項目。

API 變更

  • 將 setLaunchDisplayId 新增至 ActivityOptionsCompat (I39e77、b/379669743)
  • 新增 SYSTEM_OVERLAYS 的相容性 API。(Ibd1fd、b/287470173)
  • 新增 OutcomeReceiverCompat，這是適用於所有 API 級別的 Android OutcomeReceiver 版本。(Ib8265、b/380060342)
  • 新增 android.view.ScrollFeedbackProvider 的相容性類別。(Icaa92)
  • 新增 ViewCompat.addViewOverlay(View) 做為 View.getOverlay().add(View) 的替代方案。ViewCompat 變數修正了檢視區塊重疊和重疊擁有者之間無法解析擁有者 (例如 LifecycleOwner 和 ViewModelStoreOwner) 的問題。(I81413)
  • 介紹 View 可擁有不相交父項的概念。檢視畫面的不相交父項是另一個有效做為其他檢視畫面父項的檢視畫面，但並非透過 View.parent 屬性設定。詳情請參閱說明文件。(Ib2950)
  • 新增了 ViewGroupCompat#installCompatInsetsDispatch API，供開發人員修正 API 30 之前的插邊調度問題。(I11159)
  • 新增 FontsContractCompat.TypefaceStyle IntDef，用於註解 FontsContractCompat 中的 Typeface 樣式。(Ib3e5b)

外部貢獻

  • 淘汰了 BuildCompat.isAtLeastV。來電者應改為直接對 35 檢查 SDK_INT。感謝 Jake Wharton！(I294d1)
  • 已在 TaskStackBuilder 中新增可變動性標記。感謝 Kamal Faraj！(Ife0ec、b/371534781)

Core 和 Core-ktx 1.15 版

1.15.0 版

2024 年 10 月 30 日

發布 androidx.core:core:1.15.0、androidx.core:core-ktx:1.15.0 和 androidx.core:core-testing:1.15.0。1.15.0 版包含這些修訂項目。

自 1.14.0 版以來的重要異動

  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
  • 針對相容性類別進行多項更新，以與 Android 15 SDK 保持一致。

1.15.0-rc01 版

2024 年 10 月 16 日

發布 androidx.core:core:1.15.0-rc01、androidx.core:core-ktx:1.15.0-rc01 和 androidx.core:core-testing:1.15.0-rc01。1.15.0-rc01 版沒有任何異動。

1.15.0-beta01 版

2024 年 10 月 2 日

發布 androidx.core:core:1.15.0-beta01、androidx.core:core-ktx:1.15.0-beta01 和 androidx.core:core-testing:1.15.0-beta01。1.15.0-beta01 版包含這些修訂項目。

API 變更

  • 在 CollectionInfoCompat 中新增 itemCount 和 importantForAccessibilityItemCount 欄位。(Ibaf34)

修正錯誤

  • 修正 androidx.core.os.Profiling 中的文件問題 (I2542f)

1.15.0-alpha02 版

2024 年 8 月 21 日

發布 androidx.core:core:1.15.0-alpha02、androidx.core:core-ktx:1.15.0-alpha02 和 androidx.core:core-testing:1.15.0-alpha02。1.15.0-alpha02 版包含這些修訂項目。

重要異動

  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)

API 變更

  • 在可下載字型定義中新增 fallbackQuery XML 屬性，允許使用可下載字型進行字元層級的回溯。(Idd544)
  • 新增用於 ProfilingManager 的輔助 API (If2292)
  • 新增 ActivityOptions.setPendingIntentBackgroundActivityStartMode 的相容方法 (I3ba1f、b/349617674)
  • 新增 DisplayCutoutCompat.getCutoutPath (I58778、b/279635904)
  • 還原 ParcelCompat.writeBoolean 的淘汰狀態，並在 API 級別 29 以上版本中委派給平台 API。(I9d243、b/313834577)
  • 建立採用執行器的 FontsContractCompat.requestFonts (I03016、b/302377512)
  • 還原 LocationCompat.isMock 的淘汰狀態，並在 API 級別 31 以上版本中委派給平台 API。(I55940、b/313834577)
  • 通知現在可標記為語音留言。(I068ab)

1.15.0-alpha01 版

2024 年 6 月 12 日

發布 androidx.core:core:1.15.0-alpha01、androidx.core:core-ktx:1.15.0-alpha01 和 androidx.core:core-testing:1.15.0-alpha01。這個版本是在內部分支版本中開發，與 Android 15 Beta 3 (android-35) 相容。

API 變更

  • 針對相容性類別進行多項更新，以與 Android 15 SDK 保持一致。

Core 和 Core-ktx 1.14 版

1.14.0-alpha01 版

2024 年 5 月 1 日

發布 androidx.core:core:1.14.0-alpha01、androidx.core:core-ktx:1.14.0-alpha01 和 androidx.core:core-testing:1.14.0-alpha01。1.14.0-alpha01 版包含這些修訂項目。

新功能

  • 將 androidx 程式庫的預設 minSdkVersion 設為 21 (I6ec7f)

API 變更

Core 和 Core-ktx 1.13 版

1.13.1 版

2024 年 5 月 1 日

發布 androidx.core:core:1.13.1、androidx.core:core-ktx:1.13.1 和 androidx.core:core-testing:1.13.1。1.13.1 版包含這些修訂項目。

修正錯誤

  • 修正問題：顯示手寫工具列時，無法透過輕觸手指切換至一般鍵盤 (I7f843、b/332769437)

1.13.0 版

2024 年 4 月 17 日

發布 androidx.core:core:1.13.0、androidx.core:core-ktx:1.13.0 和 androidx.core:core-testing:1.13.0。1.13.0 版包含這些修訂項目。

自 1.12.0 版以來的重要異動

  • 程式庫的 minSdkVersion 已提高至 19。許多相容性 API 已標示為已淘汰，因為這些 API 僅適用於 API 級別 19 之前的版本。
  • 我們已在 Kotlin 中改寫多個類別，以便與 Kotlin 消費者提供更良好的互通性，同時保留 Java 相容性。
  • 已移除 FingerprintManagerCompat，這個函式從 Android V 開始為空運算，不應在較早的平台使用。用戶端應立即遷移至 BiometricPrompt。
  • 新增 PathParser，可從 SVG 路徑字串建立 Path 執行個體。

1.13.0-rc01 版

2024 年 4 月 3 日

發布 androidx.core:core:1.13.0-rc01、androidx.core:core-ktx:1.13.0-rc01 和 androidx.core:core-testing:1.13.0-rc01。1.13.0-rc01 版包含這些修訂項目。

修正錯誤

  • 修正 API 30 以上版本擷取初始系統資訊列外觀的問題 (I18596、b/219993701)

1.13.0-beta01 版

March 20, 2024

發布 androidx.core:core:1.13.0-beta01、androidx.core:core-ktx:1.13.0-beta01 和 androidx.core:core-testing:1.13.0-beta01。1.13.0-beta01 版包含這些修訂項目。

API 變更

  • PathParser 現在是 final，interpolatePathDataNodes 現在會針對不相容的引數擲回例外狀況，而不是傳回 boolean，而 nodesToPath 現在屬於 PathParser，而非 PathParser.PathDataNode。(I20d62)
  • FingerprintManagerCompat 已在從 Android V 平台 SDK 移除前軟性移除。這項實作方式將於近期替換為無作業，開發人員應立即從這個類別遷移。(I7ca1b)
  • Pool 介面及其子類別 SimplePool 和 SynchronizedPool 現在以 Kotlin 編寫。現在儲存在集區中的物件泛型型別不得為空值。(I08afe)

外部貢獻

  • GestureDetectorCompat 現已淘汰，因為平台保證在程式庫的最低 SDK 版本中提供 GestureDetector。感謝 Jake Wharton 的貢獻。(Icc4cd)
  • 由於 MarginLayoutParams 保證可在平台中做為程式庫的最低 SDK 版本使用，因此 MarginLayoutParamsCompat 現在已淘汰。感謝 Jake Wharton 的貢獻。(I4e0c3)

1.13.0-alpha05 版

2024 年 2 月 7 日

發布 androidx.core:core:1.13.0-alpha05、androidx.core:core-ktx:1.13.0-alpha05 和 androidx.core:core-testing:1.13.0-alpha05。1.13.0-alpha05 版包含此連結所列的修訂項目。

外部貢獻

  • 感謝 Matthew Zavislak 更新 ContextCompat.registerReceiver 說明文件，確保內容正確無誤。(8fd733)

1.13.0-alpha04 版

2024 年 1 月 24 日

發布 androidx.core:core:1.13.0-alpha04、androidx.core:core-ktx:1.13.0-alpha04 和 androidx.core:core-testing:1.13.0-alpha04。1.13.0-alpha04 版包含此連結所列的修訂項目。

新功能

Kotlin 轉換

  • androidx.core.util.Consumer 類別已按照 Kotlin 重新編寫，現在會強制一般型別 T 必須符合 accept() 方法接收的空值。(Ie21e0)
  • androidx.core.util.Supplier 已轉換為 Kotlin，確保 get() 傳回的型別是否可為空值，與泛型型別是否可為空值相符。(I21e9c)
  • androidx.core.util.Function 已按照 Kotlin 重新編寫，確保函式輸入和輸出的空值與所用泛型型別相符。(I09dd7)

外部貢獻

  • 感謝 Kamal Faraj 新增 AlarmManagerCompat.canScheduleExactAlarms API (I62e95、b/315440583)

1.13.0-alpha03 版

2024 年 1 月 10 日

發布 androidx.core:core:1.13.0-alpha03、androidx.core:core-ktx:1.13.0-alpha03 和 androidx.core:core-testing:1.13.0-alpha03。1.13.0-alpha03 版包含以下修訂項目。

API 變更

1.13.0-alpha02 版

2023 年 11 月 29 日

發布 androidx.core:core:1.13.0-alpha02、androidx.core:core-ktx:1.13.0-alpha02 和 androidx.core:core-testing:1.13.0-alpha02。1.13.0-alpha02 版包含以下修訂項目。

新功能

  • 新增 OnUserLeaveHintProvider 介面，讓任何元件接收實作子母畫面所需的 onUserLeaveHint 事件。這是由 ComponentActivity 在 Activity 1.9.0-alpha01 中實作。(I54892)

API 變更

  • 淘汰了 androidx.core.os.CancellationSignal。應改用平台提供的 android.os.CancellationSignal。(Id45f6、b/309499026、b/309054079)
  • OnMultiWindowModeChangedProvider、OnNewIntentProvider、OnPictureInPictureModeChangedProvider、OnConfigurationChangedProvider 和 OnTrimMemoryProvider 介面已轉換為 Kotlin，確保其監聽器方法採用的 Consumer 泛型參數具有正確的可為空值性 (全為不可為空值)。(Ib6237)
  • 傳送至各自 Provider 介面新增 Consumer 的 MultiWindowModeChangedInfo 和 PictureInPictureModeChangedInfo 類別，現在是以 Kotlin 編寫。(Ie08e2)

依附元件更新

1.13.0-alpha01 版

2023 年 10 月 18 日

發布 androidx.core:core:1.13.0-alpha01、androidx.core:core-ktx:1.13.0-alpha01 和 androidx.core:core-testing:1.13.0-alpha01。1.13.0-alpha01 版包含以下修訂項目。

API 變更

  • 將 PathParser 設為公開。這個類別可以從 SVG 路徑字串建立 Path 例項。(Ic7af2、b/302376846)
  • 新增 Context.createAttributionContext 的相容性方法。(I61dcf、Ibe187)
  • 將「NotificationCompatSideChannelService」標示為已淘汰。(I18fd9)
  • 用於差異動作甩動的新 API。(I46b0d、Ia9f68)
  • VelocityTracker 的其他相容性 API，可追蹤平台 SDK。(I32753)

修正錯誤

  • 覆寫 Person 中的 equals 和 hashCode 方法。(I610a5)

Core 和 Core-ktx 1.12 版

1.12.0 版

2023 年 9 月 6 日

發布 androidx.core:core:1.12.0、androidx.core:core-ktx:1.12.0 和 androidx.core:core-testing:1.12.0。1.12.0 版包含以下修訂項目。

自 1.11.0 版以來的重要異動

  • 為 SDK 34 新增許多相容性方法，與 TextView、AccessibilityNodeInfo 等項目保持一致。
  • 全新 LocalePreferences API，可協助開發人員輕鬆存取語言代碼資料或使用者的語言代碼偏好設定。
  • 淘汰 app.BundleCompat，改用 os.BundleCompat。
  • 淘汰了 BuildCompat.isAtLeastU()。改用 SDK_INT >= 34。

1.12.0-rc01 版

2023 年 8 月 9 日

發布 androidx.core:core:1.12.0-rc01、androidx.core:core-ktx:1.12.0-rc01 和 androidx.core:core-testing:1.12.0-rc01，但沒有重大異動。1.12.0-rc01 版包含以下修訂項目。

1.12.0-beta01 版

2023 年 7 月 26 日

發布 androidx.core:core:1.12.0-beta01、androidx.core:core-ktx:1.12.0-beta01 和 androidx.core:core-testing:1.12.0-beta01。1.12.0-beta01 版包含以下修訂項目。

API 變更

  • 在 TextView 相容性類別中新增 setLineHeight(unit, lineHeight) (Ia9fa9)
  • 新增 Android 14 的 TypedValueCompat.getUnitFromComplexDimension() (I958e8)
  • 在 TextView 相容性類別中新增 setLineHeight(unit, lineHeight) (Ib2ee1)
  • 向後移植其他 Accessibility API (Ic65ba)
  • 向後移植 API 34 AccessibilityNodeInfo 方法 (I44182)
  • 將穩定版 SDK 檢查項目從實驗功能升級 (Ia9b35)
  • 向後移植 AccessiiblityWindowInfo 34 個 API (I96a5d)
  • 淘汰了 BuildCompat.isAtLeastU()。請改用 SDK_INT >= 34。(I4f8e7、b/289269026)
  • 移除了實驗性 isAtLeastU() API 的用法 (Ie9117、b/289269026)
  • 將 BuildCompat 遷移至 Kotlin，以強化已淘汰的標記 (I56775、b/289269026)
  • 在 TextView Compat 類別中新增 setLineHeight(unit, lineHeight) (I15716)
  • 新的 accessibilityDataSensitive compat 屬性。(I0c6e0)
  • 指定 FLAG_NO_CREATE 時，PendingIntentCompat.getActivity 和 getService 可能會傳回空值。(Iffdf0、b/289696515)
  • 更新 API 檔案，以註解相容性抑制 (I8e87a、b/287516207)
  • 新增 PendingIntentCompat.send() (Iaf707)
  • 新增 Location.removeVerticalAccuracy()、Location.removeSpeedAccuracy() 和 Location.removeBearingAccuracy() 的相容版本。(I5b640)

修正錯誤

  • 如果檢視區塊有無障礙委派，則將檢視區塊設為無障礙重要檢視區塊。(If2b54)

1.12.0-alpha05 版

2023 年 6 月 7 日

發布 androidx.core:core:1.12.0-alpha05、androidx.core:core-ktx:1.12.0-alpha05 和 androidx.core:core-testing:1.12.0-alpha05。這個版本是在內部分支版本中開發而成。

修正錯誤

  • 更新了 ColorUtils 類別的說明文件，說明如何從 Material 3 色調、色度和色調 (M3HCT) 參數產生顏色。(I32979、I21c8c)
  • 修正 android.os.Trace 的 replaceWith 淘汰項目 (I730f9)

1.12.0-alpha04 版

2023 年 5 月 10 日

發布 androidx.core:core:1.12.0-alpha04、androidx.core:core-ktx:1.12.0-alpha04 和 androidx.core:core-testing:1.12.0-alpha04。這是從內部分支版本發布的內容。

1.12.0-alpha03 版

2023 年 4 月 12 日

發布 androidx.core:core:1.12.0-alpha03、androidx.core:core-ktx:1.12.0-alpha03 和 androidx.core:core-testing:1.12.0-alpha03。這是從內部分支版本發布的內容。

API 變更

  • 取消隱藏 NotificationCompat.TvExtender (aosp/01c67677e9310b2cf4c536d7e951e117d6cce64a)
  • 新增公用方法，用於存取 M3HCT 參數，並將 M3HCT 值轉換為 ARGB (aosp/06810598aa94bee731bbe0d277933b8b9614934e)
  • 新增 NotificationManager.getCurrentInterruptionFilter (aosp/b0c6940639e35371d212a7ebd7dbf01c14fc7710)
  • 將 getCurrentInterruptionFilter 新增至 NotifManagerCompat (aosp/516143e05f824ff49bde3c0c97344a2924867d30)
  • 已淘汰 app.BundleCompat，改用 os.BundleCompat (aosp/bf6169fe9ee1113065d0cf380bd2e09f31ce0a40)
  • 新增 TestConsumer，方便開發人員在測試中記錄值。(aosp/f75a4913940e710842168c832a7f57c2dcae4fdf)
  • 新增 TestConsumer，方便開發人員在測試中記錄值。(aosp/67ad4e2c6488772b7c9a061ee6ca01bba23649f7)

修正錯誤

  • 修正 Android R 以下版本無法正常運作 unregisterGnssMeasurementsCallback() 的錯誤。(aosp/c5a97c4ee956f87d229ec892f2b8849f392e956c)

1.12.0-alpha01 版

2023 年 3 月 8 日

發布 androidx.core:core:1.12.0-alpha01 和 androidx.core:core-ktx:1.12.0-alpha01。1.12.0-alpha01 版包含以下修訂項目。

新功能

  • 提供 API，協助開發人員輕鬆存取使用者的偏好設定或 ICU 中的語言代碼資料。可存取的地區設定資料包括時鐘週期、日曆類型、溫度單位和一週的第一天。

API 變更

  • 新增了 LocalePreferences API，方便開發人員輕鬆存取語言代碼資料或使用者的語言代碼偏好設定。

Core 和 Core-ktx 1.11 版

1.11.0-beta02 版

2023 年 6 月 7 日

發布 androidx.core:core:1.11.0-beta02、androidx.core:core-ktx:1.11.0-beta02 和 androidx.core:core-testing:1.11.0-beta02。1.11.0-beta02 版包含以下修訂項目。

修正錯誤

  • 更新了 ColorUtils 類別的說明文件，說明如何從 Material 3 色調、色度和色調 (M3HCT) 參數產生顏色。(I32979、I21c8c)
  • 修正 android.os.Trace 的 replaceWith 淘汰項目 (I730f9)

1.11.0-beta01 版

2023 年 5 月 24 日

發布 androidx.core:core:1.11.0-beta01、androidx.core:core-ktx:1.11.0-beta01 和 androidx.core:core-testing:1.11.0-beta01。1.11.0-beta01 版包含以下修訂項目。

API 變更

  • 在 performHapticFeedback 方法中新增 ViewCompat 支援 (Ib02c6)
  • 將 getDisplay 變更為 #getDisplayOrDefault (I96ff9)
  • 新增 ContextCompat#getDisplay(Context) (I7011f、b/178183326)
  • 新增 ContextCompat#getContextForLanguage(Context)，可在非 Activity 環境中取得每個應用程式的語言代碼 (I58e75、b/243457462)

修正錯誤

  • 清楚說明 CollectionInfoCompat 文件，尤其是 isHierarchical (I14f6c)

1.11.0-alpha04 版

2023 年 5 月 10 日

發布 androidx.core:core:1.11.0-alpha04、androidx.core:core-ktx:1.11.0-alpha04 和 androidx.core:core-testing:1.11.0-alpha04。1.11.0-alpha04 版包含以下修訂項目。

API 變更

  • 新增 LinkMovementMethodCompat，修正連結觸控處理方式 (Ia632c)
  • PendingIntent.getBroadcast() 現已正確標示為 @Nullable (Ifff96、b/277630907)

修正錯誤

  • 修正 DisplayManagerCompat 中的 Context 外洩問題 (I3409b、b/279625765)
  • 新增 SoftwareKeyboardControllerCompat，提供直接方法來顯示及隱藏指定 View 的軟體鍵盤。這個版本會將使用某些 API 級別的 WindowInsetsController API 時，已知問題的解決方法向後移植，並擷取 WindowInsetsControllerCompat.show 的支援實作內容，以及隱藏輸入法編輯器插邊類型。(Idd0a3)

1.11.0-alpha03 版

2023 年 4 月 19 日

發布 androidx.core:core:1.11.0-alpha03、androidx.core:core-ktx:1.11.0-alpha03 和 androidx.core:core-testing:1.11.0-alpha03。1.11.0-alpha03 版包含以下修訂項目。

API 變更

  • 更新 BuildCompat，為 Android 14 Beta 版 2 做準備 (Idc1b1、b/276491001)
  • 取消隱藏 NotificationCompat.TvExtender (Ibe13a)
  • 新增公用方法，存取 M3HCT 參數並將 M3HCT 值轉換為 ARGB (Id7e9d)

1.11.0-alpha02 版

2023 年 4 月 5 日

發布 androidx.core:core:1.11.0-alpha02、androidx.core:core-ktx:1.11.0-alpha02 和 androidx.core:core-testing:1.11.0-alpha02。1.11.0-alpha02 版包含以下修訂項目。

API 變更

  • 將 getCurrentInterruptionFilter 新增至 NotifManagerCompat (I8ec95、b/243183646)
  • 淘汰 app.BundleCompat，改用 os.BundleCompat (Idc3a2、b/274577000)
  • 新增 TestConsumer，讓開發人員在測試中記錄值。(I937c1)

修正錯誤

  • 修正 Android R 以下版本無法正常運作 unregisterGnssMeasurementsCallback() 的錯誤。(Id1999)

1.11.0-alpha01 版

2023 年 3 月 22 日

發布 androidx.core:core:1.11.0-alpha01 和 androidx.core:core-ktx:1.11.0-alpha01。1.11.0-alpha01 版包含以下修訂項目。

API 變更

  • 在 Android U 中，getType 的 ContentProvider API 要求呼叫端具備正確的讀取權限。FileProvider 現在提供預設的 getTypeAnonymous 實作，也就是未受限的版本。(I4773f)
  • 新增內容擷取 API 的相容性類別 (I09366)
  • 新增了 NotifCompat.Builder.setLargeIcon(Icon) (Ic0a5b)
  • 在 NotificationManagerCompat 中新增批次通知 API。建議使用者在發布多則通知時使用這個 API。(I2cd7f)
  • 在 R 前平台新增支援執行工具的 registerGnssMeasurementsCallback() (I579f8)

Core 和 Core-ktx 1.10 版

1.10.1 版本

2023 年 5 月 10 日

發布 androidx.core:core:1.10.1 和 androidx.core:core-ktx:1.10.1。1.10.1 版包含以下修訂項目。

外部貢獻

  • 修正因結果為空值而擲回 BadParcelableException 的問題 b/277434277、b/278118318，由 Mygod Studio 貢獻

1.10.0 版本

2023 年 4 月 5 日

發布 androidx.core:core:1.10.0 和 androidx.core:core-ktx:1.10.0。1.10.0 版包含以下修訂項目。

自 1.9.0 版以來的重要變更

  • 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援 OS 版本，這項變更的成效差異都是微不足道。(I0a961)
  • 為 SDK 擴充功能版本新增 BuildCompat 常數。(I6084c)
  • 如需新版 API 和錯誤修正，請參閱 1.10.0 預先發布版本的版本資訊。

1.10.0-rc01 版

2023 年 3 月 8 日

發布 androidx.core:core:1.10.0-rc01 和 androidx.core:core-ktx:1.10.0-rc01，此兩版與先前的 Beta 版沒有差別。

1.10.0-beta01 版

2023 年 2 月 22 日

發布 androidx.core:core:1.10.0-beta01 和 androidx.core:core-ktx:1.10.0-beta01。1.10.0-beta01 版包含以下修訂項目。

API 變更

  • set/getMinMillisBetweteenContentChanges 的 AccessibilityNodeInfoCompat API 已重新命名為 set/getMinDurationBetweenContentChanges，且在使用期間採用 long。(f46689)
  • 新增了 NotificationCompat.bigLargeIcon(Icon) (I60855)

修正錯誤

  • 修正 NotificationCompat.Builder.setShowWhen() 預設值的相關文件 (ba52a2)
  • 修正 AccelerateInterpolator / DecelerateInterpolator 文件中的錯字 (2173505)
  • 修正 ShortcutInfoCompat 文件中的錯字 (44075f)
  • 使用 NestedScrollView 和 CoordinatorLayout 修正向上、向下、空格鍵和按鍵變化版本的鍵盤動作 (bdd72e)

1.10.0-alpha02 版

2023 年 1 月 25 日

發布 androidx.core:core:1.10.0-alpha02 和 androidx.core:core-ktx:1.10.0-alpha02。1.10.0-alpha02 版包含以下修訂項目。

API 變更

  • 為 AD_SERVICES 擴充功能版本新增 BuildCompat 常數 (I51d98)
  • 在 WindowInsetsControllerCompat 中新增 BEHAVIOR_DEFAULT。淘汰了 BEHAVIOR_SHOW_BARS_BY_SWIPE 和 BEHAVIOR_SHOW_BARS_BY_TOUCH。(I17b61)

1.10.0-alpha01 版

2023 年 1 月 11 日

發布 androidx.core:core:1.10.0-alpha01 和 androidx.core:core-ktx:1.10.0-alpha01。1.10.0-alpha01 版包含以下修訂項目。

API 變更

  • 將 CallStyle 新增至 NotificationCompat (Id9a53、b/199294989)
  • 為 SDK 擴充功能版本新增 BuildCompat 常數 (I6084c)
  • 新增用於在無障礙節點上設定初始焦點的 API。(Id199a)
  • 新增用於限制內容變更頻率的 API (If4ea0)
  • 針對 Android 13 中推出的 Parcel、Bundle 和 Intent 相關 API 新增相容性方法。部分 ParcelCompat 方法簽名已更新，可能需要變更來源，才能升級確認新的簽名。(I57e94、b/242048899)
  • 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援版本，這項變更的成效差異都是微不足道。(I0a961)
  • 針對已淘汰的隱藏函式，更新其傳回類型是否可為空值 (Ibf7b0)
  • 新增 Point 和 PointF 的乘法/除法運算子超載 (I8e557、b/261574780)

修正錯誤

  • 對 AccessibilityEvent#TYPE_ANNOUNCEMENT 新增避免使用該項目的建議。(I818bf)
  • 指定清單應包含無障礙功能專用的 1 列或 1 欄 (Ia1223)

Core 和 Core-ktx 1.9.0 版本

1.9.0 版

2022 年 9 月 7 日

發布 androidx.core:core:1.9.0 和 androidx.core:core-ktx:1.9.0。1.9.0 版包含以下修訂項目。

自 1.8.0 版以來的重要變更

  • 更新後已改善與 Android 13 的相容性，包括可為空值性的變更以及與架構 API 保持一致。
  • 新增了 IntentSanitizer，可讓您先清理不安全的意圖再發布。(Ib0be5)
  • 現在可支援使用 Icon 的 BigPictureStyle (Ice26d)。
  • 將 @RequiresPermission 新增至需要為 SDK 33 以上版本授予 POST_NOTIFICATIONS 權限的 API (Ie542e)
  • 改善 Android 13 無障礙架構 API 與相容性 API 間的一致性 (I93c97、I5a074、Iedf82)。

1.9.0-rc01 版本

2022 年 8 月 24 日

發布 androidx.core:core:1.9.0-rc01 和 androidx.core:core-ktx:1.9.0-rc01。1.9.0-rc01 版包含以下修訂項目。

修正錯誤

  • 篩選時，IntentSanitizer.sanitizeByFiltering 不會再寫入記錄中 (69b3b55)

1.9.0-beta01 版本

2022 年 8 月 10 日

發布了 androidx.core:core:1.9.0-beta01。1.9.0-beta01 版包含以下修訂項目。

API 變更

修正錯誤

  • 將 @RequiresPermission 新增至需要為 SDK 33 以上版本授予 POST_NOTIFICATIONS 權限的 API (Ie542e、b/238790278)
  • 在 androidx-platform-dev 中新增對 T 所導入 API 的支援 ()
  • 新增 T 中針對 API 的支援。(I358f1)
  • 如果 compat impl 無法在 API 14-20 上解析，TypefaceCompate.create(..., weight, italic) 會改回使用 Typeface.create 平台 (I1ee34、b/145311058)。
  • 新增了 androidx 先前缺少的無障礙架構常數，加入位置：androidx-main am: d5747be010 (I5a074)。
  • 新增了 androidx 先前缺少的無障礙架構常數。(I93c97)

外部貢獻

  • 向後移植 Typeface#create(Typeface, int, boolean)，允許從字型系列建立特定粗細的字體 (I342dc)

1.9.0-alpha05 版本

2022 年 6 月 15 日

發布 androidx.core:core:1.9.0-alpha05 和 androidx.core:core-ktx:1.9.0-alpha05。1.9.0-alpha05 版以私人的預先發布分支版開發，並無公開修訂版。

API 變更

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

1.9.0-alpha04 版

2022 年 5 月 18 日

發布 androidx.core:core:1.9.0-alpha04 和 androidx.core:core-ktx:1.9.0-alpha04。1.9.0-alpha04 版是依 Android SDK 預先發布版建構而成，因此沒有可公開發布的修訂記錄。

修正錯誤

  • 還原 BuildCompat.isAtLeastT() 的淘汰項目和隨附的 SDK_INT 項檢查

1.9.0-alpha03 版

2022 年 4 月 27 日

發布 androidx.core:core:1.9.0-alpha03 和 androidx.core:core-ktx:1.9.0-alpha03。1.9.0-alpha04 版包含自 1.8.0-beta01 以來的所有修訂項目，但是以 Android 13 Beta 1 版為基礎來建構。

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

1.9.0-alpha02 版

2022 年 3 月 23 日

發布 androidx.core:core:1.9.0-alpha02 和 androidx.core:core-ktx:1.9.0-alpha02。1.9.0-alpha02 版包含 1.8.0-alpha06 的所有修訂項目，但以 Tiramisu DP2 為基礎建構而成。

1.9.0-alpha01 版

2022 年 2 月 23 日

發布 androidx.core:core:1.9.0-alpha01 和 androidx.core:core-ktx:1.9.0-alpha01。1.9.0-alpha01 版是以內部分支版為基礎，沒有可以開放給所有人查看的修訂版。

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

新功能

  • 與 Android Tiramisu DP1 相容。

核心和核心-ktx 1.8.0 版

1.8.0 版

2022 年 6 月 1 日

發布 androidx.core:core:1.8.0 和 androidx.core:core-ktx:1.8.0。1.8.0 版包含以下修訂項目。

自 1.7.0 版以來的重要變更

  • 明確清除可空值註解，改善 Kotlin 可用性
  • 改善 ShortcutInfoCompat 和 NotificationCompat 等的平台的一致性
  • 提供新介面，可讓元件接收子母畫面和多視窗模式變更事件，並由 Activity 程式庫中的 ComponentActivity 實作
  • 改善 MenuProvider 回呼方法，包括 onPrepareMenu 和 onMenuClosed
  • 修正問題：在某些裝置上，FileProvider 會在搭配 IllegalArgumentException 使用時無法執行
  • 修正問題：(感謝 RikkaW　提出的錯誤) TypefaceCompat 在 API 29 　以上會套用不正確的字體粗細 (b/194553426)

1.8.0-rc02 版

2022 年 5 月 18 日

發布 androidx.core:core:1.8.0-rc02 和 androidx.core:core-ktx:1.8.0-rc02。1.8.0-rc02 版包含以下修訂項目。

修正錯誤

  • 將 OnSharedElementsReadyListener 投放到完整的平台類別，以免發生 ClassCastException (0029fed)

1.8.0-rc01 版

2022 年 5 月 11 日

發布 androidx.core:core:1.8.0-rc01 和 androidx.core:core-ktx:1.8.0-rc01。1.8.0-rc01 版包含以下修訂項目。

API 變更

  • 為下一個預先發布週期新增 BuildCompat 檢查 (If5a8f、b/229859122)
  • 為最終 SDK_INT 值更新 BuildCompat.isAtLeastT()。(Iffae0)

1.8.0-beta01 版

2022 年 4 月 20 日

發布了 androidx.core:core:1.8.0-beta01 和 androidx.core:core-ktx:1.8.0-beta01，且自 1.8.0-alpha07 版以來皆無變更。1.8.0-beta01 版包含以下修訂項目。

1.8.0-alpha07 版

2022 年 4 月 6 日

發布 androidx.core:core:1.8.0-alpha07 和 androidx.core:core-ktx:1.8.0-alpha07。1.8.0-alpha07 版包含以下修訂項目。

修正錯誤

  • 在 API 29 以上級別中，TypefaceCompat 現在會遵循要求及載入的樣式資訊。這是當載入的字型不是 FontWeight.Normal 或 FontWeight.Bold 時的行為變更，因為系統會使用實際載入的字體粗細和樣式。(#212、b/194553426)

外部貢獻

  • 感謝 RikkaW 協助我們在 API 29 以上級別上能正確套用 TypefaceCompat 中的 Typeface 粗細 (#212)。

1.8.0-alpha06 版

2022 年 3 月 23 日

發布 androidx.core:core:1.8.0-alpha06。1.8.0-alpha06 版包含以下修訂項目。

API 變更

  • MenuProvider 介面現在包含 onPrepareMenu() 回呼，供選單進行動態修改且應該顯示時呼叫。(Ie85f9)
  • MenuProvider 介面現在包含 onMenuClosed() 方法，隨時可用於關閉選單。(If5a16)
  • 更新 IconCompat#getResId 來提供正確的資源註解類型，以符合 Icon#getResId 架構中對應的方法 (I49700)。
  • 還原 WindowInsetsControllerCompat 之前僅依賴 View 的變更，現在改回需要 Window 來管理某些視窗標記。淘汰 ViewCompat.getWindowInsetsController 並改用 WindowCompat.getInsetsController，確保使用正確的 Window (例如 View 在對話方塊內)。(I660ae、b/219572936)
  • 根據 Tiramisu DP2 (I0cbb7) 更新核心和應用程式是否可為空值的作法
  • 為 BitmapCompat 新增方法，讓點陣圖縮小作業更為流暢。(Ib706c)
  • 為 ActivityCompat.requestDragAndDropPermissions 新增是否可為空值註解 (I0f2b0、b/206113378)
  • 為 FileProvider 新增解決方法，方便原始設備製造商 (OEM) 從資訊清單中去除中繼資料。(I82f63)

修正錯誤

  • 在無障礙功能窗格瀏覽權限狀態為 <P 的情況下，將父項的瀏覽權限變更納入考量 (I8e04f)

1.8.0-alpha05 版

2022 年 2 月 23 日

發布 androidx.core:core:1.8.0-alpha05 和 androidx.core:core-ktx:1.8.0-alpha05。1.8.0-alpha05 版包含以下修訂項目。

API 變更

  • 更新了 androidx.core.os 類別的可空值性 (If18cd、b/206113622)
  • 更新了 androidx.core.app 類別的可空值性 (I657eb、b/206113302)
  • 更新了 androidx.core.text 類別的可空值性 (I08329、b/206113384)
  • 將 ExtraData 函式新增至 AccessibilityNodeInfoCompat (If2fc7、b/137789185)
  • 為 bundleOf() 新增零引數超載，避免在建立空白套件時發生不可見的陣列配置 (If7089)
  • 新增了 Continuation<T>.asFoo() 轉接程式來建立回呼，用於為可接受常見/一般回呼類型的 Android API 編寫暫停包裝函式 (I6615e)
  • 新增了可為空值的 Drawable.toBitmapOrNull 方法，以避免例外狀況 (I2342a)

1.8.0-alpha04 版

2022 年 2 月 9 日

發布 androidx.core:core:1.8.0-alpha04 和 androidx.core:core-ktx:1.8.0-alpha04。1.8.0-alpha04 版包含以下修訂項目。

API 變更

  • 新增 OnPictureInPictureModeChangedProvider 介面，可讓任何元件接收子母畫面模式變更事件。這是由 ComponentActivity 在 Activity 1.5.0-alpha02 中實作。(I9f567)
  • 新增 OnMultiWindowModeChangedProvider 介面，讓任何元件接收多視窗模式變更事件。這是由 ComponentActivity 在 Activity 1.5.0-alpha02 中實作。(I62d91)
  • 清除部分 androidx.core API 的可為空值性。(Ia0e2f、b/206113818)

1.8.0-alpha03 版

2022 年 1 月 26 日

發布 androidx.core:core:1.8.0-alpha03 和 androidx.core:core-ktx:1.8.0-alpha03。1.8.0-alpha03 版包含以下修訂項目。

API 變更

  • 將 WindowInsetsControllerCompat 轉換為依附於 View，而非 Window 或平台 WindowInsetsController。這可改善 Dialog 的行為、顯示輸入法編輯器，並確保未淘汰的建立方法可以解決問題 (b/180881870)。(I29264、b/207401542、b/210121779)
  • 清除部分 androidx.core API 的可為空值性。(Ib2583、b/206113818)
  • 修正 performAccessibilityAction 參數的可為空值性 (Ibbafe)
  • 新增解決 ColorStateList 問題的方法，此問題是以 Theme 為鍵的快取和 Theme.applyStyle 所造成 (I9188b、b/207739887)
  • 更新捷徑瀏覽權限 API，以提高可讀性 (Ia58df)
  • 為 persistableBundleOf() 新增零引數超載，避免在建立空白 PersistableBundle 時進行不必要的陣列配置 (Icd7a4)

1.8.0-alpha02 版

2021 年 12 月 15 日

發布 androidx.core:core:1.8.0-alpha02 和 androidx.core:core-ktx:1.8.0-alpha02。1.8.0-alpha02 版包含以下修訂項目。

API 變更

  • 為日後的 SDK 新增實驗性 BuildCompat 方法 (Iafd82、b/207528937)
  • 新增公用程式方法，可用於將文件轉換為捷徑，反之亦然。(Id512c)
  • 更新捷徑瀏覽權限 API，以提高可讀性 (I86dec)
  • 新增 OnNewIntentProvider、OnConfigurationChangedProvider 和 onTrimMemoryProvider 介面，用來表示您的自訂活動可將這些事件分派到可新增事件監聽器的任何元件。(If1f8b、If623b、Ia9295)

1.8.0-alpha01 版

2021 年 12 月 1 日

發布 androidx.core:core:1.8.0-alpha01 和 androidx.core:core-ktx:1.8.0-alpha01。1.8.0-alpha01 版包含以下修訂項目。

API 變更

  • 大量清除可空值性的註解
  • 新增了 API ShortcutInfoCompat.Builder#setHiddenFromLauncher，用來指定是否要在啟動器中隱藏捷徑。(Ia2a71)
  • 新增 NotificationCompat.Action#setAuthenticationRequired (Ieeafa、b/202172887)
  • 新增 NotificationCompat.BigPictureStyle.setContentDescription (I3b483)
  • 新增了擴充功能函式 Map<String, Any?>.toPersistableBundle() (I82c86)

修正錯誤

  • 調整無障礙功能操作的捲動距離 (If74ae)
  • 移除 Javadocs 中的硬式編碼語言程式碼 (Ie5d68)

Core 和 Core-ktx 1.7 版

1.7.0 版

2021 年 10 月 27 日

發布 androidx.core:core:1.7.0 和 androidx.core:core-ktx:1.7.0。1.7.0 版包含以下修訂項目。

自 1.6.0 版以來的重要變更

1.7.0-rc01 版

2021 年 10 月 13 日

發布 androidx.core:core:1.7.0-rc01 和 androidx.core:core-ktx:1.7.0-rc01。1.7.0-rc01 版包含以下修訂項目。

1.7.0-beta02 版

2021 年 9 月 29 日

發布了 androidx.core:core:1.7.0-beta02 和 androidx.core:core-ktx:1.7.0-beta02。1.7.0-beta02 版包含以下修訂項目。

修正錯誤

  • 現在，如果在生命週期被 DESTROYED 之前移除 MenuProvider，MenuHostHelper 將會正確移除所有 LifecycleObserver。(Ibe2e1、b/199788262)
  • 更新未使用的應用程式限制常數的說明，讓開發人員更容易理解 (I2858e)

1.7.0-beta01 版

2021 年 9 月 15 日

發布 androidx.core:core:1.7.0-beta01 和 androidx.core:core-ktx:1.7.0-beta01。1.7.0-beta01 版包含以下修訂項目。

API 變更

  • LocationRequestCompat.toProvider 現在可以傳回空值 (Ib5a09)

1.7.0-alpha02 版

2021 年 9 月 1 日

發布 androidx.core:core:1.7.0-alpha02 和 androidx.core:core-ktx:1.7.0-alpha02。1.7.0-alpha02 版包含以下修訂項目。

新功能

  • 簡化及統一生命週期感知選單的管理方式，詳情請參閱 MenuProvider。

API 變更

  • 為管理 MenuProvider 的元件新增 MenuHost 介面。(I83f23)
  • 新增了 MenuProvider 介面，用來表示元件有提供選單項目。(If8a40)
  • 新增了 MenuHostHelper，可簡化在元件中實作 MenuHost 的程序。(I74f4a)
  • 新增了 LocationRequestCompat.toLocationRequest()，用於轉換為平台類別。(I71e75)
  • 新增了與平台 API 一致的 DocumentsContractCompat 類別。(Ia9e91)
  • 新增了與平台 API 一致的 NotificationCompat.BigPictureStyle.showBigPictureWhenCollapsed(boolean)。(I8cd88)
  • 修正了 PermissionChecker 的 checkSelfPermission 會顯示麥克風/攝影機指標的問題。(I572a9)
  • 為 setImportantForAccessibility 新增明確執行緒註解。(I990fa)
  • 更新了 getUnusedAppRestrictionsStatus，以符合 API 指南規定。(I28a18)
  • 修正了 getUnusedAppRestrictionsStatus 的功能，讓其更加完善。(I7c2d6)
  • 開始支援 LocationCompat 的垂直準確率、速度準確率和方位準確率。(I1d3e9)
  • 將數學相容性函式新增至 MathUtils。(Idb590)
  • 將 OnReceiveContentListener 整合至相容性 API。(Ic6914、b/173814913)
  • 新增了 ActivityCompat#isLaunchedFromBubble，藉此與平台保持一致。(I6961a)
  • 新增了 LocationRequest 和 LocationManager.hasProvider()，藉此與平台保持一致。(I4f3e4)

修正錯誤

  • 取消在 PackageManagerCompat 中使用 lambda，以免發生 LambdaDesugaring 錯誤。(I36c87)

1.7.0-alpha01 版

2021 年 6 月 30 日

發布 androidx.core:core:1.7.0-alpha01 和 androidx.core:core-ktx:1.7.0-alpha01。1.7.0-alpha01 版包含此連結所列的修訂項目。

API 變更

  • 新增了用於設定 InputConnection 的 API，以便使用 View.performReceiveContent 處理對 InputConnection.commitContent 發出的輸入法編輯器呼叫。(I3a2ad)
  • 將兩個 API 的功能合而為一 (I261df)
  • 修改兩個 API 的功能，以便與未使用的應用程式限制功能 (例如權限撤銷、應用程式休眠) 搭配使用 (Ic1616)
  • 新增了三個 API，用來與未使用的應用程式限制功能 (例如權限撤銷、應用程式休眠) 搭配使用 (I606d7)
  • 對多個 Compat 類別新增可為空值性註解 (I2802a、b/188452327、b/189962089)
  • 新增了三個 API，用來與未使用的應用程式限制功能 (例如權限撤銷、應用程式休眠) 搭配使用 (Icafee)
  • 解決了 ViewCompat 中缺少是否可為空值的註解問題 (Ic346e、b/188453571)

Core Remote Views 1.1 版

1.1.0 版本

2024 年 6 月 12 日

發布 androidx.core:core-remoteviews:1.1.0。1.1.0 版包含這些修訂項目。

自 1.0.0 版以來的重要變更

  • 核心 RemoteViews 移至 1.1.0 穩定版。

1.1.0-rc01 版本

2024 年 5 月 14 日

發布 androidx.core:core-remoteviews:1.1.0-rc01。1.1.0-rc01 版包含這些修訂項目。

新功能

  • 將 RemoteViews 1.1.0 移至候選版。

修正錯誤

  • 將 AndroidX 程式庫的預設 minSdkVersion 移至 21。(I6ec7f)

1.1.0-beta02 版

2024 年 4 月 17 日

發布 androidx.core:core-remoteviews:1.1.0-beta02。自上次發布以來沒有重大變更。

1.1.0-beta01 版本

2024 年 4 月 3 日

發布 androidx.core:core-remoteviews:1.1.0-beta01。1.1.0-beta01 版包含這些修訂項目。

1.1.0-alpha01 版本

2024 年 2 月 7 日

發布 androidx.core:core-remoteviews:1.1.0-alpha01。1.1.0-alpha01 版包含以下修訂項目。

新功能

  • 版本升級，與依附元件版本相符。

Core Remote Views 1.0 版本

1.0.0 版本

2023 年 9 月 6 日

發布 androidx.core:core-remoteviews:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

  • 將 core-remoteviews 移至穩定版 1.0.0

1.0.0-beta04 版

2023 年 5 月 10 日

發布 androidx.core:core-remoteviews:1.0.0-beta04。1.0.0-beta04 版包含此連結所列的修訂項目。

修正錯誤

  • 修正相容性程式庫中邊角情況下擲回的 ArrayOutOfBoundsException。

1.0.0-beta03 版

2022 年 10 月 5 日

發布了 androidx.core:core-remoteviews:1.0.0-beta03。1.0.0-beta03 版包含此連結所列的修訂項目。

新功能

  • 沒有新增任何功能。

1.0.0-beta02 版

2022 年 8 月 10 日

發布 androidx.core:core-remoteviews:1.0.0-beta02。查看 1.0.0-beta02 版的修訂項。

修正錯誤

  • 版本修正

1.0.0-beta01 版

2019 年 6 月 29 日

發布了 androidx.core:core-remoteviews:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。

新功能

  • 將 Core-RemoteViews 遷移至 Beta 版。

1.0.0-alpha03 版

2022 年 2 月 23 日

發布了 androidx.core:core-remoteviews:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。

修正錯誤

  • 修正基礎結構。

1.0.0-alpha02 版

2022 年 1 月 26 日

發布了 androidx.core:core-remoteviews:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

1.0.0-alpha01 版

2021 年 12 月 15 日

發布 androidx.core:core-remoteviews:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 新的 RemoteViews.setRemoteAdapter API 向後移植。
  • Kotlin 擴充功能函式，可用於呼叫 RemoteViews 方法時避免出現反射。
  • 具有輔助函式的程式庫，用於處理 App Widget 大小調整 API。

Core Performance 1.0 版

1.0.0 版本

2024 年 1 月 10 日

發布 androidx.core:core-performance:1.0.0、androidx.core:core-performance-play-services:1.0.0 和 androidx.core:core-performance-testing:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

  • 核心效能 - 提供可靠的機制，方便開發人員在執行階段識別裝置的效能等級，進而相應調整應用程式的使用者體驗。
  • 核心效能 Play 服務 - Google 專屬的實作項目，可為測試的裝置和 OS 版本提供最新的媒體效能類別資訊。
  • 核心效能測試 - 核心效能的測試替身。

修正錯誤

  • 修正初始化版本 1.0.0-beta2 中的 PlayServicesDevicePerformance 時發生的異常終止問題。(b/318803680)

1.0.0-rc01 版

2023 年 12 月 13 日

發布 androidx.core:core-performance:1.0.0-rc01、androidx.core:core-performance-play-services:1.0.0-rc01 和 androidx.core:core-performance-testing:1.0.0-rc01。1.0.0-rc01 版本包含以下修訂項目。

新功能

  • 核心效能 - 更新程式庫實作。(DevicePerformance一般實作)。
  • Play 服務核心效能 - 初始程式庫實作。(Google 專屬的 DevicePerformance 實作)。
  • 核心效能測試 - 初始程式庫實作。(包含 Core Performance 的測試替身)。

API 變更

  • DevicePerformance 特定 API 的初始 RC 版本。

1.0.0-beta02 版

2023 年 10 月 4 日

發布 androidx.core:core-performance:1.0.0-beta02、androidx.core:core-performance-play-services:1.0.0-beta02 和 androidx.core:core-performance-testing:1.0.0-beta02。1.0.0-beta02 版包含此連結所列的修訂項目。

新功能

  • 測試相關重構。

API 變更

  • API 使用模式不變。

1.0.0-beta01 版

2023 年 9 月 6 日

發布 androidx.core:core-performance:1.0.0-beta01、androidx.core:core-performance-play-services:1.0.0-beta01 和 androidx.core:core-performance-testing:1.0.0-beta01。1.0.0-beta01 版本包含以下修訂項目。

新功能

  • 核心效能 - 更新程式庫實作。(DevicePerformance一般實作)。
  • Play 服務核心效能 - 初始程式庫實作。(Google 專屬的 DevicePerformance 實作)。
  • 核心效能測試 - 初始程式庫實作。(包含 Core Performance 的測試替身)。

API 變更

  • DevicePerformance 特定 API 的初始 Beta 版。

1.0.0-alpha03 版本

2023 年 8 月 23 日

發布 androidx.core:core-performance:1.0.0-alpha03、androidx.core:core-performance-play-services:1.0.0-alpha03 和 androidx.core:core-performance-testing:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。

新功能

  • core-performance-testing 的初始程式庫實作項目，包含核心效能的測試替身。
  • 初始程式庫實作或 core-performance-play-services。Google 專屬實作方式可提供最新的媒體效能類別資訊。

API 變更

  • 新增選用模組，從 Google Play 服務提供媒體效能類別。
  • 核心效能建構函式已變更，可支援選用實作。

1.0.0-alpha02 版

2022 年 3 月 23 日

發布了 androidx.core:core-performance:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 提供簡單且可靠的機制，方便開發人員在執行階段識別裝置的效能等級，以提供最佳的應用程式體驗。
  • 這個初始版採用手動測試的裝置清單，授予這些裝置的效能類別值高於 Build.VERSION.MEDIA_PERFORMANCE_CLASS 中宣告的等級

1.0.0-alpha01 版

2021 年 12 月 15 日

發布 androidx.core:core-performance:1.0.0-alpha01。1.0.0-alpha01 版本包含以下修訂項目。

Core Splashscreen 1.2 版

1.2.0-rc01 版本

2025 年 7 月 2 日

發布 androidx.core:core-splashscreen:1.2.0-rc01。1.2.0-rc01 版包含這些修訂項目。

1.2.0-beta02 版

2025 年 4 月 23 日

發布 androidx.core:core-splashscreen:1.2.0-beta02。1.2.0-beta02 版包含這些修訂項目。

1.2.0-beta01 版本

2025 年 2 月 26 日

發布 androidx.core:core-splashscreen:1.2.0-beta01。1.2.0-beta01 版包含這些修訂項目。

1.2.0-alpha02 版本

2024 年 9 月 4 日

發布 androidx.core:core-splashscreen:1.2.0-alpha02。1.2.0-alpha02 版包含這些修訂項目。

修正錯誤

  • 在 SplashScreen 的主題中新增 isLightTheme 屬性 (I01000、b/238522114)
  • 透過 AppCompatResources 取得啟動畫面圖示 (Ib05e、b/289242141、b/263972037)
  • 移除手動列出新平台 API 存取權的步驟，因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，系統會透過 API 建模自動執行這項作業，而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時，所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP，建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)

1.2.0-alpha01 版本

2024 年 4 月 17 日

發布 androidx.core:core-splashscreen:1.2.0-alpha01。1.2.0-alpha01 版包含這些修訂項目。

修正錯誤

  • 自 v30 起，將 Base.Theme.SplashScreen 的凹口模式一律設為「always」(Idfc3f)。
  • 從 API 31 將 enforceNavigationBarContrast 重設為系統預設值，以免啟動畫面主題損毀活動主題。 從 API 31 以上版本開始，系統不會將啟動畫面建立為 PhoneWindow，因此不需要從 API 29 繼承值。此外，請從 applyAppSystemUiTheme 移除覆寫動作，因為 enforceNavigationBarContrast 可能已在啟動期間從應用程式端變更，從屬性覆寫沒有意義。(Ic2cd9)
  • 設定預設的淺色導覽列，並遵守日/夜間主題。因此，在 API 33 以上的平台中，移除啟動畫面時，啟動畫面主題不會造成閃爍。(I8023a)
  • 從 API 33 接收啟動畫面檢視區塊後，請勿覆寫活動主題。(I10587b)

Core Splashscreen 1.1 版

1.1.0-rc01 版本

2024 年 4 月 3 日

發布 androidx.core:core-splashscreen:1.1.0-rc01。1.1.0-rc01 版包含這些修訂項目。

修正錯誤

  • 為圖示大小為 48x48dp 的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)
  • 修正 SplashScreenView#getIconView 導致 NPE 異常終止的問題 (6abfd6、b/243457485)

1.1.0-alpha02 版本

2023 年 9 月 6 日

發布 androidx.core:core-splashscreen:1.1.0-alpha02。1.1.0-alpha02 版本包含以下修訂項目。

修正錯誤

  • 為圖示大小為 48x48dp 的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)

依附元件更新

  • Core-Splashscreen 現在會針對 API 34 編譯。

1.1.0-alpha01 版本

2023 年 2 月 22 日

發布 androidx.core:core-splashscreen:1.1.0-alpha01。這是以內部分支版本為基礎。

修正錯誤

  • 修正 SplashScreenView#getIconView 傳回空值時 NullPointerException 的問題。(e231ab)

Core Splashscreen 1.0 版本

1.0.1 版

2023 年 4 月 19 日

發布 androidx.core:core-splashscreen:1.0.1。1.0.1 版包含以下修訂項目。

修正錯誤

  • 為圖示大小為 48x48dp 的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)

1.0.0 版本

2022 年 7 月 27 日

Core Splashscreen 程式庫將新的 Android 12 啟動畫面提供給所有搭載 API 23 的裝置。只要使用啟動畫面程式庫，應用程式就不需任何自訂 SplashScreen 活動，且可利用正確的 API 快速啟動應用程式。只要按照指南中的步驟操作即可。如要進一步瞭解 Android 12 啟動畫面，請參閱「官方說明文件」。

發布了 androidx.core:core-splashscreen:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0-rc01 版

2022 年 5 月 18 日

發布 androidx.core:core-splashscreen:1.0.0-rc01。1.0.0-rc01 版包含以下修訂項目。

  • 自上次 Beta 版發布後沒有任何異動。

1.0.0-beta02 版

2022 年 3 月 23 日

發布了 androidx.core:core-splashscreen:1.0.0-beta02。查看 1.0.0-beta02 版的修訂項。

修正錯誤

  • 修正 Lateinit property platformView has not been initialized (b/214835299)

外部貢獻

  • 修正在 MIUI 上使用深色模式的轉譯問題，並將 android:animateLayoutChanges 明確設為 false，避免在 OnExitAnimationListener 中移除啟動畫面時顯示淡出的動畫效果 (#327)。

1.0.0-beta01 版

2022 年 1 月 12 日

發布 androidx.core:core-splashscreen:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。

修正錯誤

  • 改善夜間模式處理作業，確保在所有 API 使用預設參數時，會處理夜間模式。2d1d182

修正 Android 12 新啟動畫面引起的錯誤：

  • 修正 API 31 的 systemBar 閃爍問題：確保自訂退出動畫時系統資訊列不會閃爍。5a75362
  • 修正使用 OnExitAnimationListener 時的插邊處理問題：確保使用 OnExitAnimationListener 時不會略過內容。4c8f264

1.0.0-alpha02 版

2021 年 9 月 29 日

發布 androidx.core:core-splashscreen:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 改善插邊支援：現在即使設定了 OnExitAnimationListener，所有 API 也會以全螢幕顯示啟動畫面。
  • postSplashScreenTheme 為選擇性項目：只要在 onCreate() 之前呼叫 activity.setTheme()，即可設定啟動畫面顯示後的應用程式主題。
  • 回溯支援 windowSplashScreenIconBackgroundColor 屬性：您可以使用 Theme.SplashScreen.IconBackground 和 windowSplashScreenIconBackgroundColor，即可為啟動畫面圖示加上背景。
  • 圖示大小已調整為符合平台規格。

API 變更

修正錯誤

  • 將 postSplashScreenTheme 設為選用選項 (I8c4bf)

1.0.0-alpha01 版

2021 年 6 月 30 日

發布 androidx.core:core-splashscreen:1.0.0-alpha01。

新功能

  • core-splashscreen 為新的 Splash Screen API 提供回溯相容性。這第一個 Alpha 版包含所有向後移植至 API 23 的新 API (圖示背景除外)。
  • 如要瞭解使用資訊，請參閱 androidx.core.splashscreen 中的 KDocs。

Core Google Shortcuts 1.2 版

1.2.0-alpha01 版本

2023 年 7 月 26 日

發布 androidx.core:core-google-shortcuts:1.2.0-alpha01。查看 1.2.0-alpha01 版的修訂項。

API 變更

Core Google Shortcuts 1.1.0 版本

1.1.0 版本

2022 年 10 月 24 日

發布 androidx.core:core-google-shortcuts:1.1.0。查看 1.1.0 版的修訂項。

自 1.0.0 版以來的重要變更

  • 已從使用 com.google.firebase:firebase-appindexing 遷移至新的 com.google.android.gms:play-services-appindex 程式庫。這個程式庫版本與 com.google.firebase:firebase-appindexing 不相容。開發人員應避免同時使用這兩個程式庫，以免發生建構錯誤。

1.1.0-rc01 版本

2022 年 10 月 5 日

發布了 androidx.core:core-google-shortcuts:1.1.0-rc01。1.1.0-rc01 版包含此連結所列的修訂項目。

新功能

  • 已從使用 com.google.firebase:firebase-appindexing 遷移至新的 com.google.android.gms:play-services-appindex 程式庫。請注意，這個版本的程式庫與 com.google.firebase:firebase-appindexing 不相容。開發人員應避免同時使用這兩個程式庫，以免發生建構錯誤。

1.1.0-beta01 版本

2022 年 9 月 21 日

發布了 androidx.core:core-google-shortcuts:1.1.0-beta01。1.1.0-beta01 版包含此連結所列的修訂項目。

新功能

  • 移除未使用的依附元件。這個版本並未推出新功能。

1.1.0-alpha03 版本

2022 年 9 月 7 日

發布了 androidx.core:core-google-shortcuts:1.1.0-alpha03。1.1.0-alpha03 版包含此連結所列的修訂項目。

新功能

  • 移除未使用的依附元件。這個版本並未推出新功能。

1.1.0-alpha02 版本

2022 年 8 月 24 日

發布了 androidx.core:core-google-shortcuts:1.1.0-alpha02。查看 1.1.0-alpha02 版的修訂項。

新功能

  • 將依附元件從 com.google.firebase:firebase-appindexing 更新為 com.google.android.gms:play-services-appindex。使用這個新版本的開發人員不應在外部利用 com.google.firebase:firebase-appindexing，因為這兩個程式庫現在不相容。

1.1.0-alpha01 版本

2021 年 8 月 4 日

發布 androidx.core:core-google-shortcuts:1.1.0-alpha01。1.1.0-alpha01 版包含以下修訂項目。

新功能

  • 在由 Google 應用程式顯示的 Donated 捷徑中，為以 URI 為基礎的圖示建立索引。

Core 和 Core-ktx 1.6.0 版

1.6.0 版

2021 年 6 月 30 日

發布 androidx.core:core:1.6.0 和 androidx.core:core-ktx:1.6.0。1.6.0 版包含以下修訂項目。

自 1.5.0 版以來的重要變更

  • 開始支援解析巢狀 ColorStateList 中的主題屬性。(I2e409、b/155579892)
  • 向後移植 CheckedTextView 的可著色背景和勾號 (I8575c)

1.6.0-rc01 版

2021 年 6 月 16 日

發布 androidx.core:core:1.6.0-rc01 和 androidx.core:core-ktx:1.6.0-rc01。1.6.0-rc01 版包含以下修訂項目。

API 變更

1.6.0-beta02 版

2021 年 6 月 2 日

發布 androidx.core:core:1.6.0-beta02 和 androidx.core:core-ktx:1.6.0-beta02。1.6.0-beta02 版包含以下修訂項目。

修正錯誤

  • 更新 BuildCompat，以便可在最新平台上使用目前的長按逾時設定 (b/185118174)
  • 從 ContextCompat 和 ContentLoadingProgress 方法移除使用 synchronized。

1.6.0-beta01 版

2021 年 5 月 18 日

發布 androidx.core:core:1.6.0-beta01 和 androidx.core:core-ktx:1.6.0-beta01。1.6.0-beta01 版包含以下修訂項目。

API 變更

1.6.0-alpha03 版本

2021 年 5 月 5 日

發布 androidx.core:core:1.6.0-alpha03 和 androidx.core:core-ktx:1.6.0-alpha03。1.6.0-alpha03 版包含以下修訂項目。

新功能

  • 開始支援解析巢狀 ColorStateList 中的主題屬性。(I2e409、b/155579892)

修正錯誤

  • 防止在 AppCompat 支援的檢視區塊上處理 null 自訂選取操作模式回呼時造成 NPE (I033c7、b/173435375)。

  • 針對版本小於 30 的 SDK 開始支援 setSystemBarsBehavior。(I062c8、b/173203649)

1.6.0-alpha02 版本

2021 年 4 月 15 日

發布 androidx.core:core:1.6.0-alpha02 和 androidx.core:core-ktx:1.6.0-alpha02。1.6.0-alpha02 版包含以下修訂項目。

API 變更

  • 新增 TelephoneManagerCompat 和 SubscriptionManagerCompat (I5568d)
  • 從 ShortcutInfoCompat 移除已淘汰的 addCapabilityBinding 方法 (Ie8f70)
  • 為 ShortcutInfoCompat.Builder 新增帶有參數的 addCapabilityBinding 和不帶參數 setter 的 addCapabilityBinding，並淘汰舊有的 addCapabilityBinding (I90686)
  • 新增 LocationCompat 類別和 LocationManagerCompat.getCurrentLocation() (I78d9a)
  • 淘汰了 ModeCompat.isNative，改為使用 DisplayCompat.getMode。(I9a6a2)
  • 新增了 ContextCompat.getAttributionTag() 和 UserHandleCompat.getUserHandleForUid() (Iea486)

外部貢獻

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

1.6.0-alpha01 版本

2021 年 3 月 24 日

發布 androidx.core:core:1.6.0-alpha01 和 androidx.core:core-ktx:1.6.0-alpha01。1.6.0-alpha01 版包含此連結所列的修訂項目。

API 變更

  • 新增用於與平台 SDK 保持一致的 Handler.hasCallbacks() 方法 (Idce1c、b/113855676)
  • 對 ShortcutInfoCompat.Builder 新增功能相關的 setter 方法 (I45af6)

Core Google Shortcuts 1.0 版

1.0.1 版

2022 年 5 月 18 日

發布 androidx.core:core-google-shortcuts:1.0.1。1.0.1 版包含以下修訂項目。

修正錯誤

  • 修正 Proguard 規則，以免方法遭到意外移除

1.0.0 版本

2021 年 6 月 30 日

發布 androidx.core:core-google-shortcuts:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

加入這個模組，讓使用 ShortcutManagerCompat 儲存的捷徑也會提供給 Google。如此一來，便能夠將具有這些捷徑的其他功能提供給使用者，例如，將其顯示為建議，或者讓 Google 助理可以透過語音查詢來執行。可以提供的捷徑數量沒有上限，而且透過這種方式提供的捷徑將儲存在裝置上。詳情請參閱將動態捷徑推送至 Google 助理的相關完整說明文件。

1.0.0-rc01 版

2021 年 6 月 16 日

發布 androidx.core:core-google-shortcuts:1.0.0-rc01。1.0.0-rc01 版包含以下修訂項目。

1.0.0-beta01 版

2021 年 5 月 18 日

發布 androidx.core:core-google-shortcuts:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。

新功能

  • 透過 core-google-shortcuts 程式庫新增的捷徑會儲存為 Firebase 應用程式索引中的 Shortcut 物件，而非一般的 schema.org/Thing 物件。

修正錯誤

  • 從程式庫中移除 minSdkVersion 要求。程式庫仍僅適用於 API 21 以上版本，但不再需要將應用程式的 minSdkVersion 設為 21。

1.0.0-alpha03 版

2021 年 5 月 5 日

發布 androidx.core:core-google-shortcuts:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。

修正錯誤

  • 新增 / 更新捷徑後，不再自動回報捷徑使用情況，而是將使用情況報告移至 ShortcutManagerCompat#pushDynamicShortcut。

1.0.0-alpha02 版

2021 年 4 月 15 日

發布 androidx.core:core-google-shortcuts:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 透過依附於選用元件 androidx.core:core-google-shortcuts 以及 androidx.core，您可以開始使用 ShortcutManagerCompat 提供捷徑給 Google 使用。
  • 新的 TrampolineActivity 將和相依於這個模組的應用程式合併。TrampolineActivity 將用於開啟這個模組提供的捷徑。

API 變更

  • 新增了 ShortcutInfoChangeListenerImpl，供 ShortcutManagerCompat 用於提供捷徑給 Firebase 應用程式索引功能。

Core 和 Core-ktx 1.5.0 版

1.5.0 版本

2021 年 5 月 18 日

發布 androidx.core:core:1.5.0 和 androidx.core:core-ktx:1.5.0。1.5.0 版包含以下修訂項目。

自 1.4.0 版以來的重要異動

  • 支援新的 Insets Animation API
  • 更新了 OnReceiveContentListener，可支援多媒體內容
  • 向後移植 WindowInsetsController 和 WindowInsetsCompat API 以便控制系統資訊列的外觀
  • 更新了 ActivityCompat.recreate()，以便在任何 API 級別從任何生命週期狀態安全地進行呼叫
  • 新增了 API，可透過 EditorInfoCompat 提供及擷取初始周圍文字，讓輸入法編輯器應用程式能避免額外的處理序間通訊 (IPC) 延遲問題。
  • 進行多項更新，以改善與平台 SDK API 的一致性

1.5.0-rc02 版

2021 年 5 月 5 日

發布 androidx.core:core:1.5.0-rc02 和 androidx.core:core-ktx:1.5.0-rc02。1.5.0-rc02 版包含以下修訂項目。

修正錯誤

  • 針對版本小於 30 的 SDK 開始支援 setSystemBarsBehavior。(I062c8、b/173203649)

1.5.0-rc01 版

2021 年 3 月 24 日

發布 androidx.core:core:1.5.0-rc01 和 androidx.core:core-ktx:1.5.0-rc01。1.5.0-rc01 版包含以下修訂項目。

摘要

  • 先前的 beta03 版沒有任何變更

1.5.0-beta03 版

2021 年 3 月 10 日

發布 androidx.core:core:1.5.0-beta03 和 androidx.core:core-ktx:1.5.0-beta03。1.5.0-beta03 版包含以下修訂項目。

API 變更

1.5.0-beta02 版

2021 年 2 月 24 日

發布 androidx.core:core:1.5.0-beta02 和 androidx.core:core-ktx:1.5.0-beta02。1.5.0-beta02 版包含以下修訂項目。

修正錯誤

  • 淘汰了 ModeCompat.isNative，改為使用 DisplayCompat.getMode。(Iefa71)
  • NotificationCompat.MessagingStyle.getText() 之前被誤標為 @NonNull；目前已更正為 @Nullable (I05cb7)

1.5.0-beta01 版

2021 年 1 月 13 日

發布 androidx.core:core:1.5.0-beta01 和 androidx.core:core-ktx:1.5.0-beta01。1.5.0-beta01 版本包含這些修訂版本。

API 變更

  • 遵循關於邊界相容性/平台互通性的 API 指南 (I7da35)
  • 將 AppCompatEditText 中的拖曳-放置 (放置事件) 和 OnReceiveContentListener 整合。(Ib26c9、b/175343405)
  • 連接新的 Insets Animation API 和 Platform 實作 (I078da)
  • 新增了 Insets Animation API (I8aebd)
  • 更新了 OnReceiveContentListener 和相關 API：
    • 更新了 OnReceiveContentListener，即可透過 ViewCompat 在任何類型的檢視區塊中設定這項方法。
    • 已從 OnReceiveContentListener 中移除 getSupportedMimeTypes()；現在，MIME 類型將在設定事件監聽器的 ViewCompat 方法上作為附加引數傳遞。
    • 對物件中的 OnReceiveContentListener.onReceiveContent() 提供包裝引數。
    • 新增了 linkUri 做為 onReceiveContent() 的參數，確保與鍵盤映像檔 API 的回溯相容性。
    • 在 onReceiveContent() 中新增 Bundle 參數，確保與鍵盤映像檔 API 的回溯相容性，以及方便日後配合 API 的演進。
    • 更新了 onReceiveContent() 以便傳回未被使用的內容，做為委派預設處理的方法。
    • 從公用 API 中移除 TextViewOnReceiveContentListener，因為現在只要從事件監聽器傳回任何未使用的內容，就能觸發預設行為。
    • (Ib4616、b/173814913)
  • 淘汰了 BuildCompat.isAtLeastR (Idb37e)
  • 將 widget.RichContentReceiverCompat 移至 view.OnReceiveContentListener。(Ifdab7、b/173814913)
  • 新增了 Preconditions.checkFlagsArgument。(I43952、b/174181100)
  • 淘汰對外共用的自訂選單。(I7cd92)
  • 通知現在可標記為未接來電。(I14d90)
  • 新增了 PackageInfoCompat#getSignatures，用於擷取套件的憑證陣列 (I8e9a3、b/159831205)

修正錯誤

  • 修正在較新的 OS 版本上設定 BigPictureStyle.bigLargeIcon 時會中斷通知的 BigPictureStyle 的錯誤。(Ic623d)

外部貢獻

  • ShareCompat 現在使用建構函式進行建構，而舊的工廠方法已遭淘汰。您現在可以透過 Context 同時建立建構工具和讀取工具，而且不再需要使用 Activity。(I315b6、b/173043501)
  • 在使用 ShareCompat 分享資料流時，設定短片資料並授予 URI 讀取權限 (I4aa31、b/173137936)

1.5.0-alpha05 版

2020 年 11 月 11 日

發布 androidx.core:core:1.5.0-alpha05 和 androidx.core:core-ktx:1.5.0-alpha05。1.5.0-alpha05 版包含此連結所列的修訂項目。

API 變更

  • 開始支援新的 GnssStatus API (Id8e22)
  • 新增了 FileProvider#getUriForFile 超載以支援自訂檔案名稱 (Ie870b)
  • 向後移植 WindowInsetsController API 以便控制系統資訊列的外觀。(Ieb4ee)
  • 將設為布林值的 getFont 重新命名為 getCachedFont (Iea520)
  • 向後移植 WindowsInsetsController API 的 #hide() 和 #show() 方法，並新增至 API 30 (I21573)
  • 新增了附加 cacheOnly 選項的新 API ResourcesCompat#getFont (Ic38cf)
  • 更新了 Android 11 的 AndroidX 通知泡泡 API (Ib9c70)

1.5.0-alpha04 版

2020 年 10 月 1 日

發布 androidx.core:core:1.5.0-alpha04 和 androidx.core:core-ktx:1.5.0-alpha04。1.5.0-alpha04 版包含以下修訂項目。

API 變更

  • 修正使用 NotificationCompat.Builder.<init>(Context,Notification) 時出現的 Style 復原不完整問題 (Ib297a)
  • 現在推出新的通知類別類型 (I9521a)

修正錯誤

  • 允許從任何 API 級別的任何生命週期狀態安全地呼叫 ActivityCompat.recreate()。(I62dde，b/160122826)

1.5.0-alpha03 版

2020 年 9 月 16 日

發布 androidx.core:core:1.5.0-alpha03 和 androidx.core:core-ktx:1.5.0-alpha03。1.5.0-alpha03 版包含此連結所列的修訂項目。

API 變更

  • ViewCompat 是公用程式類別，不應執行個體化。(If20fa)
  • 用於提供及擷取初始周圍文字的 API 已向後移植至 EditorInfoCompat。透過這些 API，輸入法編輯器應用程式可避免額外的處理序間通訊 (IPC) 延遲問題。(Ie3809)
  • 透過 compat 物件查詢通知管道和群組。(I11d18)

修正錯誤

  • 對於 P 之前的版本，請確保針對無障礙功能將窗格標記為重要，並支援 CONTENT_CHANGE_TYPE_PANE_DISAPPEARED 事件。(Iaeffc)

外部貢獻

  • 為 AndroidX 啟用 StaticFinalBuilder 的 API Lint 檢查功能 (I2b11b、b/138602561)

1.5.0-alpha02 版

2020 年 8 月 19 日

發布 androidx.core:core:1.5.0-alpha02 和 androidx.core:core-ktx:1.5.0-alpha02。1.5.0-alpha02 版包含以下修訂項目。

新功能

  • 將 WindowInsetsCompat API 更新為 Android 11 平台的版本。這包括新的 ime() 插邊類型，用於檢查螢幕小鍵盤的顯示設定和大小。

    • ime() 類型的注意事項：當 Activity 採用 adjustResize window soft input mode 時，這項類型可以在 API 23 以上版本中非常穩定可靠地執行。如果改用 adjustPan 模式，則應改回使用 API 14，才能穩定執行。

API 變更

  • 新增了 ObjectsCompat#toString(Object, String)。這提供 Objects#toString(Object, String) 的行為，但也可用於 API 19 之前的級別。(I26cdc)
  • 新增了 NotificationCompat.Builder.recoverBuilder(Notification) (I6f100)
  • 新增 NotificationCompat.Builder.createContentView() 和同類應用程式 (I6fe13)
  • 在 AccessibilityNodeInfoCompat 中新增額外資料相關的 API (I19567)
  • 新增 NotificationCompat.Builder.setSettingsText 和 NotificationCompat.MessagingStyle.addHistoricMessage (I62bb6)
  • 更新通知說明文件 (I1293f)
  • 修正 NotificationCompat.Builder 的可空值性 (I932e3)
  • 新增了 NotificationChannelCompat 和 NotificationChannelGroupCompat (Icc3b6)
  • 將 addExtraDataToAccessibilityNodeInfo 新增至 AccessibilityNodeProviderCompat (I26575)
  • 將 WindowInsetsCompat 更新為 Android 11 API (I3df9e)

外部貢獻

  • 針對 MailTo 方法新增 Uri 超載 (I6fa6b)
  • 新增了 MailTo API，可為所有 API 級別提供一致的行為和錯誤修正 (Ie9395、b/159827506)

1.5.0-alpha01 版本

2020 年 6 月 10 日

發布 androidx.core:core:1.5.0-alpha01 和 androidx.core:core-ktx:1.5.0-alpha01。

新功能

  • 提供與 Android R 平台 SDK API，的 ShortcutManager、ShortcutInfo、AccessibilityNodeInfo、DisplayCutout、GnssStatus 和 Notification 類別的一致性。

修正錯誤

  • 明確建議檢查 shouldShowPermissionRationale。
  • 變更 AtomicFile 以使用 rename-into-place。
  • 使用指定樣式調整 Typeface 顯示樣式。(b/156853883)
  • 修正通知建構工具測試失敗的問題
  • 修正註冊/取消註冊錯誤 LocationManagerCompat。

Core 和 Core-ktx 1.4.0 版

1.4.0-alpha01 版

2020 年 5 月 20 日

發布 androidx.core:core:1.4.0-alpha01 和 androidx.core:core-ktx:1.4.0-alpha01。1.4.0-alpha01 版本包含這些修訂版本。

API 變更

  • 新增用於插入多媒體內容 (例如貼上圖片) 的通用 API。新回呼提供單一 API，應用程式可透過實作這個 API 支援以各種方式插入多媒體內容。目前這個 API 僅新增至 AppCompatEditText，而且可在下列程式碼路徑中叫用：
    • 從剪貼簿貼上
    • 從輸入法編輯器插入內容 (InputConnection.commitContent) (I22bf7)
  • 向後移植 android.os.Process.isApplicationUid(int)，協助應用程式判斷程式碼是否在獨立程序中執行 (I4c83a、b/153014822)
  • 向後移植 LocusId，可讓應用程式連結不同子系統之間的狀態，例如內容擷取、捷徑和通知。(Ia3129)
  • 對 ViewGroup 新增了祖系序列 (I5f75c、b/117976097)

修正錯誤

  • 新增了 ActivityCompat.requestPermissions() 的權限驗證 (I372cc、b/122163323)
  • 擷取 28 以上版本的呼叫，成為一個獨立的靜態類別；這可修正在建構應用程式套件時，View#OnUnhandledKeyEventListener 發生的 NoClassDefFoundError 錯誤 (Id3419、b/153695093)
  • 修正 setChronometerCountDown 當機錯誤 (I47282、b/145770610)

Core 和 Core-ktx 1.3.2 版

1.3.2 版

2020 年 10 月 1 日

發布 androidx.core:core:1.3.2 和 androidx.core:core-ktx:1.3.2。1.3.2 版包含以下修訂項目。

修正錯誤

  • 允許從任何 API 級別的任何生命週期狀態安全地呼叫 ActivityCompat.recreate()。(I62dde，b/160122826)

Core 和 Core-ktx 1.3.1 版

1.3.1 版本

2020 年 7 月 22 日

發布 androidx.core:core:1.3.1 和 androidx.core:core-ktx:1.3.1。1.3.1 版包含此連結所列的修訂項目。

修正錯誤

  • 修正了 API 級別 29 中解析的字型資源 Typeface 粗細和樣式值錯誤 (b/156853883)

Core 和 Core-ktx 1.3.0 版

1.3.0 版本

2020 年 5 月 27 日

發布 androidx.core:core:1.3.0 和 androidx.core:core-ktx:1.3.0。1.3.0 版本包含以下修訂項目。

自 1.2.0 版以來的重大異動

  • 新增 NestedScrollView API，可在指定時間內執行順暢捲動
  • 新增 ViewCompat 的 API，可用於擷取分派給檢視區塊階層的原始視窗插邊

1.3.0-rc01 版本

2020 年 4 月 15 日

發布 androidx.core:core:1.3.0-rc01 和 androidx.core:core-ktx:1.3.0-rc01。1.3.0-rc01 版包含此連結所列的修訂項目。

修正錯誤

  • WindowInsetsCompat 現在可在所有支援的 API 級別正確實作 hashCode() 和 equals()。

1.3.0-beta01 版本

2020 年 4 月 1 日

發布 androidx.core:core:1.3.0-beta01 和 androidx.core:core-ktx:1.3.0-beta01。1.3.0-beta01 版本包含以下修訂項目。

1.3.0-alpha02 版本

2020 年 3 月 4 日

發布 androidx.core:core:1.3.0-alpha02 和 androidx.core:core-ktx:1.3.0-alpha02。1.3.0-alpha02 版包含以下修訂項目。

API 變更

  • 新增 NestedScrollView API，可在指定時間內執行順暢捲動
  • 新增 ViewCompat API，可用於擷取分派給檢視區塊階層的原始視窗插邊

1.3.0-alpha01 版本

2020 年 1 月 29 日

發布 androidx.core:core:1.3.0-alpha01 和 androidx.core:core-ktx:1.3.0-alpha01。1.3.0-alpha01 版包含以下修訂項目。

新功能

  • 新增了 ContentProviderCompat
  • 已新增「WindowInsetsCompat.Builder」

API 變更

  • 新增了 NotificationCompat API，可將通知執行個體設為靜音
  • 新增了 ResourcesCompat.NULL_ID
  • 淘汰了 NotificationCompat 中的 CarExtender.UnreadConversation
  • 新增了 DisplayCompat API，可用於取得裝置實際大小

修正錯誤

  • 改善了 NotificationCompat 中沒有圖示的處理操作
  • 修正了 API 級別 23 中 TextView 相對於複合可繪項目的可繪項目著色問題 (aosp/1172194)
  • 確保基礎結構定義一律為包裝函式
  • 修正了 RecyclerView 在預設情況下不應填入 Collection[Item]Info 的問題

1.2.0 版本

1.2.0 版本

2020 年 2 月 5 日

發布 androidx.core:core:1.2.0 和 androidx.core:core-ktx:1.2.0。1.2.0 版包含此連結所列的修訂項目。

自 1.1.0 版本以來的重大異動

  • 在 NotificationCompat 中新增了 API 並修正錯誤
  • 新增了 API，可透過回溯相容的方式與 AndroidQ 中引入的 BlendMode 搭配使用
  • 新增了新的 API 並修正無障礙功能相容性中的錯誤
  • 新增了可搭配 ShortcutInfo 使用的新 API
  • 新增了可搭配 WindowInsets 使用的新 API
  • 修正了 EditorInfoCompat、ShareCompat、WakefulBroadcastReceiver 和 InputConnectionCompat 中 28.0 (支援資料庫) 和 1.1 (AndroidX) 之間套件金鑰字串的回溯相容性問題

1.2.0-rc01 版本

2019 年 11 月 20 日

androidx.core:core:1.2.0-rc01 和 androidx.core:core-ktx:1.2.0-rc01 發布，且自 1.2.0-beta02 版以來皆無異動。1.2.0-rc01 版包含以下修訂項目。

1.2.0-beta02 版

2019 年 11 月 7 日

發布了 androidx.core:core:1.2.0-beta02 和 androidx.core:core:1.2.0-beta02。1.2.0-beta02 版包含以下修訂項目。

修正錯誤

  • 更新了 en-rCA 和 en-rXC 語言代碼的翻譯。

1.2.0-beta01 版本

2019 年 10 月 9 日

發布了 androidx.core:core:1.2.0-beta01 和 androidx.core:core-ktx:1.2.0-beta01。1.2.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • 開始支援使用 IconCompat 建立 NotificationCompat Action，並淘汰使用資源 ID 代表 Action 圖示的公開欄位 (及其 getter)。(aosp/1119192)
  • 為 longs 新增 MathUtils.clamp (aosp/1117300)
  • 將 setChronometerCountDown 新增至 NotificationCompat (b/138601213)

修正錯誤

  • 修正地址偵測中的萬國碼 (Unicode) 數字處理問題。(aosp/1129852)

外部貢獻

  • 感謝 Sergey Zakharov 在 AndroidX 中，針對 MissingBuild 和 ListenerLast 啟用 API Lint 檢查所做的貢獻！(aosp/1119191、aosp/1126768)

1.2.0-alpha04 版本

2019 年 9 月 5 日

發布 androidx.core:core:1.2.0-alpha04 和 androidx.core:core-ktx:1.2.0-alpha04。您可以前往這裡查看這個版本包含的修訂項目。

API 變更

  • 配合 Android 架構中 ShortcutInfo.Builder 的類似 API，淘汰了 ShortcutInfoCompat.Builder#setLongLived() 並以名稱相同的新 API (可接受布林值參數) 取代。
  • 配合 Android 架構中的 ShortcutInfo，新增了 ShortcutInfoCompat.Builder#setRank() 和 ShortcutInfoCompat#getRank()。

修正錯誤

1.2.0-alpha03 版本

2019 年 8 月 7 日

發布 androidx.core:core:1.2.0-alpha03 和 androidx.core:core-ktx:1.2.0-alpha03。您可以前往這裡查看這個版本包含的修訂項目。

新功能

  • 新增了 UriCompat.toSafeString(Uri)，以便提供可單獨從平台更新的 URI 逸出。(b/130878326)
  • 新增了 Predicate<T> 介面，可提供 Java 8 樣式述詞，而且無需使用 Java 8 語言功能。

API 變更

  • 將 removeDynamicShortuct() 變為靜態 (b/134993204)
  • 為 BlendMode 色彩濾鏡建立工廠方法 (b/135943149)
  • 將 async、counter 和 isEnabled 新增至 TraceCompat (aosp/987332)
  • 取消隱藏 WindowInsetsCompat 和 ViewDragHelper 中的 API (aosp/979408)

修正錯誤

  • 修正回應無障礙功能捲動呼叫的 NestedScrollView 捲動錯誤。(aosp/971000)
  • 在 ViewCompat 實作中改為使用 SimpleArrayMap (aosp/1012534)
  • 修正在 API 級別 23 中，FingerprintManager 未正確檢查 PackageManager 的錯誤 (b/124066957)

1.2.0-alpha02 版本

2019 年 6 月 13 日

發布 androidx.core:core:1.2.0-alpha02 和 androidx.core:core-ktx:1.2.0-alpha02。您可以前往這裡查看這個版本包含的修訂項目。

API 變更

  • 新增了 WindowInsetsCompat.wrap() 和 unwrap()，以便能夠包裝以及解除包裝 WindowInsets 執行個體

1.2.0-alpha01 版

2019 年 5 月 7 日發布了 androidx.core:core:1.2.0-alpha01 和 androidx.core:core-ktx:1.2.0-alpha01。

新功能

  • 新增 ACTION_PAGE_UP/DOWN/NEXT/PREVIOUS 無障礙功能操作
  • 將 CATEGORY_NOTIFICATION 新增至 NotificationCompat
  • 開始支援結構定義通知操作
  • 開始在 NotificationCompat 支援對話框
  • 新增了 BlendModeCompat API，可在 Android 10 中運用 BlendMode API，並盡可能改回使用 PorterDuff.Mode 的對等項目
  • 為 WindowInsetsCompat 和 ViewCompat 新增新的 getter
  • 新增支援通知中的輕觸編輯功能
  • DrawerLayout 系統手勢排除矩形
  • 新增 NotificationCompat API，可用於決定是否允許使用系統產生的關聯動作
  • 處理 NavUtils 中已停用的 <activity-alias> 元件
  • 新增 AccessibilityNodeInfoCompat.setEntryKey

修正錯誤

  • 修正在 TypefaceCompat 中載入字型時發生的例外狀況
  • 修正多個 DayNight 問題
  • 修正 EditorInfoCompat、ShareCompat、WakefulBroadcastReceiver 和 InputConnectionCompat 中 28.0 (支援資料庫) 和 1.1 (AndroidX) 之間的套件金鑰字串的回溯相容性問題

1.1.0 版本

1.1.0 版本

2019 年 9 月 5 日

發布 androidx.core:core:1.1.0 和 androidx.core:core-ktx:1.1.0。您可以前往這裡查看這個版本包含的修訂項目。

自 1.0.0 版以來的重要異動

  • 更新了無障礙功能 API，以配合 Android 10 平台無障礙功能 API，
  • 改善巢狀捲動功能；請參閱 NestedScrollingChild3 和 NestedScrollingParent3。
  • 這個程式庫不再於其 API 中公開 androidx.collection 依附元件。如果您是透過 Core 的依附元件以隱含方式依賴 androidx.collection 類型，就必須對程式庫或應用程式明確新增 androidx.collection 依附元件。這項變更在原始碼上不相容，但仍保有二進位檔的相容性。Collection 依附元件仍屬於 Core 的過渡性依附元件，但被視為實作的詳細內容，而非其 API 的一部分。
  • 解決由 AndroidX 重構引起的處理序間通訊 (IPC) 相容性問題 (aosp/948725、aosp/938269)
  • 新增了 AppCompat DayNight 多項修正 (aosp/942956)

1.1.0-rc03 版

2019 年 8 月 7 日

發布 androidx.core:core:1.1.0-rc03 和 androidx.core:core-ktx:1.1.0-rc03。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 讓隱藏的 androidx.core.app.ComponentActivity 實作 LifecycleOwner，維持與 androidx.fragment:fragment:1.0.0 的二進位檔相容性 (aosp/1094409)

1.1.0-rc02 版本

2019 年 7 月 2 日

發布 androidx.core:core:1.1.0-rc02 和 androidx.core:core-ktx:1.1.0-rc02。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • API 級別 23 中的 FingerprintManagerCompat#getFingerprintManagerOrNull 不應檢查 PackageManager (b/124066957) (aosp/987433)
  • 修正 AccessibilityNodeInfoCompat 的相等性比較問題 (aosp/985736)

1.1.0-rc01 版本

2019 年 6 月 5 日

發布 androidx.core:core:1.1.0-rc01 和 androidx.core:core-ktx:1.1.0-rc01。您可以前往這裡查看這個版本包含的修訂項目。

修正錯誤

  • 讓圖片鍵盤 API 向後移植內容與先前所有實作相容 (aosp/968220)
  • 從 androidx.core:core 程式庫依附元件移除 Guava ListenableFuture (b/133171974、aosp/965393)
  • 修正透過巢狀捲動功能快速滑過內容時速度不正確的問題。(aosp/961642)
  • 新增 TransitionDrawable 的變異測試 (b/37033322)

1.1.0-beta01 版本

2019 年 5 月 7 日

發布 androidx.core:core:1.1.0-beta01 和 androidx.core:core-ktx:1.1.0-beta01。您可以前往這裡查看這個版本包含的修訂項目。

初始版的 AndroidX 破壞了支援資料庫 compat API 的回溯相容性，這些 API 用於處理序間通訊，並以套件形式傳送鍵控資料。這個版本修正了這項相容性問題，並且恢復使用支援資料庫 28.0 (或更早版) 與 AndroidX 1.1 (或之後版) 建構的程式碼之間的通訊。

API 變更

修正錯誤

  • Core 測試中的 AppCompatTextView 時應使用 Appcompat 主題建立 (aosp/951636)
  • 在 InputConnectionCompat 中使用 1.0 之前版本的字串值 (aosp/948725)
  • 使用 AndroidX 之前版本的字串，做為套件金鑰的後援互通性選項 (aosp/938269)
  • 修正在背景中執行 DayNight 更新的相關錯誤 (aosp/942956)
  • 實作用於 Android 開放原始碼計畫鍵盤無障礙服務的文字輸入鍵 API (aosp/943897)
  • 針對執行 API 級別 20 和以下級別的裝置，修正載入字型時發生的例外狀況
  • 處理 NavUtils 中已停用的 <activity-alias> 元件 (aosp/940788)

1.1.0-alpha05 版本

2019 年 3 月 13 日

發布了 androidx.core:core:1.1.0-alpha05 和 androidx.core:core-ktx:1.1.0-alpha05。如要查看這個版本包含的完整修訂項目清單，請按這裡。

新功能

  • 新增 ActivityCompat.recreate() API，可解決在 28 以下級別平台出現的錯誤 (aosp/898940)
  • 新增 LocationManagerCompat 類別 (aosp/894736)

API 變更

  • 這個程式庫不再需要在其 API 中公開「collection」依附元件。如果您是透過「core」的依附元件以隱含方式依賴「collection」類型，就必須將明確的「collection」依附元件新增至程式庫或應用程式中。這項變更在原始碼上不相容，但可保留二進位檔的相容性。「collection」依附元件仍屬於「core」的過渡性依附元件，但被視為實作的詳細內容，而非其 API 的一部分。

修正錯誤

  • 修正在搭載 API 級別 21 的裝置上發生的 ImageView 預設著色模式錯誤

1.1.0-alpha04 版本

2019 年 1 月 30 日

發布 androidx.core:core 1.1.0-alpha04 和 androidx.core:core-ktx 1.1.0-alpha04。

API 變更

  • 變更 EXTRA_SHORTCUT_ID 的值，以便與平台一致 (aosp/877712)
  • 將 CATEGORY_NOTIFICATION 新增至 NotificationCompat (aosp/861067)

修正錯誤

  • 修正 fontFamily 無法在執行 API 級別 24 及以下級別的裝置上正常運作的問題 (aosp/807054)
  • 修正在更換及新增無障礙操作時，系統不會移除舊無障礙操作的錯誤 (aosp/848314)

1.1.0-alpha03 版本

2018 年 12 月 17 日

發布了 androidx.core 1.1.0-alpha03 和 androidx.core-ktx 1.1.0-alpha03，且包含以下變更。為配合 ktx 的 androidx.core 1.1.0-alpha02 版本發布了 androidx.core-ktx 1.1.0-alpha02。

新功能

  • 對 NotificationManagerCompat 新增了通知管道方法，讓開發人員可在處理通知時僅使用 NotificationManagerCompat。特別感謝 Zdeněk Kořán 為這項新功能所做的貢獻！

API 變更

  • 對 ShortcutManagerCompat 新增了新的 API，以便發布和更新動態捷徑。

1.1.0-alpha01 版本

2018 年 11 月 5 日

發布了 androidx.core 1.1.0-alpha01，同時提供下列 API 變更和錯誤修正。

新功能和 API 變更

  • NestedScrollingChild3 和 NestedScrollingParent3 新增「消耗的」參數到超載的 dispatchNestedScroll 和 *onNestedScroll 方法，讓驅動巢狀捲動的檢視區塊可以更好地瞭解父項在每次捲動時所消耗*的捲動距離。
  • NestedScrollView 現在會實作 NestedScrollingChild3 和 NestedScrollingParent3，因此無法保證 dispatchNestedScroll 和 onNestedScroll 的 NestedScrollingChild2 和 *NestedScrollingParent2 實作會被呼叫。期望上述其中一項會被呼叫的開發人員 * 還應該覆寫新的巢狀捲動 3 版本的 dispatchNestedScroll 和 onNestedScroll。
  • ShortcutInfoCompat 具有 Persons、categories 和 isLongLived 等新欄位。之所以新增這些欄位，目的是讓大家知道 ShortcutInfoCompat 可以接受多種類型*的內容。
  • 將 SupportActivity 重新命名為 ComponentActivity。詳情請參閱 androidx.activity。
  • 新增了 getMainExecutor() 方法，其傳回的 Executor 連結會在與該 * 內容相關的主執行緒上執行已加入佇列的工作。
  • 新增了 Resources.getFloat 的相容性實作。
  • 為 compat RemoteInput 新增結果來源。這樣做可讓應用程式區分直接和智慧回覆，以便進行記錄。
  • 為 TextView TextWatcher 操作新增 Kotlin 擴充功能函式。
  • 淘汰了 AccessibilityNodeInfo 功能與 setter 標記；改為使用操作。
  • 對 ViewCompat 新增 AccessibilityPane。
  • 透過新增 AccessibilityClickableSpanCompat，在使用 O 之前版本的裝置公開 ClickableSpan。
  • 淘汰了 AccessibilityNodeInfoCompat.setFocusable()、setClickable()、setLongClickable()、setScrollable() 和 setContextClickable()。新增了 AccessibilityAction 做為替代。
  • 新增了 ViewCompat.setAccessibilityPaneTitle()、getAccessibilityPaneTitle()、setScreenReaderFocusable()、isScreenReaderFocusable()、setAccessibilityHeading() 和 isAccessibilityHeading()，將此 View 無障礙功能向後移植至 API 19。
  • 新增了 ViewCompat.enableAccessibleClickableSpanSupport()，讓開發人員能夠再次透過 API 19 存取非網址 ClickableSpan。

修正錯誤

  • 修正在使用可下載字型時，網路出現問題會導致 ResourcesCompat.getFont() 異常終止的錯誤。
  • 修正在 ContentResolver 傳回空值時，TypefaceCompatApi21 會出現空值指標例外狀況的問題。
  • 修正 Array Utils 中的類型錯誤，預期為 ColorStateList，但取得原始顏色。

Core-Animation 和 Core-Animation-Testing 1.0.0

1.0.0 版本

2024 年 5 月 1 日

發布 androidx.core:core-animation:1.0.0 和 androidx.core:core-animation-testing:1.0.0。1.0.0 版包含這些修訂項目。

1.0.0 的主要功能

androidx.core:core-animation 是向後移植的 Animator API，包含自 API 級別 14 以來新增至平台的所有功能。其中值得注意的功能包括：

  • ValueAnimator#pause、ValueAnimator#resume (API 級別 19)
  • ObjectAnimator.ofMultiInt、ObjectAnimator.ofMultiFloat (API 級別 21)
  • ValueAnimator#setCurrentFraction (API 級別 22)
  • AnimatorSet#setCurrentPlayTime (API 級別 26)
  • androidx.core:core-animation-testing 可讓開發人員以決定性方式測試 Animator。詳情請參閱 AnimatorTestRule。

1.0.0-rc01 版

2023 年 7 月 26 日

發布 androidx.core:core-animation:1.0.0-rc01、androidx.core:core-animation-testing:1.0.0-rc01 和 androidx.core:core-remoteviews:1.0.0-rc01。1.0.0-rc01 版本包含以下修訂項目。

新功能

  • RemoteViews 在 Beta 版中穩定後，已移至 rc01。

1.0.0-beta01 版

2022 年 4 月 20 日

發布了 androidx.core:core-animation:1.0.0-beta01，且自 1.0.0-alpha02 版本以來皆無變更。1.0.0-beta01 版包含此連結所列的修訂項目。

Core-Animation Core-Animation-Testing 1.0.0-alpha02 版

2020 年 8 月 19 日

發布 androidx.core:core-animation:1.0.0-alpha02 和 androidx.core:core-animation-testing:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

修正錯誤

  • 修正單一屬性具有多個 Animator 的 AnimatorSet。(aosp/1351310)

Core-Animation 1.0.0-alpha01 版

2020 年 4 月 15 日

發布 androidx.core:core-animation:1.0.0-alpha01 和 androidx.core:core-animation-testing:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

androidx.core:core-animation 是向後移植的 Animator API，包含自 API 級別 14 以來新增至平台的所有功能。其中值得注意的功能包括：

  • ValueAnimator#pause、ValueAnimator#resume (API 級別 19)
  • ObjectAnimator.ofMultiInt、ObjectAnimator.ofMultiFloat (API 級別 21)
  • ValueAnimator#setCurrentFraction (API 級別 22)
  • AnimatorSet#setCurrentPlayTime (API 級別 26)
  • androidx.core:core-animation-testing 可讓開發人員以決定性方式測試 Animator。詳情請參閱 AnimatorTestRule。

Core-Role 1.1.0 版

1.1.0 版本

2025 年 3 月 12 日

發布 androidx.core:core-role:1.1.0。1.1.0 版包含這些修訂項目。

1.1.0-rc01 版本

2021 年 12 月 15 日

androidx.core:core-role:1.1.0-rc01 自 1.1.0-alpha01起沒有變更。1.1.0-rc01 版包含此連結所列的修訂項目。

Core-Role 1.1.0-alpha01 版

2020 年 4 月 15 日

發布了 androidx.core:core-role:1.1.0-alpha01。查看 1.1.0-alpha01 版的修訂項。

API 變更

  • 新增了系統圖片庫的角色名稱。

Core-Role 1.0.0 版

1.0.0 版本

2021 年 2 月 10 日

發布 androidx.core:core-role:1.0.0。1.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

  • 新增了 RoleManagerCompat，其中包含系統中可能提供的角色名稱和說明文件。

Core-Role 1.0.0-rc01 版

2020 年 4 月 15 日

androidx.core:core-role:1.0.0-rc01 自 1.0.0-beta01起沒有變更。查看 1.0.0-rc01 版的修訂項。

Core-Role 1.0.0-beta01 版

2019 年 11 月 20 日

androidx.core:core:1.0.0-beta01 發布，且自 1.0.0-alpha01 版以來皆無異動。1.0.0-beta01 版包含以下修訂項目。

Core-Role 1.0.0-alpha01 版

2019 年 7 月 2 日

發布了 androidx.core:core-role:1.0.0-alpha01。這是 androidx.core:core-role 的第一個版本。您可以前往這裡查看這個初始版包含的修訂項目。

新功能

  • 新增了 RoleManagerCompat，其中包含系統中可能提供的角色名稱和說明文件。

1.0.2 版

1.0.2 版

2019 年 5 月 7 日

發布了 androidx.core:core:1.0.2 和 androidx.core:core-ktx:1.0.2。這個版本包含 2 個修訂版。

初始版的 AndroidX 破壞了支援資料庫 compat API 的回溯相容性，這些 API 用於處理序間通訊，並以套件形式傳送鍵控資料。這個版本修正了這項相容性問題，並且恢復使用支援資料庫 28.0 (或更早版) 與 AndroidX 1.1 (或之後版) 建構的程式碼之間的通訊。

修正錯誤

  • 在 InputConnectionCompat 中使用 1.0 之前版本的字串值 (aosp/948725)
  • 使用 AndroidX 之前版本的字串，做為套件金鑰的後援互通性選項 (aosp/938269)

1.0.1 版

1.0.1 版

2018 年 11 月 7 日

修正 core-1.0.1 和 appcompat-1.0.2 的版本錯誤。

修正錯誤

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

Core-Ktx 1.0.1 版

2018 年 11 月 5 日

發布了 androidx.core-ktx 1.0.1 並修正以下錯誤：

  • 修正聯集和交集實作發生交換的錯誤。