SDKs zum Erstellen von Apps für Surface Duo

  • Artikel

Es gibt drei verschiedene Möglichkeiten, wie Sie Ihre Apps für Surface-Duo verbessern können:

  • Doppelbildschirmbibliothek: Eine Reihe von Layouts, Steuerelementen und Hilfsklassen, die Ihre App um Doppelbildschirmunterstützung erweitern.
  • Jetpack-Fenster-Manager: Android-Paket, das APIs für den maskierten Bereich und den Scharnierwinkel bereitstellt, die mit faltbaren Geräten verschiedener Hersteller funktionieren (einschließlich Surface Duo).
  • Anzeigemaske und Scharnierwinkel: Surface Duo-spezifische APIs, die Sie beim Erkennen des maskierten Nahtbereichs und des Scharnierwinkels unterstützen.

Sie können nur das, was Sie in Ihrer Anwendung benötigen, einschließen. Weitere Informationen zum Aktualisieren Ihres Android Studio-Projekts finden Sie weiter unten.

Layoutsteuerelemente der Doppelbildschirmbibliothek

Eine Bibliothek mit Layoutsteuerelementen und Hilfsprogrammen für Kotlin- und Java-Entwickler:

Um auf diese Funktionen zuzugreifen, fügen Sie Ihrer App die erforderlichen Abhängigkeiten hinzu. Die Bibliothek steht ausgehend von der Jetpack-Fenster-Manager- oder der Anzeigemasken-API zur Verfügung.

Jetpack-Fenster-Manager

Der Jetpack-Fenster-Manager macht die androidx.window-API verfügbar und unterstützt das Surface Duo sowie faltbare Geräte von anderen Herstellern.

Fügen Sie diese gradle-Abhängigkeit hinzu, um den Fenster-Manager in Ihre App aufzunehmen:

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

Folgen Sie unserer Anleitung zum Jetpack-Fenster-Manager, um die API direkt zu verwenden, oder fügen Sie die Doppelbildschirmbibliothek hinzu, und verwenden Sie die bereitgestellten Layouts und Steuerelemente.

Anzeigemaske und Scharnierwinkel

Befolgen Sie diese Schritte, um Ihrer Kotlin- oder Java-App die Anzeigemasken-API hinzuzufügen:

  1. Fügen Sie in der build.gradle-Datei der obersten Ebene diese Zeilen innerhalb des Abschnitts allprojects { repositories { hinzu:

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

  2. Fügen Sie in der build.gradle-Datei auf Modulebene die folgenden Zeilen im Abschnitt dependencies { hinzu:

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

  3. In Java-Projekten sollte diese Zeile außerdem zu den build.gradle-Abhängigkeiten hinzugefügt werden, da die Bibliothek mit Kotlin erstellt wird (beachten Sie, dass die $kotlin_version ebenfalls definiert werden muss):

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

Dadurch werden die folgenden Features bereitgestellt:

Layoutänderungen auf höheren Ebenen müssen vom Entwickler der App erstellt werden. Informationen zu Layoutsteuerelementen, die eine automatische Verbesserung Ihrer App unterstützen, finden Sie in den Doppelbildschirmbibliotheken.

Nächste Schritte