Wear Compose Material 3
Atualização mais recente | Versão estável | Versão candidata a lançamento | Versão Beta | Versão Alfa |
---|---|---|---|---|
13 de agosto de 2025 | - | 1.5.0-rc02 | - | - |
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-rc02" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-rc02" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-rc02" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02") // 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-rc02") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-rc02") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-rc02") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02") // 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-rc02
13 de agosto de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-rc02
. A versão 1.5.0-rc02 contém estas confirmações.
Correções de bugs
- Correção de um bug em
TimePicker
em que strings longas e internacionalizadas para o período (AM/PM) podiam quebrar o layout. (I0fa81).
Versão 1.5.0-rc01
30 de julho de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-rc01
. A versão 1.5.0-rc01 contém estas confirmações.
Correções de bugs
- O
TimePicker
agora é totalmente controlado pela localidade do usuário, usandoDateFormat.getBestDateTimePattern
para determinar a ordem e o conteúdo dos seletores e separadores. Isso corrige a ordenação incorreta de colunas para idiomas CJK, resolve problemas de layout da direita para a esquerda em idiomas como o árabe, usa separadores localizados e oferece suporte aos formatos de 0 a 11 e de 1 a 12 horas com base na localidade (I5d543). DatePicker
agora mostra um mês numérico em algumas localidades, como CJK, para evitar a mistura de formatos numéricos e linguísticos (por exemplo, 2025 | 07 | 02 em vez de 2025 | 7月 | 02). Essa mudança aplica uma heurística que verifica se a localidade usa sufixos linguísticos para o ano e, em caso afirmativo, muda o formato do mês de textual (MMM) para numérico (MM) para consistência. (Ia93fe)- O espaço vertical para o cabeçalho no componente Picker agora é constante, evitando uma mudança visível quando uma coluna do seletor é selecionada, especialmente no modo
Talkback
. (I7f8b7) - Correção de um bug de acessibilidade causado pela exibição de
HorizontalPageIndicator
eVerticalPageIndicator
em tela cheia. Os indicadores de página não são mais de tela cheia e são posicionados automaticamente quando usados comHorizontalPagerScaffold
ouVerticalPagerScaffold
. Quando não estiver usando um scaffold de pager, especifique o alinhamento explicitamente usandomodifier = Modifier.align(Alignment.BottomCenter)
comHorizontalPageIndicator
emodifier =Modifier.align(Alignment.CenterEnd)
comVerticalPageIndicator
. (I3a0ad). - A direção do gesto de deslizar em
SwipeToReveal
agora é consistente paraLayoutDirections
LTR e RTL. (I6d427). - O alinhamento vertical
SwipeToReveal
foi restabelecido para ações. SehasPartiallyRevealedState = true
,RevealState
será redefinido paraRevealValue.Covered
pelo caller quando a rolagem ocorrer. (I6473d). - O
SwipeDismissableNavHost
agora corta corretamente o conteúdo para a API 36 em diante. (Ib9a44).
Versão 1.5.0-beta06
16 de julho de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta06
. A versão 1.5.0-beta06 contém estas confirmações.
Correções de bugs
- Correção da animação
EdgeButton
quandoLazyColumn
ouScalingLazyColumn
têmreverseLayout = true
. (I46a1a). - Correção de um bug no
ScreenScaffold
em que o recurso "Tocar para explorar" não funcionava no Talkback se umScrollIndicator/PageIndicator
fosse fornecido. (I6dcee) - Agora, o
TransformingLazyColumn
permite a transformação personalizada doTransformationSpec
lendo o valoritemHeight
fornecido peloTransformationSpec
no pintor de segundo plano. (I6a599). - Transições de cores animadas ativadas/desativadas para
IconButton
, para manter a consistência comIconToggleButton
. (Ife10a). - Removemos o ajuste mínimo da seção em
CircularProgressIndicator
para evitar um salto perceptível para o tamanho mínimo do ponto durante a animação. Como parte dessa mudança, o parâmetrotargetProgress
emdrawCircularProgressIndicator
não é mais usado. (I33309). - O seletor agora tem a função semântica
ValuePicker
, que pode ser usada por leitores de tela para tornar os seletores mais acessíveis. O seletor também tem rótulos de clique de acessibilidade atualizados que diferenciam o ajuste do valor no modo somente leitura e a seleção do valor atual. (I33309).
Versão 1.5.0-beta05
2 de julho de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta05
. A versão 1.5.0-beta05 contém estas confirmações.
Correções de bugs
- Atualização da documentação para esclarecer o uso de
Modifier.edgeSwipeToDismiss
(I78cb5). - Correção de um bug em que vários itens revelados podiam ser mostrados com
SwipeToReveal
em listas lentas (I1d4f6) - As formas de contêiner em
TransformingLazyColumn
agora são dimensionadas para evitar o corte do conteúdo. (I9221a) - Os rótulos
TimePicker
eDatePicker
para hora/minuto/segundo ou ano/mês/dia agora têm semântica de cabeçalho para leitores de tela (I77d8b). - Remoção da pausa entre loops no
CircularProgressIndicator
indeterminado (Iaf0bb) - Correção de um bug de animação em
TransformingLazyColumn
quando os itens são removidos. (I73034) - Correção do processamento de itens de âncora em
TransformingLazyColumn
quando itens são removidos. (I841a8). - Agora,
PickerGroup
anima os seletores horizontalmente quando a centralização automática está ativada e o seletor selecionado (centralizado) é alterado. (Ic82c4).
Versão 1.5.0-beta04
18 de junho de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0-beta04
. A versão 1.5.0-beta04 contém estas confirmações.
Correções de bugs
- Correção de um bug de layout em
TransformingLazyColumn
, em que o conteúdo que cabe na tela agora é alinhado corretamente na parte de cima dela (I80115) - Correção de um problema com
TransformingLazyColumn
em que o item da parte de baixo era dimensionado incorretamente ao rolar até a parte de baixo de uma lista com umEdgeButton
. O progresso da rolagem agora segue um gradiente descendente ao restaurar o layout. (Iea375) - O
TransformingLazyColumn
agora lê a altura do item no painter de segundo plano, o que permite queTransformationSpecs
personalizado implemente a transformação. (I022f0). SwipeToReveal
agora centraliza verticalmente as ações reveladas corretamente. (I4419b).- Corrigimos um bug no
SwipeToReveal
que impedia o funcionamento correto com o gesto de deslizar para dispensar se as visualizações e o Compose estivessem em uso na tela. (I5dc0e) - Correção de um bug em que as ações
SwipeToReveal
eram desenhadas com um deslocamento vertical ao rolar a tela. (I29444) AlertDialog
,ConfirmationDialog
,OpenOnPhoneDialog
eSwipeToReveal
agora arredondam paddings e tamanhos calculados como uma porcentagem do tamanho da tela. (I76367).- O
ButtonDefaults.outlinedButtonBorder
agora atualiza o tamanho seguindo as mudanças de estado ativado/desativado(If2ddd). - Correção de um bug na altura do
EdgeButton
que ocorria em telas complexas com Pager eScreenScaffold
. (I946e3). - Correção de uma disputa que poderia fazer com que as animações de marcador de posição parassem. (I53530).
- Melhoria na performance de
HorizontalPageIndicator
eVerticalPageIndicator
ao desenhar no Canvas. (Ifae1e). - Refinamos o formato do EdgeButton para suavizar as transições entre as reticências e os círculos que compõem o contorno. (I7721e).
- Correção de um bug no
LevelIndicator
que fazia as animações pararem devido a recomposições desnecessárias. (I45d08).
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 ignora a semântica do ícone. AsOpenOnPhoneDialogDefaults
foram atualizadas para remover oiconContentDescription
e o parâmetrocontentDescription
deicon()
. Além disso, oConfirmationDialogDefaults
agora tem parâmetros de modificador nos elementos combináveisSuccessIcon
eFailureIcon
. (Id2ae2).
Correções de bugs
- Mudança na ordem em que aplicamos o efeito dos parâmetros
SurfaceTransformation
. Antes, as transformações aplicadas aos componentes do Wear Material3 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 estão invertidos, e aplicamos qualquer modificador transmitido entre eles. Assim, ele é afetado pelas transformações de 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 Saver por padrão. (Ie0ecb)- Os botões de ações primárias e secundárias
SwipeToReveal
agora usamButtonDefault.Height
por padrão. Corrigimos um bug em que eles preenchiam a altura máxima de botões mais altos. (Ibfba1). - Mudança em
SwipeToReveal
para redefinir o último componente com que se interagiu quando o gesto de deslizar para a direita é realizado. (Ia8450). SwipeToReveal
foi alterado para ficar no estadoRevealing
quando a posição final do gesto de deslizar estiver entre os fixadores de revelação e revelado e mais próxima do fixador de revelação. (If4458).- Agora, o conteúdo de
ButtonGroup
é invertido corretamente em um layout RTL (Ib378d). - O
AnimatedText
agora é compatível com a direção de texto RTL (I4533c). - Agora, o
TransformingLazyColumn
redimensiona os itens corretamente quando o item da parte de baixo é removido. Idacab - Agora, o
TransformingLazyColumn
faz apenas uma passagem de medição, o que melhora a performance 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
- Perfis de referência atualizados para 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. (I49d00). - O
OpenOnPhoneDialog
no TalkBack precisa anunciar o texto curvo, e não a descrição do conteúdo do ícone. (I4efe8). - Correção de um bug no
SwipeToReveal
que informava a âncora errada emRevealState.currentValue
quandohasPartiallyRevealedState
era definido como "false". (I9c7cf). - Os botões de desfazer
SwipeToReveal
agora sãoButtonDefaults.Height
por padrão. (I1f6c8). - O desempenho do
BasicSwipeToDismissBox
foi melhorado com a eliminação do uso do Canvas para desenhar scrims. (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 com a otimização do 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 é compatível com o novo sistema de design de interface chamado Material 3 Expressive. Recomendamos fazer upgrade do Material para o Material3 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, trazendo profundidade e variedade aos seus designs.- Temas de cores dinâmicos que geram automaticamente um esquema de cores para seu app de acordo com as cores do mostrador do relógio.
- Os novos componentes se adaptam automaticamente a tamanhos de tela maiores por padrão
- Transformação de forma: componentes de botões 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 se ajusta à borda com um formato especial projetado para a parte de baixo da tela.- Scaffolds: introdução de
AppScaffold
eScreenScaffold
para definir o layout da estrutura da tela e coordenar as 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 botões de alternância são necessários, enquantoRadioButton
é o botão de seleção disponível. Também são fornecidas variações de "Dividir" dos botões de alternância e seleção. ButtonGroup
: implementa um grupo expressivo de botões em uma linha que mudam de forma quando tocados.- As variações de
AlertDialog
são compatíveis com botões de confirmação/cancelamento ou umEdgeButton
. ConfirmationDialog
está disponível para mostrar uma mensagem com um tempo limite, oferecendo suporte a animações especiais para variações de sucesso, falha e abrir 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 seleção. ProgressIndicators
: indicadores de progresso circulares e lineares são compatíveis (oCircularProgressIndicator
tem variações segmentadas e indeterminadas).- Cards: várias variações estão disponíveis, incluindo
TitleCard
, que oferece layouts específicos para cards com slots de título, hora, subtítulo ou conteúdo. OTitleCard
também pode receber uma imagem de plano de fundo para reforçar o significado das informações em um card. - Paginação: os componentes
HorizontalPagerScaffold
,VerticalPagerScaffold
eAnimatedPage
coordenam as animaçõesHorizontalPageIndicator
eVerticalPagerIndicator
.HorizontalPager
eVerticalPager
são lançados na biblioteca Wear Compose Foundation. - Marcadores de posição: desenham uma forma de esqueleto sobre um componente para situações em que nenhum conteúdo provisório está disponível.
- Controles deslizantes e steppers: ambos 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 inteira geralmente pareado com 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 focais hierárquicos: usados para anotar elementos combináveis em um aplicativo, acompanhar a parte ativa da composição e coordenar o foco.
- Paginação: componentes
HorizontalPager
eVerticalPager
, criados com base nos componentes do Compose Foundation e melhorias específicas do Wear para melhorar a performance e a conformidade com as diretrizes do Wear OS.
Mudanças na API
- Atualização da 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). - Descontinuamos
SwipeToReveal
da Wear Compose Foundation em favor das APIsSwipeToReveal
no Wear Compose Material e no Wear Compose Material3. Substitua as importações do Wear FoundationSwipeToReveal
pelas importações do Wear Compose Material/ Wear Compose Material3 para continuar usando as APIs. (Ia147d). - As dependências do Wear Compose Material3
SwipeToReveal
no 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). - Atualizamos a API
SwipeToReveal
do Wear Compose Material3 da seguinte maneira: adicionamos os parâmetrosprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
ehasPartiallyRevealedState
ao elemento combinávelSwipeToReveal
; removemos a capacidade de personalizarpositionalThreshold
eanimationSpec
deRevealState
; removemoslastActionType
,revealThreshold
e a largura deRevealState
; mudamos o construtorRevealState
para aceitar umRevealDirection
em vez de âncoras; removemos as funçõescreateRevealAnchors
, âncoras ebidirectionalAnchors
; as funçõesSwipeToRevealScope
primaryAction
,secondaryAction
,undoPrimaryAction
eundoSecondaryAction
foram renomeadas comoPrimaryActionButton
,SecondaryActionButton
,UndoActionButton
e transformadas em funções combináveis; marcamosRevealActionType
como interno. (I885d0). - Atualizamos ainda mais a API
SwipeToReveal
da seguinte maneira: renomeamosonFullSwipe
paraonSwipePrimaryAction
eSwipeToRevealNonAnchoredSample
para indicar o uso do parâmetrohasPartiallyRevealedState
. RemovemosactionButtonHeight
, já que o padrão é a altura padrão do botão, e a altura maior pode ser definida usando um modificador. RemovemosSmallActionButtonHeight
deSwipeToRevealDefaults
e tornamos o parâmetro de valor nos construtoresRevealValue
eRevealDirection
particular. (I465ce).
Correções de bugs
- Corrigimos o 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).
- Atualizamos o movimento do
CircularProgressIndicator
indeterminado para que ele não regrida mais temporariamente. (Ieddb1). - Correção de um bug de
SwipeDismissableNavHost
: o foco não mudava corretamente após deslizar para trás, fazendo com que a entrada rotativa falhasse (isso era para a API 36 ou mais recente, que usa o retorno preditivo). (Ieddb1). - Documentação revisada da API Hierarchical Focus (Idf2ff).
- Atualizamos a documentação de "Button" e "Card" para explicar como
containerPainter
edisabledContainerPainter
substituemcontainerColor
edisabledContainerColor
(I4a453). - Foi revertida uma mudança em
TimeText
na versão anterior, que moveu oBroadcastReceiver
para uma linha de execução de trabalho, porque isso causava problemas em apps que gerenciam a própria execução de linhas durante a navegação. (I34d02). - Atualizamos os exemplos do seletor para remover chamadas de memorização desnecessárias e usar
rememberUpdatedState
no seletor para lembrar a função lambdacontentDescription
mais recente. (Icb5b1). - Atualizamos os estilos de texto em
TimePicker
eDatePicker
para que as mudanças de fonte não resultem mais em truncamento. (I26194). - Por padrão,
ListHeader
eListSubHeader
agora alinham o texto ao centro e ao início, respectivamente. (I78339). - Atualizamos as amostras e demonstrações do Foundation e do Material Swipe to Reveal para anunciar ações de acessibilidade personalizadas. As ações personalizadas precisam ser adicionadas como semântica no conteúdo, não no próprio elemento combinável
SwipeToReveal
. (Ie92a3). - Atualizamos o conjunto
MaxLines
padrão no conteúdoEdgeButton
de acordo com o tamanho. Agora é 1 para extrapequeno, 2 para pequeno e médio e 3 para grande. (Ie35f6). LocalReduceMotion
simplificado para que o observador seja registrado apenas uma vez, melhorando a performance. (Ib1979).- Minimizamos o número de redimensionamentos em
ScrollIndicator
para melhorar a performance. (Ia7a67). - Correção de um bug no
TransformingLazyColumn
, em que o item visível na parte de cima da 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
- Remoção de
scrollTransform
da plataforma da API pública. Use a combinação dos modificadorestransformedHeight
egraphicsLayer
se precisar da mesma funcionalidade. (Ie181d). - Substituímos os elementos combináveis
ImageButton
eImageCard
pelas 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 tremia 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 impede a atualização do layout do botão de borda quando a altura é NaN. (I32b93).
- Aumentamos o ângulo máximo de varredura em
OpenOnPhoneDialog
para que o texto padrão "Verifique seu smartphone" não seja cortado com o maior tamanho de fonte. (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 Card. Os pintores são removidos deButtonColors
eCardColors
. (I8c6a1)- Atualizamos os marcadores de posição 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 do overscroll ao
ScrollIndicator
. (Icfb7f). - Corrigimos fundos 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 ocupa 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 os espaçamentos entre letras emArcLarge
eArcSmall
foram atualizados.ConfirmationDialog
/OpenOnPhoneDialog
agora usam oArcLarge
padrão em vez de substituir por18sp
. (Id39a8).
Atualizações de dependência
- Essa biblioteca agora é destinada ao nível de linguagem Kotlin 2.0 e exige o 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 aproveita melhor o tamanho da tela disponível. (Ief06c) PagerScaffoldDefaults.FadeOutAnimation
foi renomeado comoPagerScaffoldDefaults.FadeOutAnimationSpec
O parâmetro "page" emAnimatedPage
foi renomeado comopageIndex
. (I701f2).- Atualizamos a nomenclatura da divisão
SurfaceTransformation
-applyTransformation
doTransformingLazyColumn
emapplyContainerTransformation
eapplyContentTransformation
, e renomeamoscreateBackgroundPainter
paracreateContainerPainter
. Mais atualizações de nomenclatura paraTransformationSpec
eResponsiveTransformationSpec
. (I1c534). - O
AppScaffold backgroundColor
foi renomeado comocontainerColor
. (I4e63f).
Correções de bugs
- Correção de um problema no
FadingExpandingLabel
em que o texto nem sempre era expandido corretamente. (I0e773). ArcLarge
foi reduzido de 20sp para 18sp, e os espaçamentos entre letras emArcLarge
eArcSmall
foram atualizados. Agora,ConfirmationDialog/OpenOnPhoneDialog
usa oArcLarge
padrão em vez de substituir por 18sp. (Id39a8).- Atualizamos a animação de cabeçalho para
DatePicker
eTimePicker
com base nisso, para que a animação de fade-out e fade-in funcione como uma animação de mola. (I68963). - Otimizamos
PagerScaffold
evitando a leitura decurrentPageOffsetFraction
no elemento combinávelAnimatedPage
. (I433ef). - Todas as escalas tipográficas foram atualizadas para ter numerais proporcionais por padrão, porque esse é considerado o caso de uso mais frequente, e o padrão tabular resultava em muito espaçamento entre determinados pares de números.
TimePicker
eDatePicker
continuam aplicandoFontFeatureSetting=tnum
para números tabulares. (I88929). - Corrigimos o foco inicial de entrada do RSB para
TimePicker
eDatePicker
. (I1c773). - O texto padrão em
OpenOnPhoneDialog
foi atualizado para "Confira seu smartphone". (I00a3f). - Atualizamos as ponderações de
ArcLarge
eArcMedium
de 600 para 599 para contornar um problema em que a ponderação 600 é tratada como negrito (I2a51d). - Atualize os 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
. As APIsAnimatedPage
esnapWithSpringFlingBehaviour
agora são públicas e podem ser usadas com aPager
do Wear Foundation para alcançar o comportamento anterior doPagerScaffold
do M3. Confira exemplos atualizados. (Ia4724). - Atualização de
PagerState
, removendo oPagerState
do Compose Foundation como classe base e adicionando 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 maneira de desativar a semântica curva.CurvedText
continua definindo a descrição do conteúdo como texto, mastimeTextCurvedText
etimeTextSeparator
não anunciam mais o conteúdo. (I4b568) - Adição de parâmetros de cor de conteúdo padrão e plano de fundo a
AppScaffold
. (I56652). - O processamento padrão de gestos de deslizar do
HorizontalPager
foi renomeado comoPagerDefaults.gestureInclusion
. O comportamento padrão agora é ignorar apenas gestos de deslizar que começam na borda esquerda da primeira página e somente quando o Talkback está desativado. Em outros casos, o comportamento padrão é que os gestos de deslizar não sejam ignorados pelo pager, portanto, não estarão disponíveis para manipuladores de deslizar para dispensar. (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 nossa API Wear Compose Material3 para "public val", evitando que os valores sejam inlined. (Ib0f32).
- Adição de suporte para uma zona de deslizar na borda em
SwipeToReveal
. O comportamento padrão do FoundationSwipeToReveal
agora é não permitir deslizar quando o gesto começa na borda. O comportamento padrão doSwipeToReveal’
do Material3 agora é não permitir deslizar quando o gesto começa na borda e oSwipeDirection
está definido como uma única direção. (I32ef0). - Adição do elemento combinável
FadingExpandingLabel
, que permite o aparecimento gradual do texto com animação linha por linha. (Ic60fa). - O
TransformingLazyColumn
agora usacontentPadding
vazio por padrão em vez de colocar o primeiro e o último item no centro. (I77ab7). - Removemos o
rememberRevealState
doSwipeToReveal
da biblioteca Wear Compose Material3. (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 para iniciantes 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, porque usarOnBackground
(branco) diretamente tinha muito peso visual quando competia com outros conteúdos na tela, como títulos. (I8b36f). - Reduzimos o tempo limite para animar
TimeText
eScrollIndicator
em componentes de estrutura 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 da demonstração do M3
SwipeToReveal
usando o modificadoredgeSwipeToDismiss
. (I02b07). - Adicionamos um título a
DatePicker
eTimePicker
no TalkBack para informar ao usuário que é preciso rolar a tela para definir data/hora. (Id738d). - O
AnimatedText
agora segue a configuração de redução de movimento. (Ib6578). - A otimização para usar
AppScaffold
e mostrar o conteúdo da caixa de diálogo foi melhorada para permitir que várias caixas de diálogo sejam mostradas umas sobre as outras (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 de
SwipeToRevealScope
'sprimaryAction
esecondaryAction
. A semântica de ações personalizadas precisa ser adicionada diretamente ao conteúdo do componenteSwipeToReveal
pelo desenvolvedor. (Ia67f3). - Removemos os prefixos "Button" de tamanhos, estilos de texto e funções de cor em
IconToggleButtonDefaults
eTextToggleButtonDefaults
(I5471d). - Removemos o
LocalMinimumInteractiveComponentEnforcement
experimental (I4ad8a). - Substituímos a DSL
PickerGroupScope
por um elemento combinável. Por isso, removemos o métodopickerGroupItem
dePickerGroupScope
e adicionamos@Composable PickerGroupItem
, que deve ser usado para adicionar um seletor aPickerGroup
. Também atualizamos o tipo do parâmetroPickerGroup
"content" para@Composable PickerGroupScope.() -> Unit
. (Ic6aec) - Adicionamos uma sobrecarga
LevelIndicator
para valores fracionários e um prefixo Stepper às sobrecargas que incluem um parâmetro de intervalo (adequado para uso com o componente Stepper). (If4234). - Adicionamos o
TransformationSpec
doTransformingLazyColumn
à API, o que permite definir as transformações exatas que acontecem com os itens à medida que eles são rolados na 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
pararevealDirection
emrememberRevealState
. (I7472f). - O Wear Pager 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). - Removemos o elemento combinável
CircularProgressIndicatorStatic
e adicionamos uma função públicaDrawScope
drawCircularProgressIndicator
com a mesma funcionalidade. UseCircularProgressIndicator
diretamente para que as mudanças sejam animadas por padrão, mas crie seu próprio elemento combinável usandodrawCircularProgressIndicator
se precisar de 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). - Renomeamos
openOnPhoneCurvedText
comoopenOnPhoneDialogCurvedText
(I65bdd). - Adicionamos
ScrollIndicatorColors
para fornecer cores personalizadas aScrollIndicator
. (I9eb8c) - Permite a configuração da cor usada para desenhar um plano de fundo atrás de
TimeText
. (I9f5d9). - Atualizamos as tipografias
ArcLarge
,ArcMedium
eArcSmall
para seremCurvedTextStyle
(Iffc41). - Removemos
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
. (Ia923e). - Adicionamos
errorDim
aoColorScheme
para erros de alta prioridade ou ações de emergência, como alertas de segurança, sobreposições de caixa de diálogo com falha ou botões de parada. (I70998).
Correções de bugs
- Fixamos o
wear.compose.material3
na versão 1.15.0 doandroidx.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 do
EdgeButton
. (I1a5bb). - Adicionamos semântica de botão 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
- No
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 abrem a partir da linha de base, enquanto as letras no sentido anti-horário se abrem para dentro. Por isso, é necessário um espaçamento maior entre letras. (I4b848) - Atualizamos
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
eTextToggleButtonShapes
para melhorar a consistência entre as bibliotecas do Material3. Essa mudança também introduz o cache de formas para reduzir o número de alocações. (I049fc). - Removemos o parâmetro
pressedShapeCornerSizeFraction
do métodovariantAnimatedShape
emIconToggleButton
eTextToggleButton
(I58a65). - Estamos lançando 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
doButtonGroup
, 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 fazer mutações nele. 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). - Renomeamos o parâmetro
spacing
emPicker
ePickerGroup
comoverticalSpacing
(Ib75cc) - Removemos
ConfirmationDialogDefaults.successText
efailureText
porque esperamos que os chamadores deConfirmationDialog
forneçam strings com mais contexto. Também renomeamosconfirmationCurvedText
paraconfirmationDialogCurvedText
. Por fim, renomeamos o parâmetroshow
da caixa de diálogo para "visible" (visível) para manter a consistência com outras atualizações recentes nas caixas de diálogo. (I10074). IconButton
renomeoudisabledImageOpacity
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 tipográfica "Título grande" para ter o tamanho da fonte
18dp
(Ic9d52). - Atualizamos o espaçamento e o tamanho do ícone do
AlertDialog
(Iac28c). - Corrigimos inconsistências em pontos de interrupção de telas grandes (telas com 225 dp ou mais são consideradas grandes) (I36474).
- Correção de um bug pequeno no posicionamento 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 Wear Compose para o modo "API explícita". (Iebf9f)
- Atualizamos as APIs
ScreenScaffold
eEdgeButton
para facilitar a especificação de padding 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 entre oEdgeButton
e o conteúdo da lista. (I424fd) - Em
DatePicker
, renomeamos os parâmetrosminDate
paramaxDate
eminValidDate
paramaxValidDate
. EmDatePickerColors
, renomeamos o parâmetroselectedPickerContentColor
paraactivePickerContentColor
eunselectedPickerContentColor
parainactivePickerContentColor
(Iba17b). - Atualizamos os padrões de
ArcProgressIndicator
parastrokeWidth=6dp
e recomendamosdiameter = 81.24%
da 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 à nomenclatura 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 da caixa de diálogo de introdução/encerramento. (Iaeb33). - Atualizamos
CircularProgressIndicatorContent
paraCircularProgressIndicatorStatic
(a variação não animada deCircularProgressIndicator
) para que agora possa ser usado na criação deCircularProgressIndicator
com animações personalizadas. (I1346f) - Corrigimos a ordem dos parâmetros na
ArcProgressIndicator
, colocando o parâmetro de modificador primeiro (I4656a). - Melhoramos a API
SwipeToReveal
para receber um parâmetro de slot de texto para os rótulos das ações (exceto a ação secundária) e remover parâmetros de rótulo da ação de desfazer (I5b3db).
Correções de bugs
- Corrigimos um bug em que a resposta tátil
LongPress
era acionada mais de uma vez emButton
,Card
,IconButton
,TextButton
(Ia8b0f). - Mudanças na UX de
AlertDialog
: em telas grandes, os botões de confirmação e dispensa agora são menores. Também há um espaçamento maior abaixo dos botões "Confirmar" e "Dispensar". (I4f066). - Mudamos as especificações de animação do rótulo do botão de ação do componente
SwipeToReveal
. (Ib87fb). - Mudança em
SwipeToReveal
para expandir o contêiner ao mesmo tempo em que o texto é exibido. (I44cf8). - Melhoria no
SwipeToReveal
para realizar feedback tátil quando o gesto de deslizar passa do limite em que a ação principal é confirmada. (I23efe). - Atualizamos
SwipeToReveal
para mostrar reticências no estouro de texto por padrão, para ações principais e de desfazer. (I71f5a). - Corrigimos um problema que causava instabilidade nas animações
ButtonGroup
. (I63f8f). - Adicionamos semântica de texto a
AnimatedText
(I6063c). - Agora, a caixa de diálogo redefine o escalonamento em segundo plano quando é removida da composição. Sem essa correção, a tela de inicialização poderia ter ficado 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 refatorado, 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 ficam visíveis no
DatePicker
, com um novoinvalidPickerContentColor
, ao usarminDate
oumaxDate
. (If4541). - Atualizamos a API
Stepper
para fornecer slotsincreaseIcon
edecreaseIcon
. O conteúdo deles pode ser criado como de costume no elemento combinável ícone. (Id35da). - Atualizamos
dynamicColorScheme
removendo o parâmetro opcionaldefaultColorScheme
e agora retornandoColorScheme
anulável. Isso significa que o caller 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
ajuste o conteúdo em vez de preencher a largura máxima. Os exemplos foram atualizados para mostrar isso. (I0582c). - Adicionamos
EdgeButtonDefaults
com tamanhos de ícones recomendados para os quatroEdgeButtonSizes
diferentes. Além disso, atualizamos o layoutEdgeButton
para que ele tenha um padding inferior um pouco maior do que o padding superior, o que melhora a aparência do conteúdo de ícone e texto. (Id772a) - Adicionamos movimento ao
LinearProgressIndicator
e expusemos oLinearProgressIndicatorContent
, 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) - O
TransformingLazyColumn
agora fornece o local de composiçãoLocalTransformingLazyColumnItemScope
, queCard
s,Button
s eListHeader
s agora usam para transformação automática quando colocados dentro de umTransformingLazyColumn
. Os autores das 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 no plano de fundo do
TimeText
(I1eb60). - Definimos
TextMotion
comoAnimated
por padrão na nossa tipografia para evitar instabilidade no texto devido ao ajuste de glifos de letras aos limites de pixels durante 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 ou mover itens. (I6830f). - Corrigimos um problema de animação do botão redondo para toques rápidos. Antes, a duração mínima da animação nem sempre era respeitada. (I757a7).
- Atualizamos o ângulo de varredura para
LevelIndicator
em 20% (ou seja, 72 graus). (Idde5c). - Corrigimos o posicionamento de
ScrollIndicator
quandoScalingLazyColumn
era usado comAutoCenteringParams
. (I387dd) - Atualizamos as cores e a tipografia de
ListHeader
eListSubHeader
. Além das 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
OpenOnPhoneDialog
usando o novoCircularProgressIndicatorContent
. (I3e443). - Atualizamos
HorizontalPagerScaffold
eVerticalPagerScaffold
para desativar animações quando a opção "Reduzir movimento" está ativada (Iaaf68). - Implementamos uma animação separada para indicadores de progresso circular quando o progresso atinge mais de 100%. (I47135)
- Corrigimos um bug em que
EdgeButton
podia ser desenhado com uma forma incorreta em componentes do 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 o
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 é queTimeText
permaneça no lugar para paginação horizontal e vertical. (I71767). - O
LocalHapticFeedback
agora fornece uma implementaçãoHapticFeedback
padrão quando a API Vibrator indica que a resposta tátil é compatível. Os seguintes itens foram adicionados aoHapticFeedbackType
:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Os componentes de clique longo do Wear Compose, comoButton
,IconButton
,TextButton
eCard
, agora realizam o feedback hápticoLONG_PRESS
quando um manipulador de clique longo é fornecido. (I5083d).
Correções de bugs
- Atualizamos a moção para confirmações. (I04bff).
- Atualizamos a dependência mínima da API para 1.7.4 nas bibliotecas do Compose. (I88b46)
- Foi adicionada uma nova animação para a caixa de diálogo
OpenOnPhone
. (I1e10a) - Corrigimos um bug no
LevelIndicator
para que ele seja mostrado corretamente quando o nível é zero. (Ie95a4). - Atualizamos as animações
HorizontalPageIndicator
eVerticalPageIndicator
. (I5c8f3). - Adicionamos uma animação de redução a um 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 ao indicador de progresso circular indeterminado (I2efc1).
- Tornamos públicos os elementos combináveis
AlertDialogContent
eDialog
que compõem a APIAlertDialog
. Assim, é possível adicionar personalização, se necessário, como personalizar a animaçãoAlertDialog
e manter 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ública para interna e renomeamos paraplaceholderShimmerProgression
; adicionamos constantes de duração da animação de marcador de posição aPlaceholderDefaults
. (Ie5a59). - Atualizamos a API
EdgeButton
da seguinte forma: 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 Material 3 para Wear (I0287f).
Correções de bugs
- Adicionada duração mínima da animação para
IconToggleButton
eTextToggleButton
ao clicar (Ieb333). - Adicionada duração mínima à animação de forma
IconButton
eTextButton
(Iebcee) - Corrigimos o 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 mudança de nome do Wear Compose FoundationLazyColumn
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 ao público paraListHeader
eListSubHeader
. (I96730) - Adicionamos novos componentes
HorizontalPagerScaffold
eVerticalPagerScaffold
para o Wear, que oferecem novas animações e coordenação entre o texto de hora e os componentes indicadores de página. (Iff7d0). - Adicionamos suporte a seletor giratório ao
HorizontalPagerScaffold
e aoVerticalPagerScaffold
, permitindo que os usuários naveguem pelos paginadores 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 "remember" inlinadas foram removidas, e os esquemas de movimento integrados foram movidos para um objeto complementar MotionScheme dedicado. RenomeamosstandardMotionScheme
eexpressiveMotionScheme
para "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 os paddings dos componentes de card. (I3ae48).
- Mudamos o padding em
AlertDialog
entre os botões "Confirmar"/"Dispensar" 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 para o 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 permite 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 Wear Material 3 (Ic38b2). - Adicionamos suporte a deslizar bidirecional no
SwipeToReveal
para casos raros em que a tela atual não é compatível com o gesto de deslizar para dispensar. O padrão ainda é deslizar para revelar apenas em gestos da direita para a esquerda. É 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
comoOpenOnPhoneDialogDefaults.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 (sendo tokens) eram particulares para 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 estamos usando í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 ao estouro de progresso (>100% de progresso) para
CircularProgressIndicator
eSegmentedCircularProgressIndicator
. Quando o progresso exceder 1,0, isso será indicado pela nova coroverflowTrack
. (Iaaa3d) - Os
IconToggleButton
eTextToggleButton
redondos agora oferecem suporte a uma nova variação de animação de forma, em que diferentes formas representam estados marcados, desmarcados e pressionados. A variação de forma animada anterior para o estado "acabou de ser pressionado" continua sendo compatível. (I29f03). - Removemos o suporte ao uso de
EdgeButton
comColumn
devido à necessidade de especificar explicitamente a altura deEdgeButton
emScreenScaffold
. (Ie353d). - Adicionamos suporte ao
LazyColumn
do Wear Compose com nossoScreenScaffold
e uma implementação deScrollInfoProvider
paraLazyColumnState
. (Ib8d29) - Combinamos
LocalTextMaxLines
,LocalTextAlign
eLocalTextOverflow
em um único local de composiçãoLocalTextConfiguration
para oferecer uma solução mais escalonável no futuro. (I5edbc). - Adicionamos "arc-large" como uma escala tipográfica extra, reservada para strings de texto de cabeçalho curtas na parte superior ou inferior da tela, como em sobreposições de confirmação. (I60e3e).
- Adicionamos padrões ao botão para tamanhos de ícones grandes e extragrandes recomendados e padding de conteúdo. (I84675).
Correções de bugs
- Atualizamos as cores de
IconButton
eTextButton
. (I48324). - Mudamos as sobrecargas do botão base para serem alinhadas verticalmente ao centro, para consistência com outras sobrecargas. Para restaurar o comportamento anterior, use
Modifier.align
deRowScope
. (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 por componentes em toda a biblioteca para aplicar especificações de animação, como molas para movimentos expressivos. (I54ff3).
- Adicionamos componentes
AppScaffold
eScreenScaffold
à biblioteca Material3, que incluem funcionalidades para coordenar camadas e transições deTimeText
eScrollIndicator
. OAppScaffold
fornece um nível superior de componentes de estrutura que ficam acima de todas as telas. Assim, adicionarTimeText
aoAppScaffold
permite que ele permaneça no lugar enquanto você desliza entre as telas. As telas podem substituir ou ocultar o texto de hora. OScreenScaffold
fornece um slot para oScrollIndicator
e anima automaticamente o indicador de rolagem ao rolar, incluindo um tempo limite para ocultar o indicador 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 lento é carregado na lista. (Ic228d). - Mudamos a API
ScrollAway
para queScreenStage
seja uma classe de valor em vez de uma classe de enumeração. Isso permite adicionar mais etapas conforme necessário. (I48c93). - Adicionamos
EdgeButton
, um botão específico do Wear com um formato que segue a curvatura da parte de baixo da tela (I16369). - Adicionamos um novo slot ao
ScreenScaffold
para um botão na parte 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
atual. (I89182). - Adicionamos
AlertDialog
, que oferece layouts para apresentar solicitações importantes ao usuário. As variações incluem um par de botões de confirmação/dispensa ou um único botão na parte de baixo (normalmente um EdgeButton) abaixo de uma pilha de opções. Ambas as variações têm espaços para ícone, título e texto adicional para fornecer mais detalhes. (Ieb873) - Adicionamos
OpenOnPhoneDialog
, que deve ser usado para indicar uma ação que vai continuar no smartphone do usuário.OpenOnPhoneDialog
é dispensado após um tempo limite especificado. (I978fd). - Adicionamos o
Confirmation
, um componente de caixa de diálogo com 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 reduzir problemas em que o conteúdo subjacente e oTimeText
se sobrepunham e ocultavam o horário. (Ia11fd). - Adicionamos
LevelIndicator
, que mostra o valor de uma configuração, como volume, e pode ser usado com o componenteStepper
atual para criar uma tela de volume.LevelIndicator
é semelhante aScrollIndicator
, mas aparece no lado oposto da tela e tem uma largura de traço maior e uma cor de indicador diferente por padrão. (I8a4ac). - Adicionamos
TimePicker
, com layouts para horário de 24 horas (com ou sem segundos) ou horário de 12 horas com seleção de am/pm. (Ia5124). - Adicionamos
DatePicker
, com configuração para ordenação de colunas (ou seja, 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 o(Split)ToggleButton
e o controle de alternância filho (I0d349). - Atualizamos a documentação
AnimatedText
para explicar o comportamento de ultrapassagem. (Iff30a). - Adicionamos
ButtonGroup
para combinar dois ou três botões de forma que os toques produzam uma animação coordenada. (Ie27db). - Adicionamos animação de forma opcional para
IconButton
eTextButton
quando pressionados. (Iffca5). - Adicionamos uma variação de cor,
FilledVariant
, aButton
,IconButton
,TextButton
,CompactButton
eEdgeButton
(I65fc3). - Adicionamos o parâmetro
forcedSize
aImageWithScrimPainter
para que os planos de fundo de imagens de botões mantenham o tamanho do componente por padrão. Definir oforcedSize = null
adota oPainter.instrinsicSize
. (Ic57af). - Adicionamos o clique longo aos botões (Ib613d).
- O suporte para clique longo também foi adicionado a
IconButton
eTextButton
. (I38891). - Adicionamos suporte para clique longo aos cards. (I305d5).
- Adicionamos
LocalTextMaxLines
,LocalTextAlign
eLocalTextOverflow
comoCompositionLocals
e os usamos como padrões de parâmetro 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 substituirToggleButtonColors
, que foi removido. (Ie0bf1).
Correções de bugs
- Atualizamos
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
para usar os novosCompositionLocals
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
e implementar orientações de UX. Esses parâmetros podem ser substituídos pelos desenvolvedores diretamente no texto, se necessário (Ie51f7). - Mudamos a largura do traço padrão do
LevelIndicator
para6dp
para diferenciá-lo doScrollIndicator
, que tem uma largura de traço de4dp
. (If6f63). - Corrigimos um problema no
TimeText
para que ângulos de varredura maiores sejam aceitos. (Ie489f). - Correção de um problema durante a recomposição do
EdgeButton
. (I4cdca). - Layouts corrigidos de botões de alternância divididos quando um padding de conteúdo personalizado é fornecido. (Ia33d3)
- Arredondamos para cima valores pequenos de progresso 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 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
ColorScheme
do Material3. (I7b2b8) - Atualizamos o Switch do Material3. Além de algumas mudanças de cor, a marca de seleção agora corresponde à usada na caixa de seleção. (Icac7b).
Correções de bugs
- Atualize 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 lançada devido a um problema técnico na versão anterior que resultou em arquivos JAR de origem ausentes. Não há novos commits 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 os alphas de estado pressionado e em foco do Ripple para contraste. (I59f0a).
- Adicionamos espaçamento entre os rótulos primários e secundários em
Button
,ToggleButton
eRadioButton
, seguindo as mudanças mais recentes nos estilos de tipografia e nas alturas de linha. (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 Wear Compose Material3. Esse componente mostra o horário atual (e status adicional) na parte de cima da tela. A nova API Material3 concisa evita a duplicação entre conteúdo linear e curvo. (I4d7c3). - Atualizamos os nomes dos parâmetros de
onSelected
paraonSelect
emRadioButton
. (I1a971). - Tokenize
RadioButton
eSplitRadioButton
e refatore os métodos atuais 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 de valores padrão para
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 das 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, tonais preenchidas e de contorno do 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 difere doToggleButton
atual porqueRadioButton
é selecionável (e opera em um grupo de seleção), enquantoToggleButton
pode ser ativado/desativado (e é independente). (I61275) - Estamos removendo
LocalContentAlpha
da biblioteca Wear Compose Material3 para manter a consistência com a biblioteca Compose Material3. (I49a0a). - Os componentes do Wear Material e do Wear Material 3 que expõem um
MutableInteractionSource
na API foram atualizados para expor umMutableInteractionSource
anulável que tem como padrão o valor nulo. Não há mudanças semânticas aqui: transmitir nulo significa que você não quer elevar oMutableInteractionSource
, e ele será criado dentro do componente, se necessário. A mudança para nulo permite que alguns componentes nunca aloquem umMutableInteractionSource
e que outros componentes só criem uma instância quando necessário, o que melhora o desempenho desses componentes. Se você não estiver usando oMutableInteractionSource
transmitido a esses componentes, recomendamos transmitir "null". Também é recomendável fazer mudanças semelhantes nos seus próprios componentes. (Ib90fc, b/298048146). - Adiciona uma nova API de efeito ripple 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 para usar as APIsrememberRipple/RippleTheme
descontinuadas. Isso será removido na próxima versão estável e destina-se apenas a ser uma ajuda temporária para migração em casos em que você está fornecendo umRippleTheme
personalizado. Consulte developer.android.com para informações sobre migração e mais informações contextuais sobre essa mudança. (af92b21) - Fizemos pequenas melhorias na API
HorizontalPageIndicator
e na documentação dela. (I60efc). - Atualizamos
ColorScheme
para ser imutável, o que torna as atualizações de cores individuais menos eficientes, mas o uso mais comum de cores mais eficiente. O motivo dessa mudança é que a maioria dos apps não teria a atualização de cores individuais como um caso de uso principal. Isso ainda é possível, mas vai recompor mais do que antes. Por sua vez, diminuímos significativamente a quantidade de assinaturas de estado em todo o código material e afetamos o custo de inicialização e de tempo de execução de casos de uso mais padrão. (Ibc2d6). - Atualização das APIs
ToggleButton
eSplitToggleButton
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 somente de exibição, removendo o processamento de cliques. Esses componentes devem ser usados em(Split)ToggleButton
, que processa o clique. Assim, eles agora são indicados mais claramente como somente 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ções no Wear Compose Material 3. (I437cd)
- Corrigimos um bug nos
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
eRadioButton
para que os anúncios de acessibilidade não sejam repetidos. Antes, os papéis semânticos eram duplicados. (Ica281) - Removemos a camada materialcore para
CompactButton
e 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 básico
SwipeToDismissBox
comoBasicSwipeToDismissBox
. Isso torna mais clara a distinção entre o componente de nível Foundation e oSwipeToDismissBox
de nível Material3. O último extrai cores doMaterialTheme
para serem usadas em scrims e delega a implementação restante aoBasicSwipeToDismissBox
. (Ibecfc).
Correções de bugs
- Removemos a camada material-core do botão Material3 para melhorar a performance. (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 o formato da tela do dispositivo (linear ou redondo). (I83728) - Separamos as cores de
SplitToggleButton
das 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 "Subtítulo" opcional a
TitleCard
. (Ifc45a). - Adicionamos tokens de cores 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). - Tornamos públicos os construtores de
CheckboxColors
,RadioButtonColors
eSwitchColors
. (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 dos nossos
ListHeader
eListSubheader
do Material3. (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
- Adicione
HorizontalPageIndicator
na biblioteca Wear Material3. (Ifee99)
Mudanças na API
- Atualize o código dos botões para usar tokens de design do Material3. (I92fe4)
- Declaração das APIs Stepper e Slider do Wear Material 3 como experimentais, já que os detalhes da interface do usuário ainda estão sendo finalizados. (I84d54).
- Removemos os tamanhos
ExtraSmall
dos ícones redondosTextButton
eTextToggleButton
porque esse tamanho só se aplica aoIconButton
. (Ibc7d5).
Correções de bugs
- Atualizamos a orientação sobre tipografia para TextToggleButton para usar LabelLarge em LargeButtonSize (Ib10fa).
- Atualizamos a orientação sobre tipografia para TextButton para usar LabelLarge em LargeButtonSize (I8f3a7).
- Definimos a área de toque mínima do Card como 48 dp para acessibilidade. (Ieb9b1)
- Adicionei a demonstração do AppCard com imagem e removi a demonstração do AppCard 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
- Adicionamos
ToggleButton
para material3 (I6bed6).
Mudanças na API
- Ativamos a anotação
FloatRange
como restrições de API , que antes eram declaradas em comentários. (Icb401). - Atualizamos a tipografia do Wear Material3 para seguir as 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 de seleção da 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 diferentes tamanhos deToggleButton
, recomendamos usarModifier.touchTargetAwareSize
com os tamanhos fornecidos nos respectivos botões de alternância. (I9f015). - Adicionamos
ListHeader
eListSubheader
aos nossos componentes do Material 3. (Ibaefe). - Adicionamos o Material3
SwipeToDismissBox
, que chama o novo FoundationSwipeToDismissBox
e fornece valores de cores 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 valor OInlineSlider
é 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). - Tornamos as constantes de altura públicas para o botão (Idbfde).
- Os arquivos de API foram atualizados para anotar a supressão de compatibilidade (I8e87a, b/287516207).
- Atualizamos
InlineSliderColors
no Wear Compose Material 3 para ter um construtor e propriedades públicas. (I6b632). - Atualizamos todas as classes de cores no Wear Compose Material 3 para ter construtores e propriedades públicas. (I17702)
- Tornamos públicas as constantes de padding horizontal e vertical do botão. (Ieeaf7)
Correções de bugs
- Agora, o botão 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 aceitam cliques repetidos em pressionamentos longos para que você possa aumentar/diminuir rapidamente o valor deStepper
eInlineSlider
mantendo pressionados 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
à nossa biblioteca Compose para Wear OS Material 3. É semelhante à versão anterior do Material, 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
à nossa biblioteca Material 3 do Compose para Wear OS. (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
TextButton
para usar a função de extensãotoDisabledColor
com valores alfa desativados corretos. (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 tem 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 contorno e preenchimento, usefilledTonalTextButtonColors
. (I667e4). - Adicionamos
Card
,OutlinedCard
,AppCard
eTitleCard
à biblioteca Wear Compose Material3.AppCard
eTitleCard
também podem receber 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, já que ele 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 Button do Material 3, que é nosso botão em forma de estádio e antes era chamado de Chip na biblioteca Wear Compose Material. Ele foi renomeado como Button 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 para
FilledTonal
(plano de fundo sem destaque), Outlined (transparente com uma borda fina) e Child (plano de fundo transparente e sem borda, usado para ações complementares com a menor quantidade de destaque). Os botões redondos para ícones simples e conteúdo de texto 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 a desativação do padding de fontes por padrão com as bibliotecas do Compose no futuro (consulte Correção do padding de fontes 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 reformulados. 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 Wear Material (
androidx.wear.compose:compose-material
) e o Wear Material 3 (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 devem ser misturadas no mesmo app, principalmente porque fazem referência a temas diferentes, o que levaria a inconsistências inesperadas.