用來建置 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"
這會提供下列功能:
較高層級的版面配置變更必須由應用程式開發人員建置。 如需可協助您自動增強應用程式的版面配置控制項,請參閱雙螢幕程式庫。
- 使用 Surface Duo 模擬器來測試和偵錯您的應用程式。