Пакеты SDK для создания приложений для Surface Duo

  • Статья

Существует три разных способа, которые позволяют расширить возможности приложений для Surface Duo:

  • Библиотека для двухэкранных устройств — набор макетов, элементов управления и вспомогательных классов, которые добавляют в приложение поддержку двух экранов.
  • Jetpack Window Manager — пакет Android, предоставляющий API для области маскирования и угла разворота, который работает со складными устройствами от разных производителей (включая Surface Duo).
  • Область маскирования и угол разворота — специальные API Surface Duo, которые помогают обнаруживать область маскирования стыка и угол разворота.

Вы можете включить в свое приложение только нужные компоненты. Инструкции по обновлению своего проекта Android Studio см. ниже.

Элементы управления макетом из библиотеки для двухэкранных устройств

Библиотека с элементами управления макетами и вспомогательными функциями для разработчиков на Kotlin и Java:

Чтобы получить доступ к этим функциям, добавьте необходимые зависимости в свое приложение. Библиотека доступна на основе API Jetpack Window Manager или API Display Mask.

Jetpack Window Manager

Решение Jetpack Window Manager предоставляет API androidx.window и поддерживает Surface Duo и другие складные устройства от различных производителей.

Добавьте эту зависимость Gradle, чтобы включить Jetpack Window Manager в приложение:

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

Следуйте нашим рекомендациям по работе с Jetpack Window Manager, чтобы использовать API напрямую, или добавьте библиотеку для двухэкранных устройств и используйте предоставляемые макеты и элементы управления.

Маска экрана и угол поворота

Выполните следующие шаги, чтобы добавить API Display Mask в приложение 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"

Вы получите доступ к следующим функциям:

Изменения макетов более высокого уровня должны выполняться разработчиком приложения. Библиотеки для двухэкранных устройств предоставят вам элементы управления для автоматического изменения макетов.

Дальнейшие действия