Executar e depurar um bloco

Os blocos não são apps e, portanto, são implantados e iniciados usando mecanismos diferentes. Quando um dispositivo tem as opções do desenvolvedor 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, instale o app em um dispositivo físico ou emulador usando Android Studio, conforme descrito em Criar e executar o app. Em seguida, seguindo as mesmas etapas dos usuários comuns, adicione manualmente o bloco ao carrossel de blocos.

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

Criar configuração automaticamente

A maneira mais fácil de implantar e executar um bloco é usar o ícone "run service" na margem. 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 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 "Edit…".

   

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 conforme apropriado.

   

6. Toque em "OK". A 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 Android Studio Koala Feature Drop, é possível visualizar snapshots dos blocos 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 de exibição do dispositivo ou um evento esportivo que chega 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.6.0")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.6.0")
    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. Observe que esta anotação @Previewé de um pacote diferente daquele usado para visualizações combináveis.

@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

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 a seguir:

@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

Mostrar valores específicos de 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 valores padrão para eles.

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

@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

Manipular blocos usando o adb

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

Nos comandos a seguir, ComponentName é uma string composta pelo nome do pacote e uma classe dentro desse pacote, 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

Ativar 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 associadas 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.