Core

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

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

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

宣告依附元件

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

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

Groovy

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

    // 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-alpha01"

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

Kotlin

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

    // 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-alpha01")

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

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

意見回饋:

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

建立新問題

詳情請參閱 Issue Tracker 說明文件

Core-i18n Core-location-alElevation 1.0 版。

1.0.0-alpha01 版

2023 年 7 月 26 日

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

新功能

  • 新增了含有單一靜態方法 addMslAltitudeToLocation(Context, Location)AltitudeConverterCompat 類別 (I11168)。

Core-telecom 1.0 版。

1.0.0-alpha02 版

2023 年 10 月 4 日

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

API 變更

  • 針對傳回布林值的方法變更 API 簽名,改為傳回結果類別,以清楚指出作業成功或失敗的原因。
  • 已將 CallControlCallback 方法做為 lambda 引數移至 addCall,不必在呼叫範圍內明確提供回呼

修正錯誤

  • 修正 ConnectionService 相容性層中的錯誤,該錯誤在針對舊版 SDK 執行時不會呼叫音訊。
  • 改善 API 說明文件。

1.0.0-alpha01 版

2023 年 5 月 10 日

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

新功能

  • 導入 CallsManager API,可供 VoIP 應用程式用來與裝置上的電信架構整合。向平台通知的通話具有以下優點:前景執行優先順序、藍牙、穿戴式裝置和汽車裝置的瀏覽權限,以及簡化的音訊轉送功能。

    CallsManager API 則會為搭載舊版 Android 的裝置納入舊版 ConnectionService API。

Core 和 Core-ktx 1.13 版

1.13.0-alpha05 版

2024 年 2 月 7 日

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

外部貢獻

  • 感謝 Matthew Zavislak 更新 ContextCompat.registerReceiver 說明文件的正確性。(8fd733)。

1.13.0-alpha04 版本

2024 年 1 月 24 日

發布 androidx.core:core:1.13.0-alpha04androidx.core:core-ktx:1.13.0-alpha04androidx.core:core-testing:1.13.0-alpha041.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 (I62e95b/315440583)

1.13.0-alpha03 版本

2024 年 1 月 10 日

發布 androidx.core:core:1.13.0-alpha03androidx.core:core-ktx:1.13.0-alpha03androidx.core:core-testing:1.13.0-alpha031.13.0-alpha03 版包含此連結所列的修訂項目。

API 變更

1.13.0-alpha02 版本

2023 年 11 月 29 日

發布 androidx.core:core:1.13.0-alpha02androidx.core:core-ktx:1.13.0-alpha02androidx.core:core-testing:1.13.0-alpha021.13.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 新增 OnUserLeaveHintProvider 介面,允許任何元件接收實作子母畫面所需的 onUserLeaveHint 事件。這是由 ComponentActivityActivity 1.9.0-alpha01 中實作。(I54892)。

API 變更

  • 淘汰了 androidx.core.os.CancellationSignal。應替換為平台提供的 android.os.CancellationSignal。(Id45f6b/309499026b/309054079)
  • OnMultiWindowModeChangedProviderOnNewIntentProviderOnPictureInPictureModeChangedProviderOnConfigurationChangedProviderOnTrimMemoryProvider 介面已轉換為 Kotlin,確保 Consumer 上的一般參數具有正確的是否可為空值設定 (這些都是非空值)。(Ib6237)。
  • 傳送至 Consumer 新增至其各自提供者介面的 MultiWindowModeChangedInfoPictureInPictureModeChangedInfo 類別,現在會以 Kotlin 編寫。(Ie08e2)。

依附元件更新

1.13.0-alpha01 版本

2023 年 10 月 18 日

發布 androidx.core:core:1.13.0-alpha01androidx.core:core-ktx:1.13.0-alpha01androidx.core:core-testing:1.13.0-alpha011.13.0-alpha01 版包含此連結所列的修訂項目。

API 變更

  • PathParser 設為公開。該類別可以從 SVG 路徑字串建立 Path 例項。(Ic7af2b/302376846)
  • 新增了 Context.createAttributionContext 的 Compat 方法。(I61dcfIbe187)
  • NotificationCompatSideChannelService 標示為已淘汰。(I18fd9)。
  • 全新的 API 差異化動作快速滑過功能。(I46b0dIa9f68)
  • 用於追蹤平台 SDK 的其他 VelocityTracker 相容 API。(I32753)。

