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 fonctionne 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
• Google Pixel Watch 2
• Google Pixel Watch

Votre appareil devrait recevoir une mise à jour logicielle OTA (Over The Air). Vous pouvez également mettre à jour manuellement votre appareil en procédant de l'une des façons suivantes :

• 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 d'Android Studio Ladybug Feature Drop ou une version ultérieure si vous ne l'avez pas déjà fait.
2. Dans Android Studio, accédez à Outils > SDK Manager.

3. Dans l'onglet SDK Platforms (Plates-formes SDK), sélectionnez 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 Wear OS 5.1 ARM 64 v8a System Image ou Wear OS 5.1 Intel x86_64 Atom System Image :

   

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 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 Device Manager (Gestionnaire d'appareils) s'affiche.
2. Dans la barre d'outils du volet Device Manager (Gestionnaire d'appareils), appuyez 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 l'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. Appuyez sur Course à pied .
3. Installez votre application sur l'appareil virtuel et parcourez les différents workflows orientés utilisateur qu'elle utilise.

Modifications qui affectent 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 dans Android 15, qui utilise le même niveau d'API que Wear OS 5.1.

Plusieurs changements de comportement ne sont pas pris 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 qu'utilise 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 :

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

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 :

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

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

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

Après avoir mis à jour votre version cible du SDK vers le 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.

Voici quelques fonctionnalités à découvrir :

• Compatibilité avec le Gestionnaire d'identifiants : l'API Credential Manager fournit une solution d'authentification unifiée qui prend en charge les flux de connexion à l'aide de mots de passe, de clés d'accès et d'identités fédérées (comme Se connecter avec Google). Les identifiants d'un utilisateur sont stockés dans un fournisseur d'identifiants, qui synchronise les informations de compte sur tous les appareils.
• Lecture sur le haut-parleur de la montre : sur les appareils compatibles avec la lecture de contenus multimédias sur le haut-parleur de la montre, les utilisateurs peuvent sélectionner ce haut-parleur comme option de sortie multimédia par défaut si votre application s'intègre au sélecteur 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 :

Problèmes connus

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

• L'émulateur ne permet pas toujours à l'utilisateur d'ajouter un compte lors du processus de configuration après la réinitialisation de l'appareil.
• Lorsque l'utilisateur appuie sur une notification, l'application qui l'a envoyée ne s'ouvre que lorsqu'il fait défiler l'écran.
• Il arrive que les services de santé Wear ne parviennent pas à démarrer un exercice.
• Si vous accédez aux bibliothèques androidx.wear.tiles ou androidx.wear:wear-phone-interactions dans une application ciblant le niveau d'API 35, une erreur SecurityException peut se produire. Pour résoudre ce problème, passez à androidx.wear.tiles 1.5.0-alpha05 ou version ultérieure, ou à androidx.wear:wear-phone-interactions 1.1.0 ou version ultérieure.