O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Wear

Guia do usuário  Amostra de código (link em inglês)
Crie aplicativos para smartwatches Wear OS by Google.

Esta tabela lista todos os artefatos no grupo androidx.wear.

Artefato Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
wear 1.1.0 - - 1.2.0-alpha02
wear-input - 1.0.0-rc01 - -
wear-complications-data - - - 1.0.0-alpha02
wear-complications-provider - - - 1.0.0-alpha02
wear-watchface - - - 1.0.0-alpha02
wear-watchface-complications-rendering - - - 1.0.0-alpha02
wear-watchface-data - - - 1.0.0-alpha02
wear-watchface-style - - - 1.0.0-alpha02
Esta biblioteca foi atualizada pela última vez em 11 de novembro de 2020

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:

dependencies {
    implementation "androidx.wear:wear:1.1.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.0.0-rc01"
    implementation "androidx.wear:wear-input-testing:1.0.0-rc01"

    // Use to implement wear watchface complications
    implementation "androidx.wear:wear-complications-provider:1.0.0-alpha02"

    // Use to implement wear watchfaces
    implementation "androidx.wear:wear-watchface:1.0.0-alpha02"
}

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

Feedback

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

Criar uma nova edição

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

Wear Complications and Watchface 1.0.0

Versão 1.0.0-alpha02

11 de novembro de 2020

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

Mudanças na API

  • O ComplicationDetails agora é chamado de ComplicationState e está adequadamente encapsulado. Os usos da compatibilidade do wearable com @ComplicationData.ComplicationType foram migrados para o ComplicationType do androidx (I4dd36).
  • Adição de um parâmetro highlightedComplicationId opcional a RenderParameters, que permite solicitar o destaque de uma única complicação nas capturas de tela (I66ce9).
  • O ComplicationProviderService usará a nova API de complicação de estilo para consistência (Id5aea).
  • getPreviewReferenceTimeMillis agora recebe tempos de referência de DeviceConfig (I779fe).
  • Simplificação da plataforma da API Renderer. Agora, o SurfaceHolder.Callback pode ser usado para observar as mudanças (I210db).
  • O CanvasComplicationRenderer não é uma extensão do Renderer. Renomeando para maior clareza (Ibe880).

Correções de bugs

  • Primeira versão de androidx.wear:wear-watchface-client (I1e35e).
  • Mudança do nome de GlesTextureComplication#renderer para maior clareza (Ibb78f7).
  • Renomeação de StyleCategory como StyleSetting para maior clareza (I488c7).
  • Adição de UserStyleSchema para uma API mais limpa (If36f8).

Versão 1.0.0-alpha01

28 de outubro de 2020

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

Mudanças na API

  • Remoção de alguns itens que não pretendíamos expor na API pública (I41669).
  • Criação da biblioteca androidx.wear:wear-complications-provider (I77f1f).
  • ComplicationsUserStyleCategory é a nova categoria recomendada para configurar complicações (I96909).
  • Adição da API wear-complication-data (I7c268).
  • As funções com valores de retorno booleanos serão prefixadas com "is" em vez de "get" (If36ff).
  • A recomendação da API é evitar o uso protegido, de modo que essa classe tenha sido refatorada para receber parâmetros pelo construtor (I61644).
  • Renomeação de setBackgroundComplication para maior clareza (I96fe3).
  • Uso de propriedades Kotlin para dados e isHighlighted do ComplicationDrawable (I4dcc8).
  • Em vez de ComplicationRenderer.InvalidateCallback, adicionamos Complication#invalidate() (I4f4c6).
  • Essas APIs terão o uso suspenso em WearableSupport e serão removidas aqui (Ib425c).
  • Alguns métodos do builder WatchFace foram renomeados para enfatizar a natureza de legado do Wear 2.0 (Idb775).
  • Primeira candidata de API Beta para wear/wear-watchface (Id3981).
  • Primeira versão rastreada da API (Ie9fe6).
  • ComplicationDrawable.BorderStyle IntDef foi adequadamente ocultado e movido para ComplicationStyle para consistência (I27f7a).
  • Adição de anotações ausentes para métodos ComplicationStyle (I838fd).
  • Esta biblioteca não tem plataforma de API pública (I88e2b).
  • Todas as classes Option de categoria de estilo agora são adequadamente finais (Ib8323).
  • Primeira versão rastreada da API (I27c85).

Correções de bugs

  • Mudança de ComplicationProviderService para ter um método getComplicationPreviewData explícito (I4905f).
  • A verificação de lint da API para MissingGetterMatchingBuilder está ativada para androidx (I4bbea, b/138602561).
  • Renomeação de wear-complications-rendering (Ifea02).
  • Os nomes de exibição da categoria de estilo agora são CharSequences (I28990).
  • Troca de "Substituir" por "Sobrepor" para corresponder às convenções de nomenclatura de temas e estilos atuais (I4fde9).
  • Renomeação de UserStyle#getOptions para maior clareza (I695b6).

Versão 1.2.0

Versão 1.2.0-alpha02

11 de novembro de 2020

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

