核心
androidx.core.animation
androidx.core.app
androidx.core.content
androidx.core.role
androidx.core.view
(查看所有核心套件的參考資料)
下表列出 androidx.core 群組的所有構件。
| 構件 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
|---|---|---|---|---|
| Core | 1.19.1 | - | - | - |
| core-animation | 1.0.0 | - | - | - |
| core-google-shortcuts | 1.1.0 | - | - | 1.2.0-alpha01 |
| core-performance | 1.0.0 | - | - | - |
| core-remoteviews | 1.1.0 | - | - | - |
| core-role | 1.1.0 | - | - | - |
| core-splashscreen | 1.2.0 | - | - | - |
宣告依附元件
如要新增 Core 的依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle 檔案中,新增您需要的構件依附元件:
Groovy
dependencies { def core_version = "1.19.1" // Java language implementation implementation "androidx.core:core:$core_version" // Kotlin implementation "androidx.core:core-ktx:$core_version" // To use RoleManagerCompat implementation "androidx.core:core-role:1.1.0" // To use the Animator APIs implementation "androidx.core:core-animation:1.0.0" // To test the Animator APIs androidTestImplementation "androidx.core:core-animation-testing:1.0.0" // Optional - To enable APIs that query the performance characteristics of GMS devices. implementation "androidx.core:core-performance:1.0.0" // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google implementation "androidx.core:core-google-shortcuts:1.1.0" // Optional - to support backwards compatibility of RemoteViews implementation "androidx.core:core-remoteviews:1.1.0" // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12 implementation "androidx.core:core-splashscreen:1.2.0" }
Kotlin
dependencies { val core_version = "1.19.1" // Java language implementation implementation("androidx.core:core:$core_version") // Kotlin implementation("androidx.core:core-ktx:$core_version") // To use RoleManagerCompat implementation("androidx.core:core-role:1.1.0") // To use the Animator APIs implementation("androidx.core:core-animation:1.0.0") // To test the Animator APIs androidTestImplementation("androidx.core:core-animation-testing:1.0.0") // Optional - To enable APIs that query the performance characteristics of GMS devices. implementation("androidx.core:core-performance:1.0.0") // Optional - to use ShortcutManagerCompat to donate shortcuts to be used by Google implementation("androidx.core:core-google-shortcuts:1.1.0") // Optional - to support backwards compatibility of RemoteViews implementation("androidx.core:core-remoteviews:1.1.0") // Optional - APIs for SplashScreen, including compatibility helpers on devices prior Android 12 implementation("androidx.core:core-splashscreen:1.2.0") }
如要進一步瞭解依附元件,請參閱「新增建構依附元件」一文。
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
Core 和 Core-ktx
1.19 版
1.19.1 版
2026 年 9 月 23 日
發布 androidx.core:core:1.19.1、androidx.core:core-ktx:1.19.1 和 androidx.core:core-testing:1.19.1。1.19.1 版包含這些修訂項目。
修正錯誤
androidx.lifecycle:lifecycle-runtime依附元件已更新至 2.10.0。如要搭配 AGP 9.5.0-alpha04 以上版本執行套裝生命週期執行階段 Lint 檢查,則必須使用這個版本。(Ic4c56、b/556807521)
1.19.0 版
2026 年 6 月 3 日
發布 androidx.core:core:1.19.0、androidx.core:core-ktx:1.19.0 和 androidx.core:core-testing:1.19.0。1.19.0 版包含這些修訂項目。
1.18.0 版以來的重要異動:
1.19.0-rc01 版
2026 年 5 月 19 日
發布 androidx.core:core:1.19.0-rc01、androidx.core:core-ktx:1.19.0-rc01 和 androidx.core:core-testing:1.19.0-rc01。1.19.0-rc01 版包含這些修訂項目。
1.19.0-alpha02 版
2026 年 5 月 6 日
發布 androidx.core:core:1.19.0-alpha02、androidx.core:core-ktx:1.19.0-alpha02 和 androidx.core:core-testing:1.19.0-alpha02。1.19.0-alpha02 版包含這些修訂項目。
API 變更
- 淘汰
BuildCompat.isAtLeastB*。呼叫端應改為直接檢查SDK_INT(_FULL)(I09666、b/505015815)
修正錯誤
- 修正 Android 17 (SDK 37)
CallSessionTest測試失敗的問題,方法是抑制不受影響平台版本上的特定版本錯誤緩解測試。(I970a7、b/502732317) - 修正 Android 14-16 的問題:語音通話開始時,音訊可能會意外轉到喇叭 (Ic7000、b/491932378)
- 修正
core-telecom中的當機問題 (IllegalStateException),如果電信架構或遠端服務在擴充功能設定期間多次調度連線事件,就可能發生這個問題。(I00f82、b/476724351) - 如果
BLUETOOTH_CONNECT權限遭拒,Telecom 現在會使用備用經驗法則來識別穿戴式裝置,以便做出音訊轉送決策。(Iec271、b/499302063)
外部貢獻
- 新增
TextAttributeCompat做為TextAttribute的回溯相容變化版本。(Ib4a46、b/460301602)
1.19.0-alpha01 版
2026 年 4 月 8 日
發布 androidx.core:core:1.19.0-alpha01、androidx.core:core-ktx:1.19.0-alpha01 和 androidx.core:core-testing:1.19.0-alpha01。1.19.0-alpha01 版包含這些修訂項目。
重要異動
- core-ktx API 已合併至核心程式庫。所有 Kotlin 擴充功能現在都是主要核心構件的一部分。core-ktx 現在是空白構件,用於相容性。(I6adbe)
API 變更
- 新增 API,用於取得及設定數學資訊 (Ib5ad3、b/394599312)
- 新增變化版本設定,自訂可下載的可變字型 (Ifdc93、b/223262013)
- 在
AccessibilityNodeInfoCompat.SelectionCompat中新增unwrap(),用於擷取基礎平台AccessibilityNodeInfo.Selection物件。(I3078a、b/479902413) - 將
getView()和getVirtualDescendantId()新增至AccessibilityNodeInfoCompat.SelectionPositionCompat。(Ib0c48、b/362783892) - 修正 AndroidX 中的
ACTION_ARGUMENT_SELECTION_PARCELABLE定義,使其與架構 SDK 中的定義相符,以便使用單一動作文字。(Ib40af、b/479852824) - 在
NotificationCompat中新增EXTRA_PREFER_SMALL_ICON鍵常數 (I713c9、b/469460575、b/478869887) - 在
NotificationCompat中新增對MetricStyle、語意樣式和相關 API 的支援。(I6c194、b/445685015、b/446155056、b/446157356、b/467924497) - 使用 @ChecksSdkIntAtLeast 註解
BuildCompat.isAtLeastB_1(I18a28、b/462789273)
修正錯誤
- 修正
AccessibilityNodeInfoCompat.SelectionPositionCompat和AccessibilityNodeInfoCompat.SelectionCompat中的equals()方法行為,以便正確評估相等性。(Icbe1d、b/495537199)
1.18 版
1.18.0 版
2026 年 3 月 11 日
發布 androidx.core:core:1.18.0、androidx.core:core-ktx:1.18.0 和 androidx.core:core-testing:1.18.0。1.18.0 版包含這些修訂版本。
1.17.0 版以來的重要異動:
compileSdk從 API 36 變更為 API 36.1- 新增
NotificationCompat.ProjectedExtender,支援投影裝置上的通知。 - 新增
PictureInPictureUiStateCompat,協助處理子母畫面功能的 API 差異 - 新增
AccessibilityNodeInfoCompat.SelectionCompat,協助處理搭載 API 36.1 的裝置上的無障礙選項
1.18.0-rc01 版
2026 年 2 月 11 日
發布 androidx.core:core:1.18.0-rc01、androidx.core:core-ktx:1.18.0-rc01 和 androidx.core:core-testing:1.18.0-rc01。1.18.0-rc01 版本包含這些修訂項目。
API 變更
- 移除
onViewBoundsChangedAPI (Ie56d0、b/475328144) - 新增
BasicPictureInPicture和VideoPlaybackPictureInPicture類別,用於一般子母畫面用途 (I7f989、b/475328144)
修正錯誤
- 新增
ViewBoundsTracker類別,持續追蹤檢視畫面邊界,以便在PictureInPictureParamsCompat中設定sourceRectHint(Id203a、b/474454111)
1.18.0-alpha01 版
2026 年 1 月 14 日
發布 androidx.core:core:1.18.0-alpha01、androidx.core:core-ktx:1.18.0-alpha01 和 androidx.core:core-testing:1.18.0-alpha01。1.18.0-alpha01 版包含這些修訂項目。
API 變更
- 在
WindowInsetsCompat中新增getBoundingRects的支援 (I24f18) onCanUserUpdateSilence現在是選用項目 (Ibb0c2)- 擴充
PictureInPictureProvider介面,納入OnUserLeaveHintProvider(I3125b、b/462178249) - 淘汰
PermissionsDelegateCompat.onActivityResult,FragmentActivity不會再呼叫這個方法。(I59197、b/460267600) - 將子母畫面函式從
ComponentActivity抽象化為專屬PictureInPictureProvider介面 (I068a3、b/462178249) - 新增 API,用於通知介面是否應顯示麥克風 (I55acf、b/445237449)
- 新增
DisplayShapeCompatAPI (I490d4、b/410851992) PictureInPictureParamsCompat是用來包裝架構android.app.PictureInPictureParams類別。(I8af9e、b/458803858)- 新增對
IntentSender的支援,加入位置:androidx-main am: 127eef7acc am: b4b1111b77 (I5b30b) - 在 androidx-main am: 127eef7acc 中新增對
IntentSender的支援 (I849b9) - 在 androidx-main 中新增對
IntentSender的支援 - 新增
IntentSender支援 (Ia998d、b/445163724) - 新增 API,用於取得及設定選取項目 (I05ec4、b/362784540)
- 新增已知問題 452390376:在 Pixel 10 裝置上,無法為 VIDEO_CALL 等串流用途啟用自動曝光模式低光源強化 (LLB)。(Iba480、b/452390376)
- 新增 API,用於取得及設定排序方向 (I658de、b/394670064)
- 在
CallControlScope中新增用於管理視訊通話的 API:getVideoState()可觀測音訊/視訊狀態,requestVideoState(int)則可要求變更視訊狀態。(I51065、b/333074774) - 新增缺少的
AccessibilityNodeInfoCompat勾選狀態常數。(I40b4c) - 修正缺少
AccessibilityNodeInfoCompat展開狀態 intdef 的錯誤。(I75106、b/435252704) BuildCompat.isAtLeastB1:移除@RequiresApi(I42fe2、b/430210979)- 修正缺少
AccessibilityNodeInfoCompat展開狀態常數的錯誤。(I1b1cd、b/435252704) CallsManager.registerAppWithTelecom現在包含新的選用backwardsCompatSdkLevel參數。這樣一來,開發人員就能控管要使用哪種基礎平台實作 (舊版ConnectionService或新型交易式 API)。預設值為 33,確保 SDK 34 以上版本預設使用新版 API,但可設為較高值,強制在特定 SDK 範圍使用舊版路徑。(Ib9571、b/444266242)- 新增
CallAttributesCompat.isLogExcluded,可指定是否要從通話記錄中排除通話 (Ia2a3a、b/447166999) - 新增缺少的內容異動類型。(I52a3c)
- 新增
BuildCompat.isAtLeastB1,檢查 Baklava 次要版本 1 (SDK 36.1) 新增的 API 是否可用。(I78513、b/430210979) - 推出新的 API
RangingResultFailure,用於回報測距工作階段失敗和原因,測距啟動失敗也會使用先前透過RangingResultPeerDisconnected回報的RangingResultFailure回呼 - 推出新的 API
RangingResultFailure,用於回報測距工作階段失敗和原因,測距啟動失敗也會使用先前透過RangingResultPeerDisconnected回報的RangingResultFailure回呼 (If3715) - 已淘汰
bundleOf(...)擴充功能函式,該函式不提供編譯時間類型安全,且可能導致執行階段當機。請改為直接使用Bundle方法。(I48af2、b/434825212)
修正錯誤
- 將 Pixel 12 月版本新增至 KI_398591036 的固定版本指紋清單 (I65f51、b/398591036)
- 將 Pixel 11 月版本新增至 KI_398591036 的固定版本指紋清單 (I60c10、b/398591036)
- 將 Pixel 10 月版本新增至 KI_398591036 的固定版本指紋清單 (I6438c、b/398591036)
- 從
FingerprintManagerCompat移除對FingerprintManager類別的參照,並更新所有方法,使其傳回 false 或不執行任何操作。(I0360b、b/330524057) - 修正 KI_452390376 說明文件中的程式碼連結 (I9a554、b/454020407)
- 將特定 Pixel 版本標示為已修正。(I4c751、b/398591036)
- 新增支援功能,可為
KnownIssue指定手動測試的版本指紋清單。(Iea9f9、b/453691379)
1.17 版
1.17.0 版
2025 年 8 月 13 日
發布 androidx.core:core:1.17.0、androidx.core:core-ktx:1.17.0 和 androidx.core:core-testing:1.17.0。1.17.0 版包含這些修訂項目。
自 1.16.0 版以來的重要異動
- 核心程式庫已更新,指定 Kotlin 2.0 語言層級,且必須使用 Kotlin Gradle 外掛程式 2.0.0 以上版本。
1.17.0-rc01 版
2025 年 7 月 30 日
發布 androidx.core:core:1.17.0-rc01、androidx.core:core-ktx:1.17.0-rc01 和 androidx.core:core-testing:1.17.0-rc01。1.17.0-rc01 版與前一個 Beta 版相比沒有任何變更。
1.17.0-beta01 版
2025 年 7 月 2 日
發布 androidx.core:core:1.17.0-beta01、androidx.core:core-ktx:1.17.0-beta01 和 androidx.core:core-testing:1.17.0-beta01。1.17.0-beta01 版與前一個 Alpha 版相比沒有任何異動。
1.17.0-alpha01 版
2025 年 6 月 18 日
發布 androidx.core:core:1.17.0-alpha01、androidx.core:core-ktx:1.17.0-alpha01 和 androidx.core:core-testing:1.17.0-alpha01。1.17.0-alpha01 版包含這些修訂項目。
新功能
- 核心程式庫已更新,目標為 Kotlin 2.0 語言層級,且必須使用 Kotlin Gradle 外掛程式 2.0.0 以上版本。(Idb6b5)
API 變更
新增
NotificationCompat.ProgressStyle及NotificationCompat.Builder.setRequestPromotedOngoing()。詳情請參閱「以進度為主的通知」和「最新即時資訊」。新增
Parcel.use擴充功能函式,可安全處理Parcel資源。(I436da)
1.16 版
1.16.0 版
2025 年 4 月 9 日
發布 androidx.core:core:1.16.0、androidx.core:core-ktx:1.16.0 和 androidx.core:core-testing:1.16.0。1.16.0 版包含這些修訂項目。
1.15.0 版以來的重要異動
- 這個程式庫現在使用 JSpecify 可為空值註解,屬於類型用途。Kotlin 開發人員應使用下列編譯器引數,強制執行正確用法:
-Xjspecify-annotations=strict(這是 Kotlin 編譯器 2.1.0 以上版本的預設值)。(Iaf3e1、b/326456246)
1.16.0-rc01 版
2025 年 3 月 26 日
發布 androidx.core:core:1.16.0-rc01、androidx.core:core-ktx:1.16.0-rc01 和 androidx.core:core-testing:1.16.0-rc01。1.16.0-rc01 版與先前的 Beta 版相比沒有任何變更。
1.16.0-beta01 版
2025 年 3 月 12 日
發布 androidx.core:core:1.16.0-beta01、androidx.core:core-ktx:1.16.0-beta01 和 androidx.core:core-testing:1.16.0-beta01。1.16.0-beta01 版包含這些修訂項目。
API 變更
- 精簡插邊保護 API (I7050d)
- 新增按鍵,可在未放大的視窗座標中取得字元邊界。(If7a06)
- 新增布林值屬性,代表
AccesibilityNodeInfo是否為必填欄位。(I4fd2d) - 將
View.transformMatrixToGlobal向後移植至ViewCompat(If17e2)
1.16.0-alpha02 版
2025 年 1 月 29 日
發布 androidx.core:core:1.16.0-alpha02、androidx.core:core-ktx:1.16.0-alpha02 和 androidx.core:core-testing:1.16.0-alpha02。1.16.0-alpha02 版包含這些修訂項目。
API 變更
- 新增
BuildCompat.isAtLeastB,用於檢查 Baklava 中新增的 API 是否可用 (I0f89c) - 新增實驗性 API,用於取得內建螢幕清單。(Idda4d)
- 新增一組與確保系統資訊列對比度相關的 API (I9849c)
修正錯誤
- 修正問題:在 SDK < 26 上,
getLaunchDisplayId()傳回不正確的預設值 0。(Icd679) - 這個程式庫現在使用 JSpecify 可為空值註解,屬於類型用途。Kotlin 開發人員應使用下列編譯器引數,強制執行正確用法:
-Xjspecify-annotations=strict(這是 Kotlin 編譯器 2.1.0 以上版本的預設值)。(Iaf3e1、b/326456246)
1.16.0-alpha01 版
2024 年 12 月 11 日
發布 androidx.core:core:1.16.0-alpha01、androidx.core:core-ktx:1.16.0-alpha01 和 androidx.core:core-testing:1.16.0-alpha01。1.16.0-alpha01 版包含這些修訂版本。
API 變更
- 將
setLaunchDisplayId新增至ActivityOptionsCompat(I39e77、b/379669743) - 新增
SYSTEM_OVERLAYS的相容 API。(Ibd1fd、b/287470173) - 新增
OutcomeReceiverCompat,這是 Android 的OutcomeReceiver版本,適用於所有 API 級別。(Ib8265、b/380060342) - 新增
android.view.ScrollFeedbackProvider的相容性類別。(Icaa92) - 新增
ViewCompat.addViewOverlay(View)做為View.getOverlay().add(View)的替代方案。ViewCompat變化版本修正了以下問題:LifecycleOwner和ViewModelStoreOwner等擁有者無法在疊加檢視畫面和疊加層擁有者之間解析。(I81413) - 介紹
View可擁有不相交父項的概念。檢視畫面的不相交父項是另一個檢視畫面,可有效做為其他檢視畫面的父項,但並非透過View.parent屬性設定。詳情請參閱說明文件。(Ib2950) - 新增 API
ViewGroupCompat#installCompatInsetsDispatch,供開發人員修正 API 30 之前存在的插邊調度問題。(I11159) - 新增
FontsContractCompat.TypefaceStyleIntDef,用於在FontsContractCompat中註解Typeface樣式。(Ib3e5b)
外部貢獻
- 淘汰了
BuildCompat.isAtLeastV。呼叫端應直接檢查SDK_INT是否為 35。感謝 Jake Wharton!(I294d1) - 在
TaskStackBuilder中新增可變動性標記。感謝 Kamal Faraj!(Ife0ec、b/371534781)
1.15 版
1.15.0 版
2024 年 10 月 30 日
發布 androidx.core:core:1.15.0、androidx.core:core-ktx:1.15.0 和 androidx.core:core-testing:1.15.0。1.15.0 版包含這些修訂版本。
1.14.0 版之後的重要變更
- 移除手動建立新平台 API 存取權大綱的功能,因為使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3 版) 時,系統會透過 API 建模自動執行這項操作,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,系統會針對所有建構作業執行這項操作。如果客戶未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
- 對相容性類別進行多項更新,確保與 Android 15 SDK 一致。
1.15.0-rc01 版
2024 年 10 月 16 日
發布 androidx.core:core:1.15.0-rc01、androidx.core:core-ktx:1.15.0-rc01 和 androidx.core:core-testing:1.15.0-rc01。1.15.0-rc01 版與前一個版本相比沒有任何異動。
1.15.0-beta01 版
2024 年 10 月 2 日
發布 androidx.core:core:1.15.0-beta01、androidx.core:core-ktx:1.15.0-beta01 和 androidx.core:core-testing:1.15.0-beta01。1.15.0-beta01 版包含這些修訂項目。
API 變更
- 在
CollectionInfoCompat中新增itemCount和importantForAccessibilityItemCount欄位。(Ibaf34)
修正錯誤
- 修正
androidx.core.os.Profiling中的說明文件問題 (I2542f)
1.15.0-alpha02 版
2024 年 8 月 21 日
發布 androidx.core:core:1.15.0-alpha02、androidx.core:core-ktx:1.15.0-alpha02 和 androidx.core:core-testing:1.15.0-alpha02。1.15.0-alpha02 版包含這些修訂項目。
重要異動
- 移除手動概述新平台 API 存取權的功能,因為使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3 版) 時,系統會透過 API 建模自動執行這項操作,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,系統會針對所有建構作業執行這項操作。如果客戶未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
API 變更
- 在可下載字型定義中新增
fallbackQueryXML 屬性,允許使用可下載字型進行字元層級備用。(Idd544) - 新增使用
ProfilingManager的輔助 API (If2292) - 新增
ActivityOptions.setPendingIntentBackgroundActivityStartMode的相容方法 (I3ba1f、b/349617674) - 新增
DisplayCutoutCompat.getCutoutPath(I58778、b/279635904) - 還原
ParcelCompat.writeBoolean的淘汰狀態,並在 API 級別 29 以上版本中委派給平台 API。(I9d243、b/313834577) - 建立採用執行器的
FontsContractCompat.requestFonts(I03016、b/302377512) - 還原
LocationCompat.isMock的淘汰狀態,並在 API 級別 31 以上版本中委派平台 API。(I55940、b/313834577) - 通知現在可標記為語音留言。(I068ab)
1.15.0-alpha01 版
2024 年 6 月 12 日
發布 androidx.core:core:1.15.0-alpha01、androidx.core:core-ktx:1.15.0-alpha01 和 androidx.core:core-testing:1.15.0-alpha01。這個版本是在內部開發分支版本中開發,與 Android 15 Beta 3 (android-35) 相容。
API 變更
- 對相容性類別進行多項更新,與 Android 15 SDK 保持一致。
1.14 版
1.14.0-alpha01 版
2024 年 5 月 1 日
發布 androidx.core:core:1.14.0-alpha01、androidx.core:core-ktx:1.14.0-alpha01 和 androidx.core:core-testing:1.14.0-alpha01。1.14.0-alpha01 版包含這些修訂項目。
新功能
- 將 androidx 程式庫的預設
minSdkVersion變更為 21 (I6ec7f)
API 變更
- 淘汰其他過時的相容方法。(Ie4470、b/313834577)
- 淘汰過時的相容方法。(I01d90、b/313834577)
- 更新
isAtLeastV(),為最終 V SDK 傳回 true。(I6339a)
1.13 版
1.13.1 版
2024 年 5 月 1 日
發布 androidx.core:core:1.13.1、androidx.core:core-ktx:1.13.1 和 androidx.core:core-testing:1.13.1。1.13.1 版包含這些修訂項目。
修正錯誤
- 修正問題:顯示手寫工具列時,無法透過手指輕觸切換至一般鍵盤 (I7f843、b/332769437)
1.13.0 版
2024 年 4 月 17 日
發布 androidx.core:core:1.13.0、androidx.core:core-ktx:1.13.0 和 androidx.core:core-testing:1.13.0。1.13.0 版包含這些修訂項目。
自 1.12.0 版以來的重要異動
- 程式庫的
minSdkVersion已提高至19。許多相容性 API 已標示為淘汰,因為只有在 API 級別 19 之前才需要這些 API。 - 我們在 Kotlin 中改寫了多個類別,以便與 Kotlin 使用者提供更佳的互通性,同時保留 Java 相容性。
- 已移除
FingerprintManagerCompat,這在 Android V 中是無作業,不應在舊版平台上使用。用戶端應立即遷移至BiometricPrompt。 - 新增
PathParser,可從 SVG 路徑字串建立 Path 例項。
1.13.0-rc01 版
2024 年 4 月 3 日
發布 androidx.core:core:1.13.0-rc01、androidx.core:core-ktx:1.13.0-rc01 和 androidx.core:core-testing:1.13.0-rc01。1.13.0-rc01 版本包含這些修訂項目。
修正錯誤
- 修正 API 30 以上版本擷取初始系統資訊列外觀的問題 (I18596、b/219993701)
1.13.0-beta01 版
March 20, 2024
發布 androidx.core:core:1.13.0-beta01、androidx.core:core-ktx:1.13.0-beta01 和 androidx.core:core-testing:1.13.0-beta01。1.13.0-beta01 版包含這些修訂項目。
API 變更
PathParser現已改為final,interpolatePathDataNodes現在會針對不相容的引數擲回例外狀況,而不是傳回boolean,nodesToPath現在屬於PathParser,而不是PathParser.PathDataNode。(I20d62)FingerprintManagerCompat已從 Android V 平台 SDK 移除,但仍保留在系統中。不久後,系統會將實作項目替換為無作業,開發人員應立即停止使用這個類別。(I7ca1b)Pool介面及其子類別SimplePool和SynchronizedPool現在以 Kotlin 編寫。儲存在集區中的物件泛型類型現在必須為非空值。(I08afe)
外部貢獻
GestureDetectorCompat現已淘汰,因為GestureDetector保證可在程式庫最低 SDK 版本的平台上使用。感謝 Jake Wharton 的貢獻。(Icc4cd)MarginLayoutParamsCompat現已淘汰,因為MarginLayoutParams保證可在平台中做為程式庫的最低 SDK 版本。感謝 Jake Wharton 的貢獻。(I4e0c3)
1.13.0-alpha05 版
2024 年 2 月 7 日
發布 androidx.core:core:1.13.0-alpha05、androidx.core:core-ktx:1.13.0-alpha05 和 androidx.core:core-testing:1.13.0-alpha05。1.13.0-alpha05 版包含此連結所列的修訂項目。
外部貢獻
- 感謝 Matthew Zavislak 更新
ContextCompat.registerReceiver說明文件,確保內容正確無誤。(8fd733)
1.13.0-alpha04 版
2024 年 1 月 24 日
發布 androidx.core:core:1.13.0-alpha04、androidx.core:core-ktx:1.13.0-alpha04 和 androidx.core:core-testing:1.13.0-alpha04。1.13.0-alpha04 版包含這些修訂項目。
新功能
- 新增
AlarmManagerCompat.canScheduleExactAlarmsAPI (I62e95、b/315440583)
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.canScheduleExactAlarmsAPI (I62e95、b/315440583)
1.13.0-alpha03 版
2024 年 1 月 10 日
發布 androidx.core:core:1.13.0-alpha03、androidx.core:core-ktx:1.13.0-alpha03 和 androidx.core:core-testing:1.13.0-alpha03。1.13.0-alpha03 版包含這些修訂項目。
API 變更
- 已淘汰
ListViewCompat,請直接使用ListView。(Iacce6、b/318353933) - 已淘汰
ViewCompat.LAYOUT_DIRECTION_API。(I51710、b/317055535) - 淘汰
ViewCompat中過時的相容方法。(I0bfc2、b/313834577)
1.13.0-alpha02 版
2023 年 11 月 29 日
發布 androidx.core:core:1.13.0-alpha02、androidx.core:core-ktx:1.13.0-alpha02 和 androidx.core:core-testing:1.13.0-alpha02。1.13.0-alpha02 版包含以下修訂項目。
新功能
- 新增
OnUserLeaveHintProvider介面,讓任何元件接收實作子母畫面所需的onUserLeaveHint事件。這是由ComponentActivity在 Activity1.9.0-alpha01中實作。(I54892)
API 變更
- 淘汰了
androidx.core.os.CancellationSignal。請改用平台提供的android.os.CancellationSignal。(Id45f6、b/309499026、b/309054079) OnMultiWindowModeChangedProvider、OnNewIntentProvider、OnPictureInPictureModeChangedProvider、OnConfigurationChangedProvider和OnTrimMemoryProvider介面已轉換為 Kotlin,確保其事件監聽器方法採用的Consumer泛型參數具有正確的可為空值性 (全部皆不可為空值)。(Ib6237)- 傳送至
Consumer的MultiWindowModeChangedInfo和PictureInPictureModeChangedInfo類別,現已新增至各自的 Provider 介面,並以 Kotlin 編寫。(Ie08e2)
依附元件更新
- Core 現在依附於 Lifecycle
2.6.2。(I2d94c)
1.13.0-alpha01 版
2023 年 10 月 18 日
發布 androidx.core:core:1.13.0-alpha01、androidx.core:core-ktx:1.13.0-alpha01 和 androidx.core:core-testing:1.13.0-alpha01。1.13.0-alpha01 版包含此連結所列的修訂項目。
API 變更
- 將
PathParser設為公開。這個類別可以從 SVG 路徑字串建立 Path 例項。(Ic7af2、b/302376846) - 新增
Context.createAttributionContext的相容性方法。(I61dcf、Ibe187) - 將
NotificationCompatSideChannelService標示為已淘汰。(I18fd9) - 用於差異動作快速滑動的新 API。(I46b0d、Ia9f68)
VelocityTracker的其他相容 API,用於追蹤平台 SDK。(I32753)
修正錯誤
- 覆寫
Person中的equals和hashCode方法。(I610a5)
1.12 版
1.12.0 版
2023 年 9 月 6 日
發布 androidx.core:core:1.12.0、androidx.core:core-ktx:1.12.0 和 androidx.core:core-testing:1.12.0。1.12.0 版包含此連結所列的修訂項目。
自 1.11.0 版以來的重要異動
- 新增許多相容性方法,讓 SDK 34 與 TextView、AccessibilityNodeInfo 等功能保持一致。
- 新的
LocalePreferencesAPI 可協助開發人員輕鬆存取語言代碼資料或使用者的語言代碼偏好設定。 - 淘汰
app.BundleCompat,改用os.BundleCompat。 - 淘汰了
BuildCompat.isAtLeastU()。改用SDK_INT >= 34。
1.12.0-rc01 版
2023 年 8 月 9 日
發布 androidx.core:core:1.12.0-rc01、androidx.core:core-ktx:1.12.0-rc01 和 androidx.core:core-testing:1.12.0-rc01,但沒有重大異動。1.12.0-rc01 版包含這些修訂項目。
1.12.0-beta01 版
2023 年 7 月 26 日
發布 androidx.core:core:1.12.0-beta01、androidx.core:core-ktx:1.12.0-beta01 和 androidx.core:core-testing:1.12.0-beta01。1.12.0-beta01 版包含以下修訂項目。
API 變更
- 在
TextViewcompat 類別中新增setLineHeight(unit, lineHeight)(Ia9fa9) - 新增 Android 14 的
TypedValueCompat.getUnitFromComplexDimension()(I958e8) - 在
TextView相容性類別中新增setLineHeight(unit, lineHeight)(Ib2ee1) - 向後移植各種 Accessibility API (Ic65ba)
- 向後移植 API 34
AccessibilityNodeInfo方法 (I44182) - 將穩定的 SDK 檢查功能從實驗階段升級 (Ia9b35)
- 向後移植
AccessiiblityWindowInfo34 API (I96a5d) - 淘汰了
BuildCompat.isAtLeastU()。請改用SDK_INT >= 34。(I4f8e7、b/289269026) - 移除實驗性
isAtLeastU()API 的用途 (Ie9117、b/289269026) - 將
BuildCompat遷移至 Kotlin,以強化 Deprecated 標記 (I56775、b/289269026) - 在
TextView相容類別中新增setLineHeight(unit, lineHeight)(I15716) - 新增
accessibilityDataSensitive相容性屬性。(I0c6e0) - 指定
FLAG_NO_CREATE時,PendingIntentCompat.getActivity和getService可能會傳回空值。(Iffdf0、b/289696515) - 更新 API 檔案,為相容性抑制加上註解 (I8e87a、b/287516207)
- 新增
PendingIntentCompat.send()(Iaf707) - 新增
Location.removeVerticalAccuracy()、Location.removeSpeedAccuracy()和Location.removeBearingAccuracy()的相容版本。(I5b640)
修正錯誤
- 如果檢視畫面有無障礙委派,則將檢視畫面設為無障礙功能的重要檢視畫面。(If2b54)
1.12.0-alpha05 版
2023 年 6 月 7 日
發布 androidx.core:core:1.12.0-alpha05、androidx.core:core-ktx:1.12.0-alpha05 和 androidx.core:core-testing:1.12.0-alpha05。這個版本是在內部分支版本中開發而成。
修正錯誤
- 更新
ColorUtils類別的說明文件,說明如何根據 Material 3 色相、彩度和色調 (M3HCT) 參數產生顏色。(I32979、I21c8c) - 修正
android.os.Trace的淘汰 replaceWith (I730f9)
1.12.0-alpha04 版
2023 年 5 月 10 日
發布 androidx.core:core:1.12.0-alpha04、androidx.core:core-ktx:1.12.0-alpha04 和 androidx.core:core-testing:1.12.0-alpha04。此版本是以內部分支版本為基礎。
1.12.0-alpha03 版
2023 年 4 月 12 日
發布 androidx.core:core:1.12.0-alpha03、androidx.core:core-ktx:1.12.0-alpha03 和 androidx.core:core-testing:1.12.0-alpha03。此版本是以內部分支版本為基礎。
API 變更
- 取消隱藏
NotificationCompat.TvExtender(aosp/01c67677e9310b2cf4c536d7e951e117d6cce64a) - 新增公開方法,用於存取 M3HCT 參數,並將 M3HCT 值轉換為 ARGB (aosp/06810598aa94bee731bbe0d277933b8b9614934e)
- 新增
NotificationManager.getCurrentInterruptionFilter(aosp/b0c6940639e35371d212a7ebd7dbf01c14fc7710) - 將
getCurrentInterruptionFilter新增至NotifManagerCompat(aosp/516143e05f824ff49bde3c0c97344a2924867d30) - 淘汰
app.BundleCompat,改用os.BundleCompat(aosp/bf6169fe9ee1113065d0cf380bd2e09f31ce0a40) - 新增
TestConsumer,讓開發人員在測試中記錄值。(aosp/f75a4913940e710842168c832a7f57c2dcae4fdf) - 新增
TestConsumer,讓開發人員可以在測試中記錄值。(aosp/67ad4e2c6488772b7c9a061ee6ca01bba23649f7)
修正錯誤
- 修正
unregisterGnssMeasurementsCallback()在 Android R 以下版本無法正常運作的錯誤。(aosp/c5a97c4ee956f87d229ec892f2b8849f392e956c)
1.12.0-alpha01 版
2023 年 3 月 8 日
發布 androidx.core:core:1.12.0-alpha01 和 androidx.core:core-ktx:1.12.0-alpha01。1.12.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 提供 API,協助開發人員輕鬆存取使用者的偏好設定或 ICU 中的語言代碼資料。可存取的語言代碼資料包括小時週期、日曆類型、溫度單位和一週的第一天。
API 變更
- 新增 API
LocalePreferences,協助開發人員輕鬆存取語言代碼資料或使用者的語言代碼偏好設定。
1.11 版
1.11.0-beta02 版
2023 年 6 月 7 日
發布 androidx.core:core:1.11.0-beta02、androidx.core:core-ktx:1.11.0-beta02 和 androidx.core:core-testing:1.11.0-beta02。1.11.0-beta02 版包含此連結所列的修訂項目。
修正錯誤
- 更新
ColorUtils類別的說明文件,說明如何根據 Material 3 色相、彩度和色調 (M3HCT) 參數產生顏色。(I32979、I21c8c) - 修正
android.os.Trace的淘汰 replaceWith (I730f9)
1.11.0-beta01 版
2023 年 5 月 24 日
發布 androidx.core:core:1.11.0-beta01、androidx.core:core-ktx:1.11.0-beta01 和 androidx.core:core-testing:1.11.0-beta01。1.11.0-beta01 版包含這些修訂項目。
API 變更
- 在
performHapticFeedback方法中新增ViewCompat支援 (Ib02c6) - 將
getDisplay變更為#getDisplayOrDefault(I96ff9) - 新增
ContextCompat#getDisplay(Context)(I7011f、b/178183326) - 新增
ContextCompat#getContextForLanguage(Context),用於在非活動情境中取得個別應用程式語言代碼 (I58e75、b/243457462)
修正錯誤
- 釐清
CollectionInfoCompat文件,尤其是isHierarchical(I14f6c)
1.11.0-alpha04 版
2023 年 5 月 10 日
發布 androidx.core:core:1.11.0-alpha04、androidx.core:core-ktx:1.11.0-alpha04 和 androidx.core:core-testing:1.11.0-alpha04。1.11.0-alpha04 版包含這些修訂項目。
API 變更
- 新增
LinkMovementMethodCompat,修正連結觸控處理 (Ia632c) PendingIntent.getBroadcast()現已正確標示@Nullable(Ifff96、b/277630907)
修正錯誤
- 修正
DisplayManagerCompat中的 Context 洩漏問題 (I3409b、b/279625765) - 新增
SoftwareKeyboardControllerCompat,提供直接方法,可顯示及隱藏指定 View 的螢幕鍵盤。這項功能可針對在某些 API 級別使用WindowInsetsControllerAPI 時發生的已知問題,提供回溯移植的解決方法,並擷取WindowInsetsControllerCompat.show的支援實作,以及隱藏輸入法編輯器插邊類型。(Idd0a3)
1.11.0-alpha03 版
2023 年 4 月 19 日
發布 androidx.core:core:1.11.0-alpha03、androidx.core:core-ktx:1.11.0-alpha03 和 androidx.core:core-testing:1.11.0-alpha03。1.11.0-alpha03 版包含這些修訂版本。
API 變更
- 更新
BuildCompat,為 Android 14 Beta 2 做好準備 (Idc1b1、b/276491001) - 取消隱藏
NotificationCompat.TvExtender(Ibe13a) - 新增公開方法,用於存取 M3HCT 參數,並將 M3HCT 值轉換為 ARGB (Id7e9d)
1.11.0-alpha02 版
2023 年 4 月 5 日
發布 androidx.core:core:1.11.0-alpha02、androidx.core:core-ktx:1.11.0-alpha02 和 androidx.core:core-testing:1.11.0-alpha02。1.11.0-alpha02 版包含以下修訂項目。
API 變更
- 將
getCurrentInterruptionFilter新增至NotifManagerCompat(I8ec95、b/243183646) - 淘汰
app.BundleCompat,改用os.BundleCompat(Idc3a2、b/274577000) - 新增
TestConsumer,讓開發人員在測試中記錄值。(I937c1)
修正錯誤
- 修正
unregisterGnssMeasurementsCallback()在 Android R 以下版本無法正常運作的錯誤。(Id1999)
1.11.0-alpha01 版
2023 年 3 月 22 日
發布 androidx.core:core:1.11.0-alpha01 和 androidx.core:core-ktx:1.11.0-alpha01。1.11.0-alpha01 版包含以下修訂項目。
API 變更
- 在 Android U 中,
getType的ContentProviderAPI 要求呼叫端必須具備正確的讀取的權限。FileProvider現在提供預設的getTypeAnonymous實作,也就是不受限制的版本。(I4773f) - 新增內容擷取 API 的相容性類別 (I09366)
- 新增
NotifCompat.Builder.setLargeIcon(Icon)(Ic0a5b) - 在
NotificationManagerCompat中新增批次通知 API。建議使用者在發布多則通知時使用這個 API。(I2cd7f) - 在 R 之前的平台上新增
registerGnssMeasurementsCallback(),並支援執行工具 (I579f8)
1.10 版
1.10.1 版本
2023 年 5 月 10 日
發布 androidx.core:core:1.10.1 和 androidx.core:core-ktx:1.10.1。1.10.1 版包含以下修訂項目。
外部貢獻
- 修正結果為空值時擲回
BadParcelableException的問題 (b/277434277、b/278118318,由 Mygod Studio 提供)
1.10.0 版本
2023 年 4 月 5 日
發布 androidx.core:core:1.10.0 和 androidx.core:core-ktx:1.10.0。1.10.0 版包含以下修訂項目。
自 1.9.0 版以來的重要變更
- 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援 OS 版本,這項變更的成效差異都是微不足道。(I0a961)
- 為 SDK 擴充功能版本新增
BuildCompat常數。(I6084c) - 如要瞭解新 API 和錯誤修正,請參閱 1.10.0 預先發布版的版本資訊。
1.10.0-rc01 版
2023 年 3 月 8 日
發布 androidx.core:core:1.10.0-rc01 和 androidx.core:core-ktx:1.10.0-rc01,此兩版與上一個 Beta 版沒有差別。
1.10.0-beta01 版
2023 年 2 月 22 日
發布 androidx.core:core:1.10.0-beta01 和 androidx.core:core-ktx:1.10.0-beta01。1.10.0-beta01 版包含以下修訂項目。
API 變更
set/getMinMillisBetweteenContentChanges的AccessibilityNodeInfoCompatAPI 已重新命名為set/getMinDurationBetweenContentChanges,且在使用期間採用long。(f46689)- 新增
NotificationCompat.bigLargeIcon(Icon)(I60855)
修正錯誤
- 修正
NotificationCompat.Builder.setShowWhen()預設值的相關文件 (ba52a2) - 修正
AccelerateInterpolator / DecelerateInterpolator文件中的錯字 (2173505) - 修正
ShortcutInfoCompat文件中的錯字 (44075f) - 使用
NestedScrollView和CoordinatorLayout修正向上、向下、空格鍵和按鍵變化版本的鍵盤動作 (bdd72e)
1.10.0-alpha02 版
2023 年 1 月 25 日
發布 androidx.core:core:1.10.0-alpha02 和 androidx.core:core-ktx:1.10.0-alpha02。1.10.0-alpha02 版包含以下修訂項目。
API 變更
- 為
AD_SERVICES擴充功能版本新增BuildCompat常數 (I51d98) - 在
WindowInsetsControllerCompat中新增BEHAVIOR_DEFAULT。淘汰BEHAVIOR_SHOW_BARS_BY_SWIPE和BEHAVIOR_SHOW_BARS_BY_TOUCH。(I17b61)
1.10.0-alpha01 版
2023 年 1 月 11 日
發布 androidx.core:core:1.10.0-alpha01 和 androidx.core:core-ktx:1.10.0-alpha01。1.10.0-alpha01 版包含以下修訂項目。
API 變更
- 將
CallStyle新增至NotificationCompat(Id9a53、b/199294989) - 為 SDK 擴充功能版本新增
BuildCompat常數 (I6084c) - 新增用於在無障礙節點上設定初始焦點的 API。(Id199a)
- 新增用於限制內容變更頻率的 API (If4ea0)
- 針對 Android 13 中推出的 Parcel、Bundle 和 Intent 相關 API 新增相容性方法。部分
ParcelCompat方法簽章已更新,可能需要變更來源,才能升級確認新的簽章。(I57e94、b/242048899) - 淘汰無障礙功能物件的回收作業。我們發現即使是最舊的受支援版本,這項變更的成效差異都是微不足道。(I0a961)
- 針對已淘汰的隱藏函式,更新其傳回類型是否可為空值 (Ibf7b0)
- 新增 Point 和 PointF 的乘法/除法運算子超載 (I8e557、b/261574780)
修正錯誤
1.9 版
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 相容。
1.8 版
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使用時無法執行 - 修正問題:
TypefaceCompat在 API 29 以上版本會套用不正確的字體粗細 (b/194553426),感謝 RikkaW 提出的錯誤
1.8.0-rc02 版
2022 年 5 月 18 日
發布 androidx.core:core:1.8.0-rc02 和 androidx.core:core-ktx:1.8.0-rc02。1.8.0-rc02 版包含以下修訂項目。
修正錯誤
- 將
OnSharedElementsReadyListener投放到完整的平台類別,以免發生ClassCastException(0029fed)
1.8.0-rc01 版
2022 年 5 月 11 日
發布 androidx.core:core:1.8.0-rc01 和 androidx.core:core-ktx:1.8.0-rc01。1.8.0-rc01 版包含以下修訂項目。
API 變更
- 為下一個預先發布週期新增
BuildCompat檢查 (If5a8f、b/229859122) - 為最終 SDK_INT 值更新
BuildCompat.isAtLeastT()。(Iffae0)
1.8.0-beta01 版
2022 年 4 月 20 日
發布 androidx.core:core:1.8.0-beta01 和 androidx.core:core-ktx:1.8.0-beta01,且自 1.8.0-alpha07 版以來皆無異動。1.8.0-beta01 版包含以下修訂項目。
1.8.0-alpha07 版
2022 年 4 月 6 日
發布 androidx.core:core:1.8.0-alpha07 和 androidx.core:core-ktx:1.8.0-alpha07。1.8.0-alpha07 版包含以下修訂項目。
修正錯誤
- 在 API 29 以上級別中,
TypefaceCompat現在會遵循要求及載入的樣式資訊。這是當載入的字型不是FontWeight.Normal或FontWeight.Bold時的行為變更,因為系統會使用實際載入的字體粗細和樣式。(#212、b/194553426)
外部貢獻
1.8.0-alpha06 版
2022 年 3 月 23 日
發布 androidx.core:core:1.8.0-alpha06。1.8.0-alpha06 版包含以下修訂項目。
API 變更
MenuProvider介面現在包含onPrepareMenu()回呼,供選單進行動態修改且應該顯示時呼叫。(Ie85f9)MenuProvider介面現在包含onMenuClosed()方法,隨時可用於關閉選單。(If5a16)- 更新
IconCompat#getResId,提供正確的資源註解類型,以符合Icon#getResId架構中對應的方法 (I49700)。 - 還原
WindowInsetsControllerCompat之前僅依賴 View 的變更,現在改回需要 Window 來管理某些視窗標記。淘汰ViewCompat.getWindowInsetsController並改用WindowCompat.getInsetsController,確保使用正確的 Window (例如 View 在對話方塊內)。(I660ae、b/219572936) - 根據 Tiramisu DP2 (I0cbb7) 更新核心和應用程式是否可為空值的作法
- 為
BitmapCompat新增方法,讓點陣圖縮小作業更為流暢。(Ib706c) - 為
ActivityCompat.requestDragAndDropPermissions新增是否可為空值註解 (I0f2b0、b/206113378) - 為
FileProvider新增解決方法,方便原始設備製造商 (OEM) 從資訊清單中去除中繼資料。(I82f63)
修正錯誤
- 在無障礙功能窗格瀏覽權限狀態為 <P 的情況下,將父項的瀏覽權限變更納入考量 (I8e04f)
1.8.0-alpha05 版
2022 年 2 月 23 日
發布 androidx.core:core:1.8.0-alpha05 和 androidx.core:core-ktx:1.8.0-alpha05。1.8.0-alpha05 版包含以下修訂項目。
API 變更
- 更新了 androidx.core.os 類別的可空值性 (If18cd、b/206113622)
- 更新了 androidx.core.app 類別的可空值性 (I657eb、b/206113302)
- 更新了 androidx.core.text 類別的可空值性 (I08329、b/206113384)
- 將
ExtraData函式新增至AccessibilityNodeInfoCompat(If2fc7、b/137789185) - 為
bundleOf()新增零引數超載,避免在建立空白套件時發生不可見的陣列配置 (If7089) - 新增
Continuation<T>.asFoo()轉接程式來建立回呼,用於為可接受常見/一般回呼類型的 Android API 編寫暫停包裝函式 (I6615e) - 新增可為空值的
Drawable.toBitmapOrNull方法,避免例外狀況 (I2342a)
1.8.0-alpha04 版
2022 年 2 月 9 日
發布 androidx.core:core:1.8.0-alpha04 和 androidx.core:core-ktx:1.8.0-alpha04。1.8.0-alpha04 版包含以下修訂項目。
API 變更
- 新增
OnPictureInPictureModeChangedProvider介面,讓任何元件接收子母畫面模式變更事件。這是由ComponentActivity在 Activity1.5.0-alpha02中實作。(I9f567) - 新增
OnMultiWindowModeChangedProvider介面,讓任何元件接收多視窗模式變更事件。這是由ComponentActivity在 Activity1.5.0-alpha02中實作。(I62d91) - 清除部分 androidx.core API 的可為空值性。(Ia0e2f、b/206113818)
1.8.0-alpha03 版
2022 年 1 月 26 日
發布 androidx.core:core:1.8.0-alpha03 和 androidx.core:core-ktx:1.8.0-alpha03。1.8.0-alpha03 版包含以下修訂項目。
API 變更
- 將
WindowInsetsControllerCompat轉換為依附於 View,而非 Window 或平台WindowInsetsController。這可改善 Dialog 的行為、顯示輸入法編輯器,並確保未淘汰的建立方法可以解決問題 (b/180881870)。(I29264、b/207401542、b/210121779) - 清除部分 androidx.core API 的可為空值性。(Ib2583、b/206113818)
- 修正
performAccessibilityAction參數的可為空值性 (Ibbafe) - 新增解決
ColorStateList問題的方法,此問題是以 Theme 為鍵的快取和 Theme.applyStyle 所造成 (I9188b、b/207739887) - 更新捷徑瀏覽權限 API,以提高可讀性 (Ia58df)
- 為
persistableBundleOf()新增零引數超載,避免在建立空白 PersistableBundle 時進行不必要的陣列配置 (Icd7a4)
1.8.0-alpha02 版
2021 年 12 月 15 日
發布 androidx.core:core:1.8.0-alpha02 和 androidx.core:core-ktx:1.8.0-alpha02。1.8.0-alpha02 版包含以下修訂項目。
API 變更
- 為日後的 SDK 新增實驗性
BuildCompat方法 (Iafd82、b/207528937) - 新增公用程式方法,可用於將文件轉換為捷徑,反之亦然。(Id512c)
- 更新捷徑瀏覽權限 API,以提高可讀性 (I86dec)
- 新增
OnNewIntentProvider、OnConfigurationChangedProvider和onTrimMemoryProvider介面,用來表示您的自訂活動可將這些事件分派到可新增事件監聽器的任何元件。(If1f8b、If623b、Ia9295)
1.8.0-alpha01 版
2021 年 12 月 1 日
發布 androidx.core:core:1.8.0-alpha01 和 androidx.core:core-ktx:1.8.0-alpha01。1.8.0-alpha01 版包含以下修訂項目。
API 變更
- 大量清除可空值性的註解
- 新增了 API
ShortcutInfoCompat.Builder#setHiddenFromLauncher,用來指定是否要在啟動器中隱藏捷徑。(Ia2a71) - 新增
NotificationCompat.Action#setAuthenticationRequired(Ieeafa、b/202172887) - 新增
NotificationCompat.BigPictureStyle.setContentDescription(I3b483) - 新增擴充功能函式
Map<String, Any?>.toPersistableBundle()(I82c86)
修正錯誤
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)
1.6 版本
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 變更
- 新增
Handler.hasCallbacks()方法,與平台 SDK 保持一致 (Idce1c、b/113855676) - 對
ShortcutInfoCompat.Builder新增功能相關的 setter 方法 (I45af6)
1.5 版本
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和WindowInsetsCompatAPI 以便控制系統資訊列的外觀 - 更新了
ActivityCompat.recreate(),以便在任何 API 級別從任何生命週期狀態安全地進行呼叫 - 新增了 API,可透過
EditorInfoCompat提供及擷取初始周圍文字,讓輸入法編輯器應用程式能避免額外的處理序間通訊 (IPC) 延遲問題。 - 進行多項更新,以改善與平台 SDK API 的一致性
1.5.0-rc02 版
2021 年 5 月 5 日
發布 androidx.core:core:1.5.0-rc02 和 androidx.core:core-ktx:1.5.0-rc02。1.5.0-rc02 版包含此連結所列的修訂項目。
修正錯誤
- 針對版本小於 30 的 SDK 開始支援 setSystemBarsBehavior。(I062c8、b/173203649)
1.5.0-rc01 版
2021 年 3 月 24 日
發布 androidx.core:core:1.5.0-rc01 和 androidx.core:core-ktx:1.5.0-rc01。1.5.0-rc01 版包含以下修訂項目。
摘要
- 先前的 beta03 版沒有任何變更
1.5.0-beta03 版
2021 年 3 月 10 日
發布 androidx.core:core:1.5.0-beta03 和 androidx.core:core-ktx:1.5.0-beta03。1.5.0-beta03 版包含以下修訂項目。
API 變更
- 新增了 ExecutorCompat,可從 Handler 建立 Executor。(Ib4ca3、b/181237835)
1.5.0-beta02 版
2021 年 2 月 24 日
發布 androidx.core:core:1.5.0-beta02 和 androidx.core:core-ktx:1.5.0-beta02。1.5.0-beta02 版包含以下修訂項目。
修正錯誤
- 淘汰
ModeCompat.isNative,改為使用DisplayCompat.getMode。(Iefa71) NotificationCompat.MessagingStyle.getText()之前被誤標為@NonNull;目前已更正為@Nullable(I05cb7)
1.5.0-beta01 版
2021 年 1 月 13 日
發布 androidx.core:core:1.5.0-beta01 和 androidx.core:core-ktx:1.5.0-beta01。1.5.0-beta01 版本包含這些修訂版本。
API 變更
- 遵循關於邊界相容性/平台互通性的 API 指南 (I7da35)
- 將 AppCompatEditText 中的拖曳-放置 (放置事件) 和 OnReceiveContentListener 整合。(Ib26c9、b/175343405)
- 連接新的 Insets Animation API 和 Platform 實作 (I078da)
- 新增了 Insets Animation API (I8aebd)
- 更新了 OnReceiveContentListener 和相關 API:
- 更新了 OnReceiveContentListener,即可透過 ViewCompat 在任何類型的檢視區塊中設定這項方法。
- 已從
OnReceiveContentListener中移除getSupportedMimeTypes();現在,MIME 類型將在設定事件監聽器的ViewCompat方法上作為附加引數傳遞。 - 對物件中的
OnReceiveContentListener.onReceiveContent()提供包裝引數。 - 在
onReceiveContent()中新增 linkUri 參數,確保與鍵盤圖片 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) - 向後移植
WindowInsetsControllerAPI 以便控制系統資訊列的外觀。(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 版包含以下修訂項目。
新功能
WindowInsetsCompatAPI 已更新為 Android 11 平台的版本。這包括新的ime()插邊類型,用於檢查螢幕小鍵盤的顯示設定和大小。ime()類型的注意事項:當 Activity 採用adjustResize視窗軟輸入模式時,這項類型可以在 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) - 新增
MailToAPI,可為所有 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。
1.4 版
1.4.0-alpha01 版
2020 年 5 月 20 日
發布 androidx.core:core:1.4.0-alpha01 和 androidx.core:core-ktx:1.4.0-alpha01。1.4.0-alpha01 版本包含這些修訂版本。
API 變更
- 新增用於插入多媒體內容 (例如貼上圖片) 的通用 API。新回呼提供單一 API,應用程式可透過實作這個 API 支援以各種方式插入多媒體內容。目前這個 API 僅新增至
AppCompatEditText,而且可在下列程式碼路徑中叫用:- 從剪貼簿貼上
- 從輸入法編輯器插入內容 (
InputConnection.commitContent) (I22bf7)
- 向後移植
android.os.Process.isApplicationUid(int),協助應用程式判斷程式碼是否在獨立程序中執行 (I4c83a、b/153014822) - 向後移植
LocusId,可讓應用程式連結不同子系統之間的狀態,例如內容擷取、捷徑和通知。(Ia3129) - 對 ViewGroup 新增了祖系序列 (I5f75c、b/117976097)
修正錯誤
- 新增了
ActivityCompat.requestPermissions()的權限驗證 (I372cc、b/122163323) - 擷取 28 以上版本的呼叫,成為一個獨立的靜態類別;這可修正在建構應用程式套件時,
View#OnUnhandledKeyEventListener發生的NoClassDefFoundError錯誤 (Id3419、b/153695093) - 修正
setChronometerCountDown當機錯誤 (I47282、b/145770610)
1.3 版本
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)
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)
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 版以來的重大異動
- 新增
NestedScrollViewAPI,可在指定時間內執行順暢捲動 - 新增
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 變更
- 新增
NestedScrollViewAPI,可在指定時間內執行順暢捲動 - 新增
ViewCompatAPI,可用於擷取分派給檢視區塊階層的原始視窗插邊
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 變更
- 新增了
NotificationCompatAPI,可將通知執行個體設為靜音 - 新增了
ResourcesCompat.NULL_ID - 淘汰了
NotificationCompat中的CarExtender.UnreadConversation - 新增了
DisplayCompatAPI,可用於取得裝置實際大小
修正錯誤
- 改善了
NotificationCompat中沒有圖示的處理操作 - 修正問題:API 級別 23 中,TextView 相對於複合可繪項目的可繪項目著色狀況 (aosp/1172194)
- 確保基礎結構定義一律為包裝函式
- 修正了 RecyclerView 在預設情況下不應填入 Collection[Item]Info 的問題
1.2 版本
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 版本
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,並做出以下變更。為配合 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,但取得原始顏色。
1.0 版本
1.0.2 版
2019 年 5 月 7 日
發布 androidx.core:core:1.0.2 和 androidx.core:core-ktx:1.0.2。這個版本包含 2 項修訂。
初始版的 AndroidX 破壞了支援資料庫 compat API 的回溯相容性,這些 API 用於處理序間通訊,並以套件形式傳送鍵控資料。這個版本修正了這項相容性問題,並且恢復使用支援資料庫 28.0 (或更早版) 與 AndroidX 1.1 (或之後版) 建構的程式碼之間的通訊。
修正錯誤
- 在 InputConnectionCompat 中使用 1.0 之前版本的字串值 (aosp/948725)
- 使用 AndroidX 之前版本的字串,做為套件金鑰的後援互通性選項 (aosp/938269)
1.0.1 版
2018 年 11 月 7 日
修正 core-1.0.1 和 appcompat-1.0.2 的版本錯誤。
修正錯誤
- 修正錯誤:
PrecomputedTextCompat與 RTLAppCompatTextView搭配使用時會異常終止。b/113070424
Core-Ktx 1.0.1 版
2018 年 11 月 5 日
androidx.core-ktx 1.0.1 發布,並修正以下錯誤:
- 修正聯集和交集實作發生交換的錯誤。
Core-google-shortcuts
1.2 版本
1.2.0-alpha01 版本
2023 年 7 月 26 日
發布 androidx.core:core-google-shortcuts:1.2.0-alpha01。查看 1.2.0-alpha01 版的修訂項。
API 變更
- 合併 a、b、c 路徑的公開和實驗性 API 檔案 (I8cfee、b/278769092)
- 遷移
androidx.core群組,改用合併的公開 API 檔案 (Ifdef4、b/278769092)
1.1 版本
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 為基礎的圖示建立索引。
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-Performance
1.0 版本
1.0.0 版
2024 年 1 月 10 日
發布 androidx.core:core-performance:1.0.0、androidx.core:core-performance-play-services:1.0.0 和 androidx.core:core-performance-testing:1.0.0。1.0.0 版包含此連結所列的修訂項目。
1.0.0 的主要功能
- 核心效能:提供可靠的機制,方便開發人員在執行階段識別裝置的效能等級,進而提供最佳的應用程式使用者體驗。
- Core Performance Play 服務:Google 專屬實作,為測試裝置和 OS 版本提供最新媒體效能類別資訊。
- Core Performance 測試:Core Performance 的測試替身。
修正錯誤
- 修正
1.0.0-beta2版本中初始化PlayServicesDevicePerformance時發生的當機問題。(b/318803680)
1.0.0-rc01 版
2023 年 12 月 13 日
發布 androidx.core:core-performance:1.0.0-rc01、androidx.core:core-performance-play-services:1.0.0-rc01 和 androidx.core:core-performance-testing:1.0.0-rc01。1.0.0-rc01 版包含以下修訂項目。
新功能
- Core Performance:更新程式庫實作。(
DevicePerformance通用實作)。 - Core Performance Play 服務 - 初始程式庫實作。(Google 專屬
DevicePerformance實作)。 - 核心效能測試 - 初始程式庫實作。(包含 Core Performance 的測試替身)。
API 變更
DevicePerformance專屬 API 的初始候選版本。
1.0.0-beta02 版
2023 年 10 月 4 日
發布 androidx.core:core-performance:1.0.0-beta02、androidx.core:core-performance-play-services:1.0.0-beta02 和 androidx.core:core-performance-testing:1.0.0-beta02。1.0.0-beta02 版包含此連結所列的修訂項目。
新功能
- 測試相關重構。
API 變更
- API 使用模式不變。
1.0.0-beta01 版
2023 年 9 月 6 日
發布 androidx.core:core-performance:1.0.0-beta01、androidx.core:core-performance-play-services:1.0.0-beta01 和 androidx.core:core-performance-testing:1.0.0-beta01。1.0.0-beta01 版本包含以下修訂項目。
新功能
- Core Performance:更新程式庫實作。(
DevicePerformance通用實作)。 - Core Performance Play 服務 - 初始程式庫實作。(Google 專屬
DevicePerformance實作)。 - 核心效能測試 - 初始程式庫實作。(包含 Core Performance 的測試替身)。
API 變更
DevicePerformance專屬 API 的初始 Beta 版。
1.0.0-alpha03 版本
2023 年 8 月 23 日
發布 androidx.core:core-performance:1.0.0-alpha03、androidx.core:core-performance-play-services:1.0.0-alpha03 和 androidx.core:core-performance-testing:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。
新功能
core-performance-testing的初始程式庫實作,包含核心效能的測試替身。- 初始程式庫實作或
core-performance-play-services。Google 專屬實作項目會提供最新的媒體效能類別資訊。
API 變更
- 新增選用模組,提供 Google Play 服務的媒體效能等級。
- core-performance 建構函式已變更,可支援選用實作。
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-Remoteviews
1.1 版本
1.1.0 版本
2024 年 6 月 12 日
發布 androidx.core:core-remoteviews:1.1.0。1.1.0 版包含這些修訂項目。
自 1.0.0 版以來的重要變更
- Core
RemoteViews移至 1.1.0 穩定版。
1.1.0-rc01 版本
2024 年 5 月 14 日
發布 androidx.core:core-remoteviews:1.1.0-rc01。1.1.0-rc01 版本包含這些修訂項目。
新功能
- 將
RemoteViews1.1.0 移至候選版。
修正錯誤
- 將 androidx 程式庫的預設
minSdkVersion移至 21。(I6ec7f)
1.1.0-beta02 版
2024 年 4 月 17 日
發布 androidx.core:core-remoteviews:1.1.0-beta02。自上次發布以來沒有重大異動。
1.1.0-beta01 版本
2024 年 4 月 3 日
發布 androidx.core:core-remoteviews:1.1.0-beta01。1.1.0-beta01 版包含這些修訂項目。
1.1.0-alpha01 版本
2024 年 2 月 7 日
發布 androidx.core:core-remoteviews:1.1.0-alpha01。1.1.0-alpha01 版包含以下修訂項目。
新功能
- 提高版本號碼,以符合依附元件版本。
1.0 版本
1.0.0 版
2023 年 9 月 6 日
發布 androidx.core:core-remoteviews:1.0.0。1.0.0 版包含此連結所列的修訂項目。
1.0.0 的主要功能
- 將 core-remoteviews 移至穩定版 1.0.0
1.0.0-beta04 版
2023 年 5 月 10 日
發布 androidx.core:core-remoteviews:1.0.0-beta04。1.0.0-beta04 版包含此連結所列的修訂項目。
修正錯誤
- 修正相容性程式庫中極端情況下擲回
ArrayOutOfBoundsException的問題。
1.0.0-beta03 版
2022 年 10 月 5 日
發布了 androidx.core:core-remoteviews:1.0.0-beta03。1.0.0-beta03 版包含此連結所列的修訂項目。
新功能
- 沒有新增任何功能。
1.0.0-beta02 版
2022 年 8 月 10 日
發布 androidx.core:core-remoteviews:1.0.0-beta02。查看 1.0.0-beta02 版的修訂項。
修正錯誤
- 版本修正
1.0.0-beta01 版
2019 年 6 月 29 日
發布了 androidx.core:core-remoteviews:1.0.0-beta01。1.0.0-beta01 版包含此連結所列的修訂項目。
新功能
- 將
Core-RemoteViews遷移至 Beta 版。
1.0.0-alpha03 版
2022 年 2 月 23 日
發布了 androidx.core:core-remoteviews:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。
修正錯誤
- 修正基礎結構。
1.0.0-alpha02 版
2022 年 1 月 26 日
發布了 androidx.core:core-remoteviews:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。
1.0.0-alpha01 版
2021 年 12 月 15 日
發布 androidx.core:core-remoteviews:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 新的
RemoteViews.setRemoteAdapterAPI 向後移植。 - Kotlin 擴充功能函式,可用於呼叫
RemoteViews方法時避免出現反射。 - 具有輔助函式的程式庫,用於處理
App Widget大小調整 API。
Core-Splashscreen
1.2 版本
1.2.0 版本
2025 年 11 月 5 日
發布 androidx.core:core-splashscreen:1.2.0。1.2.0 版包含以下修訂項目。
1.2.0-rc01 版本
2025 年 7 月 2 日
發布 androidx.core:core-splashscreen:1.2.0-rc01。1.2.0-rc01 版包含這些修訂版本。
1.2.0-beta02 版
2025 年 4 月 23 日
發布 androidx.core:core-splashscreen:1.2.0-beta02。1.2.0-beta02 版包含這些修訂項目。
1.2.0-beta01 版本
2025 年 2 月 26 日
發布 androidx.core:core-splashscreen:1.2.0-beta01。1.2.0-beta01 版包含這些修訂項目。
1.2.0-alpha02 版本
2024 年 9 月 4 日
發布 androidx.core:core-splashscreen:1.2.0-alpha02。1.2.0-alpha02 版包含這些修訂項目。
修正錯誤
- 在
SplashScreen的主題中新增isLightTheme屬性 (I01000、b/238522114) - 透過
AppCompatResources取得啟動畫面圖示 (Ib05e、b/289242141、b/263972037) - 移除手動概述新平台 API 存取權的功能,因為使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3 版) 時,系統會透過 API 建模自動執行這項操作,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,系統會針對所有建構作業執行這項操作。如果客戶未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
1.2.0-alpha01 版本
2024 年 4 月 17 日
發布 androidx.core:core-splashscreen:1.2.0-alpha01。1.2.0-alpha01 版包含這些修訂項目。
修正錯誤
- 自第 30 版起,將
Base.Theme.SplashScreen的挖孔模式變更為一律顯示。(Idfc3f) - 將
enforceNavigationBarContrast重設為 API 31 的系統預設值,避免啟動畫面主題破壞活動主題。從 API 31+ 開始,啟動畫面不會建立為PhoneWindow,因此不需要從 API 29 沿用值。此外,也請從applyAppSystemUiTheme中移除覆寫動作,因為enforceNavigationBarContrast可能已在啟動期間從應用程式端變更,因此從屬性覆寫沒有意義。(Ic2cd9) - 設定預設的淺色導覽列,並根據白天/夜間主題調整。因此,在 API 33 以上版本的平台上,啟動畫面主題不會在移除啟動畫面時造成閃爍。(I8023a)
- 從 API 33 接收啟動畫面檢視畫面後,請勿覆寫活動主題。(I10587b)
1.1 版本
1.1.0-rc01 版本
2024 年 4 月 3 日
發布 androidx.core:core-splashscreen:1.1.0-rc01。1.1.0-rc01 版本包含這些修訂項目。
修正錯誤
- 為具有 48x48dp 圖示的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)
- 修正
SplashScreenView#getIconView導致 NPE 異常終止的問題 (6abfd6、b/243457485)
1.1.0-alpha02 版本
2023 年 9 月 6 日
發布 androidx.core:core-splashscreen:1.1.0-alpha02。1.1.0-alpha02 版本包含以下修訂項目。
修正錯誤
- 為具有 48x48dp 圖示的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)
依附元件更新
- Core-Splashscreen 現在會根據 API 34 進行編譯。
1.1.0-alpha01 版本
2023 年 2 月 22 日
發布 androidx.core:core-splashscreen:1.1.0-alpha01。這是在內部分支版本中開發而成。
修正錯誤
- 修正
SplashScreenView#getIconView傳回空值時的NullPointerException。(e231ab)
1.0 版本
1.0.1 版
2023 年 4 月 19 日
發布 androidx.core:core-splashscreen:1.0.1。1.0.1 版包含以下修訂項目。
修正錯誤
- 為具有 48x48dp 圖示的 Wear 裝置提供預設尺寸 (Ib8de8、b/256678037)
1.0.0 版
2022 年 7 月 27 日
Core Splashscreen 程式庫將新的 Android 12 啟動畫面提供給所有搭載 API 23 的裝置。只要使用啟動畫面程式庫,應用程式就不需任何自訂 SplashScreen Activity,且可利用正確的 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為新的 啟動畫面 API 提供回溯相容性。這個 Alpha 版包含所有向後移植至 API 23 的新 API (圖示背景除外)。- 如要瞭解使用資訊,請參閱
androidx.core.splashscreen中的 KDocs。
Core-Animation 和 Core-Animation-Testing
1.0 版本
1.0.0 版
2024 年 5 月 1 日
發布 androidx.core:core-animation:1.0.0 和 androidx.core:core-animation-testing:1.0.0。1.0.0 版包含這些修訂項目。
1.0.0 的主要功能
androidx.core:core-animation 是向後移植的 Animator API,包含自 API 級別 14 以來新增至平台的所有功能。其中值得注意的功能包括:
ValueAnimator#pause、ValueAnimator#resume(API 級別 19)ObjectAnimator.ofMultiInt、ObjectAnimator.ofMultiFloat(API 級別 21)ValueAnimator#setCurrentFraction(API 級別 22)AnimatorSet#setCurrentPlayTime(API 級別 26)androidx.core:core-animation-testing可讓開發人員以決定性方式測試 Animator。詳情請參閱AnimatorTestRule。
1.0.0-rc01 版
2023 年 7 月 26 日
發布 androidx.core:core-animation:1.0.0-rc01、androidx.core:core-animation-testing:1.0.0-rc01 和 androidx.core:core-remoteviews:1.0.0-rc01。1.0.0-rc01 版包含以下修訂項目。
新功能
RemoteViews在 Beta 版中穩定後,移至 rc01。
1.0.0-beta01 版
2022 年 4 月 20 日
androidx.core:core-animation:1.0.0-beta01 發布,且自 1.0.0-alpha02 版以來皆無異動。1.0.0-beta01 版包含此連結所列的修訂項目。
Core-Animation Core-Animation-Testing 1.0.0-alpha02 版
2020 年 8 月 19 日
發布 androidx.core:core-animation:1.0.0-alpha02 和 androidx.core:core-animation-testing:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。
修正錯誤
- 修正單一屬性具有多個 Animator 的 AnimatorSet。(aosp/1351310)
Core-Animation 1.0.0-alpha01 版
2020 年 4 月 15 日
發布 androidx.core:core-animation:1.0.0-alpha01 和 androidx.core:core-animation-testing:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。
新功能
androidx.core:core-animation 是向後移植的 Animator API,包含自 API 級別 14 以來新增至平台的所有功能。其中值得注意的功能包括:
ValueAnimator#pause、ValueAnimator#resume(API 級別 19)ObjectAnimator.ofMultiInt、ObjectAnimator.ofMultiFloat(API 級別 21)ValueAnimator#setCurrentFraction(API 級別 22)AnimatorSet#setCurrentPlayTime(API 級別 26)androidx.core:core-animation-testing可讓開發人員以決定性方式測試 Animator。詳情請參閱 AnimatorTestRule。
Core-Backported-Fixes
1.0 版本
1.0.0 版
2025 年 12 月 17 日
發布 androidx.core:core-backported-fixes:1.0.0。1.0.0 版包含這些修訂項目。
1.0.0-rc01 版
2025 年 12 月 3 日
發布 androidx.core:core-backported-fixes:1.0.0-rc01。1.0.0-rc01 版本包含這些修訂版本。
修正錯誤
- 修正 KI_452390376 說明文件中的程式碼連結 (I9a554、b/454020407)
1.0.0-beta02 版
2025 年 11 月 5 日
發布 androidx.core:core-backported-fixes:1.0.0-beta02。1.0.0-beta02 版包含這些修訂項目。
API 變更
- 新增已知問題 b/452390376 (自動曝光模式低光源強化 (LLB)) 無法在 Pixel 10 裝置上用於 VIDEO_CALL 等串流用途。(Iba480、b/452390376)
修正錯誤
- 將特定 Pixel 版本標示為已修正。(I4c751、b/398591036)
- 新增支援功能,可為 KnownIssue 指定手動測試的建構指紋清單。(Iea9f9、b/453691379)
1.0.0-beta01 版
2025 年 9 月 24 日
發布 androidx.core:core-backported-fixes:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。
1.0.0-alpha01 版
2025 年 8 月 13 日
發布 androidx.core:core-backported-fixes:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。
新功能
Core Backported Fixes 程式庫可讓您檢查裝置是否已套用重大錯誤修正。這項功能非常實用,因為修正錯誤可能需要很長時間才能發布到所有裝置,而這個 API 可讓您知道何時可以安全使用依賴修正的功能。
val fixManager = BackportedFixManager() if (fixManager.isFixed(KnownIssues.KI_1234)) { Offer_experience_that_needs_fix() } else { Offer_experience_that_avoids_the_bug() }
這個版本包含
KnownIssues.KI_398591036:在部分 Pixel 裝置上拍攝JPEG-R圖片時,色調異常。在這個已知問題解決前,請使用JPEG輸出內容修正。
Core-i18n
1.0 版本
1.0.0 版
2025 年 4 月 9 日
發布 androidx.core:core-i18n:1.0.0。
這個元件可讓您更輕鬆地建立適當國際化的應用程式,主要著重於兩個方面:
- 日期和時間格式設定功能,遵循目前的最佳做法,遵循使用者自訂設定,並提供可在新舊 Android 版本上正常運作的統一 API。
android.icu.text.MessageFormat的向後移植,可在舊版 API 上運作。不過,由於它整合了上述的日期 / 時間格式,因此在新的 Android 版本上仍相當實用。這會遵循使用者設定,而android.icu.text.MessageFormat不會。
這個元件將用於向後移植新的 i18n API、新增 i18n 功能或修正,以及簡化國際化作業。
1.0.0-rc01 版
2025 年 3 月 26 日
androidx.core:core-i18n:1.0.0-rc01 發布,與上一個 Beta 版相比沒有重大異動。1.0.0-rc01 版本包含這些修訂版本。
1.0.0-beta01 版
2025 年 3 月 12 日
發布 androidx.core:core-i18n:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。
新功能
- 這是
core-i18n元件的第一個版本。這個元件可讓您更輕鬆地建立適當國際化的應用程式,主要著重於兩個方面:- 日期和時間格式設定功能,遵循目前的最佳做法,遵循使用者自訂設定,並提供可在新舊 Android 版本上正常運作的統一 API。
android.icu.text.MessageFormat的向後移植,可在舊版 API 上運作。不過,由於它整合了上述的日期 / 時間格式,因此在新的 Android 版本上仍相當實用。這會遵循使用者設定,而android.icu.text.MessageFormat不會。- 這個元件將用於向後移植新的 i18n API、新增 i18n 功能或修正,以及簡化國際化作業。
1.0.0-alpha01 版
2023 年 7 月 26 日
發布 androidx.core:core-i18n:1.0.0-alpha01。1.0.0-alpha01 版本包含以下修訂項目。
Core-location-altitude
1.0 版本
1.0.1 版
2026 年 10 月 21 日
發布 androidx.core:core-location-altitude:1.0.1、androidx.core:core-location-altitude-external-protobuf:1.0.1 和 androidx.core:core-location-altitude-proto:1.0.1。1.0.1 版包含這些修訂項目。
- 重新建構重新封裝的 protobuf 程式庫,以便在使用 R8 時更有效地縮減
1.0.0 版
2026 年 6 月 17 日
發布 androidx.core:core-location-altitude:1.0.0、androidx.core:core-location-altitude-external-protobuf:1.0.0 和 androidx.core:core-location-altitude-proto:1.0.0。1.0.0 版包含這些修訂項目。
1.0.0 的主要功能:
修正錯誤
- 將程式庫移至 Java 11 目標。這表示產生的位元碼將是 Java 11 (類別檔案版本 55),可能需要脫糖才能使用程式庫 (If4c2a、b/457821470)
- 新增 ViewBoundsTracker 類別,持續追蹤檢視畫面邊界,以便在 PictureInPictureParamsCompat 中設定 sourceRectHint (Id203a、b/474454111)
- 新增 PictureInPictureParamsValidator 類別,用於驗證應用程式提供的 PictureInPictureParamsCompat (I89b4d、b/470149490)
- 將 Pixel 12 月版本新增至 KI_398591036 的固定版本指紋清單 (I65f51、b/398591036)
- 將 Pixel 11 月版本新增至 KI_398591036 的固定版本指紋清單 (I60c10、b/398591036)
- 將 Pixel 10 月版本新增至 KI_398591036 的固定版本指紋清單 (I6438c、b/398591036)
- 從 FingerprintManagerCompat 移除 FingerprintManager 類別的參照,並更新所有方法,使其傳回 false 或不執行任何操作。(I0360b、b/330524057)
- 修正 KI_452390376 說明文件中的程式碼連結 (I9a554、b/454020407)
- 將特定 Pixel 版本標示為已修正。(I4c751、b/398591036)
- 新增支援功能,可為 KnownIssue 指定手動測試的版本指紋清單。(Iea9f9、b/453691379)
1.0.0-rc01 版
2026 年 3 月 11 日
發布 androidx.core:core-location-altitude:1.0.0-rc01、androidx.core:core-location-altitude-external-protobuf:1.0.0-rc01 和 androidx.core:core-location-altitude-proto:1.0.0-rc01,且自上一個 Beta 版以來皆無重大異動。1.0.0-rc01 版本包含這些修訂版本。
1.0.0-beta01 版
2025 年 11 月 5 日
發布 androidx.core:core-location-altitude:1.0.0-beta01、androidx.core:core-location-altitude-external-protobuf:1.0.0-beta01 和 androidx.core:core-location-altitude-proto:1.0.0-beta01,且自上一個 Alpha 版以來皆無重大異動。1.0.0-beta01 版包含這些修訂項目。
1.0.0-alpha03 版本
2024 年 10 月 16 日
發布 androidx.core:core-location-altitude:1.0.0-alpha03、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha03 和 androidx.core:core-location-altitude-proto:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂版本。
安全性修正
- 自這項異動起,androidx 會針對 protobuf 4.28.2 進行編譯,以解決 CVE-2024-7254 問題。請將
androidx.core:core-location-altitude-proto和androidx.core:core-location-altitude-external-protobuf的依附元件升級至 1.1.0-alpha03,以解決安全漏洞風險。
修正錯誤
- 移除手動概述新平台 API 存取權的功能,因為使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3 版) 時,系統會透過 API 建模自動執行這項操作,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,系統會針對所有建構作業執行這項操作。如果客戶未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
1.0.0-alpha02 版
2024 年 6 月 12 日
發布 androidx.core:core-location-altitude:1.0.0-alpha02、androidx.core:core-location-altitude-external-protobuf:1.0.0-alpha02 和 androidx.core:core-location-altitude-proto:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。
修正錯誤
- 修正因重新封裝 Proto 程式庫而導致的 Proguard 失敗問題。
外部貢獻
- 上述錯誤修正由 andrekir@pm.me 提供
1.0.0-alpha01 版
2023 年 7 月 26 日
發布 androidx.core:core-i18n:1.0.0-alpha01 和 androidx.core:core-location-altitude:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 新增
AltitudeConverterCompat類別,其中包含單一靜態方法addMslAltitudeToLocation(Context, Location)(I11168)。
Core-pip
1.0 版本
1.0.0-alpha04 版本
2026 年 8 月 26 日
發布 androidx.core:core-pip:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。
API 變更
- 將
disablePipOnAppSwitch新增至ContentPipExt(Ie5bad、b/542307174) - 在
androidx.core.pip中導入備用PiP解決方案,以便在原生PiP可能遭到抑制的導覽手勢 (例如快速切換) 期間,維持子母畫面功能。(If289a、b/540480397)
修正錯誤
- 如果
enterPip失敗,則回呼onFinishContentPip(I04b77、b/540480397)
1.0.0-alpha03 版本
2026 年 7 月 1 日
發布 androidx.core:core-pip:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂版本。
API 變更
BasicPictureInPicture和VideoPlaybackPictureInPicture類別現在需要在建構函式中加入執行工具。我們推出了新的 commit() 方法,必須呼叫該方法才能套用參數變更。(Ib9150、b/493673311)
修正錯誤
- 在
setPictureInPictureParams中擷取例外狀況 (Ibfeb2、b/519706801)
1.0.0-alpha02 版
2026 年 2 月 11 日
發布 androidx.core:core-pip:1.0.0-alpha02。1.0.0-alpha02 版包含這些修訂項目。
新功能
- 新增
BasicPictureInPicture和VideoPlaybackPictureInPicture,簡化標準導入作業。新的VideoPlaybackPictureInPicture類別可讓程式庫自動處理檢視區塊邊界追蹤,確保視覺轉換更流暢。
API 變更
- 移除
onViewBoundsChangedAPI (Ie56d0、b/475328144) - 新增
BasicPictureInPicture和VideoPlaybackPictureInPicture類別,用於一般子母畫面用途 (I7f989、b/475328144)
修正錯誤
- 新增
ViewBoundsTracker類別,持續追蹤檢視畫面邊界,以便在PictureInPictureParamsCompat中設定sourceRectHint。(Id203a、b/474454111)
1.0.0-alpha01 版
2026 年 1 月 14 日
發布 androidx.core:core-pip:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。
新功能
PiP Jetpack 程式庫旨在解決 Android 子母畫面 (PiP) 模式中的幾項難題:
- OS 分割:程式庫會處理不同 Android 版本之間的子母畫面 API 呼叫差異,例如 Android S 之前的
enterPictureInPictureMode和之後的isAutoEnterEnabled。 - 子母畫面參數不正確:提供統一的解決方案,可設定正確的子母畫面參數 (尤其是播放),確保動畫流暢 (例如來源矩形提示)。
- 分割的子母畫面狀態回呼:程式庫將
onPictureInPictureModeChanged和onPictureInPictureUiStateChanged整合為單一統合回呼介面,簡化狀態管理。
API 變更
PictureInPictureDelegate類別,可協助代表指定的PictureInPictureProvider執行個體設定子母畫面功能 (8cf9588)。PictureInPictureDelegate.onPictureInPictureEvent介面,為應用程式提供統一的回呼,用於監聽子母畫面事件 (8cf9588)。
修正錯誤
- 新增
PictureInPictureParamsValidator類別,用於驗證應用程式提供的PictureInPictureParamsCompat(I89b4d、b/470149490) - 推出專屬的
:core:core-pip程式庫,協助應用程式開發人員實作 Android 子母畫面功能 (I8ebc5、b/462178249)
Core-Role
1.1 版本
1.1.0 版本
2025 年 3 月 12 日
發布 androidx.core:core-role:1.1.0。1.1.0 版包含這些修訂項目。
1.1.0-rc01 版本
2021 年 12 月 15 日
androidx.core:core-role:1.1.0-rc01 自 1.1.0-alpha01起沒有變更。1.1.0-rc01 版包含此連結所列的修訂項目。
Core-Role 1.1.0-alpha01 版
2020 年 4 月 15 日
發布了 androidx.core:core-role:1.1.0-alpha01。查看 1.1.0-alpha01 版的修訂項。
API 變更
- 新增了系統圖片庫的角色名稱。
1.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,其中包含系統中可能提供的角色名稱和說明文件。
Core-telecom
1.1 版本
1.1.0-rc01 版本
2026 年 10 月 7 日
發布 androidx.core:core-telecom:1.1.0-rc01。1.1.0-rc01 版本包含這些修訂項目。
修正錯誤
- 將 core-telecom 升級至 1.1.0-rc01。(Iba053)
- 修正問題:使用偏好的音訊端點 (例如手機耳機) 發起視訊通話後,通話會在連線後不久錯誤地切換回裝置喇叭。(I38ea6)
- 修正問題:視訊通話開始時,音訊會錯誤地轉送至裝置喇叭,而非連接的有線耳機。(I575a8)
- 自 SDK 38 起,允許
VoIP應用程式與DisconnectCause.ERROR中斷連線,並在舊版平台上自動重新對應至 LOCAL。(I5a58c)
1.1.0-beta01 版本
2026 年 8 月 26 日
發布 androidx.core:core-telecom:1.1.0-beta01。1.1.0-beta01 版包含這些修訂項目。
修正錯誤
- 將 core-telecom 升級至 1.1.0-beta01。(I5b514、b/529775455)
- 修正
CallsManager#addCall在等待啟動音訊端點解析和藍牙穩定時,可能會延遲CallControlScope輸入最多 2 秒的問題。(Ia1e89、b/540450085) - 修正競爭狀況:在另一個通話設定進行期間叫用
CallsManager#addCall或CallsManager#addCallWithExtensions,可能會導致 OSTransactionManager發生死結或失敗,但未顯示任何訊息。現在,重疊的通話設定會立即遭到拒絕,並顯示CallException(ERROR_CALL_NOT_PERMITTED_AT_PRESENT_TIME)。(If0ac8、b/491156745)
1.1.0-alpha06 版本
2026 年 6 月 17 日
發布 androidx.core:core-telecom:1.1.0-alpha06。1.1.0-alpha06 版包含這些修訂項目。
API 變更
- 從穩定版擴充功能中移除
ExperimentalAppActions註解 (I25ab2、b/501448256)
修正錯誤
- 修正以下錯誤:在 SDK 34 以上版本使用回溯相容路徑時,視訊通話會轉接至耳機,而非喇叭 (I9f2bd、b/519599698)
- 修正以下問題:平台誤將來電的純音訊
VoIP通話視為視訊通話,導致通話轉接至擴音模式而非耳機 (I95902、b/517616475) - 修正 Core-Telecom 的錯誤:在通話初始化期間,使用者刻意切換至擴音模式,卻錯誤還原為耳機。(I9e251、b/478022476)
- 修正 core-telecom 中多餘的音訊狀態更新,可能導致主執行緒壅塞和 ANR 的問題。(Ibd794、b/491873537)
- 修正
BlueoothProfileListener#onServiceConnected中的 NPE (Idbd57、b/513341034) - 在不受影響的平台版本上,抑制特定版本錯誤緩解測試,修正 Android 17 (SDK 37) CallSessionTest 測試失敗的問題。(I970a7、b/502732317)
1.1.0-alpha05 版本
2026 年 4 月 22 日
發布 androidx.core:core-telecom:1.1.0-alpha05。1.1.0-alpha05 版包含這些修訂項目。
修正錯誤
- 修正 Android 14-16 的問題:語音通話開始時,音訊可能會意外轉到喇叭 (Ic7000、b/491932378)
- 修正
core-telecom中的當機問題 (IllegalStateException),如果電信架構或遠端服務在擴充功能設定期間多次調度連線事件,就可能發生這個問題。(I00f82、b/476724351) - 如果
BLUETOOTH_CONNECT權限遭拒,Telecom 現在會使用備用經驗法則來識別穿戴式裝置,以便做出音訊轉送決策。(Iec271、b/499302063)
1.1.0-alpha04 版本
2026 年 3 月 25 日
發布 androidx.core:core-telecom:1.1.0-alpha04。1.1.0-alpha04 版包含這些修訂項目。
修正錯誤
- 修正舊版 Android 的問題:來電或升級的視訊通話有時會錯誤地將音訊轉送至耳機。如果偵測到這類錯誤,程式庫現在會強制切換至喇叭。(I0fc797、I29fd22)
- 從通話前畫面顯示的可用端點清單中,移除 A2DP 藍牙裝置,因為 Android 平台電信架構不支援這些裝置進行語音通訊。這可讓可用裝置與平台行為保持一致。(I98b729)
- 略過受管理通話的通話擴充功能邏輯,避免可能發生的當機或非預期行為。(I177905)
1.1.0-alpha03 版本
2026 年 2 月 11 日
發布 androidx.core:core-telecom:1.1.0-alpha03。1.1.0-alpha03 版包含這些修訂項目。
新功能
- 選擇不採用進階網路切片:在
CallsManager中導入新功能CAPABILITY_OPT_OUT_OF_PREMIUM_NETWORK。這樣一來,VoIP 應用程式就能表明不希望系統預設為語音和視訊通話要求付費網路切片。根據預設,系統可能會自動要求使用進階網路切片,提升通話品質。這項功能可在registerAppWithTelecom期間傳遞。(I2dfdb) - 控制麥克風靜音功能:新增 API,讓 VoIP 應用程式通知遠端介面 (例如 Android Auto、穿戴式裝置),使用者是否應能控制麥克風狀態。如果使用者無法變更靜音狀態 (例如在受控管的會議中、以被動檢視者身分加入,或使用夥伴模式),這項功能就非常實用。(I55acf)
API 變更
- 新增
CallsManager.CAPABILITY_OPT_OUT_OF_PREMIUM_NETWORK:搭配registerAppWithTelecom(int)使用這個旗標,可防止系統自動要求進階網路功能。kotlin val callsManager = CallsManager(context) // Register with Telecom, opting out of premium network requests callsManager.registerAppWithTelecom(CallsManager.CAPABILITY_OPT_OUT_OF_PREMIUM_NETWORK) onCanUserUpdateSilence現在是選用項目 (Ibb0c2)- 新增 API,通知介面是否應顯示麥克風 (I55acf)
修正錯誤
- 修正
JetpackConnectionService中的NullPointerException,此問題是由存取待處理連線要求時的競爭狀況所造成。改用CopyOnWriteArrayList進行執行緒安全疊代後,問題已解決。(I24306) - 修正會議摘要擴充功能的問題:系統會發出常值字串「null」,而非目前發言者的實際
null值。(Idae9a)
1.1.0-alpha01 版本
2025 年 10 月 8 日
發布 androidx.core:core-telecom:1.1.0-alpha01。1.1.0-alpha01 版包含這些修訂項目。
新功能
- 新增功能,讓應用程式可以要求不將特定通話儲存至系統通話記錄,即使應用程式已啟用通話記錄功能也一樣。這項功能僅適用於搭載
Build.VERSION.SDK_INT_FULL >= Build.VERSION_CODES_FULL.BAKLAVA_1的裝置。
API 變更
- 在
CallAttributesCompat資料類別中,導入選用的isLogExcluded布林值屬性。如果設為 True,系統就不會將通話記錄在通話記錄中。在舊版平台上,這個屬性不會有任何效果。請注意,根據預設,VoIP 通話不會記錄在系統通話記錄中。開發人員必須先明確選擇加入應用程式,才能參與系統通話記錄。這需要在應用程式資訊清單中,為android.telecom.action.CALL_BACK宣告意圖處理常式。新的isLogExcluded屬性可為已啟用這項整合功能的應用程式,提供個別呼叫排除選項。(d14695)
1.0 版本
1.0.1 版
2025 年 8 月 27 日
發布 androidx.core:core-telecom:1.0.1。1.0.1 版是錯誤修正版本,包含下列改善項目,詳情請參閱這些修訂項目。
修正錯誤
- 音訊轉送和端點處理
- 穩定性與當機修正
1.0.0 版
2025 年 5 月 7 日
發布 androidx.core:core-telecom:1.0.0。1.0.0 版包含這些修訂項目。
1.0.0 的主要功能
- core-telecom API 的初始穩定版本,著重於
CallsManagerAPI 介面,用於將 VoIP 通話整合至 Android 平台。
1.0.0-rc01 版
2025 年 4 月 9 日
發布 androidx.core:core-telecom:1.0.0-rc01。1.0.0-rc01 版本包含這些修訂版本。
新功能
新的實驗性 API 呼叫擴充功能。這個版本新增的實驗性擴充功能如下:
- 支援會議摘要遠端擴充功能,允許遠端介面從連結的 VoIP 應用程式接收會議摘要資訊 (目前發言者和參與者人數)。(7cf095f)
- 支援通話圖示擴充功能,可讓 VoIP 應用程式將圖示 URI 傳送至遠端
InCallService(Auto、錶面等)。圖示可在通話期間更新,且可使用相同的 URI 值。(8e1813e)
1.0.0-beta01 版
2024 年 12 月 11 日
發布 androidx.core:core-telecom:1.0.0-beta01。1.0.0-beta01 版包含這些修訂項目。
新功能
以下新功能推出 Beta 版:
- 在新增通話前擷取可用的音訊端點。應用程式開發人員現在可以在發起通話前,顯示所有可用的端點,讓使用者順暢選取偏好的音訊端點,並調整設定。這樣一來,就不必在通話開始時調整設定,體驗更流暢。
- 實驗性 API 支援 VoIP 應用程式通話擴充功能。通話擴充功能可讓應用程式提供進行中通話的詳細資料,例如群組通話或會議的參與者清單。Android Auto 等支援的遠端介面可向使用者顯示這項資訊,並允許使用者與支援的擴充功能互動。這個版本新增的實驗性擴充功能如下:
- 支援顯示群組通話或會議中的出席者,並說明哪位出席者正在發言。支援下列參與者選用動作:
- 讓出席者舉手或手放下。
- 踢除參與者。
- 支援通話靜音,可讓遠端介面將 VOIP 通話設為靜音,而不必將麥克風設為全域靜音。
- 支援顯示群組通話或會議中的出席者,並說明哪位出席者正在發言。支援下列參與者選用動作:
API 變更
- 將
addLocalSilenceExtension重新命名為addLocalCallsilenceExtension(If4a9c) - 將
preferredStartingCallEndpoint從var變更為val。(Iab6b7) - 新增本機通話靜音 API (I29dd0)
- 為
CallEndpointCompat類別實作compareTo函式 (Ia06b7) - 新增實驗性應用程式動作 API。(Ifb796)
- 新增
CallsManagerAPIgetAvailableStartingCallEndpoints(Ia8bcf) - 更新
ExperimentalAppActions註解,確保能準確追蹤實驗功能的所有使用情形。(Id5ea5)
修正錯誤
- 為 Android API 級別 28 至 33 新增全域靜音狀態接收器。(I75e66)
- 修正只有最新連線的
InCallService才能傳送動作事件的問題 (I39599) - 實作 ICS Extensions API,用於 VoIP 應用程式動作。(I1274c)
- 在 API 級別 34 之前拒絕通話,現在會正確刪除 Telecom 中的通話。(I635b7)。
addCall現在會透過 API 正確擲回例外狀況,而不是父項協同程式 (I83334)- 在額外資訊套組新增預留位置值 (Iebf7f)
- 移除手動概述新平台 API 存取權的功能,因為使用 R8 搭配 AGP 7.3 以上版本 (例如 R8 3.3 版) 時,系統會透過 API 建模自動執行這項操作,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,系統會針對所有建構作業執行這項操作。如果客戶未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ieb9ae、b/345472586)
- 新增
CallsManager#addCall擴充功能的實驗性支援。(I24d92) - 如果平台因例外狀況、達到通話次數上限等原因而無法新增通話,Core-Telecom 現在會擲回
CallException(I41f27)。
1.0.0-alpha03 版本
2024 年 4 月 17 日
發布 androidx.core:core-telecom:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂版本。
修正錯誤
- 重構
JetpackConnectionService,修正 SDK 33 以下版本在傳入地址空白時發生的問題。重構後的JetpackConnectionService也能彈性處理 Telecom 平台 API 傳回的非預期 NULL 值。 addCall/CallControlScopeAPI 說明文件改善。- 提升測試可靠性。
1.0.0-alpha02 版
2023 年 10 月 4 日
發布 androidx.core:core-telecom:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。
API 變更
- 修改了傳回布林值的方法 API 簽章,以指出成功/失敗,改為傳回明確指出作業成功或失敗原因的結果類別。
- 將
CallControlCallback方法做為 lambda 引數移至addCall,因此不必在呼叫範圍中明確提供回呼。
修正錯誤
- 修正
ConnectionService相容性層中的錯誤,該錯誤會導致在 U 之前的 SDK 上執行時,沒有通話音訊。 - 改善 API 說明文件。
1.0.0-alpha01 版
2023 年 5 月 10 日
發布 androidx.core:core-telecom:1.0.0-alpha01。這個版本是在內部分支版本中開發而成,應與 Android 14 Beta 2 搭配使用。
新功能
推出
CallsManagerAPI,VoIP 應用程式可使用該 API 與裝置上的 Telecom 架構整合。通知平台的通話可享有前景執行優先權、在藍牙、穿戴式裝置和汽車裝置上顯示,以及簡化的音訊轉送。CallsManagerAPI 會包裝舊版ConnectionServiceAPI,適用於搭載舊版 Android 的裝置。
Core-viewtree
1.0 版本
1.0.0 版
2025 年 2 月 26 日
androidx.core:core-viewtree:1.0.0 已升級為第一個穩定版本,與先前的候選版本相比沒有任何變更。
這個程式庫導入了 View 可擁有不相交父項的概念。檢視畫面的不相交父項是獨立的 View 物件,可做為檢視畫面的父項,但並非透過 View.parent 屬性設定。ViewOverlays、彈出式視窗和對話方塊都是與父項不相交的檢視畫面,這些檢視畫面都會顯示在主要檢視區塊階層之外。如果檢視畫面沒有透過平台的 View.parent 屬性直接連結父項,則只能有不相交的父項。目前,androidx 只會為 Transition 1.6.0-alpha01 以上版本建立的 ViewOverlays 設定不相交的父項。您也可以為檢視畫面指定不相交的父項。詳情請參閱說明文件。
1.0.0-rc01 版
2025 年 2 月 12 日
androidx.core:core-viewtree:1.0.0-rc01 發布,且自 Beta 版以來皆無異動。
1.0.0-beta01 版
2025 年 1 月 29 日
androidx.core:core-viewtree:1.0.0-beta01 發布,且自 Alpha 版以來皆無異動。1.0.0-beta01 版包含這些修訂項目。
1.0.0-alpha01 版
2024 年 12 月 11 日
發布 androidx.core:core-viewtree:1.0.0-alpha01。1.0.0-alpha01 版包含這些修訂項目。
新功能
core-viewtree的初始版本,由 androidx core 傳遞公開。這個初始版本導入了 View 可擁有不相交父項的概念。檢視畫面的不相交父項是獨立的
View物件,可做為檢視畫面的父項,但並非透過View.parent屬性設定。ViewOverlays、彈出式視窗和對話方塊都是與父項不相交的檢視區塊,這些檢視區塊都會顯示在主要檢視區塊階層之外。如果檢視區塊沒有透過平台的View.parent屬性直接連結父項,則只能有不相交的父項。目前,androidx 只會為轉場建立的ViewOverlays設定不相交的父項。您也可以為檢視畫面指定不相交的父項。詳情請參閱說明文件。
API 變更
- 新增
ViewParent.getParentOrViewTreeDisjointParent()和ViewParent.setViewTreeDisjointParent(View, ViewParent?)方法 (Ib2950)