Executar e depurar um bloco

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Os blocos não são apps e, portanto, são implantados e iniciados usando mecanismos diferentes. Quando um dispositivo tem as opções para desenvolvedores ativadas (os emuladores têm esses recursos ativados por padrão), outros recursos que oferecem suporte ao desenvolvimento de blocos ficam disponíveis para uso no Android Studio e no adb.

Implantar Blocos

Para implantar o bloco, você pode instalar o app em um dispositivo físico ou emulador usando o Android Studio, conforme descrito em Criar e executar seu app. Em seguida, siga as mesmas etapas dos usuários comuns para adicionar o bloco ao carrossel de blocos.

Durante o desenvolvimento ativo, pode ser mais fácil e rápido usar o recurso Configuração de execução/depuração de "Wear OS Tile" do Android Studio. Esse método implanta e ativa o bloco automaticamente, permitindo a interação imediata sem outras etapas manuais.

Criar configuração automaticamente

A maneira mais fácil de implantar e executar um bloco é usar o ícone "run service" no gutter. Isso cria automaticamente uma configuração de execução, se ela ainda não existir. Consulte Configurações de execução/depuração do Wear OS para mais informações.

Criar configuração manualmente

Se a configuração automática não funcionar ou se você quiser ter mais controle sobre o resultado, consulte as instruções a seguir. As capturas de tela são do Android Studio Meerkat (2024.3.1).

1. Selecione a opção "⋮" ("hambúrguer") na barra de título.

   

2. Selecione "Editar…".

   

3. Selecione "+" para adicionar uma configuração na caixa de diálogo que aparece.

   

4. Selecione "Wear OS Tile" como o tipo da nova configuração.

   

5. Insira um nome para a configuração e selecione o módulo e o bloco.

   

6. Toque em "OK". Sua configuração vai aparecer na barra de título. Toque no botão "▷" ("executar") e o bloco será implantado e ativado.

Visualizar blocos no Android Studio

A partir do lançamento do recurso do Android Studio Koala, é possível conferir os instantâneos dos tiles do app Wear OS. Esse painel é útil principalmente se a aparência do bloco mudar em resposta a condições, como conteúdo diferente dependendo do tamanho da tela do dispositivo ou um evento esportivo chegando ao intervalo.

Adicionar dependências

Inclua as seguintes dependências no arquivo build.gradle.kts ou build.gradle do app:

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

Configurar visualizações de blocos

Para conferir uma prévia da aparência do bloco em diferentes tamanhos de tela do Wear OS, adicione a anotação @Preview e transmita o parâmetro device. Essa anotação @Preview é de um pacote diferente daquele usado para visualizações combináveis.

import androidx.wear.tiles.tooling.preview.Preview

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

Adicionar e registrar recursos

Se o Bloco usar recursos do Android, será necessário registrá-los no parâmetro onTileResourceRequest de TilePreviewData, conforme mostrado no snippet de código abaixo:

import androidx.wear.tiles.tooling.preview.Preview

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

fun getImageById(
    @DrawableRes id: Int,
): ImageResource =
    ImageResource.Builder()
        .setAndroidResourceByResId(
            AndroidImageResourceByResId.Builder()
                .setResourceId(id)
                .build(),
        )
        .build()

Mostrar valores específicos das fontes de dados da plataforma

Se o bloco usar dados da plataforma, como frequência cardíaca, calorias, distância e passos, ele vai mostrar os valores padrão.

Para mostrar um valor específico, defina o parâmetro platformDataValues ao criar o objeto TilePreviewData, conforme mostrado no snippet de código abaixo:

import androidx.wear.tiles.tooling.preview.Preview

@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(
            buildMyTileLayout()
        ).build()
    }
)

Manipular blocos usando o adb

adb pode ser usado para instalar, remover e ativar blocos de maneira programática durante o desenvolvimento.

Nos comandos abaixo, ComponentName é uma string composta pelo nome do pacote e uma classe dentro dele, por exemplo, com.example.wear.tiles/com.example.wear.tiles.PreviewTileService.

add-tile

Adiciona um bloco fornecido por COMPONENT_NAME e retorna o índice.

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

Exemplo de saída:

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

Se um bloco já existir no carrossel, ele será removido e reinserido no mesmo local. Caso contrário, ele será inserido em Index[0]. Além disso, se o carrossel estiver na capacidade máxima, o último bloco será removido para abrir espaço para o novo.

show-tile

Ative o bloco no índice TILE_INDEX.

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

Exemplo de saída:

Broadcast completed: result=1

remove-tile

Remove todas as instâncias de blocos no carrossel associado a COMPONENT_NAME.

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

Exemplo de saída:

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

Valores de retorno

• result=0: nenhum broadcast receiver respondeu a esse comando, provavelmente porque a versão do Wear OS é muito antiga ou o processo de depuração não está em execução.
• result=1: sucesso.
• result>1: erro.