修正錯誤

  • 覆寫 Person 中的 equalshashCode 方法。(I610a5)。

Core 和 Core-ktx 1.12 版

版本 1.12.0

2023 年 9 月 6 日

發布 androidx.core:core:1.12.0androidx.core:core-ktx:1.12.0androidx.core:core-testing:1.12.01.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-rc01androidx.core:core-ktx:1.12.0-rc01androidx.core:core-testing:1.12.0-rc01,但沒有重大變更。1.12.0-rc01 版包含此連結所列的修訂項目。

1.12.0-beta01 版

2023 年 7 月 26 日

發布 androidx.core:core:1.12.0-beta01androidx.core:core-ktx:1.12.0-beta01androidx.core:core-testing:1.12.0-beta011.12.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • setLineHeight(unit, lineHeight) 新增至 TextViewcompat 類別 (Ia9fa9)
  • 已從 Android 14 新增 TypedValueCompat.getUnitFromComplexDimension() (I958e8)
  • setLineHeight(unit, lineHeight) 新增至 TextView Compat 類別 (Ib2ee1)
  • 向後移植其他 Accessibility API (Ic65ba)
  • Backport API 34 AccessibilityNodeInfo 方法 (I44182)
  • 將穩定版 SDK 的測試升級為實驗性 (Ia9b35)
  • 向後移植 AccessiiblityWindowInfo 34 API (I96a5d)
  • 淘汰了 BuildCompat.isAtLeastU()。請改用 SDK_INT >= 34 (I4f8e7b/289269026)
  • 移除了實驗性 isAtLeastU() API 的用法 (Ie9117b/289269026)
  • 已針對已淘汰的已淘汰標記,將 BuildCompat 遷移至 Kotlin (I56775b/289269026)
  • setLineHeight(unit, lineHeight) 新增至 TextView Compat 類別 (I15716)
  • 新增 accessibilityDataSensitive Compat 屬性。(I0c6e0)。
  • 如果指定 FLAG_NO_CREATEPendingIntentCompat.getActivitygetService 可能會傳回空值。(Iffdf0b/289696515)
  • 更新 API 檔案,為相容性抑制加上註解 (I8e87ab/287516207)
  • 新增了 PendingIntentCompat.send() (Iaf707)
  • 新增 Location.removeVerticalAccuracy()Location.removeSpeedAccuracy()Location.removeBearingAccuracy() 的相容性版本。(I5b640)。

修正錯誤

  • 如果檢視區塊具有無障礙委派,則將檢視畫面納入對無障礙功能的重要考量。(If2b54)。

1.12.0-alpha05 版

2023 年 6 月 7 日

發布 androidx.core:core:1.12.0-alpha05androidx.core:core-ktx:1.12.0-alpha05androidx.core:core-testing:1.12.0-alpha05。這個版本是以內部分支版本開發。

修正錯誤

  • 更新 ColorUtils 類別的說明文件,以根據 Material 3 Hue、Chroma 和 Tone (M3HCT) 參數產生顏色。(I32979I21c8c)。
  • 修正 android.os.Trace 的 replaceWith 問題 (I730f9)

1.12.0-alpha04 版本

2023 年 5 月 10 日

發布 androidx.core:core:1.12.0-alpha04androidx.core:core-ktx:1.12.0-alpha04androidx.core:core-testing:1.12.0-alpha04。這個版本從內部分支版本中釋出。

1.12.0-alpha03 版本

2023 年 4 月 12 日

發布 androidx.core:core:1.12.0-alpha03androidx.core:core-ktx:1.12.0-alpha03androidx.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-alpha01androidx.core:core-ktx:1.12.0-alpha011.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-beta02androidx.core:core-ktx:1.11.0-beta02androidx.core:core-testing:1.11.0-beta021.11.0-beta02 版包含此連結所列的修訂項目。

修正錯誤

  • 更新 ColorUtils 類別的說明文件,以根據 Material 3 Hue、Chroma 和 Tone (M3HCT) 參數產生顏色。(I32979I21c8c)。
  • 修正 android.os.Trace 的 replaceWith 問題 (I730f9)

1.11.0-beta01 版本

2023 年 5 月 24 日

發布 androidx.core:core:1.11.0-beta01androidx.core:core-ktx:1.11.0-beta01androidx.core:core-testing:1.11.0-beta011.11.0-beta01 版包含此連結所列的修訂項目。

