Core

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

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

構件 穩定版 候選版 Beta 版 Alpha 版
Core 1.15.0 - - 1.16.0-alpha01
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.0.0 1.1.0-rc01 - -
core-splashscreen 1.0.1 1.1.0-rc01 - 1.2.0-alpha02
本程式庫上次更新日期：2024 年 12 月 11 日

宣告依附元件

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

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

Groovy

dependencies {
    def core_version = "1.15.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.0.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-alpha02"
}

Kotlin

dependencies {
    val core_version = "1.15.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.0.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-alpha02")
}

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

意見回饋

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

建立新問題

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

Core-Viewtree 1.0 版

1.0.0-alpha01 版

2024 年 12 月 11 日

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

新功能

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

  • 這個初始版本引入了 View 可擁有不相交父項的概念。檢視畫面的不相交父項是做為檢視畫面父項的個別 View 物件，但並未透過 View.parent 屬性設定。ViewOverlays、彈出式視窗和對話方塊都是具有不連續父項的 View，這些元素都會顯示在主要 View 階層之外。只有在 View 未透過平台的 View.parent 屬性擁有直接父項時，才能有不相干的父項。目前，androidx 只會為轉場建立的 ViewOverlays 設定不相交的父項。您也可以為檢視畫面指定不相交的父項。詳情請參閱說明文件。

API 變更

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

Core-i18n 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 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，這項操作會透過 API 模擬功能自動執行。建議未使用 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 版包含這些修訂項目。

修正錯誤

  • 修正因重新封裝 Protobuf 程式庫而導致的 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.0 版。

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 Extensions API。(I1274c)
  • 在 API 級別 34 之前拒絕通話，現在會在 Telecom 中正確刪除通話。(I635b7)。
  • addCall 現在會透過 API 而非父項協同程式，正確擲回例外狀況 (I83334)
  • 在額外資料組合中新增預留位置值 (Iebf7f)
  • 移除新平台 API 存取權的手動設定，因為在使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，這項操作會透過 API 模擬功能自動執行。建議未使用 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 也能應付電信平台 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 方法移至 addCall 做為 lambda 引數，以免在呼叫範圍中明確提供回呼。

修正錯誤

  • 修正 ConnectionService 相容性層中的錯誤，該錯誤會導致在針對 U 前 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.16 版

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 的 Compat 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)。
  • 新增 API ViewGroupCompat#installCompatInsetsDispatch，方便開發人員修正 API 30 之前的內嵌項目調度問題。(I11159)
  • 新增 FontsContractCompat.TypefaceStyle IntDef，用於在 FontsContractCompat 中註解 Typeface 樣式。(Ib3e5b)。

外部貢獻

  • 淘汰了 BuildCompat.isAtLeastV。呼叫端應直接檢查 SDK_INT 是否為 35。感謝 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 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，這項操作會透過 API 模擬功能自動執行。建議未使用 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 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，這項操作會透過 API 模擬功能自動執行。建議未使用 AGP 的用戶端更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)。

API 變更

  • 將 fallbackQuery XML 屬性新增至可下載字型定義，讓可下載字型支援字元層級的備用字型。(Idd544)。
  • 新增輔助 API，以便使用 ProfilingManager (If2292)
  • 為 ActivityOptions.setPendingIntentBackgroundActivityStartMode 新增相容方法 (I3ba1f、b/349617674)
  • 新增 DisplayCutoutCompat.getCutoutPath (I58778、b/279635904)
  • 在 API 級別 29 以上版本中，將 ParcelCompat.writeBoolean 淘汰並委派至平台 API。(I9d243、b/313834577)。
  • 建立可接收執行者的 FontsContractCompat.requestFonts (I03016、b/302377512)
  • 在 API 級別 31 以上版本中，將 LocationCompat.isMock 的淘汰作業復原，並委派至平台 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 版包含這些修訂版本。

新功能

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

