Wear OS 5.1

Die neueste Version von Wear OS ist im offiziellen Emulator in Android Studio verfügbar. Prüfen Sie, ob Ihre App wie erwartet funktioniert, nachdem Sie die Ziel-SDK-Version aktualisiert haben.

Wear OS 5.1 basiert auf Android 15 (API-Level 35). Daher müssen Sie Ihre Apps, die bereits auf API-Level 34 ausgerichtet sind, für Wear OS 5 testen.

Emulator für Tests vorbereiten

Wenn Sie Wear OS 5.1 im offiziellen Emulator ausführen möchten, müssen Sie zuerst das System-Image herunterladen und installieren, das auf dem Emulator ausgeführt wird. Sie müssen dann ein virtuelles Gerät erstellen, auf dem dieses System-Image ausgeführt wird.

System-Image herunterladen und installieren

Führen Sie die folgenden Schritte aus, um das richtige System-Image herunterzuladen und zu installieren:

  1. Laden Sie die neueste Version von Android Studio Meerkat herunter und installieren Sie sie, falls noch nicht geschehen.
  2. Klicken Sie in Android Studio auf Tools > SDK-Manager.
  3. Maximieren Sie auf dem Tab SDK-Plattformen den Bereich Android 15.0 („VanillaIceCream“) und wählen Sie entweder Wear OS 5.1 – ARM 64 v8a-System-Image (Vorabversion) oder Wear OS 5.1 – Intel x86_64-Atom-System-Image (Vorabversion) aus:

    „Die Emulator-Build-Images werden in der Gruppe der Build-Images für Android API 35 angezeigt.“

  4. Klicken Sie auf OK. Klicken Sie im Fenster Änderung bestätigen noch einmal auf OK.

  5. Warten Sie, bis Android Studio das System-Image heruntergeladen und installiert hat, und klicken Sie dann auf Fertigstellen.

Virtuelles Gerät erstellen

So erstellen Sie ein virtuelles Gerät, auf dem dieses System-Image im offiziellen Emulator ausgeführt wird:

  1. Öffnen Sie in Android Studio den Gerätemanager, indem Sie Tools > Gerätemanager auswählen. Der Bereich Gerätemanager wird angezeigt.
  2. Klicken Sie in der Symbolleiste im Bereich Gerätemanager auf Neues Gerät hinzufügen > Virtuelles Gerät erstellen.
  3. Wählen Sie im Bereich Formfaktor die Option Wear OS und ein Hardwareprofil aus. Klicken Sie auf Weiter.
  4. Wählen Sie ein Wear OS 5.1-System-Image aus. Das System-Image sollte die API-Ebene 35 haben.
  5. Klicken Sie auf Weiter und dann auf Fertigstellen.

App im Emulator testen

So testen Sie Ihre App auf diesem von Ihnen erstellten virtuellen Gerät:

  1. Wählen Sie in der Android Studio-Symbolleiste das virtuelle Gerät aus.
  2. Klicken Sie auf Ausführen .
  3. Installieren Sie Ihre App auf dem virtuellen Gerät und führen Sie die verschiedenen nutzerorientierten Workflows aus, die Ihre App verwendet.

Änderungen, die sich auf alle Apps auswirken

Prüfen Sie beim Testen Ihrer App unter Wear OS 5.1, wie sie mit den Änderungen am Systemverhalten umgeht, die sich auf alle Apps in Android 15 auswirken. Android 15 verwendet dasselbe API-Level wie Wear OS 5.1.

Einige Verhaltensänderungen werden in Wear OS 5.1 nicht übernommen:

SDK-Zielversion Ihrer App aktualisieren

Sie können die Kompatibilität Ihrer App mit Wear OS 5.1 verbessern, indem Sie die Ziel-SDK-Version Ihrer App auf API-Level 35 aktualisieren. Das ist dasselbe API-Level wie bei Android 15.

Öffnen Sie dazu die Datei build.gradle oder build.gradle.kts auf Modulebene und aktualisieren Sie sie mit Werten für Wear OS 5.1.

Wie Sie die Werte in Ihrer Build-Datei formatieren, hängt von der Version des Android Gradle-Plug-ins (AGP) ab, das Sie verwenden.

AGP 7.0.0 oder höher

Wenn Sie AGP 7.0.0 oder höher verwenden, aktualisieren Sie die Datei build.gradle oder build.gradle.kts Ihrer App mit den folgenden Werten für Wear OS 5.1:

Groovy

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 oder niedriger

Wenn Sie AGP 4.2.0 oder niedriger verwenden, aktualisieren Sie die Datei build.gradle oder build.gradle.kts Ihrer App mit den folgenden Werten für Wear OS 5.1:

Groovy

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Kotlin

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

Änderungen, die sich nur auf Apps mit Ziel-API-Level 35 auswirken

Nachdem Sie Ihre Ziel-SDK-Version auf API-Level 35 aktualisiert haben, müssen Sie die Änderungen für Apps vornehmen, die auf Android 15 ausgerichtet sind. Diese verwenden dasselbe API-Level wie Wear OS 5.1.

Neue Funktionen ansehen

Wear OS 5.1 bietet mehrere Funktionen, mit denen Sie die Wear OS-App noch besser nutzen können.

Zu den wichtigsten Funktionen gehören:

  • Unterstützung für den Anmeldedaten-Manager:Die Credential Manager API bietet eine einheitliche Authentifizierungslösung, die Anmeldeabläufe mit Passwörtern, Passkeys und föderierten Identitäten (z. B. Über Google anmelden) unterstützt. Die Anmeldedaten eines Nutzers werden bei einem Anmeldedatenanbieter gespeichert, der Kontoinformationen geräteübergreifend synchronisiert.
  • Wiedergabe über den Lautsprecher der Smartwatch:Auf Geräten, die die Medienwiedergabe über den Lautsprecher der Smartwatch unterstützen, können Nutzer diesen Lautsprecher als bevorzugte Option für die Medienausgabe auswählen, wenn Ihre App mit dem Wear-Ausgabeschalter integriert ist.

Versionshinweise

Das im Wear OS 5.1-Emulator verfügbare System-Image hat folgende Eigenschaften:

  • Veröffentlichungsdatum:19. November 2024
  • Build-ID:AP4A.241205.004.F1

Bekannte Probleme

Das System-Image mit Wear OS 5.1 weist die folgenden bekannten Probleme auf:

  • Im Emulator kann der Nutzer nach dem Zurücksetzen des Geräts nicht immer während der Einrichtung ein Konto hinzufügen.
  • Wenn Sie auf eine Benachrichtigung tippen, wird die App, die sie gesendet hat, erst geöffnet, wenn der Nutzer auf dem Bildschirm scrollt.
  • Manchmal startet Wear Health Services kein Training.