API 變更

  • ViewCompat 支援新增至方法 performHapticFeedback (Ib02c6)
  • getDisplay 變更為 #getDisplayOrDefault (I96ff9)
  • 新增 ContextCompat#getDisplay(Context) (I7011fb/178183326)
  • 新增 ContextCompat#getContextForLanguage(Context),以便在非活動結構定義中取得每個應用程式語言代碼 (I58e75b/243457462)

修正錯誤

  • 清楚說明 CollectionInfoCompat 文件,特別是 isHierarchical (I14f6c)

1.11.0-alpha04 版本

2023 年 5 月 10 日

發布 androidx.core:core:1.11.0-alpha04androidx.core:core-ktx:1.11.0-alpha04androidx.core:core-testing:1.11.0-alpha041.11.0-alpha04 版包含此連結所列的修訂項目。

API 變更

  • 新增了 LinkMovementMethodCompat 來修正連結觸控處理 (Ia632c)
  • PendingIntent.getBroadcast() 現已正確標示為 @Nullable (Ifff96b/277630907)

修正錯誤

  • 修正 DisplayManagerCompat 中的結構定義外洩問題 (I3409bb/279625765)
  • 新增 SoftwareKeyboardControllerCompat,以便直接依據 View 顯示或隱藏螢幕鍵盤。此向後移植了某些 API 級別使用 WindowInsetsController API 時已知的已知問題,以及 WindowInsetsControllerCompat.show 的幕後實作擷取,並隱藏 IME 插邊類型。(Idd0a3)。

1.11.0-alpha03 版本

2023 年 4 月 19 日

發布 androidx.core:core:1.11.0-alpha03androidx.core:core-ktx:1.11.0-alpha03androidx.core:core-testing:1.11.0-alpha031.11.0-alpha03 版包含此連結所列的修訂項目。

API 變更

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

1.11.0-alpha02 版本

2023 年 4 月 5 日

發布 androidx.core:core:1.11.0-alpha02androidx.core:core-ktx:1.11.0-alpha02androidx.core:core-testing:1.11.0-alpha021.11.0-alpha02 版包含此連結所列的修訂項目。

API 變更

  • getCurrentInterruptionFilter 新增至 NotifManagerCompat (I8ec95b/243183646)
  • 淘汰 app.BundleCompat,改用 os.BundleCompat (Idc3a2b/274577000)
  • 新增 TestConsumer,以便開發人員在測試中記錄值。(I937c1)。

修正錯誤

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

1.11.0-alpha01 版本

2023 年 3 月 22 日

發布 androidx.core:core:1.11.0-alpha01androidx.core:core-ktx:1.11.0-alpha011.11.0-alpha01 版包含此連結所列的修訂項目。

API 變更

  • 在 Android U 中,getTypeContentProvider API 會要求呼叫端擁有正確的讀取權限。FileProvider 現在提供預設的 getTypeAnonymous 實作,即無限制的版本。(I4773f)。
  • 新增了內容擷取 API 的 compat 類別 (I09366)
  • 新增了 NotifCompat.Builder.setLargeIcon(Icon) (Ic0a5b)
  • 將批次通知 API 新增至 NotificationManagerCompat。我們建議使用者在發布多則通知時使用這個 API。(I2cd7f)。
  • 新增了 registerGnssMeasurementsCallback(),可在 R 以下版本平台上執行 (I579f8)

Core 和 Core-ktx 1.10 版

1.10.1 版本

2023 年 5 月 10 日

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

外部貢獻

  • 修正因結果為空值而擲回 BadParcelableException 的問題 b/277434277b/278118318 (由 Mygod Studio 提供)

1.10.0 版本

2023 年 4 月 5 日

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

自 1.9.0 版以來的重要變更

  • 淘汰了無障礙功能物件的回收作業。我們發現即使是最舊的支援的 OS 版本,效能異動應該微不足道。(I0a961)
  • 為 SDK 擴充功能版本新增 BuildCompat 常數。(I6084c)。
  • 如要瞭解新的 API 和錯誤修正,請參閱預先發布版 1.10.0 的版本資訊。

1.10.0-rc01 版

2023 年 3 月 8 日

發布 androidx.core:core:1.10.0-rc01androidx.core:core-ktx:1.10.0-rc01,與先前的 Beta 版沒有差別。

1.10.0-beta01 版

2023 年 2 月 22 日

發布 androidx.core:core:1.10.0-beta01androidx.core:core-ktx:1.10.0-beta011.10.0-beta01 版包含此連結所列的修訂項目。

