Bibliothèques de dispositions double écran

Important

Les fonctionnalités et l’aide décrites dans cet article sont en préversion publique et peuvent faire l’objet de modifications importantes avant leur lancement en disponibilité générale. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Ces bibliothèques contiennent un ensemble de vues, de dispositions, de fonctions d’assistance et plus pour aider les développeurs Android à créer des applications pour les appareils double écran.

Quand vous laissez la responsabilité de la création et de la gestion de tous les modes d’écran à nos composants, votre préoccupation principale est de créer une belle application.

Modules

  • ScreenManager - contient les classes de base dont nos composants ont besoin afin de développer pour des appareils double écran. Vous pouvez également les utiliser directement dans votre code.

    • Utilisez ScreenManagerProvider pour obtenir la seule instance de SurfaceDuoScreenManager.
    • Utilisez SurfaceDuoScreenManager pour inscrire des écouteurs afin d’être notifié quand le mode d’écran change.
    • Utilisez ScreenInfoProvider pour obtenir une instance de ScreenInfo.
    • Utilisez ScreenInfo pour obtenir différentes informations d’écran en fonction du mode d’écran.
  • Navigation inférieure - contient un BottomNavigationView personnalisé avec un comportement double écran.

    • BottomNavigationView donne la possibilité de déplacer le BottomNavigationView sur l’écran de gauche ou de droite.
  • Gestionnaire de fragments - contient le code permettant de gérer les fragments dans différents modes d’écran.

    • FragmentManagerStateHandler donne la possibilité de restaurer des fragments propres à un mode d’écran lorsqu’une activité passe à un écran double ou simple.
  • Dispositions - contient les dispositions qui vous aident à créer une interface utilisateur pour les appareils double écran.

    • FoldableLayout crée des conteneurs SingleScreen ou DualScreen destinés à contenir votre interface utilisateur.
    • FoldableFrameLayout donne la possibilité d’étendre les vues enfants ou de les déplacer vers l’écran de gauche ou de droite.
  • RecyclerView - Contient une classe RecyclerView.ItemDecoration et une classe LayoutManager personnalisées avec un comportement double écran.

    • FoldableItemDecoration ajoute un espacement aux cellules pour couvrir la charnière de l’appareil lorsque l’application est en mode répartition. Ceci doit être utilisé avec FoldableLayoutManager.
    • FoldableLayoutManager fournit un LinearLayoutManager quand l’appareil est en mode écran simple et un GridLayoutManager quand l’appareil est en mode réparti.
    • FoldableStaggeredItemDecoration ajoute un espacement aux cellules pour couvrir la charnière de l’appareil lorsque l’application est en mode répartition. Ceci doit être utilisé avec FoldableStaggeredLayoutManager.
    • FoldableStaggeredLayoutManager fournit un LinearLayoutManager quand l’appareil est en mode écran simple et un StaggeredGridLayoutManager quand l’appareil est en mode réparti.
  • Tabulations - contient une classe TabLayout personnalisée avec un comportement double écran.

    • SurfaceDuoTabLayout donne la possibilité de déplacer les tabulations sur l’écran de gauche, l’écran de droite ou les deux écrans.

Déclaration des dépendances

Important

Notre première version de ces dispositions a été empaquetée dans une seule bibliothèque com.microsoft.device:dualscreen-layout.

Cette bibliothèque va être dépréciée. Nous recommandons d’utiliser les bibliothèques individuellement pour les contrôles dont vous avez besoin.

  1. Vérifiez que vous disposez du référentiel mavenCentral() dans votre fichier build.gradle de premier niveau :

    allprojects {
        repositories {
            google()
            mavenCentral()
         }
    }
    
  2. Ajoutez les dépendances dont vous avez besoin au fichier build.gradle de niveau module (vous devez toujours inclure la bibliothèque du gestionnaire d’écran) :

    ScreenManager

    Si vous voulez choisir la version qui utilise l’API Afficher le masque, vous devez ajouter les lignes suivantes à votre fichier gradle.

    implementation "com.microsoft.device.dualscreen:screenmanager-displaymask:1.0.0-beta4"
    

    Ou si vous voulez choisir la version qui utilise l’API Gestionnaire de fenêtre, vous devez ajouter les lignes suivantes.

    implementation "com.microsoft.device.dualscreen:screenmanager-windowmanager:1.0.0-beta4"
    

    Navigation inférieure

    implementation "com.microsoft.device.dualscreen:bottomnavigation:1.0.0-beta3"
    

    Gestionnaire de fragments

    implementation "com.microsoft.device.dualscreen:fragmentshandler:1.0.0-beta3"
    implementation "com.microsoft.device.dualscreen:screenmanager-windowmanager:1.0.0-beta4"
    // Or, if you want to use the screen manager with display mask version
    // implementation "com.microsoft.device.dualscreen:screenmanager-displaymask:1.0.0-beta4"
    

    Dispositions

    implementation "com.microsoft.device.dualscreen:layouts:1.0.0-beta5"
    

    Tabulations

    implementation "com.microsoft.device.dualscreen:tabs:1.0.0-beta2"
    implementation "com.microsoft.device.dualscreen:screenmanager-windowmanager:1.0.0-beta4"
    // Or, if you want to use the screen manager with display mask version
    // implementation "com.microsoft.device.dualscreen:screenmanager-displaymask:1.0.0-beta4"
    

    RecyclerView

    implementation "com.microsoft.device.dualscreen:recyclerview:1.0.0-beta4"