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.
Cliquez sur Outils > SDK Manager et installez les deux packages:
- Android 14.0 ("UpsideDownCake) (niveau d'API 34), qui inclut la Wear OS 5 – Image système Preview ARM 64 v8a et Wear OS 5 – Aperçu de l'image système Intel x86 Atom_64 Notez que même si le package contient le mot "preview", l'image de l'émulateur contient version stable de Wear OS 5.
- Android 13.0 ("Tiramisu") (niveau d'API 33), qui inclut la Image système Wear OS 4 ARM 64 v8a et Wear OS 4 Intel x86 Atom_64 System Image (Image système).
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 UpsideDownCake. nom de la version. Cette version cible Android 14.0 (Wear OS 5). 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). Si vous ne possédez pas encore de montre Wear OS 5 une image système correspondant à la définition de votre appareil, cliquez sur Download (Télécharger) à côté du nom de la version pour l'obtenir. 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/ABI
pour les émulateurs utilisés en dehors de la Chine.$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI
pour 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 ou version ultérieure ne sont compatibles qu'avec ces
d'architecture: 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.
- Accédez au bas du menu. 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.
Participer aux programmes bêta relatifs aux appareils
Dans certaines régions, vous pouvez vous inscrire à la version bêta de l'application Samsung Galaxy One UI Watch Bêta. programme. Ce programme vous permet de télécharger Wear OS 5 sur un Samsung Galaxy éligible Montrez l'appareil et testez le comportement de votre application.
Pour vous inscrire, procédez comme suit:
- Téléchargez l'application Samsung Members, disponible sur le Google Play Store :
- Connectez-vous avec votre compte Samsung.
- Faites défiler la bannière d'accueil ou la page "Avis", puis sélectionnez l'icône Fiche d'inscription au programme bêta de One UI Watch.
- Sur la page qui s'affiche, lisez les instructions, puis sélectionnez l'option "Rejoindre" qui s'affiche. Par exemple, sur un appareil Samsung Galaxy Watch6, sélectionnez Watch 6 Join.
Recommandations personnalisées
- Remarque : Le texte du lien s'affiche lorsque JavaScript est désactivé
- Intégrer des systèmes de compilation C/C++ personnalisés à l'aide de Ninja (expérimental)
- Couches de validation Vulkan sur Android
- Notes de version