Wear OS 5.1

Découvrez la dernière version de Wear OS, disponible sur certains appareils et dans l'émulateur officiel d'Android Studio. Vérifiez que votre application s'exécute comme prévu après avoir mis à jour la version du SDK cible.

Wear OS 5.1 est basé sur Android 15 (niveau d'API 35), ce qui vous oblige à tester vos applications qui ciblent déjà le niveau d'API 34 pour Wear OS 5.

Préparer un appareil compatible pour les tests

Wear OS 5.1 peut s'exécuter sur les appareils suivants:

• Google Pixel Watch 3 (Bluetooth/Wi-Fi)
• Google Pixel Watch 2 (Bluetooth/Wi-Fi)

Votre appareil devrait recevoir une mise à jour logicielle Over The Air (OTA). Vous pouvez également mettre à jour manuellement votre appareil en procédant comme suit:

• Dans l'application Paramètres, accédez à Système > Mises à jour du système.
• Après avoir activé les options pour les développeurs, flashez une image logicielle spécifique sur les appareils compatibles avec une connexion de données USB (filaire). Par exemple, vous pouvez flasher une image d'usine ou une image OTA complète.

Préparer l'émulateur pour les tests

Pour exécuter Wear OS 5.1 dans l'émulateur officiel, vous devez d'abord télécharger et installer l'image système qui s'exécute sur l'émulateur. Vous devez ensuite créer un appareil virtuel qui exécute cette image système.

Télécharger et installer l'image système

Pour télécharger et installer la bonne image système, procédez comme suit:

1. Téléchargez et installez la dernière version de la version Ladybug d'Android Studio ou une version ultérieure si vous ne l'avez pas déjà fait.
2. Dans Android Studio, cliquez sur Tools > SDK Manager (Outils > Gestionnaire de SDK).

3. Dans l'onglet SDK Platforms (Plates-formes SDK), cliquez sur Show Package Details (Afficher les détails du package), puis développez la section Android 15.0 ("VanillaIceCream") (Android 15.0 ("VanillaIceCream")) qui contient les artefacts pour le niveau d'API 35-ext15. Sélectionnez ensuite Image système Wear OS 5.1 ARM 64 v8a ou Image système Wear OS 5.1 Intel x86_64 Atom:

   

4. Cliquez sur OK. Lorsque la fenêtre Confirmer la modification s'affiche, cliquez à nouveau sur OK.

5. Attendez qu'Android Studio télécharge et installe l'image système, puis cliquez sur Finish (Terminer).

Créer un appareil virtuel

Pour créer un appareil virtuel qui exécute cette image système dans l'émulateur officiel, procédez comme suit:

1. Dans Android Studio, sélectionnez Tools > Device Manager (Outils > Gestionnaire d'appareils) pour ouvrir le Gestionnaire d'appareils. Le volet Gestionnaire d'appareils s'affiche.
2. Dans la barre d'outils du volet Device Manager (Gestionnaire d'appareils), cliquez sur Add a new device (Ajouter un appareil)  > Create Virtual Device (Créer un appareil virtuel).
3. Dans le volet Form Factor (Facteur de forme), sélectionnez Wear OS et choisissez un profil matériel. Cliquez sur Next (Suivant).
4. Sélectionnez une image système Wear OS 5.1 à utiliser. L'image système doit avoir un niveau d'API de 35.
5. Cliquez sur Suivant, puis sur Terminer.

Tester votre application sur l'émulateur

Pour tester votre application sur cet appareil virtuel que vous avez créé, procédez comme suit:

1. Accédez à la barre d'outils Android Studio, puis sélectionnez l'appareil virtuel.
2. Cliquez sur Run (Exécuter) .
3. Installez votre application sur l'appareil virtuel et parcourez les différents workflows destinés aux utilisateurs qu'elle utilise.

Modifications affectant toutes les applications

Lorsque vous testez votre application sur Wear OS 5.1, vérifiez comment elle gère les modifications de comportement du système qui affectent toutes les applications sous Android 15, qui utilise le même niveau d'API que Wear OS 5.1.

Plusieurs modifications de comportement ne sont pas prises en compte dans Wear OS 5.1:

• Les espaces privés ne sont pas compatibles avec Wear OS 5.1.
• Les animations pour la prévisualisation du Retour peuvent ne pas s'afficher.

Mettre à jour la version du SDK cible de votre application

Vous pouvez améliorer la compatibilité de votre application avec Wear OS 5.1 en mettant à jour la version du SDK cible de votre application vers le niveau d'API 35. (Il s'agit du même niveau d'API que celui utilisé par Android 15.)

Pour ce faire, ouvrez le fichier build.gradle ou build.gradle.kts au niveau du module, puis mettez-le à jour avec des valeurs pour Wear OS 5.1.

La mise en forme des valeurs dans votre fichier de compilation dépend de la version du plug-in Android Gradle (AGP) que vous utilisez.

AGP 7.0.0 ou version ultérieure

Si vous utilisez AGP 7.0.0 ou une version ultérieure, mettez à jour le fichier build.gradle ou build.gradle.kts de votre application avec les valeurs suivantes pour Wear OS 5.1:

Groovy

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

Kotlin

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

AGP 4.2.0 ou version antérieure

Si vous utilisez AGP 4.2.0 ou une version antérieure, mettez à jour le fichier build.gradle ou build.gradle.kts de votre application avec les valeurs suivantes pour Wear OS 5.1:

Groovy

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

Kotlin

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

Modifications qui ne concernent que les applications qui ciblent le niveau d'API 35

Après avoir mis à jour la version de SDK cible au niveau d'API 35, gérez les modifications pour les applications qui ciblent Android 15, qui utilise le même niveau d'API que Wear OS 5.1.

Nouveautés

Wear OS 5.1 introduit plusieurs fonctionnalités permettant d'améliorer votre expérience des applications Wear OS.

Remarque :Avant d'ajouter ces fonctionnalités à votre application, préparez-la à gérer les modifications de comportement introduites par Wear OS 5.1.

Voici quelques-unes des fonctionnalités à découvrir:

• Compatibilité avec le Gestionnaire d'identifiants:l'API Gestionnaire d'identifiants fournit une solution d'authentification unifiée, compatible avec les flux de connexion à l'aide de mots de passe, de clés d'accès et d'identités fédérées (telles que Se connecter avec Google). Les identifiants d'un utilisateur sont stockés dans un fournisseur d'identifiants, qui synchronise les informations du compte sur les appareils.
• Lecture via le haut-parleur de la montre:sur les appareils compatibles avec la lecture multimédia via le haut-parleur de la montre, les utilisateurs peuvent sélectionner ce haut-parleur comme option de sortie multimédia préférée si votre application s'intègre au commutateur de sortie Wear.

Notes de version

La dernière image système pour Wear OS 5.1, disponible sur les appareils compatibles et sur l'émulateur, présente les caractéristiques suivantes:

Date de sortie	4 mars 2025
Build	BP1A.250305.019.W3 sur les appareils AP4A.241205.004.F4 sur l'émulateur
Prise en charge des émulateurs	x86 (64 bits), ARM (v8-A)

Problèmes connus

L'image système contenant Wear OS 5.1 présente les problèmes connus suivants:

• L'émulateur n'autorise pas toujours l'utilisateur à ajouter un compte lors du flux de configuration après une réinitialisation de l'appareil.
• Lorsque vous appuyez sur une notification, l'application qui l'a envoyée ne s'ouvre que lorsque l'utilisateur fait défiler l'écran.
• Il arrive que les services Wear Health ne démarrent pas un exercice.
• Si vous accédez aux bibliothèques androidx.wear.tiles ou androidx.wear:wear-phone-interactions dans une application qui cible le niveau d'API 35, une erreur SecurityException peut se produire. Pour résoudre ce problème, passez à la dernière version de chaque bibliothèque.