WindowManager

Jetpack 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 版包含這些修訂項目。

新功能

修正錯誤

  • 在預設的 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 with ActivityOptionsCompat 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 變更

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

  • 移除已淘汰的 API (I18d39)
  • 新增對並行顯示器的支援。(Ifcbb0)

修正錯誤

  • 新增選擇不採用相容性屬性，以強制覆寫大小調整設定 (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：
    1. 以 ALWAYS_ALLOW 和 ALWAYS_DISALLOW 取代 alwaysAllow() 和 alwaysDisallow()。
    2. 將 @see 的 API 說明文件更新為獨立說明文件。(I3057b)
  • 下列建構函式本就不該讓應用程式呼叫，因此已從公用 API 中移除。
    • SplitInfo 建構函式
    • ActivityStack 建構函式 (Ide534)
  • SplitRule 現可採用 maxAspectRatioInPortrait/Landscape。只有在父項邊界的顯示比例小於或等於要求的 maxAspectRatio 時，才能分割活動。(Ia5990)
  • 將 RuleController#parseRules 變更為靜態性質 (I785df)
  • 改善與 ActivityEmbedding 相關的 API
    1. 採用一致的 API 命名方式 - 針對多個例項使用新增/移除功能：
    2. 將 registerRule 變更為 addRule
    3. 將 unregisterRule 變更為 removeRule
    4. 將 getSplitRules 替換為 getRules，因為 ActivityRule 不是分割規則
    5. 新增 RuleController#setRules，用來設定大量規則
    6. 從 SplitController 擷取規則相關 API 至單例模式 RuleController。這些因素包括：
    7. addRule
    8. removeRule
    9. getRules
    10. setRules
    11. clearRules
    12. parseRules
    13. 從 SplitController 擷取 #isActivityEmbedded 到單例模式 ActivityEmbeddingController。這些因素包括：
    14. isActivityEmbedded
    15. 移除 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)
    16. 我們不再區分靜態規則與執行階段規則。也就是說，呼叫 #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：
    1. 針對 SplitRule 採用以 DP 為單位的最小尺寸，而非像素。
    2. 重構 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 設為公開，即可取代 fun isEmpty。
  • 將 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 的 API SplitPlaceholderFinishBehavior 和 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)

修正錯誤

  • 新增 API 以自訂活動分割中的容器完成行為 (I1a1e4)
  • 為活動分割規則新增設定選項。(Iec6af)

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)

修正錯誤

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

  • 新增 WindowServices 以統一提供依附元件。
    • 新增以協同程式為基礎的 API，以便使用視窗版面配置資訊。(Iab70f)
  • 將核心視窗管理員程式庫遷移至 Kotlin。(Icca34)

修正錯誤

  • 新增資料類別來代表特徵邊界。(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 變更

  • 新增使用 FoldingFeatures 的便利方法 (Ie733f)
  • 從 WindowManager 移除同步讀取方法 (I96fd4)

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 等)，提供手機目前的姿勢。