SDK permettant de créer des applications pour Surface Duo

Vous pouvez améliorer vos applications pour Surface Duo de trois façons différentes :

  • Bibliothèque double écran : ensemble de dispositions, de contrôles et de classes d’assistance qui ajoutent la prise en charge du double écran à votre application.
  • Gestionnaire de fenêtres Jetpack : package Android fournissant des API pour la zone masquée et l’angle de la charnière, et qui fonctionne sur des appareils pliables de différents fabricants (dont Surface Duo).
  • Masque d’affichage et angle de la charnière : API spécifiques à Surface Duo qui vous permettent de détecter la zone de jointure masquée et l’angle de la charnière.

Vous pouvez inclure dans votre application uniquement ce dont vous avez besoin. Consultez les instructions ci-dessous pour mettre à jour votre projet Android Studio.

Contrôles de disposition de la bibliothèque double écran

Bibliothèque de contrôles de disposition et d’assistants pour les développeurs Kotlin et Java :

Pour bénéficier de ces fonctionnalités, ajoutez les dépendances nécessaires à votre application. La bibliothèque est disponible en fonction du Gestionnaire de fenêtres Jetpack ou de l’API Masque d’affichage.

Gestionnaire de fenêtres Jetpack

Actuellement en version bêta, le Gestionnaire de fenêtres Jetpack expose l’API androidx.window et prend en charge Surface Duo, ainsi que les appareils pliables d’autres fabricants.

Ajoutez cette dépendance gradle pour inclure le Gestionnaire de fenêtres dans votre application :

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

Suivez nos instructions sur le Gestionnaire de fenêtres Jetpack pour utiliser directement l’API, ou ajoutez une bibliothèque double écran et utilisez les dispositions et les contrôles fournis.

Masque d’affichage et angle de la charnière

Effectuez les étapes suivantes pour ajouter l’API Masque d’affichage à votre application Kotlin ou Java :

  1. Dans le fichier build.gradle du niveau supérieur, ajoutez ces lignes dans la section  :

    maven {
        url 'https://pkgs.dev.azure.com/MicrosoftDeviceSDK/DuoSDK-Public/_packaging/Duo-SDK-Feed/maven/v1'
    }
    
  2. Dans le fichier build.gradle de niveau module, ajoutez ces lignes dans la section  :

    implementation "com.microsoft.device.display:display-mask:0.3.0"
    
  3. Les projets Java doivent également ajouter cette ligne à leurs dépendances build.gradle parce que la bibliothèque est générée avec Kotlin (notez que $kotlin_version devra également être défini) :

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

Cela fournit les fonctionnalités suivantes :

Les changements de disposition de niveau supérieur doivent être générés par le développeur d’application. Consultez les bibliothèques double écran pour connaître les contrôles de disposition qui permettent d’améliorer automatiquement vos applications.

Étapes suivantes