Découvrez la dernière version de Wear OS, disponible 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 de votre 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 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 l'image système appropriée, procédez comme suit:
- Téléchargez et installez la dernière version d'Android Studio Meerkat si ce n'est pas déjà fait.
- Dans Android Studio, cliquez sur Tools > SDK Manager (Outils > Gestionnaire de SDK).
Dans l'onglet SDK Platforms (Plates-formes SDK), développez la section Android 15.0 ("VanillaIceCream"), puis sélectionnez Wear OS 5.1 - Preview ARM 64 v8a System Image (Preview Wear OS 5.1 - Preview ARM 64 v8a System Image) ou Wear OS 5.1 - Preview Intel x86_64 Atom System Image (Preview Wear OS 5.1 - Preview Intel x86_64 Atom System Image) :
Cliquez sur OK. Lorsque la fenêtre Confirmer la modification s'affiche, cliquez à nouveau sur OK.
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:
- 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.
- 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). - Dans le volet Form Factor (Facteur de forme), sélectionnez Wear OS et choisissez un profil matériel. Cliquez sur Next (Suivant).
- Sélectionnez une image système Wear OS 5.1 à utiliser. L'image système doit avoir un niveau d'API de 35.
- 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:
- Accédez à la barre d'outils Android Studio, puis sélectionnez l'appareil virtuel.
- Cliquez sur Run (Exécuter)
. - 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.
- Il est possible que les animations pour la prévisualisation du Retour ne s'affichent pas.
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'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 du 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.
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
L'image système disponible sur l'émulateur Wear OS 5.1 présente les caractéristiques suivantes:
- Date de sortie:19 novembre 2024
- ID de build: AP4A.241205.004.F1
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.