SDK per la creazione di app per Surface Duo

Esistono tre modi diversi per migliorare le app per Surface Duo:

• Libreria per dispositivi a doppio schermo: set di layout, controlli e classi helper che aggiungono all'app il supporto per i dispositivi a doppio schermo.
• Jetpack Window Manager: pacchetto Android contenente le API per l'area mascherata e l'angolo della cerniera, che funziona per dispositivi pieghevoli di produttori diversi (incluso Surface Duo).
• Maschera di visualizzazione e angolo della cerniera: API specifiche per Surface Duo che consentono di rilevare l'area di giunzione mascherata e l'angolo della cerniera.

È possibile includere nell'applicazione solo gli elementi necessari. Per aggiornare il progetto di Android Studio, vedere le istruzioni seguenti.

Controlli di layout della libreria per dispositivi a doppio schermo

Una libreria di controlli di layout e helper per sviluppatori Kotlin e Java:

• Informazioni sullo schermo
• Gestione dello schermo
• Spostamento inferiore
• Gestione dei frammenti
• Layout piegabile
• Layout cornice piegabile
• Visualizzazione riciclatore
• Schede
• SnackbarContainer
• Componente di spostamento piegabile

Per accedere a queste funzionalità, aggiungere le dipendenze richieste all'app. La libreria è disponibile in base all'API Jetpack Window Manager o Display Mask.

Jetpack Window Manager

Jetpack Window Manager espone l'API androidx.window e supporta Surface Duo e i dispositivi piegabili di altri produttori.

Aggiungere la dipendenza Gradle seguente per includere Window Manager nell'app:

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

Seguire le istruzioni di Jetpack Window Manager per usare l'API direttamente oppure aggiungere la libreria per dispositivi a doppio schermo e usare i layout e i controlli forniti.

Maschera di visualizzazione e angolo della cerniera

Per aggiungere l'API Display Mask all'app Kotlin o Java, seguire questa procedura:

1. Nel file di primo livello build.gradleadle aggiungi queste righe all'interno della sezione allprojects { repositories {:

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

2. Nel file a livello di modulobuild.gradle, aggiungi le righe seguenti nella sezione dependencies {:

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

3. Nei progetti Java devi inoltre aggiungere la riga seguente alle dipendenze build.gradle perché la libreria è compilata con Kotlin (nota che è necessario definire anche $kotlin_version):

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

In questo modo, vengono fornite le funzionalità seguenti:

• Maschera di visualizzazione
• Sensore della cerniera

Le modifiche di layout di livello superiore devono essere create dallo sviluppatore dell'app. Per informazioni sui controlli di layout che consentono di migliorare le app automaticamente, vedere le librerie per dispositivi a doppio schermo.

Passaggi successivi

• Usare l'emulatore Surface Duo per testare ed eseguire il debug delle app.