Core

程式碼範例

API 參考資料
androidx.core.animation
androidx.core.app
androidx.core.content
androidx.core.role
androidx.core.view
(查看所有核心套件的參考文件)

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

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

構件	穩定版	候選版	Beta 版	Alpha 版
Core	1.9.0	-	-	1.10.0-alpha01
core-animation	-	-	1.0.0-beta01	-
core-google-shortcuts	1.1.0	-	-	-
core-performance	-	-	-	1.0.0-alpha02
core-remoteviews	-	-	1.0.0-beta03	-
core-role	1.0.0	1.1.0-rc01	-	-
core-splashscreen	1.0.0	-	-	-

本程式庫上次更新日期：2023 年 1 月 11 日

宣告依附元件

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

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

Groovy

dependencies {
    def core_version = "1.9.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.1.0"

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

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

Kotlin

dependencies {
    val core_version = "1.9.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.1.0")

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

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

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

意見回饋

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

建立新問題

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

Core 和 Core-ktx 1.10 版本

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

新增了 ACTION_SHOW_TEXT_SUGGESTIONS 和 is/setTextSelectable 相容性 (Iedf82)。
新增了 IntentSanitizer，可讓您先清理不安全的意圖再啟動 (Ib0be5)。
使用圖示新增對 BigPictureStyle 的支援 (Ice26d，b/215583339)
更新了是否可為空值的註解 (I34cce、b/236498052、b/236498029、b/236497996、b) /236497942、b/236497884、b/236497726)
新增了 LocationManagerCompat.registerGnssMeasurementsCallback，以解決 Android R 錯誤 (Ie0f6f)。

修正錯誤

將 @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 相容。

Core 和 Core-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 版本包含以下修訂項目。

修正錯誤

TypefaceCompat 現在將遵循 API 29＋　的要求的和載入的樣式資訊。這是當載入的字型不是 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)。
更新了核心和 appcompat 是否可為空值，以符合 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。其可改善對話方塊的行為、顯示輸入法編輯器，並確保未淘汰的建立方法可以解決問題 (b/180881870)。(I29264、b/207401542、b/210121779)
清除部分 androidx.core API 的可為空值性。(Ib2583、b/206113818)
修正 performAccessibilityAction 參數的可空值性 (Ibbafe)
新增了方法，以解決以主題為金鑰的快取和 Theme.applyStyle 造成的 ColorStateList 問題 (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 版之後的重要異動

新增對與 SDK 30 以上版本的權限撤銷和應用程式休眠功能互動的支援，並在支援的裝置上向後移植到 SDK 23。詳情請參閱 IntentCompat.createManageUnusedAppRestrictionsIntent。
如需在元件中編寫選單新增支援的詳細資訊，請參閱 MenuProvider。

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

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

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

為 windowSplashScreenIconBackgroundColor 屬性新增回溯相容性
- 將 minSdkVersion 降級為 API 21 (Idd050、b/198161849、b/197759820、b/198165621)

修正錯誤

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

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

淘汰 JobIntentService，並改用 WorkManager (Ic7749、b/149049019)

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

向後移植 Objects.requireNonNull() (I27db5、b/179904366)

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 和平台實作 (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)
擷取了 v28 以上版本呼叫，使其成為獨立的靜態類別；這一點修正了在建立應用程式套件時 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 版本

2020 年 2 月 5 日

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

自 1.1.0 版本以來的重大異動

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

1.2.0-rc01 版本

2019 年 11 月 20 日

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

1.2.0-beta02 版本

2019 年 11 月 7 日

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

修正錯誤

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

1.2.0-beta01 版本

2019 年 10 月 9 日

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

API 變更

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

修正錯誤

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

外部貢獻

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

1.2.0-alpha04 版本

2019 年 9 月 5 日

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

API 變更

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

修正錯誤

在手勢超出滑動距離前，系統將不會再執行巢狀預先捲動作業 (b/139530818、aosp/1105373)。這對 ViewPager2 和其他程式庫有益。

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

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

取消淘汰功能 setter (aosp/937281)
RemoteActionCompat 現在是 1VersionedParcelable (aosp/928534)

修正錯誤

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，且包含以下異動。發布 androidx.core-ktx 1.1.0-alpha02，以便配合 ktx 的 androidx.core 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-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 版本

2019 年 5 月 7 日

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

修正錯誤

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

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 並修正以下錯誤：

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