API 變更

  • 淘汰其他過時的相容性方法。(Ie4470、b/313834577)。
  • 淘汰過時的相容性方法。(I01d90、b/313834577)。
  • 更新 isAtLeastV()，以便為已完成的 V SDK 傳回 true。(I6339a)。

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 改寫了幾個類別，以便在維持 Java 相容性的同時，提供更佳的 Kotlin 使用者互通性。
  • 已移除 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 現已淘汰，因為 GestureDetector 保證可在平台上以程式庫的最低 SDK 版本提供。感謝 Jake Wharton 提供內容。(Icc4cd)。
  • MarginLayoutParamsCompat 已淘汰，因為 MarginLayoutParams 保證可在平台上以程式庫的最低 SDK 版本提供。感謝 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)
  • MultiWindowModeChangedInfo 和 PictureInPictureModeChangedInfo 類別現在以 Kotlin 編寫，並傳送至 Consumer，該類別已新增至各自的 Provider 介面。(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 變更

  • 將 setLineHeight(unit, lineHeight) 新增至 TextView 相容性類別 (Ia9fa9)
  • 從 Android 14 新增 TypedValueCompat.getUnitFromComplexDimension() (I958e8)
  • 將 setLineHeight(unit, lineHeight) 新增至 TextView 相容性類別 (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)
  • 已將 setLineHeight(unit, lineHeight) 新增至 TextView 相容性類別 (I15716)
  • 新的 accessibilityDataSensitive 相容性屬性。(I0c6e0)
  • 指定 FLAG_NO_CREATE 時，PendingIntentCompat.getActivity 和 getService 可能會傳回空值。(Iffdf0、b/289696515)。
  • 更新 API 檔案，以標註相容性抑制 (I8e87a、b/287516207)
  • 新增 PendingIntentCompat.send() (Iaf707)
  • 新增 Location.removeVerticalAccuracy()、Location.removeSpeedAccuracy() 和 Location.removeBearingAccuracy() 的 Compat 版本。(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)

修正錯誤

  • 修正 unregisterGnssMeasurementsCallback() 在 Android R 以下版本無法正常運作的問題。(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 變更

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

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 中的內容外洩問題 (I3409b、b/279625765)
  • 新增 SoftwareKeyboardControllerCompat，提供直接方法，可在 View 中顯示及隱藏軟體鍵盤。在某些 API 級別使用 WindowInsetsController API 時，此版本會回溯解決已知問題的解決方法，並擷取 WindowInsetsControllerCompat.show 的基礎實作內容，以及隱藏 IME 內嵌類型。(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)。

修正錯誤

  • 修正 unregisterGnssMeasurementsCallback() 在 Android R 以下版本無法正常運作的錯誤。(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)
  • 將批次通知 API 新增至 NotificationManagerCompat。建議使用者在發布多則通知時使用這個 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，由 Mygod Studio 提供的 b/278118318

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 版以來的重要變更

  • 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援版本，這項變更的成效差異都是微不足道。(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 版以來的重要變更

  • Core 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 移至候選版。

修正錯誤

  • 將 21 設為 androidx 程式庫的預設 minSdkVersion。(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 專屬實作項目，可為測試裝置和作業系統版本提供最新的媒體效能類別資訊。
  • 核心效能測試：測試核心效能的替身。

修正錯誤

  • 修正在 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 泛型實作)。
  • Core Performance Play Services - Initial library implementation. (Google 專屬的 DevicePerformance 實作)。
  • 核心效能測試 - 初始程式庫實作。(包含核心效能測試雙重)。

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 泛型實作)。
  • Core Performance Play Services - Initial library implementation. (Google 專屬的 DevicePerformance 實作)。
  • 核心效能測試 - 初始程式庫實作。(包含核心效能測試雙重)。

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-alpha02 版本

2024 年 9 月 4 日

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

修正錯誤

  • 將 isLightTheme 屬性新增至 SplashScreen 的佈景主題 (I01000、b/238522114)
  • 透過 AppCompatResources 取得螢幕保護程式圖示 (Ib05e、b/289242141、b/263972037)
  • 移除新平台 API 存取權的手動設定，因為在使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時，以及在使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 的所有版本時，這項操作會透過 API 模擬功能自動執行。建議未使用 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 版包含這些修訂版本。

修正錯誤

  • 自第 30 版起，將 Base.Theme.SplashScreen 的裁切模式變更為一律開啟 (Idfc3f)。
  • 將 enforceNavigationBarContrast 重設為 API 31 的系統預設值，這樣啟動畫面主題就不會破壞活動的主題。自 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 版包含這些修訂版本。

修正錯誤

  • 為 Wear 裝置提供預設尺寸，並使用 48 x 48dp 圖示 (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 版本包含以下修訂項目。

修正錯誤

  • 為 Wear 裝置提供預設尺寸，並使用 48 x 48dp 圖示 (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 版包含以下修訂項目。

修正錯誤

  • 為 Wear 裝置提供預設尺寸，並使用 48 x 48dp 圖示 (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 變更

  • 針對 a、b、c 路徑合併公開和實驗性 API 檔案 (I8cfee、b/278769092)
  • 已遷移 androidx.core 群組，以便使用已合併的公開 API 檔案 (Ifdef4、b/278769092)

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 變更

  • 新增了 ExecutorCompat，可從 Handler 建立 Executor。(Ib4ca3、b/181237835)。

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 變更

  • 淘汰 ShortcutInfoCompat.Builder#setLongLived()，並以名稱相同的新 API (可接受布林值參數) 取代，以便與 Android 架構中 ShortcutInfo.Builder 的類似 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-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，並修正以下錯誤：

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