Esta versão adiciona uma nova API Ongoing Activities pela primeira vez. Os desenvolvedores podem usar essa API para sinalizar que uma atividade de longa duração está em andamento, como um exercício físico ou uma sessão de reprodução de mídia. Ela permite que os desenvolvedores forneçam atualizações de status periódicas, como "distância e tempo decorrido" ou "faixa em reprodução", para exibição no mostrador do relógio ou na tela de início. Essa funcionalidade é voltada a dispositivos futuros com a funcionalidade de atividade contínua ativada.

Mudanças na API

  • Nova API para atividades contínuas, que é um ambiente autônomo em "dispositivos não compatíveis" (I69a31).

Versão 1.2.0-alpha01

28 de outubro de 2020

Lançamento de androidx.wear:wear:1.2.0-alpha01. A versão 1.2.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

  • Adição do componente WearCurvedTextView para facilitar a escrita seguindo a curvatura do maior círculo que pode ser inscrito na visualização. Um exemplo de uso:
<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

Exemplo de texto curvo no Android Wear

  • Adição do contêiner WearArcLayout para definir o layout dos elementos filhos, um por um, em um arco no sentido horário ou anti-horário. Os filhos podem ser widgets Android padrão ou widgets "curvos" que implementam a interface ArcLayoutWidget. Um exemplo de uso:
<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

Exemplo de texto em arco no Android Wear

(I536da)

Wear-Input 1.0.0

Versão 1.0.0-rc01

11 de novembro de 2020

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

Essa versão é idêntica à 1.0.0-beta01.

Versão 1.0.0-beta01

28 de outubro de 2020

Lançamento de androidx.wear:wear-input:1.0.0-beta01 e androidx.wear:wear-input-testing:1.0.0-beta01, sem mudanças desde a 1.1.0-alpha01. A versão 1.0.0-beta01 contém estas confirmações.

Wear-Input-Testing versão 1.0.0-alpha01

14 de outubro de 2020

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

Mudanças na API

  • Adição de androidx.wear.input.test.TestWearableButtonsProvider, que implementa androidx.wear.input.WearableButtonsProvider para ajudar aplicativos de teste desenvolvidos com a biblioteca androidx.wear:wear-input (I0ed0c).

Wear-Input versão 1.0.0-alpha01

2 de setembro de 2020

Lançamento do androidx.wear:wear-input:1.0.0-alpha01. A versão 1.0.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

Migração da funcionalidade WearableButtons da Biblioteca de Suporte de Wearables para o Jetpack. Será oferecida maior compatibilidade com testes na biblioteca androidx.wear:wear-input-testing na próxima versão do Jetpack.

Versão 1.1.0

Versão 1.1.0

14 de outubro de 2020

Lançamento de androidx.wear:wear:1.1.0. A versão 1.1.0 contém essas confirmações (link em inglês).

Principais mudanças desde a versão 1.0.0

  • Adição de um prefixo layout_ ao atributo boxedEdges (agora layout_BoxedEdges) para BoxInsetLayout para obedecer à convenção de nomenclatura do Android. Isso removerá o erro de linter no Android Studio para esses atributos (I4272f).
  • Adição de EXTRA_ANIMATION_DURATION_MILLIS opcional a ConfirmationActivity para permitir a duração de exibição da caixa de diálogo de confirmação (adb83ce, b/143356547)
  • Atualização de WearableActionDrawView para atrasar a inflação da gaveta de ação até que ela seja aberta pela primeira vez (I01026, b/163870541)

Versão 1.1.0-rc03

2 de setembro de 2020

Lançamento do androidx.wear:wear:1.1.0-rc03. A versão 1.0.0-rc03 contém essas confirmações.

Correções de bugs

  • Foi corrigido o problema em que a gaveta de ação não mostrava o conteúdo quando aberta. (I01026, b/163870541)

Versão 1.1.0-rc02

24 de junho de 2020

androidx.wear:wear:1.1.0-rc02 é lançado. A versão 1.0.0-rc02 contém essas confirmações (link em inglês).

Correções de bugs

  • Adição de um prefixo layout_ ao atributo boxedEdges (agora layout_boxedEdges) para BoxInsetLayout para obedecer à convenção de nomenclatura do Android. Isso removerá o erro de linter no Android Studio para esses atributos.

Versão 1.1.0-rc01

14 de maio de 2020

Lançamento de androidx.wear:wear:1.1.0-rc01 sem mudanças desde .1.0-beta01. A versão 1.1.0-rc01 contém essas confirmações (link em inglês).

Versão 1.1.0-beta01

29 de abril de 2020

androidx.wear:wear:1.1.0-beta01 é lançado sem mudanças desde androidx.wear:wear:1.1.0-alpha01. A versão 1.3.0-beta01 contém essas confirmações (link em inglês).

Versão 1.1.0-alpha01

15 de abril de 2020

androidx.wear:wear:1.1.0-alpha01 é lançado. A versão 1.1.0-alpha01 contém essas confirmações (link em inglês).

Mudanças na API

  • Adição de EXTRA_ANIMATION_DURATION_MILLIS opcional a ConfirmationActivity para permitir a duração de exibição da caixa de diálogo de confirmação (adb83ce, 134523c, b/143356547, links em inglês).

Correções de bugs

  • Atualização de WearableActionDrawView para atrasar a inflação da gaveta de ação até que ela seja aberta pela primeira vez (5cd32f7, link em inglês).