Core

以最新的平台功能和 API 為目標,同時支援舊裝置。

這個表格列出 androidx.core 群組中的所有構件。

構件 穩定版 候選版 Beta 版 Alpha 版
Core 1.8.0 - - 1.9.0-alpha05
core-animation - - 1.0.0-beta01 -
core-google-shortcuts 1.0.1 - - 1.1.0-alpha01
core-performance - - - 1.0.0-alpha02
core-remoteviews - - 1.0.0-beta01 -
core-role 1.0.0 1.1.0-rc01 - -
core-splashscreen 1.0.0 - - -
本程式庫上次更新日期:2022 年 7 月 27 日

宣告依附元件

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

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

Groovy

dependencies {
    def core_version = "1.8.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-beta01"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0-beta01"

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

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

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

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

Kotlin

dependencies {
    val core_version = "1.8.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-beta01")
    // To test the Animator APIs
    androidTestImplementation("androidx.core:core-animation-testing:1.0.0-beta01")

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

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

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

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

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

意見回饋

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

建立新問題

詳情請參閱 Issue Tracker 文件

Core 和 Core-ktx 1.9.0 版本

1.9.0-alpha05 版本

2022 年 6 月 15 日

androidx.core:core:1.9.0-alpha05androidx.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-alpha04androidx.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-alpha03androidx.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-alpha02androidx.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-alpha01androidx.core:core-ktx:1.9.0-alpha01。1.9.0-alpha01 版本是以內部分支版本為基礎,沒有可以開放給所有人查看的修訂版本。

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

新功能

  • 與 Android Tiramisu DP1 相容。

Core 和 Core-ktx 1.8.0 版本

1.8.0 版本

2022 年 6 月 1 日

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

1.7.0 版之後的重要異動

  • 明確清除可空值註解,改善 Kotlin 可用性
  • 改善 ShortcutInfoCompatNotificationCompat 等的平台的一致性
  • 提供新介面,可讓元件接收子母畫面和多視窗模式變更事件,並由 Activity 程式庫中的 ComponentActivity 實作
  • 改善 MenuProvider 回呼方法,包括 onPrepareMenuonMenuClosed
  • 修正問題:在部分裝置上,FileProvider會失敗並附有 IllegalArgumentException
  • 修正問題:TypefaceCompat 在 API 29+ 套用不正確的字體權重 (b/194553426) 感謝 RikkaW 提出的錯誤

1.8.0-rc02 版本

2022 年 5 月 18 日

androidx.core:core:1.8.0-rc02androidx.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-rc01androidx.core:core-ktx:1.8.0-rc011.8.0-rc01 版本包含以下修訂項目。

API 變更

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

1.8.0-beta01 版本

2022 年 4 月 20 日

發布 androidx.core:core:1.8.0-beta01androidx.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-alpha07androidx.core:core-ktx:1.8.0-alpha071.8.0-alpha07 版本包含以下修訂項目。

修正錯誤

  • TypefaceCompat 現在將遵循 API 29+ 的要求的和載入的樣式資訊。這是當載入的字型不是 FontWeight.NormalFontWeight.Bold 時的行為變更,因為將會使用實際載入的字體粗細和樣式。(#212b/194553426)

外部貢獻

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

1.8.0-alpha06 版

2022 年 3 月 23 日

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

API 變更

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

修正錯誤

  • 在 a11y 窗格瀏覽權限狀態為 <P 的情況下,將父項的瀏覽權限異動納入考量 (I8e04f)

1.8.0-alpha05 版

2022 年 2 月 23 日

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

API 變更

  • 更新 androidx.core.os 類別的可空值性 (If18cdb/206113622)
  • 更新 androidx.core.app 類別的可空值性 (I657ebb/206113302)
  • 更新 androidx.core.text 類別的可空值性 (I08329b/206113384)
  • ExtraData 函式新增至 AccessibilityNodeInfoCompat (If2fc7b/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-alpha04androidx.core:core-ktx:1.8.0-alpha041.8.0-alpha04 版本包含以下修訂項目。

API 變更

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

1.8.0-alpha03 版本

2022 年 1 月 26 日

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

API 變更

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

1.8.0-alpha02 版本

2021 年 12 月 15 日

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

API 變更

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

1.8.0-alpha01 版本

2021 年 12 月 1 日

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

API 變更

  • 大量清除可空值性的註解
  • 新增新的 API ShortcutInfoCompat.Builder#setHiddenFromLauncher,以指定是否要從啟動器隱藏捷徑。(Ia2a71)
  • 新增 NotificationCompat.Action#setAuthenticationRequired (Ieeafab/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.0androidx.core:core-ktx:1.7.01.7.0 版本包含以下修訂項目。

自 1.6.0 版之後的重要異動

1.7.0-rc01 版本

2021 年 10 月 13 日

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

1.7.0-beta02 版本

2021 年 9 月 29 日

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

修正錯誤

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

1.7.0-beta01 版本

2021 年 9 月 15 日

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

API 變更

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

1.7.0-alpha02 版本

2021 年 9 月 1 日

發布 androidx.core:core:1.7.0-alpha02androidx.core:core-ktx:1.7.0-alpha021.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)
  • 修正 PermissionCheckercheckSelfPermission 會顯示麥克風/攝影機指標的問題。(I572a9)
  • setImportantForAccessibility 新增明確執行緒註解。(I990fa)
  • 更新 getUnusedAppRestrictionsStatus,以符合 API 指南規定。(I28a18)
  • 修正 getUnusedAppRestrictionsStatus 的功能,讓其更加完善。(I7c2d6)
  • 開始支援 LocationCompat 的垂直準確率、速度準確率和方位準確率。(I1d3e9)
  • 將數學相容性函式新增至 MathUtils。(Idb590)
  • OnReceiveContentListener 整合至相容性 API。(Ic6914b/173814913)。
  • 為了與平台一致,新增 ActivityCompat#isLaunchedFromBubble。(I6961a)
  • 為了與平台一致,新增 LocationRequestLocationManager.hasProvider()。(I4f3e4)

修正錯誤

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

1.7.0-alpha01 版本

2021 年 6 月 30 日

發布 androidx.core:core:1.7.0-alpha01androidx.core:core-ktx:1.7.0-alpha011.7.0-alpha01 版本包含以下修訂項目。

API 變更

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

Core Remote Views 1.0 版本

1.0.0-beta01 版

2019 年 6 月 29 日

發布 androidx.core:core-remoteviews:1.0.0-beta011.0.0-beta01 版本包含以下修訂項目。

新功能

  • Core-RemoteViews 遷移至 Beta 版。

1.0.0-alpha03 版

2022 年 2 月 23 日

發布 androidx.core:core-remoteviews:1.0.0-alpha031.0.0-alpha03 版本包含以下修訂項目。

修正錯誤

  • 修正基礎結構。

1.0.0-alpha02 版本

2022 年 1 月 26 日

發布 androidx.core:core-remoteviews:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

1.0.0-alpha01 版本

2021 年 12 月 15 日

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

新功能

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

核心效能 1.0 版

1.0.0-alpha02 版本

2022 年 3 月 23 日

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

新功能

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

1.0.0-alpha01 版本

2021 年 12 月 15 日

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

Core Splashscreen 1.0 版本

1.0.0 版本

2022 年 7 月 27 日

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

發布 androidx.core:core-splashscreen:1.0.01.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-beta021.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-beta011.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-alpha021.0.0-alpha02 版本包含以下修訂項目。

新功能

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

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.1.0 版本

1.1.0-alpha01 版本

2021 年 8 月 4 日

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

新功能

  • 針對 Donated 捷徑中以 URI 為基礎的圖示 (由 Google 應用程式進行顯示) 提供索引支援。

Core 和 Core-ktx 1.6.0 版本

1.6.0 版本

2021 年 6 月 30 日

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

自 1.5.0 版本之後的重要異動

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

1.6.0-rc01 版本

2021 年 6 月 16 日

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

API 變更

1.6.0-beta02 版本

2021 年 6 月 2 日

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

修正錯誤

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

1.6.0-beta01 版本

2021 年 5 月 18 日

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

API 變更

1.6.0-alpha03 版本

2021 年 5 月 5 日

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

新功能

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

修正錯誤

  • 在 AppCompat 支援的檢視區塊上處理 null 自訂選擇操作模式回呼時,防止出現 NPE。(I033c7b/173435375)。

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

1.6.0-alpha02 版本

2021 年 4 月 15 日

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

API 變更

  • 新增 TelephoneManagerCompatSubscriptionManagerCompat (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-alpha01androidx.core:core-ktx:1.6.0-alpha011.6.0-alpha01 版本包含以下修訂項目。

API 變更

  • 新增與平台 SDK 一致的 Handler.hasCallbacks() 方法 (Idce1cb/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-rc011.0.0-rc01 版本包含以下修訂項目。

1.0.0-beta01 版

2021 年 5 月 18 日

發布 androidx.core:core-google-shortcuts:1.0.0-beta011.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-alpha031.0.0-alpha03 版本包含以下修訂項目。

修正錯誤

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

1.0.0-alpha02 版本

2021 年 4 月 15 日

發布 androidx.core:core-google-shortcuts:1.0.0-alpha021.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.0androidx.core:core-ktx:1.5.01.5.0 版本包含以下修訂項目。

自 1.4.0 版本以來的重要異動

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

1.5.0-rc02 版本

2021 年 5 月 5 日

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

修正錯誤

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

1.5.0-rc01 版本

2021 年 3 月 24 日

androidx.core:core:1.5.0-rc01androidx.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-beta03androidx.core:core-ktx:1.5.0-beta03 發布。1.5.0-beta03 版本包含以下修訂項目。

API 變更

  • 新增 ExecutorCompat,功能為可從 Handler 建立 Executor。(Ib4ca3b/181237835)。

1.5.0-beta02 版本

2021 年 2 月 24 日

發布 androidx.core:core:1.5.0-beta02androidx.core:core-ktx:1.5.0-beta021.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-beta01androidx.core:core-ktx:1.5.0-beta011.5.0-beta01 版本包含以下修訂項目。

API 變更

  • 遵循關於邊界相容性/平台互通性的 API 指南 (I7da35)
  • 將 AppCompatEditText 中的拖曳-放置 (放置事件) 和 OnReceiveContentListener 整合。(Ib26c9b/175343405)
  • 連接新的 Insets Animation API 和平台實作 (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,因為現在只要從事件監聽器傳回未被使用的內容,就能觸發預設行為。
    • (Ib4616b/173814913)
  • 淘汰 BuildCompat.isAtLeastR (Idb37e)
  • widget.RichContentReceiverCompat 移至 view.OnReceiveContentListener。(Ifdab7b/173814913)。
  • 新增 Preconditions.checkFlagsArgument。(I43952b/174181100)。
  • 淘汰對外共用的自訂選單。(I7cd92)
  • 通知現在可標記為未接來電。(I14d90)
  • 新增 PackageInfoCompat#getSignatures,用於擷取套件的憑證陣列 (I8e9a3b/159831205)

修正錯誤

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

外部貢獻

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

1.5.0-alpha05 版本

2020 年 11 月 11 日

發布 androidx.core:core:1.5.0-alpha05androidx.core:core-ktx:1.5.0-alpha051.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-alpha04androidx.core:core-ktx:1.5.0-alpha041.5.0-alpha04 版本包含以下修訂項目。

API 變更

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

修正錯誤

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

1.5.0-alpha03 版本

2020 年 9 月 16 日

發布 androidx.core:core:1.5.0-alpha03androidx.core:core-ktx:1.5.0-alpha031.5.0-alpha03 版本包含以下修訂項目。

API 變更

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

修正錯誤

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

外部貢獻

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

1.5.0-alpha02 版本

2020 年 8 月 19 日

發布 androidx.core:core:1.5.0-alpha02androidx.core:core-ktx:1.5.0-alpha021.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.setSettingsTextNotificationCompat.MessagingStyle.addHistoricMessage (I62bb6)
  • 更新通知說明文件 (I1293f)
  • 修正 NotificationCompat.Builder 的可空值性 (I932e3)
  • 新增 NotificationChannelCompatNotificationChannelGroupCompat (Icc3b6)
  • addExtraDataToAccessibilityNodeInfo 新增至 AccessibilityNodeProviderCompat (I26575)
  • 將 WindowInsetsCompat 更新為 Android 11 API (I3df9e)

外部貢獻

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

1.5.0-alpha01 版本

2020 年 6 月 10 日

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

新功能

  • 提供與 Android R 平台 SDK API,的 ShortcutManagerShortcutInfoAccessibilityNodeInfoDisplayCutoutGnssStatusNotification 類別的一致性。

修正錯誤

  • 明確建議檢查 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-alpha01androidx.core:core-ktx:1.4.0-alpha011.4.0-alpha01 版本包含以下修訂項目。

API 變更

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

修正錯誤

  • 新增 ActivityCompat.requestPermissions() 的權限驗證 (I372ccb/122163323)
  • 擷取 v28 以上版本呼叫成為獨立的靜態類別;該類別可在建立應用程式套件時修正 View#OnUnhandledKeyEventListenerNoClassDefFoundError 錯誤 (Id3419b/153695093)
  • 修正 setChronometerCountDown 當機錯誤 (I47282b/145770610)

Core 和 Core-ktx 1.3.2 版本

1.3.2 版本

2020 年 10 月 1 日

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

修正錯誤

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

Core 和 Core-ktx 1.3.1 版本

1.3.1 版本

2020 年 7 月 22 日

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

修正錯誤

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

Core 和 Core-ktx 1.3.0 版本

1.3.0 版本

2020 年 5 月 27 日

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

自 1.2.0 版本以來的重要異動

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

1.3.0-rc01 版本

2020 年 4 月 15 日

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

修正錯誤

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

1.3.0-beta01 版本

2020 年 4 月 1 日

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

1.3.0-alpha02 版本

2020 年 3 月 4 日

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

API 變更

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

1.3.0-alpha01 版本

2020 年 1 月 29 日

發布 androidx.core:core:1.3.0-alpha01androidx.core:core-ktx:1.3.0-alpha011.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.0androidx.core:core-ktx:1.2.01.2.0 版本包含以下修訂項目

自 1.1.0 版本以來的重大異動

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

1.2.0-rc01 版本

2019 年 11 月 20 日

發布 androidx.core:core:1.2.0-rc01androidx.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-beta02androidx.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-beta01androidx.core:core-ktx:1.2.0-beta011.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/1119191aosp/1126768)!

1.2.0-alpha04 版本

2019 年 9 月 5 日

發布 androidx.core:core:1.2.0-alpha04androidx.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-alpha03androidx.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)
  • asynccounterisEnabled 新增至 TraceCompat (aosp/987332)
  • 取消隱藏 WindowInsetsCompatViewDragHelper 中的 API (aosp/979408)

修正錯誤

  • 修正回應 a11y 捲動呼叫的 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-alpha02androidx.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-alpha01androidx.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、WakefulBroadcastReceiverInputConnectionCompat 中 28.0 (支援資料庫) 和 1.1 (AndroidX) 之間的套件金鑰字串的回溯相容性問題

1.1.0 版本

1.1.0 版本

2019 年 9 月 5 日

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

自 1.0.0 版以來的重要異動

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

1.1.0-rc03 版本

2019 年 8 月 7 日

發布 androidx.core:core:1.1.0-rc03androidx.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-rc02androidx.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-rc01androidx.core:core-ktx:1.1.0-rc01。您可以前往這裡查看這個版本包含的修訂版本。

修正錯誤

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

1.1.0-beta01 版本

2019 年 5 月 7 日

發布 androidx.core:core:1.1.0-beta01androidx.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-alpha05androidx.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-alpha04androidx.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-alpha03androidx.core-ktx 1.1.0-alpha03,而且有以下異動。發布 androidx.core-ktx 1.1.0-alpha02 以提供 androidx.core 1.1.0-alpha02 的 ktx 匹配項目。

新功能

  • 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,但得到原色。

核心-動畫和核心-動畫測試 1.0.0 版本

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-alpha02androidx.core:core-animation-testing:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

修正錯誤

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

Core-Animation 1.0.0-alpha01 版本

2020 年 4 月 15 日

發布 androidx.core:core-animation:1.0.0-alpha01androidx.core:core-animation-testing:1.0.0-alpha011.0.0-alpha01 版本包含以下修訂項目。

新功能

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

  • ValueAnimator#pauseValueAnimator#resume (API 級別 19)
  • ObjectAnimator.ofMultiIntObjectAnimator.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-alpha011.1.0-alpha01 版本包含以下修訂項目。

API 變更

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

Core-Role 1.0.0 版本

1.0.0 版本

2021 年 2 月 10 日

發布 androidx.core:core-role:1.0.01.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.2androidx.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.1appcompat-1.0.2 的版本。

修正錯誤

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

Core-Ktx 1.0.1 版本

2018 年 11 月 5 日

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

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