Observação : o Formato do mostrador do relógio é necessário para que os mostradores sejam instalados em dispositivos com o Wear OS 5 ou versões mais recentes pré-instalados e para todos os novos mostradores publicados no Google Play.
A partir de janeiro de 2026, o formato do mostrador do relógio será obrigatório para a instalação em todos os dispositivos Wear OS.
Saiba mais sobre as mudanças para o usuário neste artigo da Central de Ajuda.
O mostrador do relógio é a primeira coisa que um usuário vê ao olhar para o relógio, o que faz dele a plataforma mais usada do Wear OS. Os usuários usam mostradores de relógio para personalizar os relógios de acordo com o estilo e fornecer informações rápidas em um relance.
Opções para criar mostradores de relógio
O formato do mostrador do relógio (WFF, na sigla em inglês) facilita a criação de mostradores. 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 processa a 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.
Oferecemos várias maneiras de criar um mostrador do relógio:
- Se você preferir uma ferramenta de estilo WYSIWYG que permita criar o design do mostrador diretamente, use o Watch Face Studio, que oferecemos em parceria com a Samsung.
- Se você tem experiência em usar o Figma como designer ou quer acelerar as primeiras etapas de criação de um mostrador do relógio como desenvolvedor, use o Watch Face Designer, que pode ser acessado com um plug-in no Figma.
Se você preferir gerenciar a configuração do relógio manualmente e publicar na sua própria app store, defina os mostradores usando XML e publique com o Watch Face Push.
O Android Studio também inclui suporte para criar e executar mostradores de relógio que usam o Formato do mostrador do relógio.
Os mostradores de relógio criados com esse formato exigem menos manutenção e 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
No centro de um mostrador do relógio no Formato de mostrador do relógio (WFF, na sigla em inglês) está um documento que define o layout e o comportamento do mostrador. Este documento é escrito em XML, de acordo com a especificação do WFF.
O sistema Wear OS inclui um componente renderizador de mostradores do relógio. Esse componente analisa seu documento XML do WFF e renderiza um mostrador de relógio com base nele. Outros recursos, como imagens e fontes, são extraídos conforme necessário.
Com essa abordagem, você só precisa descrever a aparência do mostrador do relógio, e o Wear OS processa todo o código para desenhar o mostrador.
Para implantar um mostrador do relógio no 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, mais recursos são adicionados, representados por mais elementos, atributos e fontes de dados que usam o Formato do Mostrador do Relógio.
Por exemplo, a versão 2 do WFF introduziu o suporte para clima como uma fonte de dados, que não está disponível na versão 1.
Ao projetar o mostrador do relógio, fique atento aos recursos que você quer usar e à 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 esta orientação para configurar seu AndroidManifest.xml e o arquivo de build 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 de mostrador de relógio compatíveis com cada versão do Formato do mostrador de 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.
- Watch Face Designer: aprenda a usar o plug-in do Figma para criar seu 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 criando mostradores do relógio de exemplo e implantando-os no emulador do Wear OS ou no seu 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 conferir recursos de uma versão específica do formato do mostrador do relógio na referência XML, verifique se o botão da versão apropriada está selecionado na parte de cima da página de documentação. - Guia de publicação: aprenda a publicar e monetizar seu 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 de mostrador do relógio e confirmar o uso aceitável de memória antes de enviar para o Google Play.