Wear Tiles

Guia do usuário  Exemplo de código (link em inglês)
Crie aplicativos para smartwatches Wear OS by Google.
Atualização mais recente Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
3 de novembro de 2021 1.0.0 - - -

Declarar dependências

Para adicionar uma dependência ao Wear, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.0.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.0.0"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.0.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.0.0")
}

Para ver mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0

3 de novembro de 2021

Lançamento de androidx.wear.tiles:tiles-*:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

  • A biblioteca Wear Tiles tem uma funcionalidade para criar blocos personalizados para dispositivos Wear OS, além das classes que permitem que o sistema busque e exiba o bloco junto ao mostrador do relógio.
  • O elemento tiles-renderer permite que um bloco seja mostrado como parte de uma atividade do Android, facilitando o teste rápido dos layouts de blocos.

Versão 1.0.0-rc01

27 de outubro de 2021

Lançamento de androidx.wear.tiles:tiles-*:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Versão 1.0.0-beta01

13 de outubro de 2021

androidx.wear.tiles:tiles-*:1.0.0-beta01 é lançado. A versão 1.0.0-beta01 contém estas confirmações (link em inglês).

Correções de bugs

  • Correção da NullPointerException no TileUiClient quando uma versão vazia do recurso era fornecida (I0586e).

Versão 1.0.0-alpha12

29 de setembro de 2021

Lançamento de androidx.wear.tiles:tiles-*:1.0.0-alpha12. A versão 1.0.0-alpha12 contém estas confirmações (link em inglês).

Correções de bugs

  • UpdateScheduler não usa mais uma referência fraca, corrigindo problemas em que o TileUiClient não era atualizado (I1120d, b/199061124).

  • Declara que o SysUiTileUpdateRequester consulta o PacakgeManager, corrigindo um bug em que as atualizações de blocos não funcionavam nos dispositivos R+ (I1120d).

Versão 1.0.0-alpha11

1.º de setembro de 2021

Lançamento de androidx.wear.tiles:tiles-*:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estas confirmações.

Novos recursos

  • Uma biblioteca de testes, androidx.wear.tiles-tiles-testing, foi adicionada e lançada para que os desenvolvedores testem os blocos com mais facilidade (Iedb6b).

Mudanças na API

  • A classe TileProviderService foi renomeada como TileService (I1ad2c).
  • Os builders de blocos foram atualizados. Os métodos .builder() estáticos foram descontinuados e substituídos pelo new Foo.Builder(). As sobrecargas de setter que aceitavam uma instância de Builder foram removidas (Ia9606).
  • A classe TileRenderer agora usará um contexto da IU em vez do contexto do aplicativo (I84b61).

Correções de bugs

  • O bug que aplica vários sublinhados em algumas situações foi corrigido (Ib6712).

Versão 1.0.0-alpha10

18 de agosto de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estas confirmações.

Mudanças na API

  • Os verificadores de layout foram removidos da API pública. Eles sempre serão ativados, mas um aviso só será exibido se houver uma falha na verificação (Ie9f29).
  • A classe TileRenderer agora aceita um contexto de IU em vez do contexto do aplicativo.

Correções de bugs

  • O bug que impedia cliques em elementos clicáveis em uma Spannable foi corrigido.

Versão 1.0.0-alpha09

21 de julho de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Novos recursos

  • Adição de verificadores de layout ao renderizador do Wear Tiles (I3a869).
    • Eles são usados para validar as práticas recomendadas no bloco. Para começar, um alerta será gerado se o bloco não tiver elementos com um modificador Semantics.
  • Foi adicionada uma documentação para DefaultTileProviderClient e TestingTileProviderClient constructors (I9f4b9).

Mudanças na API

  • Renomeação em TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Adição de verificadores de layout ao renderizador do Wear Tiles (I3a869).

Correções de bugs

  • Garantir que um destino LaunchAction não tenha permissões especiais (I39136).

Versão 1.0.0-alpha08

30 de junho de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Novos recursos

  • Spanables agora são compatíveis com line_height em vez de line_spacing.

