Wear OS 5.1

Die aktuelle Version von Wear OS ist auf ausgewählten Geräten und im offiziellen Emulator in Android Studio verfügbar. Prüfen Sie, ob Ihre App nach der Aktualisierung der SDK-Zielversion wie erwartet funktioniert.

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

Unterstütztes Gerät für Tests vorbereiten

Wear OS 5.1 kann auf den folgenden Geräten ausgeführt werden:

• Google Pixel Watch 3
• Google Pixel Watch 2
• Google Pixel Watch

Dein Gerät sollte ein Over-the-Air-Softwareupdate (OTA) erhalten. Sie können Ihr Gerät auch manuell aktualisieren. Dazu haben Sie folgende Möglichkeiten:

• Rufen Sie in den Einstellungen System > Systemupdates auf.
• Nachdem Sie die Entwickleroptionen aktiviert haben, können Sie ein bestimmtes Software-Image auf Geräte flashen, die eine kabelgebundene USB-Datenverbindung unterstützen. Sie können beispielsweise ein Werksimage oder ein vollständiges OTA-Image flashen.

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. Anschließend müssen Sie ein virtuelles Gerät erstellen, auf dem dieses System-Image ausgeführt wird.

Systemabbild herunterladen und installieren

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

1. Laden Sie die aktuelle Version von Android Studio Ladybug Feature Drop oder höher herunter und installieren Sie sie, falls Sie das noch nicht getan haben.
2. Rufen Sie in Android Studio Tools > SDK-Manager auf.

3. Wählen Sie auf dem Tab SDK-Plattformen die Option Paketdetails anzeigen aus und maximieren Sie den Bereich Android 15.0 („VanillaIceCream“), der Artefakte für API-Level 35-ext15 enthält. Wählen Sie dann entweder Wear OS 5.1 ARM 64 v8a System Image oder Wear OS 5.1 Intel x86_64 Atom System Image aus:

   

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äte-Manager, indem Sie Tools > Geräte-Manager auswählen. Der Bereich Geräteverwaltung wird angezeigt.
2. Tippen Sie in der Symbolleiste im Bereich Geräte-Manager 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-Systemimage aus. Das System-Image muss das API-Level 35 haben.
5. Klicken Sie auf Weiter und dann auf Fertig stellen.

App im Emulator testen

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

1. Wählen Sie in der Android Studio-Symbolleiste das virtuelle Gerät aus.
2. Tippe auf Laufen .
3. Installieren Sie Ihre App auf dem virtuellen Gerät und durchlaufen Sie die verschiedenen benutzerorientierten Workflows, die Ihre App verwendet.

Änderungen, die sich auf alle Apps auswirken

Wenn Sie Ihre App unter Wear OS 5.1 testen, sollten Sie prüfen, wie sie mit den Systemverhaltensänderungen 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 wirksam:

• Vertrauliche Profile werden in Wear OS 5.1 nicht unterstützt.
• Animationen für intelligente „Zurück“-Touchgeste werden möglicherweise nicht angezeigt.

SDK-Zielversion Ihrer App aktualisieren

Sie können die Kompatibilität Ihrer App mit Wear OS 5.1 verbessern, indem Sie das Ziel-SDK-Level Ihrer App auf API-Level 35 aktualisieren. (Dies ist dasselbe API-Level, das von Android 15 verwendet wird.)

Ö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, die 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:

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

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:

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

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

Änderungen, die sich nur auf Apps auswirken, die auf API-Level 35 ausgerichtet sind

Nachdem Sie das Ziel-SDK auf API-Level 35 aktualisiert haben, müssen Sie die Änderungen für Apps, die auf Android 15 ausgerichtet sind, berücksichtigen. Android 15 verwendet dasselbe API-Level wie Wear OS 5.1.

Neue Funktionen ansehen

Wear OS 5.1 bietet mehrere Funktionen, mit denen Sie die Nutzung Ihrer Wear OS-App verbessern können.

Hier einige wichtige Funktionen, die Sie sich ansehen sollten:

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

Versionshinweise

Das aktuelle System-Image für Wear OS 5.1, das auf unterstützten Geräten und im Emulator verfügbar ist, hat die folgenden Merkmale:

Bekannte Probleme

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

• Im Emulator kann der Nutzer nach dem Zurücksetzen des Geräts nicht immer ein Konto während der Einrichtung hinzufügen.
• Wenn der Nutzer auf eine Benachrichtigung tippt, wird die App, die die Benachrichtigung gesendet hat, erst geöffnet, wenn er auf dem Bildschirm scrollt.
• Wear Health Services kann manchmal kein Training starten.
• Wenn Sie in einer App, die auf API-Level 35 ausgerichtet ist, auf die Bibliotheken androidx.wear.tiles oder androidx.wear:wear-phone-interactions zugreifen, kann ein SecurityException auftreten. Führen Sie zur Behebung dieses Problems ein Upgrade auf androidx.wear.tiles 1.5.0-alpha05 oder höher oder auf androidx.wear:wear-phone-interactions 1.1.0 oder höher durch.