Exécuter et déboguer une carte

Les cartes ne sont pas des applications. Elles sont donc déployées et lancées à l'aide de mécanismes différents. Lorsqu'un appareil est doté des options pour les développeurs (les émulateurs sont dotés de ces fonctionnalités par défaut), des fonctionnalités supplémentaires permettant le développement de cartes sont disponibles dans Android Studio et adb.

Déployer des cartes

Pour déployer votre carte, vous pouvez installer votre application sur un appareil physique ou un émulateur à l'aide d'Android Studio, comme décrit dans Créer et exécuter votre application. Ensuite, en suivant les mêmes étapes que les utilisateurs habituels, ajoutez manuellement la carte au carrousel de cartes.

Pendant le développement actif, vous pouvez trouver plus simple et plus rapide d'utiliser la fonctionnalité de configuration d'exécution/de débogage "Wear OS Tile" (Carte Wear OS) d'Android Studio. Cette méthode déploie et active automatiquement votre carte, ce qui permet une interaction immédiate sans étapes manuelles supplémentaires.

Créer une configuration automatiquement

Le moyen le plus simple de déployer et d'exécuter une carte consiste à utiliser l'icône "run service" (exécuter le service) dans la marge. Cela crée automatiquement une configuration d'exécution si elle n'existe pas déjà. Pour en savoir plus, consultez Configurations d'exécution/de débogage Wear OS.

Capture d'écran avec une flèche rouge pointant vers "▷" dans la marge
Cliquez sur "▷" dans la marge
Capture d'écran montrant une flèche rouge pointant vers le menu déroulant de configuration d'exécution, et l'option de configuration "TestTileService" encadrée en rouge
Une "configuration d'exécution" est créée automatiquement.

Créer une configuration manuellement

Si la configuration automatique ne fonctionne pas ou si vous souhaitez mieux contrôler le résultat, consultez les instructions suivantes. Les captures d'écran proviennent d'Android Studio Meerkat (2024.3.1).

  1. Sélectionnez l'option "⋮" ("hamburger") dans la barre de titre.

    Capture d'écran avec une flèche rouge pointant vers l'option "⋮" (hamburger) dans la barre de titre.

  2. Sélectionnez "Edit…" (Modifier…).

    "Modifier…" est la première option de la section "Configuration" de la liste déroulante.

  3. Sélectionnez "+" pour ajouter une configuration dans la boîte de dialogue qui s'affiche.

    Capture d'écran avec une flèche rouge pointant vers le signe "+".

  4. Sélectionnez "Wear OS Tile" (Carte Wear OS) comme type de la nouvelle configuration.

    Capture d'écran avec une flèche rouge pointant vers l'option de configuration "Carte Wear OS".

  5. Saisissez un nom pour votre configuration, puis sélectionnez le module et la carte appropriés.

    Capture d'écran avec trois flèches rouges pointant vers des zones de la boîte de dialogue.

  6. Appuyez sur "OK". Votre configuration s'affiche dans la barre de titre. Appuyez sur le bouton "▷" ("exécuter") pour déployer et activer votre carte.

Prévisualiser des cartes dans Android Studio

À partir de la fonctionnalité Koala Feature Drop d'Android Studio, vous pouvez afficher des instantanés des cartes de votre application Wear OS. Ce panneau est particulièrement utile si l'apparence de votre carte change en fonction des conditions, par exemple si le contenu est différent selon la taille d'affichage de l'appareil ou si un événement sportif atteint la mi-temps.

Les noms de groupes dans le panneau d'aperçu correspondent à ceux indiqués dans l'annotation d'aperçu.
Panneau d'aperçu des cartes dans Android Studio.

Ajouter des dépendances

Incluez les dépendances suivantes dans le fichier build.gradle.kts ou build.gradle de votre application :

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.6.0")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.6.0")
    implementation("androidx.wear:wear-tooling-preview:1.0.0")
}

Configurer des aperçus de cartes

Pour afficher un aperçu de l'apparence de votre carte sur différentes tailles d'écran Wear OS, ajoutez l'annotation @Preview et transmettez le paramètre device. Notez que cette @Preview annotation provient d'un package différent de celui que vous utilisez pour les aperçus composables.

@Preview(device = WearDevices.SMALL_ROUND)
@Preview(device = WearDevices.LARGE_ROUND)
fun tilePreview(context: Context) = TilePreviewData { request ->
    TilePreviewHelper.singleTimelineEntryTileBuilder(
        buildMyTileLayout(context, request.deviceConfiguration)
    ).build()
}
Preview.kt

Ajouter et enregistrer des ressources

Si votre carte utilise des ressources Android, vous devez les enregistrer dans le paramètre onTileResourceRequest de TilePreviewData, comme illustré dans l'extrait de code suivant :

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithResources(context: Context) = TilePreviewData(
    onTileResourceRequest = { request ->
        Resources.Builder()
            .setVersion(RESOURCES_VERSION)
            .addIdToImageMapping(
                myImageId,
                getImageById(R.drawable.animated_walk)
            )
            .build()
    },
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout(context, request.deviceConfiguration)
        ).build()
    }
)
Preview.kt

Afficher des valeurs spécifiques à partir de sources de données de plate-forme

Si votre carte utilise des données de plate-forme (fréquence cardiaque, calories, distance et pas, par exemple), elle affiche des valeurs par défaut.

Pour afficher une valeur spécifique, définissez le paramètre platformDataValues lors de la création de l'objet TilePreviewData, comme illustré dans l'extrait de code suivant :

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithPlatformOverride(context: Context) = TilePreviewData(
    platformDataValues = PlatformDataValues.of(
        PlatformHealthSources.Keys.HEART_RATE_BPM,
        DynamicDataBuilders.DynamicDataValue.fromFloat(160f)
    ),
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayoutDynamic(context, request.deviceConfiguration)
        ).build()
    }
)
Preview.kt

Manipuler des cartes à l'aide d'adb

adb peut être utilisé pour installer, supprimer et activer des cartes par programmation pendant le développement.

Dans les commandes suivantes, ComponentName est une chaîne composée du nom du package et d'une classe dans ce package, par exemple com.example.wear.tiles/com.example.wear.tiles.PreviewTileService.

add-tile

Ajoute une carte fournie par COMPONENT_NAME et renvoie l'index.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation add-tile --ecn component [COMPONENT_NAME]

Exemple de résultat :

Broadcast completed: result=1, data="Index=[0]"

Si une carte existe déjà dans le carrousel, elle est supprimée et réinsérée au même emplacement. Sinon, elle est insérée à Index[0]. De plus, si le carrousel atteint sa capacité maximale, la dernière carte est supprimée pour laisser la place à la nouvelle.

show-tile

Active la carte à l'index TILE_INDEX.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SYSUI --es operation show-tile --ei index [TILE_INDEX]

Exemple de résultat :

Broadcast completed: result=1

remove-tile

Supprime toutes les instances de carte du carrousel associées à COMPONENT_NAME.

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation remove-tile --ecn component [COMPONENT_NAME]

Exemple de résultat :

result=1, data="Tile(s) removed."

Valeurs renvoyées

  • result=0 : aucun broadcast receiver n'a répondu à cette commande, probablement parce que la version de Wear OS est trop ancienne ou que le processus de débogage n'est pas en cours d'exécution.
  • result=1 : réussite.
  • result>1 : erreur.