Mudanças na API

  • A compatibilidade com line_height foi adicionada em Spannables, removendo line_delimiter (Ibeb54).
    • Códigos que usam line_spacing precisam ser convertidos para usar line_height.

Correções de bugs

  • O bug ao usar dimensões proporcionais foi corrigido (I37ace).
  • O bug que impedia a descrição dos elementos de texto foi corrigido (Id2c7d).

Versão 1.0.0-alpha07

16 de junho de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Mudanças na API

  • A interface TileProviderClient foi adicionada e DefaultTileProviderClient foi exposta, permitindo que implementações sejam vinculadas a uma interface TileProviderService (I69165).

Versão 1.0.0-alpha06

2 de junho de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Mudanças na API

  • Todas as classes Builder agora contêm getters para todas as propriedades. Elas são destinadas apenas para testes (I9d155).
  • Mudança do pacote: as classes em androidx.wear.tiles.builders foram movidas para androidx.wear.tiles.
  • Adição de compatibilidade experimental com tonalidade em blocos (I38929).
  • LayoutElementBuilders.HALIGN_* foi renomeado como LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58).
  • LayoutElementBuilders.VALIGN_* foi renomeado como LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58).
  • LayoutElementBuilders.SPAN_VALIGN_* foi renomeado como LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58).
  • Adição de classes Builder para solicitações e eventos (Ib5cf4).
  • Migração de TileProviderService para usar classes de solicitação e evento de RequestBuilders e EventBuilders em vez de RequestReaders/EventReaders. Por exemplo, a onTileRequest agora fornece um RequestBuilders.TileRequest em vez de RequestReaders.TileRequest (I46ea1).

Correções de bugs

  • Correção do bug no carregamento assíncrono de imagem para o renderizador de blocos (Iad9b0).
  • Correção do bug de layout ao colocar uma imagem com largura ou altura definidas como expand() em um Box com largura ou altura definidas como wrap() (I33770).

Versão 1.0.0-alpha05

18 de maio de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Mudanças na API

  • getTileId foi removido dos eventos de blocos recebidos (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest) (Ifbba2).
  • ImageResource#setAndroidResourceByResid foi renomeado como setAndroidResourceByResId (I4ba6e).
  • TimelineManager#deInit foi renomeado para close e AutoCloseable foi implementado (I5dff2).

Versão 1.0.0-alpha04

5 de maio de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Mudanças na API

  • As classes TileProviderService concretas foram ocultas.
    • Agora, o TileUpdateRequester usa um Class<? extends TileProviderService> (Ib7cca).
  • Nova capacidade de acrescentar extras à AndroidActivity (I748f4).

Tiles: versão 1.0.0-alpha03

21 de abril de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Mudanças na API

  • TileManager foi renomeado como TileClient
    • TileManager#create foi renomeado como TileClient#connect (I91839).

Correções de bugs

  • Regras do Proguard foram incluídas para garantir que tiles e tiles-renderer funcionem corretamente com o ProGuard ativado (Ie3d85).

Versão 1.0.0-alpha02

7 de abril de 2021

Lançamento de androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02 e androidx.wear.tiles:tiles-renderer:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Mudanças na API

  • androidx.wear:wear-tiles mudou de grupos e agora precisa ser chamado usando androidx.wear.tiles:tiles.
  • androidx.wear:wear-tiles-renderer mudou de grupos e agora precisa ser chamado usando androidx.wear.tiles:tiles-renderer.
  • TileRenderer.LoadActionListener agora consome uma instância de androidx.wear.tiles.builders.StateBuilders.State em vez de androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer agora aceita recursos de blocos de androidx.wear.tiles.builders.ResourceBuilders.Resources, em vez de uma instância de androidx.wear.tiles.renderer.ResourceAccessors.

Correções de bugs

  • Correção da impossibilidade de usar LoadActionListener, por que ele expunha uma classe interna.

Versão 1.0.0-alpha01

10 de Março de 2021

Lançamento de androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01 e androidx.wear:wear-tiles-renderer:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

  • A biblioteca Wear Tiles Renderer fornece funcionalidade para criar blocos personalizados para dispositivos Wear OS, além das classes que permitem que o sistema busque e exiba o bloco ao lado do mostrador do relógio.