Wear Compose Material 3
Atualização mais recente | Versão estável | Versão candidata a lançamento | Versão Beta | Versão Alfa |
---|---|---|---|---|
4 de junho de 2025 | - | - | 1.5.0-beta03 | - |
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 ao arquivo build.gradle
do
seu app ou módulo:
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0-beta03" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-beta03" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-beta03" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.5.0-beta03") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-beta03") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-beta03") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, please raise a bug to let us know. }
Para 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.
Wear Compose Material3 versão 1.5
Versão 1.5.0-beta03
4 de junho de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta03
. A versão 1.5.0-beta03 contém estas confirmações.
Mudanças na API
- O
OpenOnPhoneDialog
agora anuncia apenas o texto da mensagem no TalkBack e pula a semântica do ícone. OOpenOnPhoneDialogDefaults
foi atualizado para remover oiconContentDescription
e o parâmetrocontentDescription
deicon()
. Além disso, oConfirmationDialogDefaults
agora tem parâmetros modificadores nos elementos combináveisSuccessIcon
eFailureIcon
. (Id2ae2).
Correções de bugs
- Mudamos a ordem em que aplicamos o efeito dos parâmetros
SurfaceTransformation
. Antes, as transformações aplicadas aos componentes do Material3 para Wear eram feitas da seguinte maneira: pintor de plano de fundo, transformação de contêiner e transformação de conteúdo. Agora, os dois primeiros são invertidos, e aplicamos qualquer modificador transmitido entre eles, para que seja afetado pelas transformações do contêiner. Isso corrige casos como o uso de um efeito de brilho de marcador de posição com elementos em um TLC usando o parâmetro de transformação. (I786cf). RevealState.Saver
foi adicionado para ser usado na restauração do estado deSwipeToReveal
quando a atividade ou o processo é recriado. A funçãorememberRevealState
agora usa esse recurso por padrão. (Ie0ecb).- Os botões de ações primárias e secundárias
SwipeToReveal
devem serButtonDefault.Height
por padrão. Foi corrigido um bug em que eles preenchiam a altura máxima para botões mais altos. (Ibfba1). SwipeToReveal
foi alterado para redefinir o último componente com o qual foi feita a interação quando o gesto de deslizar para a direita é realizado. (Ia8450).- O
SwipeToReveal
foi alterado para se estabelecer no estadoRevealing
quando a posição final do deslize estiver entre as âncoras de revelação e de exibição e estiver mais próxima da âncora de revelação. (If4458). - Agora, o conteúdo de
ButtonGroup
é invertido corretamente em um layout RTL (Ib378d). - A
AnimatedText
agora oferece suporte à direção de texto RTL (I4533c). - O
TransformingLazyColumn
agora redimensiona os itens corretamente quando o item de baixo é removido (Idacab). - Agora,
TransformingLazyColumn
faz apenas uma passagem de medição, o que melhora o desempenho reduzindo os tempos de frame. (I501a1).
Versão 1.5.0-beta02
20 de maio de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta02
. A versão 1.5.0-beta02 contém estas confirmações.
Correções de bugs
- Atualização dos perfis de referência para as bibliotecas Foundation, Material e Material3. (I53f06).
- Correção de um bug em
TransformingLazyColumn
, em que os itens eram redimensionados quando o item de baixo era removido (Idacab). - Correção de um bug com
TransformingLazyColumn
, quando a lista ficava presa na parte de cima ou de baixo da tela. (I49d00). OpenOnPhoneDialog
no TalkBack precisa anunciar o texto curvado, e não a descrição do conteúdo do ícone. (I4efe8).- Correção de um bug em
SwipeToReveal
que informava a âncora errada emRevealState.currentValue
quandohasPartiallyRevealedState
estava definido como falso (I9c7cf). - Os botões de desfazer
SwipeToReveal
agora sãoButtonDefaults.Height
por padrão. (I1f6c8). - O desempenho de
BasicSwipeToDismissBox
foi aprimorado com a eliminação do uso de tela para desenhar telas. (I68f2c). - Correção de um bug de acessibilidade no controle deslizante, em que a porcentagem anunciada não correspondia ao valor após as atualizações (I91146).
- Correção de um bug na implementação de
placeholderShimmer
(Iee39b). - A performance do
TransformingLazyColumn
foi melhorada, otimizando o cálculo doScrollProgress
em 30%. (I4c4cb).
Versão 1.5.0-beta01
7 de maio de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta01
. A versão 1.5.0-beta01 contém estas confirmações.
A versão 1.5.0-beta01 do Compose para Wear OS indica que esta versão da biblioteca está com todos os recursos e a API está bloqueada (exceto quando marcada como experimental).
O Wear Compose 1.5.0-beta01 inclui a biblioteca Wear Compose Material3, que oferece suporte ao novo sistema de design da interface chamado Material 3 Expressive. É recomendável fazer upgrade do Material Design para o Material 3 para adotar o novo design visual nos apps e aproveitar os novos componentes da seguinte forma:
MaterialTheme
para esquemas de cores, tipografia e formas atualizados e estendidos que dão profundidade e variedade aos seus designs.- O tema de cores dinâmico, que gera automaticamente um esquema de cores para o app corresponder às cores do mostrador do relógio.
- Os novos componentes se adaptam automaticamente a tamanhos de tela maiores por padrão
- Morphing de forma: componentes de botão redondos, como
IconButton
,TextButton
,IconToggleButton
eTextToggleButton
, oferecem suporte a variações que são animadas quando pressionadas ou marcadas. EdgeButton
: um novo botão que abraça a borda com uma forma especial projetada para a parte de baixo da tela.- Estruturas: introdução de
AppScaffold
eScreenScaffold
para definir o layout da estrutura da tela e coordenar animaçõesScrollIndicator
eTimeText
. - Botões: vários botões em forma de estádio são compatíveis com contêineres flexíveis de slot único e variações de vários slots para botões com ícones e rótulos.
CheckboxButton
eSwitchButton
são fornecidos quando os botões de alternância são necessários, enquantoRadioButton
é o botão de seleção disponível. As variações "Split" dos botões de alternância e de seleção também são fornecidas. ButtonGroup
: implementa um grupo expressivo de botões em uma linha que muda de forma quando tocado.- As variações de
AlertDialog
oferecem suporte a botões de confirmação/cancelamento ou a umEdgeButton
. - O
ConfirmationDialog
está disponível para mostrar uma mensagem com um tempo limite, com suporte a animações especiais para variações de sucesso, falha e abertura no smartphone. - Seletores: as variações
TimePicker
eDatePicker
são compatíveis, assim como os componentes Picker ePickerGroup
para criar suas próprias telas de seletor. ProgressIndicators
: os indicadores de progresso circulares e lineares são aceitos (oCircularProgressIndicator
tem variações segmentadas e indeterminadas).- Cards: várias variações de cards estão disponíveis, incluindo
TitleCard
, que oferece layouts específicos para cards com título, hora, legenda ou slots de conteúdo.TitleCard
também pode ter um plano de fundo de imagem para reforçar o significado das informações em um card. - Páginas de chamadas: os componentes
HorizontalPagerScaffold
,VerticalPagerScaffold
eAnimatedPage
coordenam animaçõesHorizontalPageIndicator
eVerticalPagerIndicator
.HorizontalPager
eVerticalPager
são lançados na biblioteca Wear Compose Foundation. - Marcadores de posição: desenha uma forma de esqueleto sobre um componente para situações em que nenhum conteúdo provisório está disponível.
- Controles deslizantes e steppers: permitem que os usuários escolham um valor em um intervalo. Os controles deslizantes são mais compactos e podem ser segmentados, enquanto o Stepper é um componente de tela cheia normalmente associado a um
StepperLevelIndicator
. SwipeToReveal
: usado para adicionar outras ações a um elemento combinável quando ele é deslizado da direita para a esquerda.
Além disso, a Wear Compose Foundation 1.5.0-beta01 inclui estes novos componentes:
TransformingLazyColumn
: uma lista de rolagem vertical lenta que oferece suporte a animações de escalonamento e transformação.- Grupos de foco hierárquicos: usados para anotar elementos combináveis em um app, acompanhar a parte ativa da composição e coordenar o foco.
- Pagers: componentes
HorizontalPager
eVerticalPager
, criados com base nos componentes do Compose Foundation e com melhorias específicas do Wear para melhorar o desempenho e a adesão às diretrizes do Wear OS.
Mudanças na API
- Atualizamos a API Hierarchical Focus: renomeamos
Modifier.hierarchicalFocus
paraModifier.hierarchicalFocusGroup
e removemos o parâmetro de callback. Também removemos a sobrecarga deModifier.hierarchicalFocusRequester
com um parâmetroFocusRequester
e criamos um novoCompositionLocal
,LocalScreenIsActive
para que os componentes possam informar e verificar qual tela está ativa. (I5ff7c). - O
SwipeToReveal
da Wear Compose Foundation foi descontinuado em favor das APIsSwipeToReveal
no Wear Compose Material e no Wear Compose Material3. Substitua as importaçõesSwipeToReveal
do Wear Foundation por importações do Wear Compose Material/ Wear Compose Material3 para continuar usando as APIs. (Ia147d). - As dependências
SwipeToReveal
do Wear Compose Material3 na Foundation foram movidas para o pacote material3, por exemplo,RevealValue
,RevealDirection
,RevealActionType
,RevealState
,rememberRevealState
. Os desenvolvedores precisam mudar as importações dessas classes e funções deandroidx.wear.compose.foundation
paraandroidx.wear.compose.material3
. (I640e6). - A API
SwipeToReveal
do Material3 do Compose para Wear foi atualizada da seguinte maneira: foram adicionados os parâmetrosprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
ehasPartiallyRevealedState
ao elemento combinávelSwipeToReveal
. A capacidade de personalizarpositionalThreshold
eanimationSpec
emRevealState
foi removida.lastActionType
,revealThreshold
e largura emRevealState
foram removidos. O construtorRevealState
foi alterado para aceitar umRevealDirection
em vez de âncoras. As funçõescreateRevealAnchors
, âncoras ebidirectionalAnchors
foram renomeadas comoPrimaryActionButton
,SecondaryActionButton
,UndoActionButton
e transformadas em funções combináveis.RevealActionType
foi marcado como interno.primaryAction
secondaryAction
undoPrimaryAction
undoSecondaryAction
SwipeToRevealScope
(I885d0). - A API
SwipeToReveal
foi atualizada da seguinte forma: renomeação deonFullSwipe
paraonSwipePrimaryAction
; renomeação deSwipeToRevealNonAnchoredSample
para indicar o uso do parâmetrohasPartiallyRevealedState
; remoção deactionButtonHeight
, já que a altura padrão do botão é o valor padrão e a altura maior pode ser definida usando um modificador; remoção deSmallActionButtonHeight
deSwipeToRevealDefaults
; o parâmetro de valor nos construtoresRevealValue
eRevealDirection
foi definido como privado. (I465ce).
Correções de bugs
- Correção do processamento de
EdgeButton
doScreenScaffold
para que, depois que um itemTransformingLazyColumn
for removido, oEdgeButton
seja animado no lugar. (I6d366). - As dependências do Wear Compose nas bibliotecas do Compose foram atualizadas para a versão 1.8.0. (I2ef3f).
- A movimentação do
CircularProgressIndicator
indeterminado foi atualizada para que ele não retroceda temporariamente (Ieddb1). - Correção de um bug na
SwipeDismissableNavHost
: o foco não mudava corretamente após a deslizar para trás, fazendo com que a entrada por seletor giratório falhasse (isso era para a API 36 e versões mais recentes, que usa a volta preditiva). (Ieddb1). - A documentação da API Hierarchical Focus (Idf2ff) foi corrigida.
- Atualizamos a documentação de Botão e Card para explicar como
containerPainter
edisabledContainerPainter
substituemcontainerColor
edisabledContainerColor
(I4a453). - Uma mudança na
TimeText
da versão anterior foi revertida. Ela movia aBroadcastReceiver
para uma linha de execução de worker, o que causava problemas em apps que gerenciam a própria linha de execução durante a navegação. (I34d02). - Atualizamos os exemplos do seletor para remover chamadas desnecessárias de recordação e usar
rememberUpdatedState
no seletor para lembrar a função lambdacontentDescription
mais recente. (Icb5b1). - Estilos de texto atualizados em
TimePicker
eDatePicker
para que as mudanças de fonte não resultem mais em truncamento. (I26194). ListHeader
eListSubHeader
agora definem o alinhamento de texto como centralizado e alinhado à esquerda, respectivamente. (I78339).- Atualizamos os exemplos e as demonstrações de deslizar para revelar da Fundação e do Material Design para anunciar ações de acessibilidade personalizadas. As ações personalizadas precisam ser adicionadas como semântica no conteúdo, não no elemento combinável
SwipeToReveal
. (Ie92a3). - O
MaxLines
padrão definido no conteúdoEdgeButton
foi atualizado de acordo com o tamanho: agora é 1 para extra pequeno, 2 para pequeno e médio e 3 para grande. (Ie35f6). - A
LocalReduceMotion
foi simplificada para que o observador seja registrado apenas uma vez, melhorando a performance. (Ib1979). - O número de recriações foi minimizado em
ScrollIndicator
para melhorar o desempenho. (Ia7a67). - Correção de um bug em
TransformingLazyColumn
, em que o item visível de cima na lista não era dimensionado corretamente quando o EdgeButton atingia a altura total. (I30580).
Wear Compose Material3 versão 1.0
Versão 1.0.0-alpha37
23 de abril de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha37
. A versão 1.0.0-alpha37 contém estas confirmações.
Mudanças na API
scrollTransform
foi removido da plataforma da API pública. Use a combinação dos modificadorestransformedHeight
egraphicsLayer
se precisar ter a mesma funcionalidade. (Ie181d).- Os elementos combináveis
ImageButton
eImageCard
foram substituídos por sobrecargasButton
eCard/TitleCard
, respectivamente.imageButtonColors
foi renomeado comobuttonWithContainerPainterColors
, eimageCardColors
foi renomeado comocardWithContainerPainterColors
. Adição deButtonDefaults.scrimBrush
eCardDefaults.scrimBrush
públicos. Os botõesimageBackgroundGradientStartColor
eimageBackgroundGradientEndColor
foram renomeados comoscrimGradientStartColor
escrimGradientEndColor
.CardDefaults.ImageContentPadding
foi renomeado comoCardDefaults.CardWithContainerPainterContentPadding
(I7b8b6). Picker
ePickerGroup
agora usamcontentDescription
como uma lambda para evitar recomposições desnecessárias. (I002dd).
Correções de bugs
- Correção de um problema em que o
CircularProgressIndicator
indeterminado oscilava durante a animação se a largura não fosse igual à altura (I76bfe). - Correção de um problema com o layout do botão de borda em tamanho inválido. Agora, a atualização do layout do botão de borda é impedida quando a altura é NaN. (I32b93).
- Aumentamos o ângulo máximo de varredura em
OpenOnPhoneDialog
para que o texto padrão "Confira seu smartphone" não seja cortado com o tamanho de fonte maior. (I90af9).
Versão 1.0.0-alpha36
9 de abril de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha36
. A versão 1.0.0-alpha36 contém estas confirmações.
Mudanças na API
ButtonDefaults.imageBackgroundButtonColors
foi substituído porImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
eButtonDefaults.disabledContainerPainter
. E mudanças semelhantes para o cartão. Os pintores foram removidos deButtonColors
eCardColors
. (I8c6a1).- Marcadores de posição atualizados para simplificar a API. Agora oferecemos dois modificadores,
Modifier.placeholderShimmer
para aplicar um efeito de brilho no nível do componente eModifier.placeholder
para aplicar uma máscara sobre o conteúdo não carregado (Iaee7a).
Correções de bugs
- Integração de rolagem excessiva no
ScrollIndicator
. (Icfb7f). - Correção de planos de fundo em branco e caixas de diálogo ausentes ao iniciar caixas de diálogo do Material3. (Ice597).
- Correção de problemas em
FadingExpandingLabel
quando o texto se estende por várias linhas. (I04eb7). - Atualizamos o padding entre os rótulos primário e secundário nos botões. (I99b7b).
ArcLarge
foi reduzido de20sp
para18sp
, e o espaçamento entre letras emArcLarge
eArcSmall
foi atualizado.ConfirmationDialog
/OpenOnPhoneDialog
agora usam oArcLarge
padrão em vez de substituí-lo por18sp
. (Id39a8).
Atualizações de dependência
- Essa biblioteca agora é destinada ao nível de linguagem Kotlin 2.0 e requer a KGP 2.0.0 ou mais recente. (Idb6b5).
Versão 1.0.0-alpha35
26 de março de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha35
. A versão 1.0.0-alpha35 contém estas confirmações.
Mudanças na API
- O padding superior
AlertDialog
agora é reduzido por padrão quando um ícone é fornecido. Isso otimiza o uso do tamanho da tela disponível. (Ief06c). PagerScaffoldDefaults.FadeOutAnimation
foi renomeado comoPagerScaffoldDefaults.FadeOutAnimationSpec
O parâmetro de página emAnimatedPage
foi renomeado comopageIndex
. (I701f2).- A nomenclatura do
SurfaceTransformation
doTransformingLazyColumn
foi atualizada:applyTransformation
foi dividida emapplyContainerTransformation
eapplyContentTransformation
, ecreateBackgroundPainter
foi renomeado comocreateContainerPainter
. Atualizações de nomenclatura adicionais paraTransformationSpec
eResponsiveTransformationSpec
. (I1c534). - O
AppScaffold backgroundColor
foi renomeado comocontainerColor
. (I4e63f).
Correções de bugs
- Correção de um problema em
FadingExpandingLabel
em que o texto nem sempre era expandido corretamente (I0e773). - O tamanho da
ArcLarge
foi reduzido de 20sp para 18sp, e o espaçamento entre letras emArcLarge
eArcSmall
foi atualizado.ConfirmationDialog/OpenOnPhoneDialog
agora usa oArcLarge
padrão em vez de substituí-lo por 18sp. (Id39a8). - Atualizamos a animação do título com base em
DatePicker
eTimePicker
para que a animação de fade-out e fade-in funcione como uma animação de mola. (I68963). - Otimização da
PagerScaffold
evitando a leitura decurrentPageOffsetFraction
no elemento combinávelAnimatedPage
. (I433ef). - Todas as escalas de tipo foram atualizadas para ter números proporcionais por padrão, porque esse é o caso de uso mais frequente, e a exibição em tabela resultou em muito espaço entre determinados pares de números.
TimePicker
eDatePicker
continuam aplicandoFontFeatureSetting=tnum
para números tabulares. (I88929). - Correção do foco inicial de entrada do RSB para
TimePicker
eDatePicker
. (I1c773). - O texto padrão em
OpenOnPhoneDialog
foi atualizado para "Verificar seu smartphone". (I00a3f). - As ponderações de
ArcLarge
eArcMedium
foram atualizadas de 600 para 599 para contornar um problema em que a ponderação 600 era tratada como negrito (I2a51d). - Atualização dos paddings
SwipeToReveal
entre o conteúdo e os botões de ação, além do padding entre o ícone e o texto dos botões de ação. (Ic46cb).
Versão 1.0.0-alpha34
12 de março de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha34
. A versão 1.0.0-alpha34 contém estas confirmações.
Mudanças na API
- O
PagerScaffold
não emite mais um componentePager
. Em vez disso, ele precisa ser fornecido pelo elemento combinávelcontent
.AnimatedPage
esnapWithSpringFlingBehaviour
agora são públicos e podem ser usados com oPager
da Wear Foundation para alcançar o comportamento anterior doPagerScaffold
do M3. (Consulte os exemplos atualizados). (Ia4724). - Atualizamos o
PagerState
, removendo oPagerState
do Compose Foundation como a classe base e adicionando as propriedadescurrentPage
,currentPageOffsetFraction
epageCount
. Atualizamos a interfaceGestureInclusion
, renomeando o método paraignoreGestureStart
. (I4ae07). - Os parâmetros de ângulo de varredura
LevelIndicator
agora são anotados comFloatRange(0, 360)
(I7e636). - Adicionamos
CurvedModifier.clearAndSetSemantics
para oferecer uma forma de desativar a semântica curva.CurvedText
continua definindo a descrição do conteúdo como padrão para o texto, mastimeTextCurvedText
etimeTextSeparator
não anunciam mais o conteúdo. (I4b568). - Foram adicionados parâmetros de cor de plano de fundo e de conteúdo padrão a
AppScaffold
. (I56652). - O processamento padrão de gestos de deslizar de
HorizontalPager
foi renomeado comoPagerDefaults.gestureInclusion
. O comportamento padrão agora é ignorar apenas os gestos de deslizar que começam na borda esquerda da primeira página e apenas quando o Talkback está desativado. Em outros casos, o comportamento padrão é que os gestos de deslizar não são ignorados pelo seletor, então eles não estão disponíveis para manipuladores de deslizar para descartar. (Iee486). - Adicionamos um parâmetro
SurfaceTransformation
aos componentes de botão, card e cabeçalho de lista para que eles possam aplicar diferentes transformações de plano de fundo e conteúdo quando usados em contêineres que mudam a aparência dos itens com base na posição deles, comoTransformingLazyColumn
. (Iabe3f). - Atualizamos as propriedades "public const val" na API Wear Compose Material3 para "public val", para evitar que os valores sejam inline. (Ib0f32).
- Foi adicionado suporte a uma zona de deslizamento na borda para
SwipeToReveal
. O comportamento padrão doSwipeToReveal
da Fundação agora é não permitir a deslizar quando o gesto começa na borda. O comportamento padrão doSwipeToReveal’
do Material3 agora é impedir a deslizar quando o gesto começa na borda, quando oSwipeDirection
está definido como uma única direção. (I32ef0). - Foi adicionado o elemento combinável
FadingExpandingLabel
, que permite que o texto seja exibido com animação linha por linha (Ic60fa). - O
TransformingLazyColumn
agora usacontentPadding
vazio por padrão em vez de centralizar o primeiro e o último item. (I77ab7). - O
rememberRevealState
doSwipeToReveal
foi removido da biblioteca Material3 do Wear Compose. (I8c0e0).
Correções de bugs
- As bibliotecas do Wear Compose foram atualizadas para o compilador Kotlin 2.0. (I2de79).
- O suporte para
ScrollIndicator
ePageIndicator
não arredondados foi removido do Material3. O suporte a telas quadradas também não faz mais parte dos requisitos do Wear OS. Consulte o Guia de início para mais informações. (I9a852). - O
CurvedTextStyle
usado emConfirmationDialogDefaults
eOpenOnPhoneDialogDefaults
foi atualizado para usar a tipografiaArcLarge
com tamanho18sp
e espaçamento entre letras1.8sp
. (Ic9ced). Card
,ListHeader
,RadioButton
,CheckboxButton
eSwitchButton
não restringem mais a altura do conteúdo por padrão. Quando necessário, useModifier.height(IntrinsicSize.Min)
para restaurar o comportamento anterior. (I80bb8).- Atualizamos as cores padrão
TimeText
eScrollIndicator
para incluir mais tons de cinza. Isso porque o uso deOnBackground
(branco) tinha muito peso visual quando competia com outros conteúdos na tela, como títulos. (I8b36f). - Reduzimos o tempo limite para animar o
TimeText
e oScrollIndicator
em componentes de scaffold para 2 segundos. (I52021). - Atualizamos o movimento da caixa de diálogo para que a escala do plano de fundo seja sincronizada com o gesto de deslizar para dispensar. (I925a9).
- Adição de uma demonstração de
SwipeToReveal
do M3 usando o modificadoredgeSwipeToDismiss
. (I02b07). - Adicionamos um título a
DatePicker
eTimePicker
no TalkBack para que o usuário seja informado sobre como rolar para definir a data/hora. (Id738d). - O
AnimatedText
agora segue a configuração de redução de movimento. (Ib6578). - A otimização para usar
AppScaffold
no conteúdo da caixa de diálogo de exibição foi aprimorada para permitir que várias caixas de diálogo sejam mostradas uma sobre a outra (I1209c).
Versão 1.0.0-alpha33
26 de fevereiro de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha33
. A versão 1.0.0-alpha33 contém estas confirmações.
Mudanças na API
- Removemos o parâmetro de rótulo do
primaryAction
esecondaryAction
doSwipeToRevealScope
. A semântica de ação personalizada precisa ser adicionada ao conteúdo do componenteSwipeToReveal
diretamente pelo desenvolvedor. (Ia67f3). - Os prefixos "Button" foram removidos dos tamanhos, estilos de texto e funções de cor em
IconToggleButtonDefaults
eTextToggleButtonDefaults
(I5471d). - O
LocalMinimumInteractiveComponentEnforcement
experimental foi removido (I4ad8a). - Substituímos o DSL
PickerGroupScope
por um elemento combinável. Por isso, removemos o métodopickerGroupItem
doPickerGroupScope
e adicionamos@Composable PickerGroupItem
, que precisa ser usado para adicionar um seletor aoPickerGroup
. Também atualizamos o tipo do parâmetro "content"PickerGroup
para@Composable PickerGroupScope.() -> Unit
. (Ic6aec). - Adicionamos uma sobrecarga
LevelIndicator
para valores fracionários e um prefixo Stepper para as sobrecargas que incluem um parâmetro de intervalo (adequados para uso com o componente Stepper). (If4234). - Adicionamos o
TransformationSpec
daTransformingLazyColumn
à API, o que permite a definição das transformações exatas que ocorrem nos itens conforme eles são rolados pelo TLC. (I21856). - Atualizamos
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
eTextToggleButtonShapes
para serem consistentes com as classes compose/material3 (I5a081). - Adicionamos um parâmetro
overscrollEffect
aScalingLazyColumn
,TransformingLazyColumn
eScreenScaffold
. (I0cee8). - Renomeamos o parâmetro
swipeDirection
comorevealDirection
emrememberRevealState
. (I7472f). - O Pager do Wear agora tem o próprio
PagerScope
em vez de usar oPagerScope
do Compose. (I9195b). - Removemos o elemento combinável
LinearProgressIndicatorContent
. UseLinearProgressIndicator
diretamente para que as mudanças nos valores sejam animadas por padrão. (I2c4ad). - O elemento combinável
CircularProgressIndicatorStatic
foi removido e uma funçãoDrawScope
públicadrawCircularProgressIndicator
com a mesma funcionalidade foi adicionada. UseCircularProgressIndicator
diretamente para que as mudanças sejam animadas por padrão, mas crie seu próprio elemento combinável emdrawCircularProgressIndicator
se for necessário usar animações personalizadas. (Ie762f). - Reordenamos os parâmetros em
DrawScope.drawCircularProgressIndicator
para mover o parâmetrotargetProgress
para cima. (I8ab92). - A API
OpenOnPhoneDialog
foi atualizada para melhorar a clareza e a consistência com outras caixas de diálogo. O parâmetroshow
foi renomeado comovisible
, ecurvedText
agora é fornecido pelo autor da chamada em vez de ter um valor padrão. (Idec2d). openOnPhoneCurvedText
foi renomeado comoopenOnPhoneDialogCurvedText
(I65bdd).- Adicionamos
ScrollIndicatorColors
para fornecer cores personalizadas aScrollIndicator
. (I9eb8c). - Permita a configuração da cor usada para desenhar um plano de fundo por trás de
TimeText
. (I9f5d9). - As famílias tipográficas
ArcLarge
,ArcMedium
eArcSmall
foram atualizadas paraCurvedTextStyle
(Iffc41). - Removemos
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
. (Ia923e). - Adicionamos
errorDim
aoColorScheme
para erros de alta prioridade ou ações de emergência, como alertas de segurança, falhas em sobreposições de caixa de diálogo ou botões de parada. (I70998).
Correções de bugs
- Fixamos
wear.compose.material3
na versão 1.15.0 deandroidx.core.core
(I132e9). - Melhoramos o desempenho da caixa de diálogo usando o
AppScaffold
para sobrepor caixas de diálogo a outros conteúdos da tela (I1b9a4). - Reduzimos o padding vertical interno de
EdgeButton
. (I1a5bb). - Adicionamos a semântica de botões aos botões de controle deslizante. (I80cc6).
Versão 1.0.0-alpha32
29 de janeiro de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha32
. A versão 1.0.0-alpha32 contém estas confirmações.
Mudanças na API
- Em
CurvedTextStyle
, dividimos o espaçamento entre letras em sentido horário e anti-horário. Isso é necessário porque as letras no sentido horário se espalham a partir da linha de base, enquanto as letras no sentido anti-horário se espalham para dentro (portanto, é necessário um espaçamento maior entre as letras) (I4b848). - Atualizamos
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
eTextToggleButtonShapes
para melhorar a consistência nas bibliotecas do Material3. Essa mudança também introduz o armazenamento em cache de formas para reduzir o número de alocações. (I049fc). - Removemos o parâmetro
pressedShapeCornerSizeFraction
do métodovariantAnimatedShape
emIconToggleButton
eTextToggleButton
(I58a65). - Melhorias na renderização de texto curvo (incluindo
TimeText
) que são incompatíveis com telas não redondas. O suporte a telas não redondas também não faz mais parte dos requisitos do Wear OS. Consulte o guia de início para mais informações. (I1cc1c). - Atualizamos o
ButtonGroupScope
deButtonGroup
, substituindo oButtonGroupItem
baseado em DSL porModifier.weight
,Modifier.minWidth
eModifier.enlargeOnPress
. (I16c3c). - Na API
ButtonGroup
, atualizamos o novoButtonGroupScope
baseado em modificador:enlargeOnPress
agora é chamado deanimateWidth
e usa umInteractionSource
, em vez deMutableInteractionSource
, porque não é necessário mutá-lo. Também adicionamos a constante públicaButtonGroupDefaults.DefaultMinWidth
, a largura mínima padrão dos botões em umButtonGroup
. (Ie27ec). - Atualizamos
ListHeaderDefaults.contentColor
para começar com uma letra minúscula, já que é uma propriedade combinável (I125a5). - Adicionamos um parâmetro de descrição de conteúdo a
SliderDefaults.DecreaseIcon
eSliderDefaults.IncreaseIcon
, com valores padrão adequados (I2e1a7). - O parâmetro
spacing
emPicker
ePickerGroup
foi renomeado comoverticalSpacing
(Ib75cc). - Removemos
ConfirmationDialogDefaults.successText
efailureText
porque espera-se que os autores de chamadas deConfirmationDialog
forneçam strings com mais contexto. Também renomeamosconfirmationCurvedText
comoconfirmationDialogCurvedText
. Por fim, o parâmetroshow
da caixa de diálogo foi renomeado para "visível" para manter a consistência com outras atualizações recentes das caixas de diálogo. (I10074). IconButton
foi renomeado dedisabledImageOpacity
paraDisabledImageOpacity
. (I5f94a).
Correções de bugs
- Correção de um bug na animação
EdgeButton
para que o tamanho correto seja usado em cada frame (Id3b58). - Correção de um problema em que
animateContentSize
não funcionava comButton
. (Ib18a0). - Mudamos a escala de tipo de título grande para ter o tamanho da fonte
18dp
(Ic9d52). - Atualizamos o espaçamento e o tamanho do ícone
AlertDialog
(Iac28c). - Correção de inconsistências em pontos de interrupção de telas grandes (telas com 225 dp ou mais são grandes) (I36474).
- Correção de um pequeno bug na posição do botão (I952c2).
Versão 1.1.0-alpha31
15 de janeiro de 2025
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha31
. A versão 1.0.0-alpha31 contém estas confirmações.
Mudanças na API
- Atualizamos todas as bibliotecas do Compose para Wear ao modo "API explícita". (Iebf9f).
- Atualizamos as APIs
ScreenScaffold
eEdgeButton
para facilitar a especificação de paddings de conteúdo em telas que incluem umEdgeButton
. Na nova API, osize
doEdgeButton
é transmitido apenas para oEdgeButton
, e oScreenScaffold
usa um parâmetroedgeButtonSpacing
para o espaçamento entreEdgeButton
e o conteúdo da lista. (I424fd). - Em
DatePicker
, renomeamos os parâmetrosminDate
paramaxDate
eminValidDate
paramaxValidDate
. EmDatePickerColors
, renomeamos o parâmetroselectedPickerContentColor
comoactivePickerContentColor
eunselectedPickerContentColor
comoinactivePickerContentColor
(Iba17b). - Atualizamos os padrões de
ArcProgressIndicator
parastrokeWidth=6dp
e recomendamosdiameter = 81.24%
de altura da tela (I6f248). - Atualizamos a API Confirmation para refletir o uso dela como uma caixa de diálogo. O elemento combinável agora é chamado de
ConfirmationDialog
, com atualizações associadas ao nome de cores e classes padrão. Também renomeamos o parâmetroshow
paravisible
para compatibilidade com outras APIs de animação do Compose. Além disso, disponibilizamosConfirmationDialogContent
,SuccessConfirmationDialogContent
eFailureConfirmationDialogContent
para situações em que os desenvolvedores precisam personalizar as animações de caixa de diálogo de introdução/finalização. (Iaeb33). - Atualizamos
CircularProgressIndicatorContent
paraCircularProgressIndicatorStatic
(a variação não animada deCircularProgressIndicator
) para que possa ser usado na criação deCircularProgressIndicator
com animações personalizadas. (I1346f). - Corrigimos a ordem dos parâmetros na
ArcProgressIndicator
, colocando o parâmetro do modificador em primeiro lugar (I4656a). - Melhoria na API
SwipeToReveal
para receber um parâmetro de slot de texto para os rótulos das ações (exceto ação secundária) e para remover parâmetros de rótulo da ação de desfazer (I5b3db).
Correções de bugs
- Foi corrigido um bug em que as haptics
LongPress
eram acionadas mais de uma vez emButton
,Card
,IconButton
eTextButton
(Ia8b0f). - Mudanças na UX de
AlertDialog
: em telas grandes, os botões de confirmação e rejeição agora são menores. O espaçamento abaixo dos botões de confirmação e dispensa também foi aumentado. (I4f066). - Mudamos as especificações de animação do rótulo do botão de ação do componente
SwipeToReveal
. (Ib87fb). SwipeToReveal
foi alterado para expandir o contêiner ao mesmo tempo que o texto é mostrado. (I44cf8).- Melhorias no
SwipeToReveal
para realizar feedback tátil quando o gesto de deslizar ultrapassa o limite em que a ação principal é confirmada. (I23efe). - Atualizamos
SwipeToReveal
para mostrar reticências no texto em excesso por padrão, para ações principais e desfazer. (I71f5a). - Correção de um problema que causava instabilidade nas animações
ButtonGroup
. (I63f8f). - Adicionamos a semântica de texto a
AnimatedText
(I6063c). - A caixa de diálogo agora redefine o escalonamento em segundo plano quando é removida da composição. Sem essa correção, a tela de inicialização poderia ficar em um estado reduzido (Id24ac).
- Adicionamos uma animação de transformação de forma aos botões no componente Stepper (Id6ed3).
Versão 1.0.0-alpha30
11 de dezembro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha30
. A versão 1.0.0-alpha30 contém estas confirmações.
Mudanças na API
- O modificador
scrollTransform
paraTransformingLazyColumn
foi refatorizado, o que acionou uma mudança na API. (I0c6dc). - Atualizamos
IconToggleButtonShapes
eTextToggleButtonShapes
para ter dois parâmetros de forma diferentes,uncheckedPressed
echeckedPressed
(I85dbd). - As opções de mês/dia inválidas agora aparecem no
DatePicker
, com um novoinvalidPickerContentColor
, ao usarminDate
oumaxDate
. (If4541). - Atualizamos a API
Stepper
para fornecer slotsincreaseIcon
edecreaseIcon
. O conteúdo deles pode ser criado normalmente no elemento combinável do ícone. (Id35da). - Atualizamos
dynamicColorScheme
removendo o parâmetro opcionaldefaultColorScheme
e retornandoColorScheme
anulável. Isso significa que o autor da chamada precisa processar explicitamente o caso de substituição quando um esquema de cores dinâmico não é fornecido. (I6d62e). - Atualizamos os tamanhos dos ícones em
ButtonDefaults
para uso comCompactButton
. UmCompactButton
que contém apenas um ícone deve usarButtonDefaults.SmallIconSize = 24.dp
, enquanto umCompactButton
que contém ícone e texto deve usarButtonDefaults.ExtraSmallIconSize = 20.dp
. Recomendamos queCompactButton
envolva o conteúdo (em vez de preencher a largura máxima), e os exemplos foram atualizados para mostrar isso. (I0582c). - Adicionamos
EdgeButtonDefaults
com tamanhos de ícone recomendados para os 4EdgeButtonSizes
diferentes. Além disso, atualizamos o layoutEdgeButton
para que ele tenha um padding inferior um pouco maior do que o superior, o que melhora a aparência do conteúdo de ícone e texto. (Id772a). - Adicionamos movimento a
LinearProgressIndicator
e expomosLinearProgressIndicatorContent
, que fornece o conteúdo visual sem animações. (Idee99). - Adicionamos um novo elemento combinável
CircularProgressIndicatorContent
para mostrar o conteúdo visual deCircularProgressIndicator
sem animações. (Ie33d4). TransformingLazyColumn
agora fornece a composição localLocalTransformingLazyColumnItemScope
, queCard
s,Button
s eListHeader
s usam para se transformar automaticamente quando colocados dentro de umTransformingLazyColumn
. Os autores de chamadas podem desativar a transformação automática usando o novo wrapperTransformExclusion
. (I1652f).- Atualizamos o tipo de
ButtonDefaults.shape
paraRoundedCornerShape
(Iccdf2).
Correções de bugs
- Correção de um bug para respeitar o Alfa atual em segundo plano para
TimeText
(I1eb60). - Definimos
TextMotion
comoAnimated
por padrão na nossa tipografia para evitar a instabilidade do texto devido à fixação de glifos de letras nos limites de pixels durante as operações de escalonamento. (I626fa). - Atualizamos a aparência do
ScrollIndicator
aumentando a largura e o tamanho do espaço para melhorar a visibilidade. (Ied7cb). - Corrigimos um bug no
Modifier.scrollTransform
ao adicionar/remover/mover itens. (I6830f). - Corrigimos um problema de animação do botão redondo para toques curtos. Antes, a duração mínima da animação nem sempre era observada. (I757a7).
- Atualizamos o ângulo de varredura de
LevelIndicator
para 20% (ou seja, 72 graus). (Idde5c). - Corrigimos o posicionamento de
ScrollIndicator
quandoScalingLazyColumn
foi usado comAutoCenteringParams
. (I387dd). - Atualizamos as cores e a tipografia de
ListHeader
eListSubHeader
. Além disso, as cores dos controles de alternância emCheckboxButton
eSwitchButton
. (I39817). - Corrigimos o posicionamento de
ScrollIndicator
emLazyColumn
eScalingLazyColumn
comContentPadding
. (I2bc51). - Correção de um bug na animação de progresso da
OpenOnPhoneDialog
usando o novoCircularProgressIndicatorContent
(I3e443). - Atualizamos o
HorizontalPagerScaffold
e oVerticalPagerScaffold
para desativar animações quando a redução de movimento estiver ativada (Iaaf68). - Implementamos uma animação separada para indicadores de progresso circular quando o progresso chega a mais de 100%. (I47135).
- Correção de um bug em que o
EdgeButton
podia ser desenhado com uma forma incorreta em componentes de pager (I91db9).
Versão 1.0.0-alpha29
13 de novembro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha29
. A versão 1.0.0-alpha29 contém estas confirmações.
Mudanças na API
- Atualizamos
TimeText
para fornecer conteúdo padrão que mostra a hora. (Id23b3). - Simplificamos o
ScrollInfoProvider
paraPagerState
removendo o parâmetroorientation
, que não é mais necessário. O novo comportamento é que aTimeText
permaneça no lugar para paginação horizontal e vertical. (I71767). - O
LocalHapticFeedback
agora oferece uma implementação padrão deHapticFeedback
quando a API Vibrator indica que há suporte para háptica. Os seguintes valores foram adicionados aHapticFeedbackType
:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Os componentes de clique longo do Wear Compose, comoButton
,IconButton
,TextButton
eCard
, agora executam a resposta tátilLONG_PRESS
quando um manipulador de clique longo é fornecido. (I5083d).
Correções de bugs
- Atualizamos a animação para confirmações. (I04bff).
- Atualizamos a dependência mínima da API para 1.7.4 nas bibliotecas do Compose. (I88b46).
- Foi adicionado um novo movimento para a caixa de diálogo
OpenOnPhone
. (I1e10a). - Corrigimos um bug no
LevelIndicator
para que ele seja mostrado corretamente com o nível zero. (Ie95a4). - Atualizamos as animações
HorizontalPageIndicator
eVerticalPageIndicator
. (I5c8f3). - Adicionamos uma animação de redução a ponto ao
ArcProgressIndicator
indeterminado. (I9fd51).
Versão 1.0.0-alpha28
30 de outubro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha28
. A versão 1.0.0-alpha28 contém estas confirmações.
Mudanças na API
- Adicionamos uma variação de arco no indicador de progresso circular indeterminado (I2efc1).
- Os elementos combináveis
AlertDialogContent
eDialog
que compõem a APIAlertDialog
foram disponibilizados publicamente para que seja possível adicionar personalização, se necessário, como personalizar a animaçãoAlertDialog
mantendo o layout de conteúdo recomendado. Além disso, adicionamos os parâmetrosModifier
eColor
aos membrosEdgeButton
,ConfirmButton
eDismissButton
deAlertDialogDefaults
. (I4eb71). - Atualizamos a API
Placeholder
da seguinte forma: renomeamosPlaceholderState.startPlaceholderAnimation
paraPlaceholderState.animatePlaceholder
,PlaceholderState.isShowContent
paraPlaceholderState.isHidden
ePlaceholderDefaults.shape
paraPlaceholderDefaults.Shape
; renomeamos o parâmetropainter
empainterWithPlaceholderOverlayBackgroundBrush
paraoriginalPainter
; mudamos a visibilidade dePlaceholderState.placeholderProgression
de "público" para "interno" e renomeamos paraplaceholderShimmerProgression
; adicionamos constantes de duração da animação do marcador de posição aPlaceholderDefaults
. (Ie5a59). - Atualizamos a API
EdgeButton
da seguinte maneira: renomeamos o parâmetro emScreenScaffold
debottomButton
paraedgeButton
e transformamosEdgeButtonSize
em uma classe de valor. (Ieef15). - Mudamos a visibilidade de
copy()
para "pública" nas classes de cores do Material3 para Wear (I0287f).
Correções de bugs
- Adicionada a duração mínima da animação para
IconToggleButton
eTextToggleButton
ao clicar (Ieb333). - Adicionada duração mínima na animação de forma
IconButton
eTextButton
(Iebcee). - Correção do estado da opção de repetição de
DatePicker
. (I3587c). - Adição de movimento para caixas de diálogo de alerta e confirmação. (I173b1).
Versão 1.0.0-alpha27
16 de outubro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha27
. A versão 1.0.0-alpha27 contém estas confirmações.
Mudanças na API
- Atualizamos o
ScreenScaffold
e oScrollIndicator
após a renomeação da Fundação Wear ComposeLazyColumn
paraTransformingLazyColumn
. (I0608b). - O parâmetro
preferredHeight
deEdgeButton
foi renomeado parabuttonSize
, e o valor dele só pode ser escolhido entre quatro constantes na classe de valorEdgeButtonSize
recém-introduzida. (Icdd70). - Mudamos o nome de
ListSubheader
paraListSubHeader
e adicionamos valores padrão acessíveis publicamente paraListHeader
eListSubHeader
. (I96730). - Adicionamos novos componentes
HorizontalPagerScaffold
eVerticalPagerScaffold
para o Wear, que oferecem novas animações e coordenação entre o texto de tempo e os componentes do indicador de página. (Iff7d0). - Adicionamos suporte a seletor giratório a
HorizontalPagerScaffold
eVerticalPagerScaffold
, permitindo que os usuários naveguem por pagers usando dispositivos de entrada por seletor giratório. (I9770d). - Fizemos mudanças na API
MotionScheme
para simplificar o uso e melhorar a consistência. As funções de recordação inline foram removidas e os MotionSchemes integrados foram movidos para um objeto complementar MotionScheme dedicado.standardMotionScheme
eexpressiveMotionScheme
foram renomeados como padrão e expressivo. (I5fd45). - Adicionamos suporte a um esquema de cores dinâmico com base nas cores do sistema. (I073e9).
- Atualizamos o Stepper para as especificações de UX mais recentes. (I622bb).
Correções de bugs
- Atualizamos a tipografia e o padding dos componentes do card. (I3ae48).
- Mudamos o preenchimento em
AlertDialog
entre os botões "Confirmar/Rejeitar" e o restante do conteúdo de 8 dp para 12 dp de acordo com as especificações da UX (Ie55f0). - Atualizamos a opacidade da cor do componente Controle deslizante. (Idb383).
Versão 1.0.0-alpha26
2 de outubro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha26
. A versão 1.0.0-alpha26 contém estas confirmações.
Mudanças na API
- Atualizamos a API e a aparência de
HorizontalPageIndicator
e adicionamosVerticalPageIndicator
para uso comVerticalPager
(Ic9309). - O
AlertDialog
agora oferece suporte à capacidade de omitir o botão inferior padrão da variação da pilha de botões para layouts personalizados em que o EdgeButton não é necessário. (I34fa9). - Adicionamos um componente
SwipeToReveal
para o Material 3 do Wear (Ic38b2). - Adicionamos suporte ao deslizamento bidirecional em
SwipeToReveal
para casos raros em que a tela atual não oferece suporte ao gesto de deslizar para fechar. O padrão ainda é deslizar para revelar apenas em deslizamentos da direita para a esquerda, e é altamente recomendável respeitar o comportamento padrão para evitar conflitos com o gesto de deslizar para dispensar. (Ifac04). - Renomeamos o parâmetro
buttonHeight
deEdgeButton
comopreferredHeight
. (I4fab3). - A versão do Kotlin foi atualizada para 1.9 (I1a14c).
- Renomeamos
OpenOnPhoneDialogDefaults.Icon
paraOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
para evitar conflitos comIcon
(I0f391). - Adicionamos suporte para
ScrollIndicator
emLazyColumn
. (Ia546a). - Atualizamos os valores padrão de
TextToggleButton
eIconToggleButton
. (I7aaa9). - Simplificamos as APIs
Picker
ePickerGroup
. (Id0653). - Adicionamos
CardDefaults.Shape
eCardDefaults.Height
, que, por serem tokens, eram privados para os desenvolvedores que usavam a biblioteca. (I1594a, b/347649765). - Renomeamos o parâmetro de progresso do indicador de progresso circular segmentado binário para
segmentValue
. (Ib72d9). - Atualizamos as cores e o layout do controle deslizante. (Ic3eec).
Correções de bugs
- Atualizamos a animação do ícone
openOnPhone
(I66f85). - Agora usamos os ícones do Google Symbols em
Slider
,TimePicker
eDatePicker
. (I46c7c). - Atualizamos os paddings em
Confirmation
eOpenOnPhoneDialog
. (Iaa82e).
Versão 1.0.0-alpha25
18 de setembro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha25
. A versão 1.0.0-alpha25 contém estas confirmações.
Mudanças na API
- Adicionamos um indicador de progresso circular indeterminado. (I427a7).
- Adicionamos suporte para o transbordamento de progresso (>100% de progresso) para
CircularProgressIndicator
eSegmentedCircularProgressIndicator
. Quando o progresso exceder 1,0, isso será indicado pela nova coroverflowTrack
. (Iaaa3d). - O
IconToggleButton
e oTextToggleButton
redondos agora oferecem suporte a uma nova variação de animação de forma, em que formas diferentes representam estados de verificação, desmarcação e pressionamento. A variação de forma animada anterior para o estado pressionado continua sendo aceita. (I29f03). - Removemos o suporte para o uso de
EdgeButton
comColumn
devido à necessidade de especificar a altura deEdgeButton
explicitamente emScreenScaffold
. (Ie353d). - Adicionamos suporte ao
LazyColumn
do Compose para Wear com nossoScreenScaffold
e adicionamos uma implementação deScrollInfoProvider
paraLazyColumnState
(Ib8d29). - Combinamos
LocalTextMaxLines
,LocalTextAlign
eLocalTextOverflow
em uma única composição localLocalTextConfiguration
para oferecer uma solução mais escalonável. (I5edbc). - Adicionamos arc-large como uma escala de tipo adicional, reservada para strings de texto de cabeçalho curtas na parte superior ou inferior da tela, como nas sobreposições de confirmação. (I60e3e).
- Adicionamos padrões ao botão para tamanhos de ícone grandes e extragrandes recomendados e padding de conteúdo. (I84675).
Correções de bugs
- Atualizamos as cores de
IconButton
eTextButton
. (I48324). - Mudamos as sobrecargas de botão básicas para que fiquem alinhadas verticalmente ao centro para consistência com outras sobrecargas. Para restaurar o comportamento anterior, use
Modifier.align
noRowScope
. (I66e57).
Versão 1.0.0-alpha24
4 de setembro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha24
. A versão 1.0.0-alpha24 contém estas confirmações.
Mudanças na API
- Adicionamos um esquema de movimento ao tema Material3. Isso será usado pelos componentes da biblioteca para aplicar especificações de animação, como molas para movimentos expressivos. (I54ff3).
- Adicionamos os componentes
AppScaffold
eScreenScaffold
à biblioteca Material3, que incluem funcionalidades para coordenar camadas e transições deTimeText
eScrollIndicator
.AppScaffold
fornece um nível superior de componentes de esqueleto que ficam acima de todas as telas. Assim, adicionarTimeText
aoAppScaffold
permite que ele permaneça no lugar ao deslizar entre as telas. As telas podem substituir ou ocultar o texto de tempo. OScreenScaffold
fornece um slot para oScrollIndicator
e anima automaticamente o indicador de rolagem durante a rolagem, incluindo o tempo limite para ocultar o indicador de rolagem após a inatividade. (I047d6). - Adicionamos
ScrollIndicator
com o novo design do Material3. Ele tem um tamanho de miniatura fixo com base no conteúdo inicial da lista para evitar variações de tamanho quando o conteúdo preguiçoso é carregado na lista. (Ic228d). - Mudamos a API
ScrollAway
para queScreenStage
seja uma classe de valor em vez de uma classe de tipo enumerado, permitindo que outros estágios sejam adicionados conforme necessário. (I48c93). - Adicionamos
EdgeButton
, um botão distinto específico para o Wear com uma forma que segue a curvatura da parte de baixo da tela (I16369). - Adicionamos um novo slot à
ScreenScaffold
para um botão de baixo (comoEdgeButton
), que será mostrado e redimensionado dependendo do conteúdo de rolagem (I032eb). - Adicionamos
Modifier.scrollTransform
eModifier.targetMorphingHeight
para adicionar efeitos de movimento do Material3 a itens emLazyColumn
. (Ie229a). - Adicionamos
SegmentedCircularProgressIndicator
como uma variação deCircularProgressIndicator
. A variação segmentada mostra um único valor de progresso em todos os segmentos ou mostra cada segmento como ativado/desativado. (I6e059) - Adicionamos
LinearProgressIndicator
como uma alternativa aoCircularProgressIndicator
. (I89182). - Adicionamos
AlertDialog
, fornecendo layouts para apresentar solicitações importantes ao usuário. As variações incluem um par de botões de confirmação/exclusão ou um único botão na parte de baixo (geralmente um EdgeButton) abaixo de uma pilha de opções. Ambas as variações têm slots para ícone, título e texto adicional para fornecer mais detalhes. (Ieb873). - Adicionamos
OpenOnPhoneDialog
, que precisa ser usado para indicar uma ação que vai continuar no smartphone do usuário.OpenOnPhoneDialog
é dispensada após um tempo limite especificado. (I978fd). - Adicionamos
Confirmation
, um componente de caixa de diálogo que tem slots para um ícone e texto curvo ou linear. Variações específicas são fornecidas para mensagens de sucesso/falha. As confirmações são dispensadas automaticamente após um tempo limite. (Ib43e8). - Adicionamos um plano de fundo ao
TimeText
para evitar problemas em que o conteúdo e oTimeText
se sobrepõem e obscurecem o tempo. (Ia11fd). - Adicionamos
LevelIndicator
, que mostra o valor de uma configuração, como o volume, e pode ser usado com o componenteStepper
para criar uma tela de volume.LevelIndicator
é semelhante aScrollIndicator
, mas aparece no lado oposto da tela e tem uma largura de traço mais larga e uma cor de indicador diferente por padrão. (I8a4ac). - Adicionamos
TimePicker
, com layouts para o horário de 24 horas (com ou sem segundos) ou de 12 horas com seleção de manhã/tarde. (Ia5124). - Adicionamos
DatePicker
, com configuração para ordenação de colunas (por exemplo, dia-mês-ano, mês-dia-ano ou ano-mês-dia) e datas mínimas/máximas opcionais. (Ibf13b). - Adicionamos um parâmetro de peso à função
text
deTimeText
. Nos casos em que o TimeText é composto por mais de um elemento de texto, isso permite controlar como o espaço é distribuído. (I36700). - Adicionamos
RadioButton
eSplitRadioButton
. Esses componentes simplificam a API anterior combinando oSelectableButton
(Split) e o controle de rádio filho (If7ae8). - Adicionamos
CheckboxButton
eSplitCheckboxButton
. Esses componentes simplificam a API anterior combinando oToggleButton
(Split) e o controle de caixa de seleção filho (Ia8f70). - Adicionamos
SwitchButton
eSplitSwitchButton
. Esses componentes simplificam a API anterior combinando(Split)ToggleButton
e o controle de alternância filho (I0d349). - Atualizamos a documentação de
AnimatedText
para explicar o comportamento de ultrapassagem. (Iff30a). - Adicionamos
ButtonGroup
para combinar dois ou três botões, de modo que pressioná-los produza uma animação coordenada. (Ie27db). - Adicionamos uma animação de forma opcional para
IconButton
eTextButton
quando pressionados. (Iffca5). - Adicionamos uma variação de cor,
FilledVariant
, paraButton
,IconButton
,TextButton
,CompactButton
eEdgeButton
(I65fc3). - Adicionamos o parâmetro
forcedSize
aImageWithScrimPainter
, de modo que os planos de fundo de imagens de botões agora mantenham o tamanho do componente por padrão. A configuração doforcedSize = null
adota oPainter.instrinsicSize
. (Ic57af). - Adicionamos o clique longo aos botões (Ib613d).
- O suporte a cliques longos também foi adicionado a
IconButton
eTextButton
. (I38891). - Adicionamos suporte a cliques longos aos cards. (I305d5).
- Adicionamos
LocalTextMaxLines
,LocalTextAlign
eLocalTextOverflow
comoCompositionLocals
e os usamos como parâmetros padrão emText
. Os locais de composição agora podem ser usados por componentes comoCheckboxButton
,SwitchButton
eRadioButton
para implementar orientações de UX, mas os parâmetros podem ser substituídos pelos desenvolvedores, se necessário. (Iab841). - Adicionamos
Placeholder
para ajudar a mascarar o conteúdo de componentes, como botões e cards, até que os dados sejam carregados. (I1a532). - Adicionamos
IconToggleButtonColors
eTextToggleButtonColors
para substituir oToggleButtonColors
, que foi removido. (Ie0bf1).
Correções de bugs
- Atualizamos
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
eCompactButton
para usar o novoCompositionLocals
LocalTextMaxLines
,LocalTextAlign
eLocalTextOverflow
para implementar orientações de UX. Esses parâmetros podem ser substituídos diretamente pelos desenvolvedores no texto, se necessário (Ie51f7). - Mudamos a largura de traço padrão do
LevelIndicator
para6dp
para diferenciá-lo doScrollIndicator
, que tem uma largura de traço de4dp
. (If6f63). - Um problema em
TimeText
foi corrigido para que ângulos de varredura maiores sejam aceitos. (Ie489f). - Correção de um problema durante a recomposição de
EdgeButton
(I4cdca). - Correção de layouts de botões de alternância divididos quando o padding de conteúdo personalizado é fornecido. (Ia33d3).
- Os valores pequenos de progresso foram arredondados para pelo menos a largura da linha do indicador de progresso. (I3bd84).
Versão 1.0.0-alpha23
14 de maio de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha23
. A versão 1.0.0-alpha23 contém estas confirmações.
Mudanças na API
- Atualizamos as APIs
ToggleButton
eRadioButton
para que as cores desativadas possam ser configuradas. (If13a7). - Adicionamos um novo
CircularProgressIndicator
para o Material3. (Ib3bd7).
Correções de bugs
- Corrigimos um bug em que os botões selecionáveis anunciavam o toque duplo para alternar quando já estavam selecionados. (I7ed88).
Versão 1.0.0-alpha22
1º de maio de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha22
. A versão 1.0.0-alpha22 contém estas confirmações.
Mudanças na API
- Atualizamos o Material3
ColorScheme
. (I7b2b8). - Atualizamos o botão de alternância do Material3 e fizemos algumas mudanças de cor. Agora, o ícone de marcação corresponde ao usado na caixa de seleção. (Icac7b).
Correções de bugs
- Atualizamos todas as demonstrações de integração para usar o novo modificador
rotaryScrollable
. (I25090).
Versão 1.0.0-alpha21
17 de abril de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha21
. A versão 1.0.0-alpha21 contém estas confirmações.
- Essa versão foi acionada devido a um problema técnico na versão anterior que resultou em jars de origem ausentes. Não há novas confirmações nesta versão.
Versão 1.0.0-alpha20
3 de abril de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha20
. A versão 1.0.0-alpha20 contém estas confirmações.
Correções de bugs
- Ajustamos as alfas do estado pressionado e focado da Ripple para contraste. (I59f0a).
- Adicionamos espaço entre os rótulos primário e secundário em
Button
,ToggleButton
eRadioButton
, seguindo as mudanças mais recentes nos estilos de tipografia e nas alturas das linhas. (I2c0ba).
Versão 1.0.0-alpha19
6 de março de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha19
. A versão 1.0.0-alpha19 contém estas confirmações.
Mudanças na API
- Adicionamos
TimeText
à biblioteca Material3 do Compose para Wear. Esse componente mostra o horário atual (e outros status) na parte de cima da tela. A nova API Material3 concisa evita a duplicação entre conteúdo linear e curvo. (I4d7c3). - Renomeamos os nomes dos parâmetros de
onSelected
paraonSelect
emRadioButton
. (I1a971). - Tokenize
RadioButton
eSplitRadioButton
e refatorize os métodos existentes para reduzir a quantidade de pesquisaCompositionLocal
adicionando instâncias em cache de cores e tornando os métodos deRadioButtonColors
eSplitRadioButtonColors
internos. (I02b33).
Versão 1.0.0-alpha18
21 de fevereiro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha18
. A versão 1.0.0-alpha18 contém estas confirmações.
Mudanças na API
- Refatoramos o padrão padrão de
CardColors
,ToggleButtonColors
eSplitToggleButtonColors
criando instâncias em cache internamente e reduzindo o uso deCompositionLocal
. (If3fec).
Versão 1.0.0-alpha17
7 de fevereiro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha17
. A versão 1.0.0-alpha17 contém estas confirmações.
Mudanças na API
- Atualizamos a API Button para usar
buttonColors
por padrão e removemos ofilledButtonColors
duplicado. (I4fe3b). - Refatoramos os padrões padrão para
ButtonColors
,IconButtonColors
eTextButtonColors
criando uma instância em cache internamente e reduzindo o uso deCompositionLocal
. (I5f51c). - Removemos a sobrecarga de
rememberUpdatedState
em classes de cores específicas do componente e marcamos os métodos de acesso dentro de classes de cores como internos. (If6571).
Correções de bugs
- Atualizamos
Modifier.minimumInteractiveComponentSize
para usarModifier.node
. (Iba6b7).
Versão 1.0.0-alpha16
24 de janeiro de 2024
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha16
. A versão 1.0.0-alpha16 contém estas confirmações.
Novos recursos
- Adicionamos
CompactButton
, que pode usar as mesmas cores preenchidas, preenchidas tonal e contornadas que o botão.(I05df0)
Mudanças na API
- Adicionamos
RadioButton
/SplitRadioButton
como contêineres para controles de seleção, como o controle de rádio. Isso é diferente doToggleButton
atual, porque oRadioButton
é selecionável (e opera em um grupo de seleção), enquanto oToggleButton
é alternável (e é independente). (I61275). - Removemos
LocalContentAlpha
da biblioteca Material3 do Wear Compose para manter a consistência com a biblioteca Material3 do Compose. (I49a0a). - Os componentes do Material para Wear e do Material 3 para Wear que expõem um
MutableInteractionSource
na API foram atualizados para expor umMutableInteractionSource
anulável que é padrão null. Não há mudanças semânticas aqui: transmitir "null" significa que você não quer elevar oMutableInteractionSource
, e ele será criado dentro do componente, se necessário. A mudança para "null" permite que alguns componentes nunca aloquem umMutableInteractionSource
e permite que outros componentes criem uma instância de forma lenta apenas quando necessário, o que melhora o desempenho nesses componentes. Se você não estiver usando oMutableInteractionSource
que transmite para esses componentes, recomendamos transmitir "null". Também é recomendável fazer mudanças semelhantes nos seus componentes. (Ib90fc, b/298048146). - Adição de uma nova API de ondulação nas bibliotecas
wear:compose-material
ewear:compose-material3
, que substitui arememberRipple
descontinuada Também adiciona umCompositionLocal
temporário,LocalUseFallbackRippleImplementation
, para reverter os componentes do Material Design para o uso das APIsrememberRipple/RippleTheme
descontinuadas. Esse recurso será removido na próxima versão estável e tem como objetivo auxiliar temporariamente a migração de casos em que você fornece umRippleTheme
personalizado. Acesse developer.android.com para conferir informações sobre a migração e mais detalhes sobre essa mudança. (af92b21). - Fizemos pequenas melhorias na API
HorizontalPageIndicator
e na documentação dela. (I60efc). - Atualizamos
ColorScheme
para ser imutável, tornando as atualizações de cores individuais menos eficientes, mas tornando o uso mais comum de cores mais eficiente. O motivo dessa mudança é que a maioria dos apps não tem a atualização de cores individuais como um caso de uso principal. Isso ainda é possível, mas será recomposto mais do que antes. Por sua vez, reduzimos significativamente a quantidade de assinaturas de estado em todo o código do Material Design e afetamos o custo de inicialização e execução de casos de uso mais padrão. (Ibc2d6). - As APIs
ToggleButton
eSplitToggleButton
foram atualizadas para permitir a personalização de cores desativadas. Além disso, os tokens do Material Design agora são usados para valores de cor e tipografia. (If087c). - As cores de plano de fundo da imagem do botão foram atualizadas para usar tokens do Material Design. (Iba215).
- Mudamos os componentes
Checkbox
,Switch
eRadioButton
para serem apenas de exibição, removendo o processamento de cliques. Esses componentes devem ser usados em(Split)ToggleButton
, que processa o clique. Por isso, eles agora são indicados de forma mais clara como somente de exibição (e não são destinados ao uso independente no Wear). (I2322e).
Correções de bugs
- Adicionamos tokens para valores de movimento de durações e suavização no Wear Compose Material 3. (I437cd).
- Corrigimos um bug nos elementos
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
eRadioButton
para que os avisos de acessibilidade não sejam repetidos. Antes, os papéis semânticos eram duplicados. (Ica281). - Removemos a camada materialcore para
CompactButton
para melhorar o desempenho. (7902858).
Versão 1.0.0-alpha15
15 de novembro de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha15
. A versão 1.0.0-alpha15 contém estas confirmações.
Mudanças na API
- Renomeamos o nível de base
SwipeToDismissBox
comoBasicSwipeToDismissBox
. Isso torna a distinção mais clara entre o componente de nível de base e oSwipeToDismissBox
do nível do Material3. O segundo extrai cores doMaterialTheme
para serem usadas em telas de proteção e delega a implementação restante aoBasicSwipeToDismissBox
. (Ibecfc).
Correções de bugs
- Removemos a camada material-core do botão Material3 para melhorar o desempenho. (I55555).
Versão 1.0.0-alpha14
18 de outubro de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha14
. A versão 1.0.0-alpha14 contém estas confirmações.
Mudanças na API
- Removemos o parâmetro
indicatorStyle
doHorizontalPageIndicator
do Material3. Em vez disso, ele vai seguir a forma da tela do dispositivo (linear ou redonda). (I83728). - Separamos as cores de
SplitToggleButton
das cores deToggleButton
, adicionando uma nova classeSplitToggleButtonColors
. (I78bee).
Versão 1.0.0-alpha13
4 de outubro de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha13
. A versão 1.0.0-alpha13 contém estas confirmações.
Mudanças na API
- Adicionamos um campo de legenda opcional a
TitleCard
. (Ifc45a). - Adicionamos tokens de cor do Material Design para
TextButton
. (I769dc).
Versão 1.0.0-alpha12
20 de setembro de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha12
. A versão 1.0.0-alpha12 contém estas confirmações.
Mudanças na API
- Atualizamos
IconButton
para usar tokens do Material Design. (I3f137). - Atualizamos
IconToggleButton
para usar tokens do Material Design. (I7d263). - Os construtores de
CheckboxColors
,RadioButtonColors
eSwitchColors
foram disponibilizados publicamente. (I82b73).
Versão 1.0.0-alpha11
6 de setembro de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha11
. A versão 1.0.0-alpha11 contém estas confirmações.
Correções de bugs
- Atualizamos a tipografia dos cards do Material3 para
TitleMedium
. (I597bd). - Atualizamos a tipografia e o alinhamento do Material3
ListHeader
eListSubheader
. (Ib5ceb).
Versão 1.0.0-alpha10
23 de agosto de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha10
. A versão 1.0.0-alpha10 contém estas confirmações.
Novos recursos
- Adição de
HorizontalPageIndicator
na biblioteca Material3 do Wear. (Ifee99).
Mudanças na API
- O código de botões foi atualizado para usar os tokens de design do Material3. (I92fe4).
- As APIs Stepper e Slider do Wear Material 3 foram declaradas como experimentais, porque os detalhes da interface do usuário ainda estão sendo finalizados. (I84d54).
- Removemos os tamanhos
ExtraSmall
doTextButton
redondo e doTextToggleButton
, porque eles se aplicam apenas aoIconButton
. (Ibc7d5).
Correções de bugs
- Atualizamos as orientações sobre tipografia para TextToggleButton para usar LabelLarge para LargeButtonSize (Ib10fa).
- Atualizamos as orientações sobre tipografia para TextButton para usar LabelLarge para LargeButtonSize (I8f3a7).
- Definimos a área de toque mínima do card como 48 dp para acessibilidade. (Ieb9b1).
- Adição de uma demonstração de card de app com imagem e remoção da demonstração de card de app com plano de fundo (Id735f).
- Correção de um bug em botões redondos em que os modificadores não eram encadeados corretamente (I5e162).
Versão 1.0.0-alpha09
9 de agosto de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha09
. A versão 1.0.0-alpha09 contém estas confirmações.
Novos recursos
- O
ToggleButton
foi adicionado ao Material3 (I6bed6).
Mudanças na API
- Ativamos a anotação
FloatRange
como restrições de API , que foram mencionadas anteriormente nos comentários. (Icb401). - Atualizamos a tipografia do Material3 para Wear para obedecer às diretrizes mais recentes do Material3. (I1bad6).
Correções de bugs
- Atualizamos as cores de
Button
,IconButton
eTextButton
de acordo com o design do Material3. (Ib2495). - Corrigimos a visibilidade da marcação de caixa de seleção em estados desativados. (Ib25bf).
Versão 1.0.0-alpha08
26 de julho de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha08
. A versão 1.0.0-alpha08 contém estas confirmações.
Novos recursos
- Adicionamos os seguintes controles de seleção para o Material3:
Switch
,Checkbox
eRadioButton
. (Ib918c). - Adicionamos
IconToggleButton
eTextToggleButton
ao Material3, um botão de alternância circular com um único slot para ícone e texto, respectivamente. Para tamanhos diferentes deToggleButton
, recomendamos usarModifier.touchTargetAwareSize
com os tamanhos fornecidos nos botões de alternância. (I9f015). - Adicionamos
ListHeader
eListSubheader
aos nossos componentes do Material3. (Ibaefe). - Adicionamos o
SwipeToDismissBox
do Material3, que chama o novoSwipeToDismissBox
do Foundation e fornece valores de cor padrão do tema. (I275fb). - Adicionamos o
InlineSlider
do Material3 ao Wear Compose. Ele permite que os usuários escolham um valor em um intervalo. O intervalo é mostrado como uma barra entre os valores mínimo e máximo, em que os usuários podem selecionar um único valorInlineSlider
é ideal para ajustar configurações como volume ou brilho. (I7085f).
Mudanças na API
- Atualizamos as formas no tema do Wear Material 3 para usar
RoundedCornerShape
em vez de Shape. (Idb133). - As constantes de altura para o botão foram publicadas (Idbfde).
- Os arquivos da API foram atualizados para anotar a supressão de compatibilidade (I8e87a, b/287516207).
- Atualizamos o
InlineSliderColors
no Wear Compose Material 3 para ter um construtor público e propriedades públicas. (I6b632). - Atualizamos todas as classes de cores no Wear Compose Material 3 para ter construtores e propriedades públicos. (I17702).
- Tornamos públicas as constantes de padding horizontal e vertical do botão. (Ieeaf7).
Correções de bugs
- O botão agora ajusta a altura para acomodar conteúdo que cresceu devido a fontes grandes para acessibilidade, quando necessário (Iaf302).
- Atualizamos várias demonstrações de botões para resolver problemas de acessibilidade. (I61ce9).
Stepper
eInlineSlider
agora oferecem suporte a cliques repetidos em um toque longo para que você possa aumentar/diminuir rapidamente o valor deStepper
eInlineSlider
pressionando os botões + ou - (I27359).
Versão 1.0.0-alpha07
21 de junho de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha07
. A versão 1.0.0-alpha07 contém estas confirmações.
Novos recursos
- Adicionamos o componente
Stepper
à biblioteca Compose for Wear OS Material 3. Isso é semelhante à versão anterior do Material Design, mas omite a semântica de intervalo por padrão, seguindo o feedback dos desenvolvedores. FornecemosModifier.rangeSemantics
os casos em que a semântica de intervalo é necessária. (Ic39fd). - Adicionamos
curvedText
à biblioteca Compose for Wear OS Material 3. (Ia8ae3).
Correções de bugs
- Atualizamos
wear.compose.foundation
para ser uma dependência de API dewear.compose.material3
(I72004, b/285404743).
Versão 1.0.0-alpha06
7 de junho de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha06
. A versão 1.0.0-alpha06 contém estas confirmações.
Correções de bugs
- Atualizamos o
TextButton
para usar a função de extensãotoDisabledColor
para corrigir valores alfa desativados. (I814c8).
Versão 1.0.0-alpha05
24 de maio de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha05
. A versão 1.0.0-alpha05 contém estas confirmações.
Novos recursos
- Adicionamos
TextButton
ao Material3, um botão circular com um único slot para texto. Para diferentes tamanhos deTextButton
, recomendamos usarModifier.touchTargetAwareSize
eExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
eLargeButtonSizeIcon
fornecidos emTextButtonDefaults
. OTextButton
padrão não tem borda e um plano de fundo transparente para ações de baixa ênfase. Para ações que exigem alta ênfase, usefilledTextButtonColors
. Para uma ênfase média, useTextButton
com contorno e defina a borda comoButtonDefaults.outlinedButtonBorder
. Para um meio-termo entre o contorno e o preenchimento, usefilledTonalTextButtonColors
. (I667e4). - Adicionamos
Card
,OutlinedCard
,AppCard
eTitleCard
à biblioteca Wear Compose Material3.AppCard
eTitleCard
também podem ter a aparência de contorno usandoCardDefaults.outlinedCardColors
eCardDefaults.outlinedCardBorder
(I80e72).
Mudanças na API
- Movemos o parâmetro de rótulo do botão para o final para oferecer suporte à sintaxe de lambda final e removemos o parâmetro de função, que pode ser substituído usando
Modifier.semantics
. Os construtoresButtonColors
agora são públicos. (Ie1b6d).
Versão 1.0.0-alpha04
10 de maio de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha04
. A versão 1.0.0-alpha04 contém estas confirmações.
Novos recursos
- Adicionamos
IconButton
ao Material3, um botão circular com um único slot para ícone/imagem. Há quatro variações:IconButton
,FilledIconButton
,FilledTonalIconButton
eOutlinedIconButton
. Para diferentes tamanhos deIconButton
, recomendamos usarModifier.touchTargetAwareSize
eExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
eLargeButtonSizeIcon
fornecidos emIconButtonDefaults
. Também fornecemosIconButtonDefaults.iconSizeFor
para determinar o tamanho de ícone recomendado para um determinado tamanho de botão. (I721d4).
Versão 1.0.0-alpha03
19 de abril de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha03
. A versão 1.0.0-alpha03 contém estas confirmações.
Mudanças na API
- Adicionamos o componente Botão do Material 3, que é o botão em forma de estádio e antes se chamava "Chip" na biblioteca Wear Compose Material. Ele foi renomeado para "Botão" para manter a consistência com a biblioteca Compose Material 3. O botão padrão tem um plano de fundo preenchido e há variações de botão para
FilledTonal
(plano de fundo desativado), com contorno (transparente com uma borda fina) e filho (plano de fundo transparente e sem borda, usado para ações complementares com a menor quantidade de destaque). Botões redondos para conteúdo de texto e ícone simples serão lançados em uma versão futura.(Ia6942).
Versão 1.0.0-alpha02
5 de abril de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha02
. A versão 1.0.0-alpha02 contém estas confirmações.
Correções de bugs
- Adicionamos um
DefaultTextStyle
ao Wear Compose Material 3, que define oPlatformTextStyle.includeFontPadding
como verdadeiro (a configuração atual). Isso vai permitir que sincronizemos o desligamento do padding de fonte por padrão com as bibliotecas do Compose no futuro (consulte Corrigir o padding de fonte no Compose para segundo plano). (I7e461).
Versão 1.0.0-alpha01
22 de março de 2023
Lançamento de androidx.wear.compose:compose-material3:1.0.0-alpha01
. A versão 1.0.0-alpha01 contém estas confirmações.
Novos recursos
O Material 3 é a próxima evolução do Material Design e inclui temas atualizados e componentes redesenhados. O Material 3 no Wear Compose foi projetado para ser coeso com a biblioteca Material 3 Compose no Android. Esta primeira versão alfa contém implementações práticas e funcionais do seguinte:
Vamos continuar desenvolvendo o Material Design para Wear (
androidx.wear.compose:compose-material
) e o Material Design 3 para Wear (androidx.wear.compose:compose-material3
) em paralelo. As versões futuras do Material3 vão ampliar o conjunto de widgets para incluir outros componentes conhecidos do Compose para Wear OS, como botões, seletores e controles deslizantes.As bibliotecas Wear Material e Wear Material 3 são mutuamente exclusivas e não podem ser misturadas no mesmo app, principalmente porque fazem referência a temas diferentes, o que levaria a inconsistências inesperadas.