API 變更

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

修正錯誤

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

1.10.0-alpha02 版本

2023 年 1 月 25 日

發布 androidx.core:core:1.10.0-alpha02androidx.core:core-ktx:1.10.0-alpha021.10.0-alpha02 版包含此連結所列的修訂項目。

API 變更

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

1.10.0-alpha01 版本

2023 年 1 月 11 日

發布 androidx.core:core:1.10.0-alpha01androidx.core:core-ktx:1.10.0-alpha011.10.0-alpha01 版包含此連結所列的修訂項目。

API 變更

  • CallStyle 新增至 NotificationCompat (Id9a53b/199294989)
  • 為 SDK 擴充功能版本新增 BuildCompat 常數 (I6084c)
  • 新增用於在無障礙節點上設定初始焦點的 API。(Id199a)。
  • 新增用於限制內容變更頻率的 API (If4ea0)
  • 針對 Android 13 中推出的 Parcel、Bundle 和 Intent 相關 API 新增相容性方法。部分 ParcelCompat 方法簽名已更新,可能需要變更來源,才能升級確認新的簽名。(I57e94b/242048899)
  • 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援版本,這項變更的成效差異都是微不足道。(I0a961)
  • 針對已淘汰的隱藏函式,更新其傳回類型是否可為空值 (Ibf7b0)
  • 新增 Point 和 PointF 的乘法/除法運算子超載 (I8e557b/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.0androidx.core:core-ktx:1.9.01.9.0 版包含此連結所列的修訂項目。

自 1.8.0 版以來的重要變更

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

1.9.0-rc01 版本

2022 年 8 月 24 日

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

修正錯誤

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

1.9.0-beta01 版本

2022 年 8 月 10 日

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

API 變更

修正錯誤

  • @RequiresPermission 新增至需要為 SDK 33 以上版本授予 POST_NOTIFICATIONS 權限的 API (Ie542eb/238790278)。
  • 在 androidx-platform-dev 中新增對 T 所導入 API 的支援 ()
  • 新增 T 中針對 API 的支援。(I358f1)。
  • 如果 compat impl 無法在 API 14-20 上解析,TypefaceCompate.create(..., weight, italic) 會改回使用 Typeface.create 平台 (I1ee34b/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-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 相容。

核心和核心-ktx 1.8.0 版

1.8.0 版

2022 年 6 月 1 日

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

自 1.7.0 版以來的重要變更

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

1.8.0-rc02 版

2022 年 5 月 18 日

發布 androidx.core:core:1.8.0-rc02androidx.core:core-ktx:1.8.0-rc021.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 版包含此連結所列的修訂項目。

修正錯誤

  • 在 API 29 以上級別中,TypefaceCompat 現在會遵循要求及載入的樣式資訊。這是當載入的字型不是 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)
  • 根據 Tiramisu DP2 (I0cbb7) 更新核心和應用程式是否可為空值的作法
  • BitmapCompat 新增方法,讓點陣圖縮小作業更為流暢。(Ib706c)。
  • ActivityCompat.requestDragAndDropPermissions 新增是否可為空值註解 (I0f2b0b/206113378)
  • FileProvider 新增解決方法,方便原始設備製造商 (OEM) 從資訊清單中去除中繼資料。(I82f63)。

修正錯誤

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

1.8.0-alpha05 版

2022 年 2 月 23 日

發布 androidx.core:core:1.8.0-alpha05androidx.core:core-ktx:1.8.0-alpha051.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。這可改善 Dialog 的行為、顯示輸入法編輯器,並確保未淘汰的建立方法可以解決問題 (b/180881870)。(I29264b/207401542b/210121779)
  • 清除部分 androidx.core API 的可為空值性。(Ib2583b/206113818)
  • 修正 performAccessibilityAction 參數的可為空值性 (Ibbafe)
  • 新增瞭解決 ColorStateList 問題的方法,此問題是以 Theme 為鍵的快取和 Theme.applyStyle 所造成 (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-beta021.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)。
  • 新增了 NotificationCompat.BigPictureStyle.showBigPictureWhenCollapsed(boolean),以便與平台 API 保持一致。(I8cd88)。
  • 修正了 PermissionCheckercheckSelfPermission 會顯示麥克風/攝影機指標的問題。(I572a9)。
  • setImportantForAccessibility 新增明確執行緒註解。(I990fa)。
  • 根據 API 指南更新了 getUnusedAppRestrictionsStatus。(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.1 版

1.1.0-alpha01 版

2024 年 2 月 7 日

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

新功能

  • 配合依附元件版本更新版本編號。

Core Remote Views 1.0 版本

1.0.0 版本

2023 年 9 月 6 日

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

1.0.0 的主要功能

  • 將 core-remoteviews 移至穩定版 1.0.0

1.0.0-beta04 版

2023 年 5 月 10 日

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

修正錯誤

  • 修正了 compat 程式庫中角案例擲回 ArrayOutOfBoundsException 的問題。

1.0.0-beta03 版

2022 年 10 月 5 日

發布 androidx.core:core-remoteviews:1.0.0-beta031.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-beta011.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-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。

Core Performance 1.0 版

1.0.0 版本

2024 年 1 月 10 日

發布 androidx.core:core-performance:1.0.0androidx.core:core-performance-play-services:1.0.0androidx.core:core-performance-testing:1.0.01.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-rc01androidx.core:core-performance-play-services:1.0.0-rc01androidx.core:core-performance-testing:1.0.0-rc011.0.0-rc01 版包含此連結所列的修訂項目。

新功能

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

API 變更

  • DevicePerformance 專用 API 的初始 RC 版。

1.0.0-beta02 版

2023 年 10 月 4 日

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

新功能

  • 測試相關重構。

API 變更

  • 未變更的 API 使用模式。

1.0.0-beta01 版本

2023 年 9 月 6 日

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

新功能

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

API 變更

  • 最初 Beta 版 DevicePerformance 專用 API。

1.0.0-alpha03 版本

2023 年 8 月 23 日

發布 androidx.core:core-performance:1.0.0-alpha03androidx.core:core-performance-play-services:1.0.0-alpha03androidx.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-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.1 版

1.1.0-alpha02 版

2023 年 9 月 6 日

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

修正錯誤

依附元件更新

  • 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.11.0.1 版包含以下修訂項目。

修正錯誤

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-rc011.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-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.2 版

1.2.0-alpha01 版

2023 年 7 月 26 日

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

API 變更

  • 合併適用於 ab、c-path 的公開和實驗性 API 檔案 (I8cfeeb/278769092)
  • 遷移 androidx.core 群組,以便使用合併的公用 API 檔案 (Ifdef4b/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-rc011.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-beta011.1.0-beta01 版包含此連結所列的修訂項目。

新功能

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

1.1.0-alpha03 版

2022 年 9 月 7 日

發布 androidx.core:core-google-shortcuts:1.1.0-alpha031.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-alpha011.1.0-alpha01 版包含以下修訂項目。

新功能

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

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.11.0.1 版包含以下修訂項目。

修正錯誤

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

1.0.0 版本

2021 年 6 月 30 日

發布 androidx.core:core-google-shortcuts:1.0.01.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-alpha03查看 1.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-rc011.5.0-rc01 版包含以下修訂項目。

摘要

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

1.5.0-beta03 版本

2021 年 3 月 10 日

發布 androidx.core:core:1.5.0-beta03androidx.core:core-ktx:1.5.0-beta031.5.0-beta03 版包含此連結所列的修訂項目。

API 變更

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)
  • 擷取 28 以上版本的呼叫,成為一個獨立的靜態類別;這可修正在建構應用程式套件時,View#OnUnhandledKeyEventListener 發生的 NoClassDefFoundError 錯誤 (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-beta021.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)

修正錯誤

  • 修正回應無障礙功能捲動呼叫的 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,且包含以下變更。為配合 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-rc01 版本

2023 年 7 月 26 日

發布 androidx.core:core-animation:1.0.0-rc01androidx.core:core-animation-testing:1.0.0-rc01androidx.core:core-remoteviews:1.0.0-rc011.0.0-rc01 版包含此連結所列的修訂項目。

新功能

  • 在 Beta 版穩定功能後,RemoteViews 已移至 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-alpha02androidx.core:core-animation-testing:1.0.0-alpha021.0.0-alpha02 版包含此連結所列的修訂項目。

修正錯誤

  • 修正單一屬性具有多個 Animator 的 AnimatorSet。(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-rc011.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.01.0.0 版包含此連結所列的修訂項目。

1.0.0 的主要功能

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

Core-Role 1.0.0-rc01 版

2020 年 4 月 15 日

androidx.core:core-role:1.0.0-rc011.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 並修正以下錯誤:

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