Glance

Crie layouts para superfícies remotas usando uma API no estilo Jetpack Compose.
Atualização mais recente Versão estável Candidata a lançamento Versão Beta Versão Alfa
5 de outubro de 2022 - - - 1.0.0-alpha05

Declarar dependências

Para adicionar uma dependência ao Glance, é preciso adicionar 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 do seu app ou módulo:

Groovy

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.0.0"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.0.0"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.0.0")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.0.0")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

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 clicando no botão de estrela.

Criar novo problema

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

Versão 1.0.0

Versão 1.0.0-alpha05

5 de outubro de 2022

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

Novos recursos

  • Adição de requestPinGlanceAppWidget a GlanceAppWidgetManager, permitindo que os apps solicitem que um usuário adicione o widget baseado em Glance à tela inicial (Ic6e47)
  • Adição de ACTION_DEBUG_UPDATE a GlanceAppWidgetReceiver para permitir que os desenvolvedores forcem a atualização do widget do adb em dispositivos e emuladores com acesso root (I94ae1)

Mudanças na API

  • Remova os botões de ação de cabeçalho nos modelos do Glance para simplificar o caso de uso (Ie4387)
  • O modelo de entidade única foi refatorado para reutilizar o design de subsistema Block (Iecd2c)
  • Modelo de lista de recursos refatorado para usar o design de blocoText/Image/Action (If0cc1)
  • Adição de um intervalo de número de prioridade para TextBlock e ImageBlock (I73100)

Correções de bugs

  • A dependência do Material3 foi removida (I28d1c)
  • Mudança para um sistema mais consistente a fim de adicionar margens e espaçamento em layouts de modelos rápidos (I29773)
  • Corrigida uma regra incorreta do Proguard que bloqueava a criação de versões reduzidas

Versão 1.0.0-alpha04

10 de agosto de 2022

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

Novos recursos

  • Foram adicionados recursos para cores de botões.
  • A anotação GlanceComposable foi adicionada para melhorar a verificação do tempo de compilação.
  • Foram adicionados recursos específicos do Glance do Wear.

Mudanças na API

  • A API Glance Gallery Data e a Condensed View foram atualizadas (Ibc7a8).
  • Foram adicionadas ButtonColors para configurar botões (Iea88d, b/236305351).
  • ColorProvider.resolve foi renomeado como ColorProvider.getColor (Ic9dfe).
  • O método copy() foi adicionado ao TextStyle (I9aef6).
  • Foi adicionada uma classe ColorProviders, que pode ser usada como parte de temas do Glance (I848b9, b/237012816).
  • Foi adicionado suporte a modelos de lista para estilos de lista e de visualização recolhida (I50cdc).
  • Foi adicionada semântica a GlanceModiier e GlanceCurvedModifier (Ifda7e).
  • A anotação GlanceComposable foi adicionada (I5dbf0).
  • Transferência de modelos do Glance para o projeto principal do Glance (I9db94).
  • ColorProvider.resolve() foi adicionado (Ife532, b/214733442).
  • Novo método para receber o GlanceId de um appWidgetId atual ou uma intent de uma atividade de configuração (Icb70c, b/230391946).
  • A anotação GlanceComposable foi adicionada (I2c21f).
  • Foram adicionadas GlanceRemoteViews para executar a composição fora de GlanceAppWidget (I18f92).
  • Remoção da cor em ProgressIndicatorDefaults (I40299).
  • O método onRun de ActionCallback foi renomeado como onAction, para fins de consistência com as APIs públicas, conforme exigido pelo feedback da avaliação da API (Icfa57).
  • Os layouts de modelos de visão geral foram convertidos para usar um mapa (I46bfd).
  • O elemento de composição RadioButton foi adicionado (I4ecce).
  • GlanceWearTiles foi adicionado para fazer a composição de blocos do Wear (Ia9f65).
  • GlanceCurvedModifier agora pode receber cliques (Iec2a0).
  • CurvedRow foi implementada como um escopo e foi criada uma DSL para adicionar elementos normais de composição e/ou curvados. curvedLine e curvedSpacer também foram adicionados, que são convertidos em ArcLine e ArcSpacer em blocos proto (Ib955b).
  • Atualizada nulidade no núcleo e na appcompat para oferecer suporte ao Tiramisu DP2 (I0cbb7).
  • Adicionado suporte a RuncallbackAction em blocos de uso rápido. No momento, apenas RunCallbackAction com o parâmetro NO tem suporte (Ide64a).

Contribuição externa

  • Atualização da API :compose:ui-ui-test (updateApi) devido à migração de test-coroutines-lib (I3366d).

Versão 1.0.0-alpha03

23 de fevereiro de 2022

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

Novos recursos

  • Definição simplificada do estado como padrão para o elemento Preferences.

Mudanças na API

  • O processamento de estado foi simplificado, tornando PreferencesGlanceStateDefinition o processamento de estado padrão. GlanceAppWidget.updateAppWidgetState foi removido e updateAppWidgetState, que usa Preferences por padrão, foi introduzido (I58963).
  • A classe TemplateText do Glance foi adicionada e o design do modelo foi atualizado (I4e146).
  • A infraestrutura de contorno foi adicionada ao modelo de forma livre (If03d6).
  • Atualizações para layouts SingleEntityTemplate (If925d).
  • LazyVerticalGrid foi adicionada (I5f442).
  • Use o ColorProvider em SingleEntityTemplate (I01ee0).
  • O nome da classe de modelo foi atualizado (I3720e).
  • Os elementos LinearProgressIndicator e CircularProgressIndicator que podem ser compostos foram adicionados (Ie116b).

Correções de bugs

  • Implementação inicial de modelos de visão geral, que define dados de "modelos de item único" e layouts de modelo de exemplo (I35837).
  • O conteúdo de blocos vai ser alinhado ao centro por padrão (I264be).
  • Correção de bug com fillMaxSize/Width/Height em glance-wear-tiles (I0a39f).

Versão 1.0.0-alpha02

26 de janeiro de 2022

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

Novos recursos

Esta versão contém o conjunto de APIs para criar blocos do Wear usando o ambiente de execução do Compose com elementos de composição otimizados para "Glanceable".

  • Declare o serviço de bloco de Wear estendendo GlanceTileService, um serviço para criar o bloco na função Content() que pode ser composta.
  • Elementos visuais que podem ser compostos de blocos do Wear: CurvedRow, CurvedText.
  • Gerencie diferentes modos de linha do tempo para o bloco definindo TimelineMode.SingleEntry e TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, a composição local se refere a um intervalo de tempo específico.
  • BorderModifer é um GlanceModifier que aplica uma borda ao redor de um elemento.

Esta versão também adiciona indicadores de progresso ao AppWidget Glance.

Mudanças na API

  • Os elementos LinearProgressIndicator e CircularProgressIndicator que podem ser compostos foram adicionados (Ie116b).
  • Mudança de actionStartBroadcastReceiver para actionSendBroadcast (I7d555).
  • O contexto é transmitido ao callback onDelete GlanceAppWidget (I4c795).

Correções de bugs

  • Processamento correto de OPTIONS_APPWIDGET_SIZES, se estiver presente, mas vazio (I01f82).

Versão 1.0.0-alpha01

15 de dezembro de 2021

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

Recursos na versão inicial

  • A primeira versão do Glance inclui o primeiro conjunto de APIs para criar o AppWidget usando o Compose Runtime, com um conjunto de novos elementos que podem ser compostos otimizados para “Glanceables”.

Recursos