Surface Duo 用アプリを構築するための SDK

Surface Duo 用アプリを強化するには、次の 3 つの方法があります。

  • デュアルスクリーン ライブラリ - アプリにデュアルスクリーンのサポートを追加するレイアウト、コントロール、およびヘルパー クラスのセット。
  • Jetpack Window Manager - マスクされた領域とヒンジ角度用の API を提供する Android パッケージ。さまざまな製造元の折りたたみ型デバイス (Surface Duo を含む) に利用できます。
  • ディスプレイ マスクとヒンジ角度 - マスクされたシーム領域とヒンジ角度の検出に役立つ Surface Duo 固有の API。

アプリケーションで必要なものだけを含めることができます。 以下の手順を参照して、Android Studio プロジェクトを更新します。

デュアルスクリーン ライブラリのレイアウト コントロール

Kotlin および Java 開発者向けのレイアウト コントロールとヘルパーのライブラリ:

これらの機能にアクセスするには、必要な依存関係をアプリに追加します。 このライブラリは、Jetpack Window Manager または Display Mask API に基づいて使用できます。

Jetpack Window Manager

Jetpack Window Manager では androidx.window API が公開されており、Surface Duo だけでなく他の製造元の折りたたみ型デバイスがサポートされています。

アプリに Window Manager を含めるには、この gradle の依存関係を追加します。

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

Jetpack Window Manager のガイダンスに従って API を直接使用するか、デュアルスクリーン ライブラリを追加し、提供されているレイアウトとコントロールを使用します。

ディスプレイ マスクとヒンジ角度

次の手順に従って、Display Mask 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"
    

これには次のような機能があります。

より高度なレイアウト変更は、アプリ開発者が作成する必要があります。 アプリを自動的に拡張するために役立つレイアウト コントロールについては、デュアルスクリーン ライブラリに関する記事を参照してください。

次の手順