Glance
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.
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
aGlanceAppWidgetManager
, permitindo que os apps solicitem que um usuário adicione o widget baseado em Glance à tela inicial (Ic6e47) - Adição de
ACTION_DEBUG_UPDATE
aGlanceAppWidgetReceiver
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 bloco
Text/Image/Action
(If0cc1) - Adição de um intervalo de número de prioridade para
TextBlock
eImageBlock
(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 comoColorProvider.getColor
(Ic9dfe).- O método
copy()
foi adicionado aoTextStyle
(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
eGlanceCurvedModifier
(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 umappWidgetId
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 deGlanceAppWidget
(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
ecurvedSpacer
também foram adicionados, que são convertidos emArcLine
eArcSpacer
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, apenasRunCallbackAction
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 eupdateAppWidgetState
, que usaPreferences
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
emSingleEntityTemplate
(I01ee0). - O nome da classe de modelo foi atualizado (I3720e).
- Os elementos
LinearProgressIndicator
eCircularProgressIndicator
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
eTimelineMode.TimeBoundEntries
. LocalTimeInterval
, a composição local se refere a um intervalo de tempo específico.BorderModifer
é umGlanceModifier
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
eCircularProgressIndicator
que podem ser compostos foram adicionados (Ie116b). - Mudança de
actionStartBroadcastReceiver
paraactionSendBroadcast
(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
- Declare os widgets do app com GlanceAppWidget e GlanceAppWidgetReceiver.
- Crie sua IU com o conjunto inicial de elementos que podem ser compostos do Glance: Box, Row, Column, Text, Button, LazyColumn, Image e Spacer.
- Aplique modificadores aos elementos que podem ser compostos usando os métodos GlanceModifier.
- Processe interações do usuário com Ações predefinidas.
- Forneça parâmetros para uma Ação com ActionParameters.
- Gerencie diferentes modos de tamanho definindo SizeMode.Single, SizeMode.Exact ou SizeMode.responsive.
- Mantenha o estado GGGAppWidget fornecendo um GlanceStateDefinition.
- Composições locais como LocalContext, LocalState, LocalGlanceId e LocalSize.
- Interoperabilidade entre RemoteViews já existentes e o elemento de composição AndroidRemoteViews.