Cette page vous explique comment créer votre première application pour Wear OS à l'aide d'un modèle Android Studio. L'application présente les différentes manières d'afficher un aperçu des informations sur les appareils Wear OS, ainsi que quelques bonnes pratiques pour développer des applications sur la plate-forme.
Ce guide s'appuie sur certaines connaissances préalables de la plate-forme Android et de l'IDE Android Studio. Si vous débutez sur Android, créez une application à l'aide de cet atelier de programmation. Pour en savoir plus sur les fonctionnalités d'Android Studio, consultez la page Découvrir Android Studio.
Créer une application Wear OS
Après avoir téléchargé et installé la dernière version d'Android Studio, suivez les instructions de l'assistant "New Project" (Nouveau projet) :
- Ouvrez Android Studio, puis accédez à File > New > New Project (Fichier > Nouveau > Nouveau projet). La fenêtre New Project (Nouveau projet) s'affiche.
- Dans le volet Templates (Modèles), sélectionnez Wear OS. Ensuite, dans le volet principal, sélectionnez Empty Wear App (Application Wear vide).
- Attribuez un nom à votre projet, puis cliquez sur Finish (Terminer). Android Studio télécharge les dépendances nécessaires et crée la version initiale de votre projet.
Accédez à Tools > SDK Manager (Outils > SDK Manager), puis installez Android 11.0 ("R") (niveau d'API 30) et Android 13.0 (Tiramisu) (niveau d'API 33).
Pour fermer SDK Manager, cliquez sur OK.
Vous pouvez désormais exécuter votre première application sur Wear OS.
Exécuter une application sur l'émulateur
Le moyen le plus simple d'exécuter votre première application Wear OS consiste à configurer un émulateur.
Configurer un émulateur
Pour configurer un émulateur dans Android Studio, procédez comme suit :
- Dans SDK Manager, ouvrez l'onglet SDK Tools (Outils SDK). Vérifiez que vous disposez de la dernière version d'Android SDK Platform-Tools.
- Accédez à Tools > Device Manager (Outils > Gestionnaire d'appareils).
- Sélectionnez Create (+) (Créer (+)). L'assistant Virtual Device Configuration (Configuration de l'appareil virtuel) s'affiche.
- Dans le volet Category (Catégorie), sélectionnez Wear OS et choisissez un profil matériel, tel que Wear OS Small Round. Cliquez sur Next (Suivant).
Pour les images système utilisées en dehors de la Chine, sélectionnez le nom de version Tiramisu. Cette version cible Android 13.0 (Wear OS 4). Pour les images système utilisées en Chine, sélectionnez le nom de version R. Cette version cible Android 11.0 (Wear OS 3). Cliquez sur Next (Suivant).
Remarque : Les images système de l'émulateur Wear OS incluent des avis de fichiers et de code source tiers. Vous pouvez afficher les avis de tiers pour une image système particulière en ouvrant le fichier
NOTICE.txt, qui se trouve dans l'un des répertoires suivants :$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABIpour les émulateurs utilisés en dehors de la Chine.$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABIpour les émulateurs utilisés en Chine.
Vous pouvez conserver la valeur par défaut pour tous les paramètres de cet écran, sauf si vous souhaitez personnaliser votre émulateur. Cliquez sur Finish (Terminer).
Pour plus d'informations sur l'utilisation des émulateurs, consultez le guide Exécuter des applications sur Android Emulator.
Ouvrir l'application dans l'émulateur
- Accédez à Run > Select Device (Exécuter > Sélectionner un appareil). Choisissez l'émulateur que vous venez de créer.
- Dans la barre d'outils d'Android Studio, cliquez sur Run (Exécuter)
. L'émulateur démarre et ouvre votre application. - Après quelques instants, le message "Hello…" (Bonjour…) s'affiche dans l'émulateur.
Tester l'audio Bluetooth à l'aide de l'émulateur
Sur les images système exécutant Wear OS 4 ou une version ultérieure, l'émulateur prend en charge le Bluetooth émulé, ce qui vous permet de tester l'audio Bluetooth dans plusieurs cas d'utilisation.
Les images système récentes ne sont compatibles qu'avec les architectures 64 bits
Les images système de l'émulateur pour Wear OS 4 ne sont compatibles qu'avec les architectures 64 bits suivantes : x86-64 et arm64-v8a. Si vous savez ou pensez que votre application utilise du code natif (qui n'est pas écrit dans les langages de programmation Kotlin ou Java), vérifiez qu'elle inclut des bibliothèques natives 32 bits et 64 bits.
Pour en savoir plus sur la compatibilité avec les architectures 64 bits, consultez cette page.
Exécuter une application sur une montre physique (facultatif)
Exécuter et déboguer votre application sur une montre vous permet de mieux évaluer l'expérience utilisateur globale. Cela est particulièrement important si votre application repose sur du matériel spécifique, tel que des capteurs ou un GPU.
Pour exécuter une application sur une montre physique, préparez l'appareil à des fins de test, puis connectez-le à votre ordinateur de développement.
Préparer la montre pour les tests
Afin de préparer votre montre pour les tests, activez le débogage ADB en suivant les étapes ci-dessous.
- Sur la montre, ouvrez le menu Paramètres.
- Faites défiler le menu vers le bas. Si aucun élément Options pour les développeurs ne s'affiche, suivez les étapes ci-dessous. Sinon, passez directement à l'étape suivante.
- Appuyez sur Système > À propos ou sur Système > À propos > Versions.
- Recherchez l'élément Numéro de version, puis appuyez dessus sept fois. Si votre montre est protégée par un code ou un schéma, saisissez-le lorsque vous y êtes invité.
- Dans le menu Paramètres, appuyez sur Options pour les développeurs.
- Activez l'option Débogage ADB.
Connecter la montre à l'ordinateur de développement
Certaines montres vous permettent de vous connecter à l'aide d'un câble USB, tandis que d'autres nécessitent une connexion sans fil.
Configurer une connexion filaire via USB
Pour connecter la montre, procédez comme suit :
- Connectez la montre à votre ordinateur de développement à l'aide d'un câble USB.
- Sur la montre, activez Toujours autoriser sur cet ordinateur, puis appuyez sur OK.
Configurer une connexion sans fil
Si votre montre ne possède pas de port USB, découvrez comment connecter une montre via le Wi-Fi ou le Bluetooth.
Ouvrir l'application sur la montre
- Accédez à Run > Select Device (Exécuter > Sélectionner un appareil). Choisissez la montre connectée à votre ordinateur.
- Dans la barre d'outils d'Android Studio, cliquez sur Run (Exécuter) . L'émulateur démarre et ouvre votre application.
- Après quelques instants, le message "Hello…" (Bonjour…) s'affiche sur la montre.