SDK para compilar aplicaciones para Surface Duo

  • Artículo

Hay tres maneras diferentes de mejorar las aplicaciones para Surface Duo:

  • Biblioteca de doble pantalla: Conjunto de diseños, controles y clases auxiliares que agregan compatibilidad con doble pantalla a una aplicación.
  • Window Manager de Jetpack: Paquete de Android que proporciona las API para el área enmascarada y el ángulo de bisagra, que funciona en dispositivos plegables de distintos fabricantes (incluida Surface Duo).
  • Máscara de visualización y ángulo de bisagra: API específicas de Surface Duo que le ayudan a detectar el área de unión enmascarada y el ángulo de la bisagra.

Puede incluir solo lo que necesita en la aplicación. Consulte las instrucciones siguientes para actualizar el proyecto de Android Studio.

Biblioteca de controles de diseño de doble pantalla

Biblioteca de controles de diseño y aplicaciones auxiliares para desarrolladores de Kotlin y Java:

Para acceder a estas características, agregue las dependencias necesarias a la aplicación. La biblioteca está disponible en función de Window Manager de Jetpack o de la API de máscara de visualización.

Administrador de ventanas de Jetpack

Window Manager de Jetpack expone la API androidx.window y admite Surface Duo, así como dispositivos plegables de otros fabricantes.

Agregue esta dependencia de Gradle para incluir Window Manager en la aplicación:

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

Siga nuestra guía de Window Manager de Jetpack para usar la API directamente, o bien agregue la biblioteca de doble pantalla y use los diseños y los controles proporcionados.

Visualización de la máscara y el ángulo de bisagra

Siga estos pasos para agregar la API de máscara de visualización a la aplicación de Kotlin o Java:

  1. En el archivo de nivel superior build.gradle, agregue estas líneas dentro de la sección allprojects { repositories {:

    maven {
    url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
}

  2. En el archivo de nivel de módulo build.gradle, agregue estas líneas en la sección dependencies {:

    implementation "com.microsoft.device.display:display-mask:0.3.0"

  3. Los proyectos de Java también deben agregar esta línea a sus dependencias de build.gradle, ya que la biblioteca está compilada con Kotlin (tenga en cuenta que $kotlin_version también deberá definirse):

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

Esto ofrece las siguientes características:

El desarrollador de la aplicación debe compilar los cambios de diseño de nivel superior. Consulte las bibliotecas de doble pantalla para ver los controles de diseño que ayudan a mejorar las aplicaciones automáticamente.

Pasos siguientes