用來建置 Surface Duo 應用程式的 SDK

有三種不同的方式可讓您增強 Surface Duo 應用程式：

雙螢幕程式庫 - 一組版面配置、控制項和協助程式類別，可為應用程式新增雙螢幕支援。
Jetpack 視窗管理員 - 這是 Android 套件，可提供適用於遮罩區域和轉軸角度的 API，此套件可在不同製造商推出的摺疊式裝置 (包括 Surface Duo) 上運作。
顯示遮蔽區和轉軸角度 - Surface Duo 特定的 API，可協助您偵測遮蔽的接縫區域和轉軸角度。

您只能在應用程式中包含所需的內容。請參閱下列指示，以更新您的 Android Studio 專案。

雙螢幕程式庫版面配置控制項

版面配置控制項和協助程式的程式庫 (適用於 Kotlin 和 Java 開發人員)：

若要存取這些功能，請將必要的相依性新增至您的應用程式。此程式庫可根據 Jetpack 視窗管理員或顯示遮蔽區 API 來取得。

Jetpack 視窗管理員會公開 androidx.window API ，並支援 Surface Duo 以及其他製造商的可折迭裝置。

新增此 gradle 相依性，以在應用程式中包含視窗管理員：

dependencies {
    implementation "androidx.window:window:1.0.0"
}

請遵循我們的 Jetpack 視窗管理員指引來直接使用 API，或新增雙螢幕程式庫並使用所提供的版面配置和控制項。

請遵循下列步驟，將顯示遮蔽區 API 新增至 Kotlin 或 Java 應用程式：

在頂層 build.gradle 檔案的 allprojects { repositories { 區段內新增下列幾行：

maven {
    url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
}

在模組層 build.gradle 檔案的 dependencies { 區段中新增下列幾行：
```
implementation "com.microsoft.device.display:display-mask:0.3.0"
```
JAVA 專案也應該將下列一行新增到其 build.gradle 相依性，因為程式庫是以 Kotlin 建置的 (請注意，也必須定義 $kotlin_version)：
```
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
```

這會提供下列功能：

較高層級的版面配置變更必須由應用程式開發人員建置。如需可協助您自動增強應用程式的版面配置控制項，請參閱雙螢幕程式庫。