閱讀英文

共用方式為


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

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

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

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

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

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

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

Jetpack 視窗管理員

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

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

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

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

顯示遮罩和轉軸角度

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

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

    maven {
        url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
    }
    
  2. 在模組層 build.gradle 檔案的 dependencies { 區段中新增下列幾行:

    implementation "com.microsoft.device.display:display-mask:0.3.0"
    
  3. JAVA 專案也應該將下列一行新增到其 build.gradle 相依性,因為程式庫是以 Kotlin 建置的 (請注意,也必須定義 $kotlin_version):

    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    

這會提供下列功能:

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

後續步驟