WindowManager
最近更新時間 | 穩定版 | 候選版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2025 年 7 月 2 日 | 1.4.0 | - | 1.5.0-beta01 | - |
宣告依附元件
如果要為 WindowManager 新增依附元件,您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一節。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Groovy
dependencies { implementation "androidx.window:window:1.4.0" // For Java-friendly APIs to register and unregister callbacks implementation "androidx.window:window-java:1.4.0" // For RxJava2 integration implementation "androidx.window:window-rxjava2:1.4.0" // For RxJava3 integration implementation "androidx.window:window-rxjava3:1.4.0" // For testing implementation "androidx.window:window-testing:1.4.0" }
Kotlin
dependencies { implementation("androidx.window:window:1.4.0") // For Java-friendly APIs to register and unregister callbacks implementation("androidx.window:window-java:1.4.0") // For RxJava2 integration implementation("androidx.window:window-rxjava2:1.4.0") // For RxJava3 integration implementation("androidx.window:window-rxjava3:1.4.0") // For testing implementation("androidx.window:window-testing:1.4.0") }
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 Issue Tracker 說明文件。
1.5 版本
1.5.0-beta01 版
2025 年 7 月 2 日
發布 androidx.window:window-*:1.5.0-beta01
。1.5.0-beta01 版包含這些修訂項目。
1.5.0-alpha02 版
2025 年 5 月 7 日
發布 androidx.window:window-*:1.5.0-alpha02
。1.5.0-alpha02 版包含這些修訂項目。
API 變更
- 為「Large」和「XLarge」新增
WindowSizeClass
中斷點。(I40d85) - 展開「計算」
WindowMetrics
,然後展開「應用程式內容」。(I8eeeb、b/360934048) - 提供 Getter,直接存取
WindowLayoutInfo
(Ie9513) - 導入 API,自動儲存嵌入狀態,並在應用程式程序重新啟動時自動還原嵌入狀態。(Ie0295)
- 移除實驗性
WindowInsets
API。(I68a71) - 隱藏幾個建構函式 (I87b8d)
修正錯誤
- 修正
EmbeddingRule
在某些情況下傳回不同hashCode
的問題。(I748cc)
1.5.0-alpha01 版本
2025 年 3 月 12 日
發布 androidx.window:window-*:1.5.0-alpha01
。1.5.0-alpha01 版包含這些修訂項目。
新功能
- 下一個 1.5.0 版本的初始版本。
1.4 版
1.4.0 版本
2025 年 5 月 20 日
發布 androidx.window:window-*:1.4.0
。1.4.0 版包含這些修訂項目。
自 1.3.0 版以來的重要異動
- 活動嵌入
- 自訂啟動動畫的 API
- 互動式分隔線
ActivityStack
置頂- 全螢幕對話方塊調暗功能
- 內嵌活動視窗資訊回呼
- 更完善的
ActivityStack
管理功能 - 將活動啟動至指定
ActivityStack
WindowMetricsCalculator
- 改善可測試性支援
WindowMetrics
- 計算
withDp
和heightDp
的便利方法 - 將邊界檢查更新為
isAtLeast
,並使用下限來支援新增值
- 計算
WindowSizeClass
- 從「
WindowMetrics
」新增計算方式
- 從「
WindowInfoTracker
- 新增 API,用於偵測裝置支援的姿勢
1.4.0-rc02 版
2025 年 4 月 23 日
發布 androidx.window:window-*:1.4.0-rc02
。1.4.0-rc02 版包含這些修訂項目。
修正錯誤
- 修正
ActivityEmbedding
的保護措施當機問題。
1.4.0-rc01 版本
2025 年 3 月 12 日
發布 androidx.window:window-*:1.4.0-rc01
。1.4.0-rc01 版包含這些修訂項目。
新功能
WindowSizeClass
API 更新。- 更新活動嵌入 API。
1.4.0-beta02 版本
2025 年 2 月 12 日
發布 androidx.window:window-*:1.4.0-beta02
。1.4.0-beta02 版包含這些修訂項目。
新功能
- 修正僅位於屬性但不在 getter 的註解。
1.4.0-beta01 版本
2025 年 1 月 15 日
發布 androidx.window:window-*:1.4.0-beta01
。1.4.0-beta01 版包含這些修訂項目。
新功能
- 新增 API,可自訂
ActivityEmbedding
動畫。 - 擴充
WindowMetricsCalculator
測試 API,允許偽造視窗指標。
API 變更
- 隱藏幾個建構函式 (I87b8d)
- 允許應用程式自訂
ActivityEmbedding
動畫 (If31a8) - 新增對
watchosDeviceArm64
KMP 目標的支援,並以 Kotlin 1.9 為目標 (Icf15d、b/364652024) - 公開
WindowMetricsCalculator
API。(I1cebf)
修正錯誤
- 這個程式庫現在使用 JSpecify 空值註解,這些註解屬於型別用途。Kotlin 開發人員應使用下列編譯器引數,強制執行正確用法:
-Xjspecify-annotations=strict
(這是 Kotlin 編譯器 2.1.0 版的預設值)。(Ie69ac、b/326456246)
1.4.0-alpha05 版
2024 年 10 月 16 日
發布 androidx.window:window-*:1.4.0-alpha05
。1.4.0-alpha05 版包含這些修訂項目。
新功能
- 新增便利函式,從
WindowMetrics
取得widthDp
和heightDp
。
API 變更
- 將
widthDp
和heightDp
新增至WindowMetrics
。(Ide026) - 移除實驗性
WindowInsets
API。(I68a71) - 將邊界檢查方法名稱更新為
isAtLeast
(Ib0ab7)
1.4.0-alpha04 版本
2024 年 10 月 2 日
發布 androidx.window:window-*:1.4.0-alpha04
。1.4.0-alpha04 版包含這些修訂項目。
API 變更
- 新增從
WindowMetrics
計算WindowSizeClass
的方法。(874dba) - 為清楚起見,請將
WindowSizeClass
方法變更為containsWidthDp
、containsHeightDp
和containsWindowSizeDp
。(fa760d) - 將
WindowAreaController
轉換為抽象基礎類別。(I90893)
修正錯誤
- 建立測試
FoldingFeature
時,新增對相對邊界的支援。(2e6b3e) - 修正選取
WindowSizeClass
時的一般錯誤。
1.4.0-alpha03 版
2024 年 9 月 18 日
發布 androidx.window:window-*:1.4.0-alpha03
。1.4.0-alpha03 版包含這些修訂項目。
新功能
- 新增公用程式方法,從
WindowMetrics
取得WindowSizeClass
。(I83f1f) - 將
isAtLeast
重新命名為containsBreakpoint
。(I85b47) - 使用浮點數將多載新增至
computeWindowSizeClass
。(I3dcb2、b/364677934、b/364677802、b/364680886)
修正錯誤
- 在預設的
WindowSizeClass
中斷點集中新增遺漏的中斷點。 - 修正在某些情況下,系統無法正確選取精簡尺寸的錯誤。
1.4.0-alpha02 版
2024 年 9 月 4 日
發布 androidx.window:window-*:1.4.0-alpha02
。1.4.0-alpha02 版包含這些修訂項目。
新功能
新增對自訂 WindowSizeClass
的支援。
- 開放
WindowSizeClass
的建構函式,讓開發人員使用自己的建構函式。 - 新增
isAtLeast
公用程式方法,讓開發人員可以處理一系列WindowSizeClass
值。 - 在
Set<WindowSizeClass>
上新增擴充功能函式,從 Set 計算最佳相符項目。 - 新增 Android 建議中斷點的常數。
- 新增與 Android 建議中斷點對應的中斷點集。
API 變更
- 更新
WindowSizeClass
的界線方法名稱。(If89a6) - 更新
WindowSizeClass
API,以便日後新增中斷點值。我們不會使用絕對界限,而是使用下限,並建議開發人員在處理WindowSizeClass
時使用下限檢查。現有的WindowWidthSizeClass
和WindowHeightSizeClass
將會淘汰,因為我們不會再進一步開發。(I014ce)
1.4.0-alpha01 版
2024 年 8 月 7 日
發布 androidx.window:window-*:1.4.0-alpha01
。1.4.0-alpha01 版包含這些修訂項目。
新功能
- ActivityStack Pinning 可讓應用程式將內容固定在一個容器中,並將導覽作業與其他容器隔離。
- 互動式分隔線可讓應用程式在分割畫面中,於兩個活動之間顯示固定或可拖曳的分隔線。
- 全螢幕對話方塊調暗功能可讓應用程式指定對話方塊調暗區域,調暗整個工作視窗,或只調暗顯示對話方塊的容器。
- 應用程式可透過內嵌活動視窗資訊回呼,持續接收內嵌活動視窗的更新。
- 嵌入動畫背景可讓應用程式指定動畫背景,在使用
ActivityEmbedding
時提升轉場動畫品質。 - 改善 ActivityStack 管理功能後,應用程式就能在使用
ActivityEmbedding
時,進一步控管ActivityStacks
,包括: - 在指定
ActivityStack
中啟動活動 - 完成
ActivityStack
API 變更
新版 API
WindowInfoTracker#supportedPostures
:- 這個 API 可判斷裝置是否支援可摺疊裝置的桌面模式。新增 WindowAreaSessionPresenter#getWindow
新增 API,支援釘選
ActivityStack
:SplitPinRule
類別SplitController#pinTopActivityStack
SplitController#unpinTopActivityStack
新增 API 來啟用及設定互動式分隔線
DividerAttributes
類別SplitAttributes.Builder#setDividerAttributes
新增 API,用於設定對話方塊的
EmbeddingConfiguration
和DimAreaBehavior
EmbeddingConfiguration
類別DimAreaBehavior
類別ActivityEmbeddingController#setEmbeddingConfiguration
新增 API,接收嵌入式活動視窗資訊更新
EmbeddedActivityWindowInfo
類別ActivityEmbeddingController#embeddedActivityWindowInfo
新增 API,用於設定嵌入動畫背景
EmbeddingAnimationBackground
SplitAttributes.Builder#setAnimationBackground
新增 API 以完成
ActivityStacks
ActivityEmbeddingController#finishActivityStacks
新增 API 來設定啟動
ActivityStack
ActivityEmbeddingOptions#setLaunchingActivityStack
下列 API 為穩定版,不再是實驗性質:
ActivityEmbeddingController#invalidateVisibleActivityStacks
(從 SplitController#invalidateTopVisibleSplitAttributes 移出)ActivityEmbeddingController#getActivityStack
SplitController#updateSplitAttributes
新增 1.4 版的 API。(I56774)
修正錯誤
- 修正特定裝置的錯誤,在工作階段處於啟用狀態時,系統會傳回 UNAVAILABLE,而非 ACTIVE。
- 由於 API 支援不穩定,因此移除
vendorApiLevel
為 2 的裝置對transferActivityToWindowArea
的支援。 - 推出 API,讓使用者可以拖曳 Activity Embedding 可拖曳的分隔線,將活動設為全螢幕。(I645c9)
- 允許應用程式透過
SplitAttributes
的動畫參數停用ActivityEmbedding
動畫。(Idc01a) - 移除手動列出新平台 API 存取權的步驟,因為使用 AGP 7.3 以上版本 (例如 R8 3.3 版) 的 R8 時,系統會透過 API 建模自動執行這項作業,而使用 AGP 8.1 以上版本 (例如 D8 8.1 版) 時,所有建構作業都會自動執行這項作業。如果用戶端未使用 AGP,建議更新至 D8 8.1 以上版本。詳情請參閱這篇文章。(Ia60e0、b/345472586)
- 允許擴充功能取得
SplitAttributes
的動畫參數,以便裝置用於動畫轉場效果。(Iede00) - 隱藏重疊 API (Ic4251)
- 導入 API,設定分割畫面固定或可拖曳的分隔線 (Ia7a78)
- 在
WindowMetrics
中新增密度 (Id6723) - 新增 API 來取得
SupportedPostures
。(If557a) - 從實驗性 API 移除
setLaunchingActivityStack
(I191cf) - 推出
ActivityEmbeddingController#embeddedActivityWindowInfo
(I24312) - 淘汰
#getToken
並新增#getActivityStackToken
(Ie0471) - 為
embeddedActivityWindowInfo
Flow API 導入回呼轉接程式 (Ida77f) - 為 overlayInfo flow API 新增回呼轉接程式 (I7264f)
- 導入
WindowSdkExtensionsRule
,以便覆寫extensionsVersion
進行測試。(Ifb928) - - Migrate
#setLaunchingActivityStack
to Bundle to compat withActivityOptionsCompat
usages.- 使用者應傳遞
activityOptions.toBundle
,而非ActvityOptions
本身。 - 移除
#setLaunchingActivityStack(Activity)
。使用者應遷移至ActivityEmbeddingController#getActivityStac(Activity)
,取得ActivityStack
,然後將ActivityStack
傳遞至#setLaunchingActivityStack
。(Ie0ccc)
- 使用者應傳遞
- - 導入
ActivityStack.Token
和SpltInfo.Token
做為 WM Jetpack 與擴充功能之間的通訊 ID。- 淘汰/取代 API,改為接收/傳回 Token,而非 IBinder。(I12b24)
- - 導入
ActivityEmbeddingController#invalidateVisibleActivityStacks
- 移除
SplitController#invalidateTopVisibleSplitAttributes
,因為這項功能已併入#invalidateVisibleActivityStacks
(I02ef5)
- 移除
- - 新增 API 來設定嵌入設定。(I59a4a)
- - 新增置頂/取消置頂
ActivityStack
androidx.Window
API- 更新示範應用程式,允許釘選/取消釘選頂端
ActivityStack
(I24dd3)
- 更新示範應用程式,允許釘選/取消釘選頂端
- 重新新增
#finishActivityStacks
和ActivityEmbeddingOptions
(Ic1ab3) - 移除不穩定的 API。(Ibc534、b/302380585)
1.3 版本
1.3.0 版本
2024 年 5 月 29 日
發布 androidx.window:window-*:1.3.0
。1.3.0 版包含這些修訂項目。
自 1.2.0 版以來的重要異動
- 支援 Kotlin Multiplatform 的視窗大小類別。
1.3.0-rc01 版本
2024 年 5 月 14 日
WindowManager
Jetpack 1.3 支援 WindowSizeClass
功能的 Kotlin Multiplatform,並修正多項錯誤。
發布 androidx.window:window-*:1.3.0-rc01
。1.3.0-rc01 版包含這些修訂項目。
1.3.0-beta02 版
2024 年 5 月 1 日
發布 androidx.window:window-*:1.3.0-beta02
。1.3.0-beta02 版包含這些修訂項目。
API 變更
- 移除建立及使用自訂
WindowSizeClass
的支援。(Id1143)
修正錯誤
- 修正因 Proguard 剝除特定裝置實作中的部分檔案而導致的
KotlinReflectionInternalError
。(I01b02)
1.3.0-beta01 版本
2024 年 4 月 3 日
發布 androidx.window:window-*:1.3.0-beta01
。1.3.0-beta01 版包含這些修訂項目。
1.3.0-alpha03 版
2024 年 3 月 6 日
發布 androidx.window:window-*:1.3.0-alpha03
。1.3.0-alpha03 版包含這些修訂項目。
API 變更
- 將
WindowSizeClassUtil
分割為更專注的方法。(Ie9292) - 還原
WindowSizeClass#compute
(I21355、b/324293374)
修正錯誤
- 修正當機問題,原因是系統無法正確解除包裝所提供的內容。(94d10ce,b/318787482)
1.3.0-alpha02 版本
2024 年 2 月 7 日
發布 androidx.window:window-*:1.3.0-alpha02
。查看 1.3.0-alpha02 版的修訂項。
新功能
- 更新 Window Size Class API 的 API 介面,為想使用自有大小類別的開發人員提供更靈活的選擇。
API 變更
- 在寬度選取器中加入高度限制條件。(I23393)
- 新增公用程式函式,從一組
WindowSizeClass
中挑選WindowSizeClass
。新增實驗性評分函式,方便開發人員編寫自己的選取器。新增選取器擴充功能函式,在指定界線內挑選最寬的WindowSizeClass
。(I0c944) - 開啟
WindowSizeClass
建構函式,以便新增自訂中斷點。(Ic1ff3) - 新增便利函式,根據寬度、高度和密度建立大小類別。(If67f4)
修正錯誤
- 修正浮點值截斷為 0 時的例外狀況。(272ffac)
1.3.0-alpha01 版本
2023 年 11 月 15 日
發布 androidx.window:window-*:1.3.0-alpha01
。1.3.0-alpha01 版包含此連結所列的修訂項目。
新功能
- 公開實驗性視窗 API,供存取後螢幕。
- 用於建立
FoldingFeature
的測試 API 現在是穩定版。 - 用於設定虛假
ActivityEmbedding
值的測試 API 現在已可穩定運作。 WindowLayoutInfoPublisherRule
現在從UiContext
取得值時,會回報覆寫。WindowInfoTracker
會將摺疊功能資料回報給UiContext
參數。- 在裝置上公開擴充功能版本。
WindowProperties
常數,適用於使用者個別應用程式的覆寫設定:PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE
:通知系統應用程式已選擇不覆寫面向使用者的螢幕比例相容性。PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE
:通知系統應用程式已選擇不使用使用者螢幕比例相容性覆寫設定的全螢幕選項
1.2 版本
1.2.0 版本
2023 年 11 月 15 日
發布 androidx.window:window-*:1.2.0
。1.2.0 版包含此連結所列的修訂項目。
自 1.1.0 版以來的重要異動
- 公開實驗性視窗 API,供存取後螢幕。
- 用於建立
FoldingFeature
的測試 API 現在是穩定版。 - 用於設定虛假
ActivityEmbedding
值的測試 API 現在已可穩定運作。 WindowLayoutInfoPublisherRule
現在從UiContext
取得值時,會回報覆寫。WindowInfoTracker
會將摺疊功能資料回報給UiContext
參數。- 在裝置上公開擴充功能版本。
1.2.0-rc01 版本
2023 年 11 月 1 日
發布 androidx.window:window-*:1.2.0-rc01
。查看 1.2.0-rc01 版的修訂項目。
新功能
- 公開實驗性視窗 API,供存取後螢幕。
- 用於建立
FoldingFeature
的測試 API 現在是穩定版。 - 用於設定虛假
ActivityEmbedding
值的測試 API 現在已可穩定運作。 WindowLayoutInfoPublisherRule
現在從UiContext
取得值時,會回報覆寫。WindowInfoTracker
會將摺疊功能資料回報給UiContext
參數。- 在裝置上公開擴充功能版本。
1.2.0-beta04 版
2023 年 10 月 18 日
發布 androidx.window:window-*:1.2.0-beta04
。1.2.0-beta04 版包含此連結所列的修訂項目。
API 變更
- 移除不穩定的 API。(Ibc534、b/302380585)
1.2.0-beta03 版本
2023 年 9 月 20 日
發布 androidx.window:window-*:1.2.0-beta03
。查看 1.2.0-beta03 版的修訂項目。
新功能
- 針對需要特定擴充功能版本的 API 新增
RequiresApi
檢查,確保 API 正常運作。 - 新增 API,在裝置上公開擴充功能版本。
API 變更
- 在公開 API 中註解所需的 Window SDK 擴充功能版本。
- 在「活動嵌入」元件中移除
isXXXSupported
。(Ie3dae)
- 在「活動嵌入」元件中移除
- 導入
WindowSdkExtensions
,在裝置上回報擴充功能版本。- 導入
RequiresWindowSdkExtension
,註解最低必要擴充功能版本。(I05fd4)
- 導入
- 將
WindowAreaInfo#getCapability
設為不可為空值。(I17048)
1.2.0-beta01 版本
2023 年 7 月 26 日
發布 androidx.window:window-*:1.2.0-beta01
。查看 1.2.0-beta01 版的修訂項目。
新功能
- 公開實驗性視窗 API,供存取後螢幕。
- 用於建立
FoldingFeature
的測試 API 現在是穩定版。 - 用於設定虛假
ActivityEmbedding
值的測試 API 現在已可穩定運作。 WindowLayoutInfoPublisherRule
現在從UiContext
取得值時,會回報覆寫。WindowInfoTracker
會將摺疊功能資料回報給UiContext
參數。
API 變更
- 將
WindowArea
API 標示為實驗性質,以便在 1.3 版 (I857f5) 的穩定版中繼續進行 API 變更 - 更新 API 檔案,以註解相容性抑制 (I8e87a、b/287516207)
1.2.0-alpha03 版本
2023 年 6 月 21 日
發布 androidx.window:window-*:1.2.0-alpha03
。查看 1.2.0-alpha03 版的修訂項。
新功能
- 從 API 介面移除已淘汰的 API。
- 新增支援並行顯示的 API。
- 新增屬性,選擇不強制覆寫大小。
- 新增屬性,選擇不採用最小長寬比覆寫值。
- 穩定
ActivityEmbeddingRule
,支援活動嵌入的單元測試。
API 變更
修正錯誤
- 新增選擇不採用相容性屬性,以強制覆寫大小調整設定 (Ie7ab1)
- 從擴充功能介面移除
SESSION_STATE_CONTENT_INVISIBLE
。(I6ed19) - 穩定
ActivityEmbeddingRule
,支援 Activity 嵌入的單元測試。(I8d6b6) - 新增選擇不採用相容性屬性,以覆寫最小顯示比例。(I66390)
- 移除已淘汰的 WindowArea API (Ieb67c)
- 將方向要求迴圈屬性重新命名為
PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED
。(Ie2fbd) - 更新視窗區域工作階段常數名稱 (I83675)
- 新增選擇不採用相容性屬性,偵測到方向要求迴圈時會忽略 (I0a7a2)
- 新增
WindowAreaComponent#STATUS_ACTIVE
,表示這項功能已啟用。(I62bc3) - 新增
RearDisplayPresentationMode
API (I0401c) - 移除穩定版的背景顏色 API。(I34c3e)
- 隱藏 Window Area API。(I39de0)
- 新增方法,以覆寫
SplitController
中的SplitInfo
。新增測試方法,為SplitInfo
和ActivityStack
建立雙精度浮點數。(Icd69f) - 將「
ActivityRule.Builder
」的標記設為選用項目。(Ib0b44) - 移除
RatioSplitType
、ExpandContainersSplit
和HingeSplitType
。他們現在是SplitType
。- 將
#splitEqually()
、#expandContainers()
和#splitByHinge
替換為常數SplitType SPLIT_TYPE_EQUAL
、SPLIT_TYPE_EXPAND
和SPLIT_TYPE_HINGE
- 移除設定鉸鏈分割類型備用類型的功能。如果目前的裝置或視窗狀態無法套用鉸鏈分割類型,系統會改為平均分割父項工作容器。使用
SplitController#setSplitAttributesCalculator
自訂備用分割類型。(Ifcc59)
- 將
- 淘汰
add
/removeSplitCallback
- 將
add
/removeSplitCallback
移至SplitControllerCallbackAdapter
- 新增
Flow
支援,取得SplitInfo
清單 (I7f1b6)
- 將
- 為
ActivityEmbeddingController
新增測試規則 (I42e9b) - 將
ActivityOptionsCompat
重新命名為ActivityEmbeddingOptions
(I89301) - 新增
splitSupportStatus
,表示是否支援 Activity 嵌入功能。(I10024) - 導入
SplitAttributes.BackgroundColor
,以便更準確地呈現DEFAULT
值。明確指出系統不支援不透明的動畫背景顏色,因此任何不透明的顏色都會視為預設顏色,也就是使用目前主題的視窗背景顏色。(Ic6b95) - 以
ALWAYS_ALLOW
和ALWAYS_DISALLOW
取代alwaysAllow()
和alwaysDisallow()
。(I3057b) - 為
SplitRule
、SplitAttributes
和SplitAttributesCalculator
新增 API。(I92d23) - 新增
TestActivityStack
以建立ActivityStack
進行測試- 新增
TestSplitInfo
以建立SplitInfo
進行測試。(I8e779)
- 新增
- 新增建立虛假
SplitAttributesCalculatorParams
的方法,方便開發人員驗證自訂SplitAttributesCalculator
(Id4a6e) - 新增
WindowMetricsCalculator#computeCurrentWindowMetrics(@UiContext context: Context)
和WindowMetricsCalculator#computeMaximumWindowMetrics(@UiContext context: Context)
(I66c7f)
1.2.0-alpha02 版本
2023 年 6 月 7 日
發布 androidx.window:window-*:1.2.0-alpha02
。1.2.0-alpha02 版包含此連結所列的修訂項目。
新功能
- 更新測試 API,加入未指定折疊功能的常數。
- 使用
WindowLayoutInfoPublishRule
覆寫會覆寫windowLayoutInfo
的所有值,包括以 Context 為基礎的 API。
API 變更
- 新增未指定中央摺疊功能的常數。(I7530c)
修正錯誤
- 更新
WindowLayoutInfoPublishRule
,以支援以Context
為基礎的WindowLayoutInfo
覆寫。(I2037a)
1.2.0-alpha01 版本
2023 年 5 月 24 日
發布 androidx.window:window-*:1.2.0-alpha01
。1.2.0-alpha01 版包含此連結所列的修訂項目。
新功能
穩定活動嵌入和 WindowLayoutInfoTracker
的測試 API。ActivityEmbeddingRule
已升級為穩定版。
WindowMetricsCalculatorRule
已升級為穩定版。
建立 FoldingFeature
的測試公用程式函式已升級為穩定版。
API 變更
- 穩定
ActivityEmbeddingRule
,支援 Activity 嵌入的單元測試。(I8d6b6) WindowMetrisCalculatorTestRule
是穩定版本,可為 JVM 測試提供虛設常式指標。建議使用模擬器,確保結果準確。- 穩定
WindowLayoutInfo
的測試 API,支援 JVM 測試。(Ie036e) - 新增
IntRange
,以測試折疊功能值。(I69f7d)
1.1 版本
1.1.0 版本
2023 年 6 月 7 日
發布 androidx.window:window-*:1.1.0
。查看 1.1.0 版的修訂項。
自 1.0.0 版以來的重要變更
活動嵌入
- 在應用程式資訊清單中,將
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
新增為<application>
標記的布林值屬性。 - 已淘汰
isSplitSupported
,並改用splitSupportStatus
,提供更詳細的資訊,說明為何無法使用分割功能。 - 新增
SplitController.SplitSupportStatus
巢狀類別,為splitSupportStatus
屬性提供狀態常數。 - 將
SplitController
重構為多個模組:ActivityEmbeddingController
模組,適用於Activity
或ActivityStack
相關 API。- 已將
isActivityEmbedded
從SplitController
移至ActivityEmbeddingController
。 RuleController
模組,用於EmbeddingRule
相關作業:- 已移除
SplitController
API: clearRegisteredRules()
getSplitRules()
initialize()
registerRule()
unregisterRule()
- 新增
RuleController
API: addRule()
:新增規則或更新具有相同標記的規則。removeRule()
:從已註冊規則的集合中移除規則。setRules()
:建立規則集合。clearRules()
:移除所有已註冊的規則。parseRules()
:從 XML 規則定義剖析規則。
- 所有模組都需要透過
#getInstance()
方法初始化內容,包括:ActivityEmbeddingController#getInstance(Context)
SplitController#getInstance(Context)
RuleController#getInstance(Context)
- 新增
EmbeddingAspectRatio
類別,定義與顯示比例相關的列舉類別行為常數。 - 新增
SplitAttributes
類別,定義分割版面配置。 - 已在
SplitController
中新增SplitAttributes
計算機函式,可自訂分割畫面版面配置:setSplitAttributesCalculator(Function)
clearSplitAttributesCalculator()
isSplitAttributesCalculatorSupported()
,確認裝置是否支援SplitAttributesCalculator
API
- 新增
EmbeddingRule#tag
欄位。 SplitRule
中的 API 更新:- 新增
defaultSplitAttributes
,定義分割的預設分割版面配置,並取代splitRatio
和layoutDirection
。 - 將 XML 屬性
splitRatio
和splitLayoutDirection
的翻譯新增至defaultSplitAttributes
。 - 將最小尺寸定義改為使用密度獨立像素 (dp),而非像素。
- 新增
minHeightDp
,預設值為 600dp。 - 已將
minWidth
變更為minWidthDp
,預設值為 600dp。 - 已將
minSmallestWidth
變更為minSmallestWidthDp
,預設值為 600dp。 - 新增了預設值為
ALWAYS_ALLOW
的maxAspectRatioInHorizontal
。 - 新增預設值為 1.4 的
maxAspectRatioInPortrait
。 - 定義
FinishBehavior
巢狀類別,取代完成行為常數。 - 將屬性變更套用至
SplitPairRule
和SplitPlaceholderRule
的 Builder 巢狀類別。
- 新增
- 以
SplitInfo#getSplitAttributes()
取代SplitInfo#getSplitRatio()
,提供更多有關分攤的資訊。
WindowLayout
WindowInfoTracker
新增實驗性非活動 UI 內容支援。- 在
WindowMetricsCalculator
中新增實驗性非活動 UI 環境。
遷移步驟
- 如要啟用活動嵌入功能,在分割畫面中顯示活動,應用程式必須將
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
屬性新增至資訊清單<application>
標記:xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" />
這樣一來,系統就能預先為應用程式最佳化分割行為。 SplitInfo
ratio- 檢查目前的分割畫面是否為堆疊模式:
kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
- 查看目前的比例:
kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
- 檢查目前的分割畫面是否為堆疊模式:
- SplitController 遷移:
SplitController.getInstance()
變更為SplitController.getInstance(Context)
。SplitController.initialize(Context, @ResId int)
變更為RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))
。SplitController.getInstance().isActivityEmbedded(Activity)
變更為ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)
。SplitController.getInstance().registerRule(rule)
變更為RuleController.getInstance(Context).addRule(rule)
。SplitController.getInstance().unregisterRule(rule)
變更為RuleController.getInstance(Context).removeRule(rule)
。SplitController.getInstance().clearRegisteredRules()
變更為RuleController.getInstance(Context).clearRules()
。SplitController.getInstance().getSplitRules()
變更為RuleController.getInstance(Context).getRules()
。
SplitRule
屬性遷移:minWidth
和minSmallestWidth
現在使用 dp 單位,而非像素。應用程式可以使用下列呼叫:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )
或直接將minWith
(以像素為單位) 除以displayMetrics#density
。
- 完成行為常數必須遷移至
FinishBehavior
類似列舉的類別常數:FINISH_NEVER
變更為FinishBehavior.NEVER
。FINISH_ALWAYS
變更為FinishBehavior.ALWAYS
。FINISH_ADJACENT
變更為FinishBehavior.ADJACENT
。
- 版面配置方向必須遷移至
SplitAttributes.LayoutDirection
:ltr
變更為SplitAttributes.LayoutDirection.LEFT_TO_RIGHT
。rtl
變更為SplitAttributes.LayoutDirection.RIGHT_TO_LEFT
。locale
變更為SplitAttributes.LayoutDirection.LOCALE
。splitRatio
必須遷移至SplitAttributes.SplitType.ratio(splitRatio)
。
SplitPairRule.Builder
migrations:- 將
SplitPairRule.Builder(filters, minWidth, minSmallestWidth)
變更為kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
setLayoutDirection(layoutDirection)
和setSplitRatio(ratio)
變更為kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
setFinishPrimaryWithSecondary
和setFinishSecondaryWithPrimary
會採用類似FinishBehavior
列舉的常數。詳情請參閱「SplitRule 遷移作業」。- 使用
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
在直向裝置上顯示分割畫面。
- 將
SplitPlaceholder.Builder
migrations:- 只有
filters
和placeholderIntent
參數。其他屬性會移至設定器。詳情請參閱「SplitPairRule.Builder 遷移作業」。 setFinishPrimaryWithPlaceholder
採用類似列舉的常數。FinishBehavior
詳情請參閱「SplitRule 遷移作業」。setLayoutDirection(layoutDirection)
和setSplitRatio(ratio)
會變更為:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- 使用
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
在直向裝置上顯示分割畫面。
- 只有
1.1.0-rc01 版本
2023 年 5 月 10 日
發布 androidx.window:window-*:1.1.0-rc01
。1.1.0-rc01 版包含此連結所列的修訂項目。
新功能
- 將
ActivityEmbedding
發布為穩定版 API。 - 修正多項錯誤。
1.1.0-beta02 版
2023 年 4 月 5 日
發布 androidx.window:window-*:1.1.0-beta02
。1.1.0-beta02 版本包含這些修訂版本。
新功能
- 修正內部問題並清理。
1.1.0-beta01 版本
2023 年 3 月 22 日
發布 androidx.window:window-*:1.1.0-beta01
。1.1.0-beta01 版包含此連結所列的修訂項目。
活動嵌入
- 在應用程式資訊清單中,將
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
新增為<application>
標記的布林值屬性。 - 已淘汰
isSplitSupported
,並改用splitSupportStatus
,提供更詳細的資訊,說明為何無法使用分割功能。 - 新增
SplitController.SplitSupportStatus
巢狀類別,為splitSupportStatus
屬性提供狀態常數。 - 將
SplitController
重構為多個模組:ActivityEmbeddingController
模組,適用於Activity
或ActivityStack
相關 API。- 已將
isActivityEmbedded
從SplitController
移至ActivityEmbeddingController
。 RuleController
模組,用於EmbeddingRule
相關作業:- 已移除的
SplitController
API:clearRegisteredRules()
getSplitRules()
initialize()
registerRule()
unregisterRule()
- 新增
RuleController
API:addRule()
:新增規則或更新具有相同標記的規則。removeRule()
:從已註冊規則的集合中移除規則。setRules()
:建立規則集合。clearRules()
:移除所有已註冊的規則。- `parseRules()`:從 XML 規則定義剖析規則。
- 所有模組都需要透過
#getInstance()
方法初始化內容,包括:ActivityEmbeddingController#getInstance(Context)
SplitController#getInstance(Context)
RuleController#getInstance(Context)
- 新增
EmbeddingAspectRatio
類別,定義與顯示比例相關的列舉類別行為常數。 - 新增
SplitAttributes
類別,定義分割版面配置。 - 已在
SplitController
中新增SplitAttributes
計算機函式,可自訂分割畫面版面配置:setSplitAttributesCalculator(Function)
clearSplitAttributesCalculator()
isSplitAttributesCalculatorSupported()
,確認裝置是否支援 SplitAttributesCalculator API
- 新增
EmbeddingRule#tag
欄位。 SplitRule
中的 API 更新:- 新增
defaultSplitAttributes
,定義分割的預設分割版面配置,並取代splitRatio
和layoutDirection
。 - 將 XML 屬性
splitRatio
和splitLayoutDirection
的翻譯新增至defaultSplitAttributes
。 - 將最小尺寸定義改為使用密度獨立像素 (dp),而非像素。
- 新增
minHeightDp
,預設值為 600dp。 - 已將
minWidth
變更為minWidthDp
,預設值為 600dp。 - 已將
minSmallestWidth
變更為minSmallestWidthDp
,預設值為 600dp。 - 新增了預設值為
ALWAYS_ALLOW
的maxAspectRatioInHorizontal
。 - 新增了預設值為
1.4
的maxAspectRatioInPortrait
。 - 定義
FinishBehavior
巢狀類別,取代完成行為常數。 - 將屬性變更套用至
SplitPairRule
和SplitPlaceholderRule
的Builder
巢狀類別。
- 新增
- 以
SplitInfo#getSplitAttributes()
取代SplitInfo#getSplitRatio()
,提供更多有關分攤的資訊。
WindowLayout
- 在
WindowInfoTracker
中新增非活動 UI 內容支援。 - 在
WindowMetricsCalculator
中新增非活動 UI 環境。
遷移步驟
- 如要啟用活動嵌入功能,在分割畫面中顯示活動,應用程式必須將
PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED
屬性新增至資訊清單<application>
標記:xml <property android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_SPLITS_ENABLED" android:value="true" />
這樣一來,系統就能預先為應用程式最佳化分割行為。 SplitInfo
ratio- 檢查目前的分割畫面是否為堆疊模式:
kotlin SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.ExpandContainersSplitType
- 查看目前的比例:
kotlin if (SplitInfo.splitAttributes.splitType is SplitAttributes.SplitType.RatioSplitType) { val ratio = splitInfo.splitAttributes.splitType.ratio } else { // Ratio is meaningless for other types. }
- 檢查目前的分割畫面是否為堆疊模式:
SplitController
migrations:SplitController.getInstance()
變更為SplitController.getInstance(Context)
。SplitController.initialize(Context, @ResId int)
變更為RuleController.getInstance(Context).setRules(RuleController.parse(Context, @ResId int))
。SplitController.getInstance().isActivityEmbedded(Activity)
變更為ActivityEmbeddingController.getInstance(Context).isActivityEmbedded(Activity)
。SplitController.getInstance().registerRule(rule)
變更為RuleController.getInstance(Context).addRule(rule)
。SplitController.getInstance().unregisterRule(rule)
變更為RuleController.getInstance(Context).removeRule(rule)
。SplitController.getInstance().clearRegisteredRules()
變更為RuleController.getInstance(Context).clearRules()
。SplitController.getInstance().getSplitRules()
變更為RuleController.getInstance(Context).getRules()
。
SplitRule
屬性遷移:minWidth
和minSmallestWidth
現在使用 dp 單位,而非像素。應用程式可以使用下列呼叫:kotlin TypedValue.applyDimension( COMPLEX_UNIT_DIP, minWidthInPixels, resources.displayMetrics )
或直接將minWith
(以像素為單位) 除以displayMetrics#density
。
- 完成行為常數必須遷移至
FinishBehavior
類似列舉的類別常數:FINISH_NEVER
變更為FinishBehavior.NEVER
。FINISH_ALWAYS
變更為FinishBehavior.ALWAYS
。FINISH_ADJACENT
變更為FinishBehavior.ADJACENT
。
- 版面配置方向必須遷移至
SplitAttributes.LayoutDirection
:ltr
變更為SplitAttributes.LayoutDirection.LEFT_TO_RIGHT
。rtl
變更為SplitAttributes.LayoutDirection.RIGHT_TO_LEFT
。locale
變更為SplitAttributes.LayoutDirection.LOCALE
。splitRatio
必須遷移至SplitAttributes.SplitType.ratio(splitRatio)
。
SplitPairRule.Builder
migrations:- 將
SplitPairRule.Builder(filters, minWidth, minSmallestWidth)
變更為kotlin SplitPairRule.Builder(filters) .setMinWidthDp(minWidthInDp) // Optional if minWidthInDp is 600. .setMinSmallestWidthDp(minSmallestWidthDp) // Optional if minSmallestWidthInDp is 600.
setLayoutDirection(layoutDirection)
和setSplitRatio(ratio)
變更為kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
setFinishPrimaryWithSecondary
和setFinishSecondaryWithPrimary
會採用類似FinishBehavior
列舉的常數。詳情請參閱「SplitRule 遷移作業」。- 使用
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
在直向裝置上顯示分割畫面。
- 將
SplitPlaceholder.Builder
migrations:- 只有
filters
和placeholderIntent
參數。其他屬性會移至設定器。詳情請參閱「SplitPairRule.Builder 遷移作業」。 setFinishPrimaryWithPlaceholder
採用類似列舉的常數。FinishBehavior
詳情請參閱「SplitRule 遷移作業」。setLayoutDirection(layoutDirection)
和setSplitRatio(ratio)
會變更為:kotlin setDefaultSplitAttributes( SplitAttributes.Builder() .setLayoutDirection(layoutDirection) .setSplitType(SplitAttributes.SplitType.ratio(ratio)) .build() )
- 使用
setMaxAspectRatioInPortrait(EmbeddingAspectRatio.ALWAYS_ALLOW)
在直向裝置上顯示分割畫面。
- 只有
1.1.0-alpha06 版本
2023 年 2 月 22 日
發布 androidx.window:window-*:1.1.0-alpha06
。查看 1.1.0-alpha06 版的修訂項。
新功能
- 公開實驗功能版本,從 UI 內容取得
WindowLayoutInfo
。
API 變更
- 新增
splitSupportStatus
,表示是否支援 Activity 嵌入功能。(I10024) - 將 UI Context
WindowLayoutInfo
API 列為實驗功能。(I58ee0) - 加入
WindowAreaController
和 API,讓RearDisplay
模式將目前視窗移至與後置鏡頭對齊的螢幕。(Iffcbf) - 更新預設背景顏色。(I1ac1b)
- 新增
SplitAttributes
參數。(I18bdd) - 為
SplitRule
、SplitAttributes
和SplitAttributesCalculator
新增 API。(I92d23) - 改善與
maxAspectRatio
相關的 API:- 以
ALWAYS_ALLOW
和ALWAYS_DISALLOW
取代alwaysAllow()
和alwaysDisallow()
。 - 將 @see 的 API 說明文件更新為獨立說明文件。(I3057b)
- 以
- 下列建構函式本就不該讓應用程式呼叫,因此已從公用 API 中移除。
SplitInfo
建構函式ActivityStack
建構函式 (Ide534)
SplitRule
現可採用maxAspectRatioInPortrait/Landscape
。只有在父項邊界的顯示比例小於或等於要求的maxAspectRatio
時,才能分割活動。(Ia5990)- 將
RuleController#parseRules
變更為靜態性質 (I785df) - 改善與 ActivityEmbedding 相關的 API
- 採用一致的 API 命名方式 - 針對多個例項使用新增/移除功能:
- 將
registerRule
變更為addRule
- 將
unregisterRule
變更為removeRule
- 將
getSplitRules
替換為getRules
,因為ActivityRule
不是分割規則 - 新增
RuleController#setRules
,用來設定大量規則 - 從
SplitController
擷取規則相關 API 至單例模式RuleController
。這些因素包括: addRule
removeRule
getRules
setRules
clearRules
parseRules
- 從
SplitController
擷取#isActivityEmbedded
到單例模式ActivityEmbeddingController
。這些因素包括: isActivityEmbedded
- 移除
SplitController#initialize
。如要透過 XML 檔案設定規則,請使用RuleController#parseRules
和#setRules
。 實施這項變更前:SplitController.initialize(context, R.xml.static_rules)
實施這項變更後:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
- 我們不再區分靜態規則與執行階段規則。也就是說,呼叫
#clearRules
結果即可清除所有規則,無論是使用靜態 XML 規則定義註冊或在執行階段註冊都一樣。如要保留SplitController#clearRegisteredRules
的舊版行為,請使用 XML 資源 ID 呼叫RuleController#parseRules
,並呼叫RuleController#setRules
再次設回規則。實施這項變更前:SplitController.getInstance(context).clearRegisteredRules()
實施這項變更後:val ruleController = RuleController.getInstance(context) val rules = ruleController.parseRules(R.xml.static_rules) ruleController.setRules(rules)
(Ib3967)
- 改善 SplitRule API:
- 針對
SplitRule
採用以 DP 為單位的最小尺寸,而非像素。 - 重構
SplitRule
建構工具,使其採用最小尺寸做為選用項目。(I95f17)
- 針對
- 傳遞 Context,用來初始化
SplitController
(I42549) - 已將
SplitRule#layoutDir
重新命名為#layoutDirection
,並將SplitRule Builder#setLayoutDir
重新命名為Builder#setLayoutDirection
。(I3f6d1)
1.1.0-alpha04 版本
2022 年 11 月 9 日
發布 androidx.window:window-*:1.1.0-alpha04
。1.1.0-alpha04 版包含此連結所列的修訂項目。
新功能
- 公開判定
ActivityEmbedding
的ActivityStack
是否空白的方法。 - 從
ActivityEmbedding
API 中移除實驗性 API 標記。 - 將
ActivityRule
建構函式做為Builder
隱藏是偏好的方式。 - 新增在
WindowMetrics
取得WindowInsets
的實驗性方法。 - 更新
SplitPlaceholderFinishBehavior
,以免結束預留位置。如果結束預留位置,則會造成某項錯亂行為。
API 變更
- 將 val
isEmpty
設為公開,即可取代 funisEmpty
。 - 將
ActivityStack
參數活動重新命名為activitiesInProcess
。(Ia5055) - 移除造成錯亂的
ActivityFilter#matchesClassName
和ActivityFilter#matchesClassNameOrWildCard
。 - 新增
ActivityFilter#componentName
和ActivityFilter#intentAction
,方便呼叫端區別不同的篩選條件 (I41f22) - 從實驗性 API 中移除
@Deprecated
API (I216b3) - 移除活動嵌入 API 的
@ExperimentalWindowApi
(I69ebe) - 隱藏
ActivityRule
建構函式,請改用 Builder。(If4eb6) - 新增用於檢查活動是否屬於
ActivityFilter
的 API。(Ia43cf) - 更新 API 檔案,以反映
WindowMetrics
和WindowMetricsCalculatorCompat
類別的變更 (I667fe) - 更新
ActivityEmbedding
屬性 Javadoc 和類別名稱 (Ia1386) - 新增要用於 AndroidManifest.xml (Id1ad4) 的
ActivityEmbedding
屬性標記名稱 - 新增取代
SplitPlaceholderRule.finishPrimaryWithSecondary
的 APISplitPlaceholderFinishBehavior
和SplitPlaceholderRule.finishPrimaryWithPlaceholder
,藉以定義何時要結束預留位置活動,以及活動嵌入中關聯的活動應有怎樣的行為。(I64647)
修正錯誤
- 加入
WindowAreaController
和 API,讓RearDisplay
模式將目前視窗移至與後置鏡頭對齊的螢幕。(I388ab)
1.1.0-alpha03 版本
2022 年 7 月 27 日
發布 androidx.window:window-*:1.1.0-alpha03
。1.1.0-alpha03 版包含此連結所列的修訂項目。
新功能
- 更新嵌入規則的預設值。
API 變更
- 更新嵌入規則屬性的預設值 (Ic4d35)
1.1.0-alpha02 版本
2022 年 5 月 11 日
發布 androidx.window:window-*:1.1.0-alpha02
。查看 1.1.0-alpha02 版的修訂項。
新功能
- 發布轉接程式程式庫以支援 Java 與 RxJava。
1.1.0-alpha01 版本
2022 年 5 月 11 日
發布 androidx.window:window-*:1.1.0-alpha01
。1.1.0-alpha01 版包含以下修訂項目。
新功能
- 發布轉接程式以支援 Java 與 RxJava
1.1.0-alpha01 版本
2022 年 4 月 20 日
發布 androidx.window:window:1.1.0-alpha01
。1.1.0-alpha01 版包含以下修訂項目。
新功能
- 修正了當設定應用程式背景時會停止傳送折疊功能的錯誤。
- 在實驗性 ActivityEmbedding API 中展開。
API 變更
- 用於檢查活動是否嵌入的公用 API。(I39eb7)
修正錯誤
1.0 版本
1.0.0 版本
2022 年 1 月 26 日
發布 androidx.window:window-*:1.0.0
。1.0.0 版包含此連結所列的修訂項目。
1.0.0 的主要功能
- 透過
WindowInfoTracker
和FoldingFeature
支援折疊式手機。使用WindowMetricsCalculator
計算目前的 WindowMetrics。
1.0.0-rc01 版
2021 年 12 月 15 日
androidx.window:window-*:1.0.0-rc01
發布。查看 1.0.0-rc01 版的修訂項。
新功能
- 新增透過
WindowInfoTracker
提供折疊式手機支援。 - 新增方法來計算
WindowMetrics
的現有值和最小值。 - 新增支援的測試 API。
1.0.0-beta04 版
2021 年 11 月 17 日
androidx.window:window-*:1.0.0-beta04
發布。1.0.0-beta04 版包含此連結所列的修訂項目。
新功能
- 將 WindowInfoRepository 重新命名為 WindowInfoTracker。
- 將活動明確設為 WindowInfoTracker 的方法依附元件。
- 為 WindowMetricsCalculator 新增簡單的 TestRule,藉此支援使用 Robolectric 的開發人員。
API 變更
- 擷取擴充功能。(I25a5f)
- 在 ActivityStack 中新增 isEmpty。(I5a4e6)
- 將 WindowInfoRepository 重新命名為 WindowInfoTracker。
- 更新 java/rxjava/testing 依附元件以進行比對。(I0da63)
- 為簡易的 WindowMetricsCalculator 新增測試規則。(Ibacdb)
1.0.0-beta03 版
2021 年 10 月 27 日
androidx.window:window-*:1.0.0-beta03
發布。1.0.0-beta03 版包含此連結所列的修訂項目。
新功能
- 新增實驗功能活動嵌入 API。初始版面配置版本可讓您並排顯示兩個活動。
API 變更
- 已移除 currentWindowMetrics API,因為我們無法正確提供。請改用 WindowMetricsCalculator。(Icda5f)
- 已更新擴充功能 API。(Ica92b)
- 已新增允許嵌入活動的新功能介面,並可在父項工作視窗中並排顯示這些活動。(I5711d)
- 隱藏 WindowMetrics 和 WindowLayoutInfo 的建構函式,請改用測試 API。(I5a1b5)
- 新增 API,用於建立假的 WindowLayoutInfo 物件。(I4a2fd)
修正錯誤
- 修正記憶體流失問題。(I3fc79、b/202989046)
1.0.0-beta02 版
2021 年 9 月 1 日
androidx.window:window-*:1.0.0-beta02
發布。查看 1.0.0-beta02 版的修訂項。
新功能
- 新增實驗功能註解,以註解實驗功能 API。(I9f1b6)
- 新增測試方法,建立可接受 Rect 的測試 FoldingFeature。如此一來,您在使用 Robolectric 時,會比實際活動更容易測試。(Id1cca)
1.0.0-beta01 版
2021 年 8 月 18 日
androidx.window:window-*:1.0.0-beta01
發布。1.0.0-beta01 版包含此連結所列的修訂項目。
新功能
- 已移除舊常數,並使
FoldingFeature
成為介面。
API 變更
- 移除舊常數,並將 FoldFeature 設為介面。(I9a2d5)
修正錯誤
- 仰賴
Test Core
程式庫的程式庫已升級為1.4.0
版,現在可與 Android 平台版本 S 搭配使用。(I88b72、b/189353863)
1.0.0-alpha10 版本
2021 年 8 月 4 日
androidx.window:window-*:1.0.0-alpha10
發布。1.0.0-alpha10 版本包含以下修訂項目。
新功能
- 將 WindowInfoRepo 重新命名為 WindowInfoRepository 並調整對應的類別 / 檔案。
- 將目前的視窗指標轉換為 WindowInfoRepository 中的流程,因為值會隨著時間改變。
- 將 WindowInfoRepoJavaAdapter 重新命名為 WindowInfoRepoCallbackAdapter
- 新增輔助方法來建立測試 FoldingFeature 物件。
- 根據支援的功能更新套件,將類別分類。
API 變更
- 將 ActivityExt 重新命名為 ActivityExtensions 從 Repo 變更為 Repository。(I61a16)
- 更新類別的套件。(I23ae2)
- 從 WindowInfoRepo 移除 WindowMetrics。(I24663)
- 移除 WindowManager 並使用 WindowInfoRepo
- 將 WindowBackend 設為內部。(I06d9a)
- 將視窗指標轉換為流程。
- 將 Java 轉接程式重新命名為 WindowInfoRepoCallbackAdapter
- 移除 callbackFlow,因此不必再使用實驗功能 API。(Ia4d15)
- 新增輔助方法來建立測試顯示功能。
- 從 occlusionMode 變更為 occlusionType (If4cff)
修正錯誤
- 修正移除核心程式庫的 ProGuard 錯誤。
- 修正未將 WindowLayoutInfo 傳送給其他訂閱者的錯誤。
- 修正設定變更不會觸發折疊功能更新的錯誤。
1.0.0-alpha09 版本
2021 年 6 月 30 日
androidx.window:window-*:1.0.0-alpha09
發布。查看 1.0.0-alpha09 版的修訂項。
新功能
- 從整數常數變更為不設限的列舉。
- 新增測試公用程式,以建立測試折疊功能。
API 變更
- 新增輔助方法來建立測試顯示功能。(I3cf54)
- 從
occlusionMode
變更為occlusionType
。
- 從
修正錯誤
- 新增多位資料串流消費者時,先發出初始值。
1.0.0-alpha08 版本
2021 年 6 月 16 日
androidx.window:window-*:1.0.0-alpha08
發布。查看 1.0.0-alpha08 版的修訂項。
新功能
- 發布測試構件,方便您在使用 WindowInfoRepository 時進行測試。使用 WindowInfoRepository 取得 DisplayFeatures 和 WindowMetrics 的相關資訊。(I57f66、Ida620)
1.0.0-alpha07 版本
2021 年 6 月 2 日
androidx.window:window-*:1.0.0-alpha07
發布。查看 1.0.0-alpha07 版的修訂項。
新功能
- 將核心視窗程式庫遷移至 Kotlin。將使用協同程式並暫停函式,以公開日後的非同步資料。
- 將 WindowInfoRepo 新增為取得 WindowMetrics 和 WindowLayoutInfo 串流的主要互動點。
- 新增
window-java
構件來公開 Java 適用的 API,用於註冊及取消註冊回呼。 - 新增
window-rxjava2
和window-rxjava3
構件,以公開經過 RxJava 調整的 API。
API 變更
修正錯誤
- 新增資料類別來代表特徵邊界。(I6dcd1)
1.0.0-alpha06 版本
2021 年 5 月 5 日
androidx.window:window:1.0.0-alpha06
發布。1.0.0-alpha06 版本包含以下修訂項目。
新功能
- 我們已經開始遷移至 Kotlin,將於下一版中完成。
- DeviceState 已從公用 API 中移除,請改用 FoldingFeature。
- 我們目前已將
STATE_FLIPPED
從 FoldingFeature 狀態中移除,因為目前沒有任何用途支援這項功能。 - 我們也移除了其他已淘汰的 API。
API 變更
- 將 Kotlin 新增為依附元件。
- 將核心程式庫遷移至 Kotlin。(Idd995)
- 已移除
DisplayFeature
建構工具。(I61fa4) - 已從公用 API 中移除
DeviceState
,請改用FoldingFeature
。(Id6079) - 從擴充功能中移除裝置狀態回呼。(I5ea83)
- 從 FoldingFeature 移除
STATE_FLIPPED
。(I9c4e1) - 移除已淘汰的註冊方法。(Ib381b)
1.0.0-alpha05 版本
2021 年 3 月 24 日
androidx.window:window:1.0.0-alpha05
發布。1.0.0-alpha05 版包含此連結所列的修訂項目。
新功能
我們已為 FoldingFeature 新增便利的方法,讓應用程式能夠判斷功能是否分離、阻塞,並判定轉軸的方向。我們也會隱藏轉軸類型。
我們即將從 WindowManager 中移除同步讀取方法。同步讀取方法很容易出錯,因為有隱含的競爭狀況。註冊事件監聽器和回呼,即可在 WindowLayoutInfo 上接收更新。
API 變更
1.0.0-alpha04 版本
2021 年 3 月 10 日
androidx.window:window:1.0.0-alpha04
發布。1.0.0-alpha04 版本包含以下修訂項目。
新功能
- 修正未執行 OEM 實作時,不會發出 WindowLayoutInfo 的錯誤。我們現在會發出空的 WIndowLayoutInfo。
- 修正應用程式在背景執行時,轉軸狀態變更時狀態未妥善更新的錯誤。現在狀態應能保持一致。
- 更新 ProGuard 檔案,忽略執行階段依附元件的警告。
修正錯誤
- 缺少 OEM 程式庫時,發送空白值。(Ide935)
1.0.0-alpha03 版本
2021 年 2 月 18 日
androidx.window:window:1.0.0-alpha03
發布。1.0.0-alpha03 版包含以下修訂項目。
新功能
- 當 OEM 實作為空白時,發出空白的 WindowLayoutInfo 值。這樣你就可以在更多裝置上輕鬆使用程式庫。由於 API 為非同步,我們仍建議應用程式編寫一些防禦程式碼,並在逾時後發出預設值。我們無法對 OEM 實作作業提供任何保證,因此初始值可能會延遲。
修正錯誤
- 缺少 OEM 程式庫時,發送空白值。(Ide935)
1.0.0-alpha02 版
2021 年 1 月 27 日
androidx.window:window:1.0.0-alpha02
發布。1.0.0-alpha02 版包含此連結所列的修訂項目。
新功能
我們已淘汰部分 API 來簡化 API,並減少錯誤。值得留意的範例包括從 WindowManager 移除同步讀取作業,並淘汰 DeviceState。同步讀取作業可能會導致競爭狀況及不正確的使用者介面。
我們已將 DisplayFeature 轉換至日後可實作其他功能的介面。第一項功能是 FoldingFeature,現在表示螢幕折疊或轉軸。另外也包含轉軸取代 DeviceState 的狀態。
WindowMetrics 是在 Android 11 中推出,讓開發人員透過簡單的方法查詢視窗相關指標,例如其在畫面上的位置和大小及系統插邊。我們已在這個版本中向後移植 API,讓開發人員能利用 WindowMetrics 並繼續支援舊版 Android。WindowMetrics 可透過
WindowManager#getCurrentWindowMetrics()
和 WindowManager#getMaximumWindowMetrics() API 取得。
API 變更
- 淘汰將在下一個 Alpha 版中移除的 API (Ib7cc4)
- 更新
ExtensionInterface
,使其接受明確的 Activity 參照。(I07ded) - 推出 WindowMetrics API。(I3ccee)
- 從 WindowManager 移除同步讀取方法 (I69983)
- 為 ExtensionWindowBackend 套件加上防護。(Ied208)
修正錯誤
- 更新
ExtensionInterface
API,使其接受影像形式的背景資訊。(I8e827)
外部貢獻
- 合併 DeviceState 和 WindowLayoutInfo,這樣即可輕鬆存取資料。(Id34f4)
1.0.0-alpha01 版
2020 年 2 月 27 日
發布了 androidx.window:window:1.0.0-alpha01
和 androidx.window:window-extensions:1.0.0-alpha01
。1.0.0-alpha01 版包含這些修訂版本。這是視窗管理員程式庫的第一個版本。
新功能
DisplayFeature
:這個新的 API 可找出連續平面螢幕途徑的中斷情形,例如轉軸或折疊DeviceState
:這個新的 API 會根據已定義的姿勢清單 (例如CLOSED
、OPENED
、HALF_OPENED
等),提供手機目前的姿勢。