用于构建 Surface Duo 应用的 SDK

  • 项目

可以通过三种不同的方法增强 Surface Duo 应用：

  • 双屏库 - 一组布局、控件和帮助程序类，用于向应用添加双屏支持。
  • Jetpack 窗口管理器 - 为屏蔽区域和铰链角度提供 API 的 Android 包，适用于来自不同制造商的可折叠设备（包括 Surface Duo）。
  • 显示掩码和铰链角 - 特定于 Surface Duo 的 API，可帮助你检测屏蔽的接缝区和铰链角。

可以仅包含应用程序中所需的内容。 请参阅下面的说明，更新 Android Studio 项目。

双屏库布局控件

面向 Kotlin 和 Java 开发人员的布局控件和帮助程序库：

若要访问这些功能，请向应用添加必需的依赖项 。 此库基于 Jetpack 窗口管理器或 Display Mask API 提供。

Jetpack 窗口管理器

Jetpack 窗口管理器公开了 androidx.window API，并支持来自其他制造商的 Surface Duo 和折叠设备。

添加此 gradle 依赖项，以便在应用中包含窗口管理器：

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

按照我们的 Jetpack 窗口管理器指南直接使用 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"

此版本提供下列功能：

高级别布局更改必须由应用开发人员构建。 如需了解有助于自动增强应用的布局控件，请参阅双屏库。

后续步骤