Compartilhar via


SDKs para criar aplicativos para o Surface Duo

Há três maneiras diferentes de aprimorar seus aplicativos para o Surface Duo:

  • Biblioteca de tela dupla – um conjunto de layouts, controles e classes auxiliares que adicionam suporte de tela dupla ao seu aplicativo.
  • Gerenciador de Janelas do Jetpack – o pacote do Android que fornece APIs para a área mascarada e o ângulo da dobradiça, que funciona em dispositivos dobráveis de fabricantes diferentes (incluindo o Surface Duo).
  • Máscara de exibição e ângulo da dobradiça – APIs específicas do Surface Duo que ajudam a detectar a área de junção mascarada e o ângulo da dobradiça.

Será possível incluir em seu aplicativo somente o necessário. Confira as instruções abaixo para atualizar seu projeto do Android Studio.

Controles de layout da biblioteca de tela dupla

Uma biblioteca de controles de layout e auxiliares para desenvolvedores Kotlin e Java:

Para acessar esses recursos, adicione as dependências necessárias ao aplicativo. A biblioteca está disponível com base no Gerenciador de Janelas do Jetpack ou na API de Máscara de Exibição.

Gerenciador de Janelas do Jetpack

O Gerenciador de Janelas do Jetpack expõe a API androidx.window e dá suporte ao Surface Duo, bem como a dispositivos dobráveis de outros fabricantes.

Adicione essa dependência gradle para incluir o Gerenciador de Janelas em seu aplicativo:

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

Siga nossas diretrizes do Gerenciador de Janelas do Jetpack para usar a API diretamente ou adicionar a biblioteca de tela dupla e usar os layouts e controles fornecidos.

Máscara de exibição e ângulo de dobradiça

Siga estas etapas para adicionar a API da Máscara de Exibição a um aplicativo Kotlin ou Java:

  1. No arquivo de nível superior build.gradle, adicione essas linhas dentro da seção allprojects { repositories {:

    maven {
        url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
    }
    
  2. No arquivo build.gradle do nível de módulo, adicione essas linhas na seção dependencies {:

    implementation "com.microsoft.device.display:display-mask:0.3.0"
    
  3. Os projetos Java também devem adicionar essa linha às suas dependências do build.gradle, pois a biblioteca é compilada com o Kotlin (observe que a $kotlin_version também precisará ser definida):

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

Isso fornece os seguintes recursos:

As alterações de layout de nível superior precisam ser criadas pelo desenvolvedor do aplicativo. Confira as bibliotecas de tela dupla para obter controles de layout que ajudam a aprimorar seus aplicativos automaticamente.

Próximas etapas