作者 / Android 開發(fā)者關(guān)系工程師 Francesco Romano

自 Jetpack WindowManager 1.0 穩(wěn)定版發(fā)布的一年多以來，可折疊設(shè)備和大屏設(shè)備領(lǐng)域發(fā)生了諸多變化。許多新款設(shè)備都已進(jìn)入市場，大量新用例也已解鎖！ Jetpack WindowManager 庫在幫助您優(yōu)化您的 Android 應(yīng)用上發(fā)揮重要作用，使其能夠適用于不同的設(shè)備類型。并且此版本還包含多項(xiàng)新功能和改進(jìn)，是一個(gè)重大的里程碑式進(jìn)展。 讓我們來回顧一下 Jetpack WindowManager 庫涵蓋的所有用例。

獲取窗口指標(biāo) (和大小類別！)

過去，開發(fā)者通過設(shè)備顯示尺寸來決定其應(yīng)用布局，但隨著不同設(shè)備類型 (如可折疊設(shè)備) 和顯示模式 (如多窗口模式和多顯示屏模式) 的出現(xiàn)，了解應(yīng)用窗口的大小而不是設(shè)備的顯示尺寸變得至關(guān)重要。 Jetpack WindowManager WindowMetricsCalculator 界面可以提供可靠的數(shù)據(jù)來源，以幫助您衡量當(dāng)前可用于顯示您應(yīng)用的屏幕空間。

• WindowMetricsCalculator

  https://developer.android.google.cn/reference/kotlin/androidx/window/layout/WindowMetricsCalculator

在此基礎(chǔ)上，窗口大小類別是一組視口劃分點(diǎn)，有助于您設(shè)計(jì)、開發(fā)和測試響應(yīng)式和自適應(yīng)應(yīng)用布局。此類劃分點(diǎn)專門用于平衡布局的簡單性和靈活性，以便針對特殊情況優(yōu)化您的應(yīng)用。

• 窗口大小類別

  https://developer.android.google.cn/guide/topics/large-screens/support-different-screen-sizes#window_size_classes

對于基于 View 的應(yīng)用，您可以使用以下代碼段來計(jì)算窗口大小類別:

privatefuncomputeWindowSizeClasses(){
        val metrics = WindowMetricsCalculator.getOrCreate()
            .computeCurrentWindowMetrics(this)
        val width = metrics.bounds.width()
        val height = metrics.bounds.height()
        val density = resources.displayMetrics.density
        val windowSizeClass = WindowSizeClass.compute(width/density, height/density)


        // use windowSizeClass.windowHeightSizeClass and windowSizeClass.windowWidthSizeClass
}

您可以參閱 "支持不同屏幕尺寸"開發(fā)者指南了解詳細(xì)信息。

• 支持不同屏幕尺寸

  https://developer.android.google.cn/guide/topics/large-screens/support-different-screen-sizes

讓應(yīng)用能夠感知折疊

Jetpack WindowManager 還提供優(yōu)化可折疊設(shè)備布局所需的所有 API。 具體而言，您可以使用 WindowInfoTracker 查詢 FoldingFeature 信息，如

• 狀態(tài): 設(shè)備的折疊狀態(tài): FLAT 或 HALF_OPENED

• 方向:折疊或設(shè)備合頁的方向:HORIZONTAL 或 VERTICAL
• 遮擋類型: 折疊或合頁是否遮擋部分顯示屏:NONE 或 FULL
• 是否分離:折疊或合頁是否創(chuàng)建了兩個(gè)邏輯顯示區(qū)域:true 或 false
• 邊界:應(yīng)用窗口內(nèi)功能的邊界矩形 (繼承自 DisplayFeature)

• WindowInfoTrackerhttps://developer.android.google.cn/reference/kotlin/androidx/window/layout/WindowInfoTracker
• FoldingFeaturehttps://developer.android.google.cn/reference/androidx/window/layout/FoldingFeature
• DisplayFeaturehttps://developer.android.google.cn/reference/androidx/window/layout/DisplayFeature#getBounds%28%29

您可以通過 Flow 訪問這些數(shù)據(jù):

override fun onCreate(savedInstanceState: Bundle?) {
    ...
    lifecycleScope.launch(Dispatchers.Main) {
        lifecycle.repeatOnLifecycle(Lifecycle.State.STARTED) {
            WindowInfoTracker.getOrCreate(this@MainActivity)
                .windowLayoutInfo(this@MainActivity)
                .collect { layoutInfo ->
                    // New posture information
                    val foldingFeature = layoutInfo.displayFeatures
                    // use the folding feature to update the layout
                }
        }
    }
}

• Flow

  https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/

一旦收集到 FoldingFeature 信息，您便可以使用這些數(shù)據(jù)為當(dāng)前設(shè)備狀態(tài)創(chuàng)建優(yōu)化布局，例如實(shí)現(xiàn)桌面模式。您可以在 MediaPlayerActivity.kt 中查看桌面模式的示例。

