O mostrador do relógio é a primeira coisa que um usuário nota ao olhar para o relógio, o que faz dele a plataforma mais usada do Wear OS. Os usuários usam mostradores para personalizar o relógio de acordo com o estilo e fornecer informações rápidas de relance.
Público-alvo
Nosso novo formato de mostrador do relógio (WFF, na sigla em inglês) facilita a criação de mostradores. Em parceria com a Samsung, lançamos o Watch Face Studio, uma ferramenta do tipo "o que você vê é o que você tem", que permite projetar o mostrador do relógio diretamente.
Se você preferir gerenciar a configuração do relógio manualmente, também poderá definir mostradores de relógio usando XML. Esses guias são destinados a desenvolvedores que usam XML ou criam ferramentas personalizadas para criar mostradores de relógio usando o Formato do mostrador do relógio. O Android Studio também inclui suporte para criar e executar mostradores de relógio que usam o Formato do mostrador do relógio.
Criado em parceria com a Samsung, o Formato do mostrador do relógio é um formato XML declarativo para configurar a aparência e o comportamento de mostradores de relógio. Ao contrário de outras APIs de mostrador do relógio, em que o APK precisa incluir o código para renderizar o mostrador, o Formato do mostrador do relógio exige apenas recursos e instruções declarativas. A plataforma Wear OS cuida da lógica necessária para renderizar o mostrador do relógio para que você possa se concentrar nas suas ideias criativas, em vez de otimizações de código ou desempenho da bateria.
Os mostradores de relógio criados com esse novo formato exigem menos manutenção e menos atualizações do que aqueles criados com as bibliotecas legadas do Jetpack Watch Face. Por exemplo, você não precisa atualizar o mostrador do relógio para aproveitar as melhorias de desempenho ou de consumo da bateria ou para receber as correções de bugs mais recentes.
Sobre o formato
O formato do mostrador do relógio (WFF, na sigla em inglês) é um documento que define o layout e o comportamento do mostrador. Este documento é escrito em XML, em conformidade com a especificação do WFF.
O sistema Wear OS inclui um componente de renderizador de mostrador do relógio. Esse componente analisará seu documento XML do WFF e renderizará um mostrador do relógio a partir dele. Outros recursos, como imagens e fontes, são extraídos conforme necessário.
Com essa abordagem, você só precisa descrever como o mostrador do relógio vai ficar, e o Wear OS processa todo o código para renderizar o mostrador do relógio.
Para implantar um mostrador do Formato do mostrador do relógio em um dispositivo, empacote o documento XML em um pacote AAB ou APK padrão.
O diagrama a seguir mostra uma visão geral da abordagem:
Controle de versões no WFF
À medida que o WFF evolui, novos recursos são adicionados, representados por novos elementos, atributos, fontes de dados etc. no formato.
Por exemplo, a versão 2 do WFF introduziu a compatibilidade com o Weather como uma fonte de dados, que não está disponível na versão 1 do WFF.
Ao projetar o mostrador do relógio, saiba quais recursos você quer usar e a disponibilidade da versão deles. O guia de referência marca todos os recursos com a disponibilidade deles.
Cada versão do WFF está alinhada a uma versão do Wear OS:
| Versão do WFF | Versão mínima do Wear OS | Nível mínimo da API |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
Consulte estas orientações para configurar o arquivo de build do AndroidManifest.xml e do
Gradle de maneira adequada.
Saiba mais
Saiba mais sobre o Formato do mostrador do relógio nestes guias:
- Recursos disponíveis: conheça os recursos do mostrador do relógio com suporte em cada versão do Formato do mostrador do relógio.
- Diretrizes de design: conheça as práticas recomendadas para o layout e a experiência do usuário do mostrador do relógio.
- Configuração: configure um Android App Bundle que ofereça suporte ao Formato do mostrador do relógio.
- Exemplos do GitHub: comece a criar mostradores de relógio de exemplo e implante-os no emulador do Wear OS ou no dispositivo físico.
- Otimizar o uso da memória: aprenda a configurar o mostrador do relógio para que o sistema consuma o mínimo possível de memória ao renderizá-lo.
- Referência XML: conheça os elementos individuais que fazem parte de um
arquivo no Formato do mostrador do relógio. O elemento raiz é sempre
WatchFace. Observação: para visualizar recursos de uma versão específica do Formato do mostrador do relógio na referência XML, verifique se o botão de versão apropriado está selecionado na parte de cima da página de documentação. - Guia de publicação: aprenda a publicar e gerar receita com o mostrador do relógio na Play Store e por métodos alternativos.
- WFF e validador de memória: use essas ferramentas de código aberto para verificar se há erros no arquivo do formato do mostrador do relógio e confirmar o uso de memória aceitável antes de enviar para o Google Play.