• MediaPlayerActivity.kt

  https://github.com/android/platform-samples/blob/main/samples/user-interface/windowmanager/src/main/java/com/example/platform/ui/windowmanager/MediaPlayerActivity.kt

您還可以訪問我們的 Codelab 了解如何使用 Jetpack WindowManager 支持可折疊設(shè)備和雙屏設(shè)備:https://developer.android.google.cn/codelabs/android-window-manager-dual-screen-foldables

并排顯示兩個(gè) Activity

除了上述功能您還可以使用最新的穩(wěn)定版 Jetpack WindowManager API:Activity 嵌入。

• Activity 嵌入

  https://developer.android.google.cn/reference/kotlin/androidx/window/embedding/package-summary

自 Android 12L 起，Activity 嵌入允許采用傳統(tǒng)多 Activity 架構(gòu)的開發(fā)者通過同一應(yīng)用，甚至多個(gè)應(yīng)用在大屏設(shè)備上并排顯示多個(gè) Activity。 這是以最少的代碼更改甚至無需代碼更改便可以實(shí)現(xiàn)列表詳情布局的絕佳方式。 注意: Modern Android Development (MAD) 建議使用基于 Jetpack API (包括 Jetpack Compose) 的單 Activity 架構(gòu)。如果您的應(yīng)用使用 Fragment，請參閱 SlidingPaneLayout。Activity 嵌入專為無法輕松更新為 MAD 的多 Activity 舊版應(yīng)用而設(shè)計(jì)。

• SlidingPaneLayout

  https://developer.android.google.cn/jetpack/androidx/releases/slidingpanelayout

這也是該庫中最大的變化，目前在 Jetpack WindowManager 1.1 版中，Activity 嵌入 API 非常穩(wěn)定！ 不僅如此，該 API 目前的功能也更加豐富，您可以通過此 API:

• 修改分屏行為 (分屏比例、規(guī)則、結(jié)束行為)

• 定義占位符
• 在運(yùn)行時(shí)環(huán)境中檢查 (并更改) 分屏狀態(tài)
• 實(shí)現(xiàn)水平分屏
• 在全窗口中啟動(dòng)模態(tài)

如果您想探索 Activity 嵌入，可訪問專用 Codelab 了解如何使用 Activity 嵌入構(gòu)建列表詳情布局:

https://developer.android.google.cn/codelabs/large-screens/activity-embedding

許多應(yīng)用都已開始在生產(chǎn)環(huán)境中使用 Activity 嵌入，例如 WhatsApp: ?還有 eBay！

實(shí)現(xiàn)包含多 Activity 的列表詳情布局并不是 Activity 嵌入的唯一用例。 自 Android 13 (API 級(jí)別 33) 起，應(yīng)用可以嵌入來自其他應(yīng)用的 Activity。 跨應(yīng)用 Activity 嵌入支持多個(gè) Android 應(yīng)用的 Activity 進(jìn)行可視化集成處理。系統(tǒng)會(huì)在屏幕上并排或上下顯示托管應(yīng)用的 Activity 和其他應(yīng)用的嵌入 Activity，就像在單一應(yīng)用 Activity 嵌入中一樣。 托管應(yīng)用會(huì)按照實(shí)現(xiàn)單一應(yīng)用 Activity 嵌入的相同方式實(shí)現(xiàn)跨應(yīng)用 Activity 嵌入，但出于安全原因，被嵌入的應(yīng)用必須同意并選擇加入。 您可以在 "Activity 嵌入" 開發(fā)者指南中深入了解跨應(yīng)用嵌入:

• Activity 嵌入

  https://developer.android.google.cn/guide/topics/large-screens/activity-embedding#cross-application

總結(jié)

如果您想優(yōu)化您的應(yīng)用在不同設(shè)備類型上的用戶體驗(yàn)，Jetpack WindowManager 便是您應(yīng)該學(xué)習(xí)的最重要的庫之一。 WindowManager 還將在每個(gè)版本中添加有趣的新功能，敬請關(guān)注 1.2 版本中即將推出的功能。

• 1.2 版本

  https://developer.android.google.cn/jetpack/androidx/releases/window#version_12_2

您可以參閱 Jetpack WindowManager 文檔和示例應(yīng)用，即刻開始使用 WindowManager！

• 文檔

  https://developer.android.google.cn/jetpack/androidx/releases/window

• 示例應(yīng)用

  https://github.com/android/platform-samples/tree/main/samples/user-interface/windowmanager

開發(fā)者福利月

在十月，開啟專屬開發(fā)者們的快樂！線下線上精彩互動(dòng)活動(dòng)、神秘禮品、干貨資料包統(tǒng)統(tǒng)安排上，讓驚喜和期待填滿整月。

趕快來了解詳情參與互動(dòng)，收獲快樂和福利吧！

?點(diǎn)擊屏末|閱讀原文|即刻開始使用 Jetpack WindowManager