Wear Compose Material 3
| Atualização mais recente | Versão estável | Versão candidata a lançamento | Versão Beta | Versão Alfa |
|---|---|---|---|---|
| 27 de agosto de 2025 | 1.5.0 | - | - | - |
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" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // 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") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // 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
27 de agosto de 2025
Lançamento de androidx.wear.compose:compose-*:1.5.0. A versão 1.5.0 contém estas confirmações.
Mudanças importantes desde a versão 1.4.0
Primeira versão da biblioteca Wear Compose Material 3, que oferece suporte ao novo sistema de design expressivo do Material 3. Esta versão inclui:
- Atualizamos o
MaterialThemee o tema de cores dinâmicas. - Novos componentes
AppScaffold, ScreenScaffold,HorizontalPagerScaffoldeVerticalPagerScaffoldpara definir a estrutura da tela e coordenar animaçõesScrollIndicator,TimeText,HorizontalPageIndicatoreVerticalPageIndicator. - Transformação de formas
IconButton,TextButton,IconToggleButtoneTextToggleButton, com variações que são animadas quando pressionadas ou marcadas. EdgeButton, que tem um formato especial projetado para a parte de baixo da tela.ButtonGroupimplementa um grupo expressivo de botões em uma linha que muda de forma quando tocada.AlertDialogeConfirmationDialogcom variações para conteúdo adicional da caixa de diálogo.- Componentes
TimePickereDatePicker. - Os indicadores de progresso incluem
CircularProgressIndicator(com variação segmentada),ArcProgressIndicatoreLinearProgressIndicator.
Além disso, o Wear Compose Foundation 1.5.0 inclui o seguinte:
TransformingLazyColumn, uma lista de rolagem vertical lenta que oferece suporte a animações de escalonamento e transformação.- Suporte à paginação na Wear Compose Foundation com
HorizontalPagereVerticalPager. - Grupos focais hierárquicos: usados para anotar elementos combináveis em um aplicativo e acompanhar a parte ativa da composição e coordenar o foco.
Saiba mais sobre o Material 3 Expressive para Wear OS.
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
TimePickerem 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
TimePickeragora é totalmente controlado pela localidade do usuário, usandoDateFormat.getBestDateTimePatternpara 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). DatePickeragora 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
HorizontalPageIndicatoreVerticalPageIndicatorem tela cheia. Os indicadores de página não são mais de tela cheia e são posicionados automaticamente quando usados comHorizontalPagerScaffoldouVerticalPagerScaffold. Quando não estiver usando um scaffold de pager, especifique o alinhamento explicitamente usandomodifier = Modifier.align(Alignment.BottomCenter)comHorizontalPageIndicatoremodifier =Modifier.align(Alignment.CenterEnd)comVerticalPageIndicator. (I3a0ad). - A direção do gesto de deslizar em
SwipeToRevealagora é consistente paraLayoutDirectionsLTR e RTL. (I6d427). - O alinhamento vertical
SwipeToRevealfoi restabelecido para ações. SehasPartiallyRevealedState = true,RevealStateserá redefinido paraRevealValue.Coveredpelo caller quando a rolagem ocorrer. (I6473d). - O
SwipeDismissableNavHostagora 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
EdgeButtonquandoLazyColumnouScalingLazyColumntêmreverseLayout = true. (I46a1a). - Correção de um bug no
ScreenScaffoldem que o recurso "Tocar para explorar" não funcionava no Talkback se umScrollIndicator/PageIndicatorfosse fornecido. (I6dcee) - Agora, o
TransformingLazyColumnpermite a transformação personalizada doTransformationSpeclendo o valoritemHeightfornecido peloTransformationSpecno 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
CircularProgressIndicatorpara evitar um salto perceptível para o tamanho mínimo do ponto durante a animação. Como parte dessa mudança, o parâmetrotargetProgressemdrawCircularProgressIndicatornã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
SwipeToRevealem listas lentas (I1d4f6) - As formas de contêiner em
TransformingLazyColumnagora são dimensionadas para evitar o corte do conteúdo. (I9221a) - Os rótulos
TimePickereDatePickerpara 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
CircularProgressIndicatorindeterminado (Iaf0bb) - Correção de um bug de animação em
TransformingLazyColumnquando os itens são removidos. (I73034) - Correção do processamento de itens de âncora em
TransformingLazyColumnquando itens são removidos. (I841a8). - Agora,
PickerGroupanima 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
TransformingLazyColumnem 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
TransformingLazyColumnagora lê a altura do item no painter de segundo plano, o que permite queTransformationSpecspersonalizado implemente a transformação. (I022f0). SwipeToRevealagora centraliza verticalmente as ações reveladas corretamente. (I4419b).- Corrigimos um bug no
SwipeToRevealque 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
SwipeToRevealeram desenhadas com um deslocamento vertical ao rolar a tela. (I29444) AlertDialog,ConfirmationDialog,OpenOnPhoneDialogeSwipeToRevealagora arredondam paddings e tamanhos calculados como uma porcentagem do tamanho da tela. (I76367).- O
ButtonDefaults.outlinedButtonBorderagora atualiza o tamanho seguindo as mudanças de estado ativado/desativado(If2ddd). - Correção de um bug na altura do
EdgeButtonque 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
HorizontalPageIndicatoreVerticalPageIndicatorao 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
LevelIndicatorque 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
OpenOnPhoneDialogagora anuncia apenas o texto da mensagem no TalkBack e ignora a semântica do ícone. AsOpenOnPhoneDialogDefaultsforam atualizadas para remover oiconContentDescriptione o parâmetrocontentDescriptiondeicon(). Além disso, oConfirmationDialogDefaultsagora tem parâmetros de modificador nos elementos combináveisSuccessIconeFailureIcon. (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.Saverfoi adicionado para ser usado na restauração do estado deSwipeToRevealquando a atividade ou o processo é recriado. A funçãorememberRevealStateagora usa esse Saver por padrão. (Ie0ecb)- Os botões de ações primárias e secundárias
SwipeToRevealagora usamButtonDefault.Heightpor padrão. Corrigimos um bug em que eles preenchiam a altura máxima de botões mais altos. (Ibfba1). - Mudança em
SwipeToRevealpara redefinir o último componente com que se interagiu quando o gesto de deslizar para a direita é realizado. (Ia8450). SwipeToRevealfoi alterado para ficar no estadoRevealingquando 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
AnimatedTextagora é compatível com a direção de texto RTL (I4533c). - Agora, o
TransformingLazyColumnredimensiona os itens corretamente quando o item da parte de baixo é removido. Idacab - Agora, o
TransformingLazyColumnfaz 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
OpenOnPhoneDialogno TalkBack precisa anunciar o texto curvo, e não a descrição do conteúdo do ícone. (I4efe8). - Correção de um bug no
SwipeToRevealque informava a âncora errada emRevealState.currentValuequandohasPartiallyRevealedStateera definido como "false". (I9c7cf). - Os botões de desfazer
SwipeToRevealagora sãoButtonDefaults.Heightpor padrão. (I1f6c8). - O desempenho do
BasicSwipeToDismissBoxfoi 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
TransformingLazyColumnfoi melhorada com a otimização do cálculo doScrollProgressem 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:
MaterialThemepara 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,IconToggleButtoneTextToggleButton, 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
AppScaffoldeScreenScaffoldpara definir o layout da estrutura da tela e coordenar as animaçõesScrollIndicatoreTimeText. - 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.
CheckboxButtoneSwitchButtonsã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
AlertDialogsão compatíveis com botões de confirmação/cancelamento ou umEdgeButton. ConfirmationDialogestá 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
TimePickereDatePickersão compatíveis, assim como os componentes Picker ePickerGrouppara criar suas próprias telas de seleção. ProgressIndicators: indicadores de progresso circulares e lineares são compatíveis (oCircularProgressIndicatortem 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. OTitleCardtambé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,VerticalPagerScaffoldeAnimatedPagecoordenam as animaçõesHorizontalPageIndicatoreVerticalPagerIndicator.HorizontalPagereVerticalPagersã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
HorizontalPagereVerticalPager, 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.hierarchicalFocusparaModifier.hierarchicalFocusGroupe removemos o parâmetro de callback. Também removemos a sobrecarga deModifier.hierarchicalFocusRequestercom um parâmetroFocusRequestere criamos um novoCompositionLocal,LocalScreenIsActivepara que os componentes possam informar e verificar qual tela está ativa. (I5ff7c). - Descontinuamos
SwipeToRevealda Wear Compose Foundation em favor das APIsSwipeToRevealno Wear Compose Material e no Wear Compose Material3. Substitua as importações do Wear FoundationSwipeToRevealpelas importações do Wear Compose Material/ Wear Compose Material3 para continuar usando as APIs. (Ia147d). - As dependências do Wear Compose Material3
SwipeToRevealno 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.foundationparaandroidx.wear.compose.material3. (I640e6). - Atualizamos a API
SwipeToRevealdo Wear Compose Material3 da seguinte maneira: adicionamos os parâmetrosprimaryAction,onFullSwipe,secondaryAction,undoPrimaryAction,undoSecondaryActionehasPartiallyRevealedStateao elemento combinávelSwipeToReveal; removemos a capacidade de personalizarpositionalThresholdeanimationSpecdeRevealState; removemoslastActionType,revealThresholde a largura deRevealState; mudamos o construtorRevealStatepara aceitar umRevealDirectionem vez de âncoras; removemos as funçõescreateRevealAnchors, âncoras ebidirectionalAnchors; as funçõesSwipeToRevealScopeprimaryAction,secondaryAction,undoPrimaryActioneundoSecondaryActionforam renomeadas comoPrimaryActionButton,SecondaryActionButton,UndoActionButtone transformadas em funções combináveis; marcamosRevealActionTypecomo interno. (I885d0). - Atualizamos ainda mais a API
SwipeToRevealda seguinte maneira: renomeamosonFullSwipeparaonSwipePrimaryActioneSwipeToRevealNonAnchoredSamplepara 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. RemovemosSmallActionButtonHeightdeSwipeToRevealDefaultse tornamos o parâmetro de valor nos construtoresRevealValueeRevealDirectionparticular. (I465ce).
Correções de bugs
- Corrigimos o processamento de
EdgeButtondoScreenScaffoldpara que, depois que um itemTransformingLazyColumnfor removido, oEdgeButtonseja 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
CircularProgressIndicatorindeterminado 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
containerPainteredisabledContainerPaintersubstituemcontainerColoredisabledContainerColor(I4a453). - Foi revertida uma mudança em
TimeTextna versão anterior, que moveu oBroadcastReceiverpara 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
rememberUpdatedStateno seletor para lembrar a função lambdacontentDescriptionmais recente. (Icb5b1). - Atualizamos os estilos de texto em
TimePickereDatePickerpara que as mudanças de fonte não resultem mais em truncamento. (I26194). - Por padrão,
ListHeadereListSubHeaderagora 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
MaxLinespadrão no conteúdoEdgeButtonde acordo com o tamanho. Agora é 1 para extrapequeno, 2 para pequeno e médio e 3 para grande. (Ie35f6). LocalReduceMotionsimplificado para que o observador seja registrado apenas uma vez, melhorando a performance. (Ib1979).- Minimizamos o número de redimensionamentos em
ScrollIndicatorpara 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
scrollTransformda plataforma da API pública. Use a combinação dos modificadorestransformedHeightegraphicsLayerse precisar da mesma funcionalidade. (Ie181d). - Substituímos os elementos combináveis
ImageButtoneImageCardpelas sobrecargasButtoneCard/TitleCard, respectivamente.imageButtonColorsfoi renomeado comobuttonWithContainerPainterColors, eimageCardColorsfoi renomeado comocardWithContainerPainterColorsAdição deButtonDefaults.scrimBrusheCardDefaults.scrimBrushpúblicos. Os botõesimageBackgroundGradientStartColoreimageBackgroundGradientEndColorforam renomeados comoscrimGradientStartColorescrimGradientEndColor.CardDefaults.ImageContentPaddingfoi renomeado comoCardDefaults.CardWithContainerPainterContentPadding(I7b8b6). PickerePickerGroupagora usamcontentDescriptioncomo uma lambda para evitar recomposições desnecessárias. (I002dd)
Correções de bugs
- Correção de um problema em que o
CircularProgressIndicatorindeterminado 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
OpenOnPhoneDialogpara 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.imageBackgroundButtonColorsfoi substituído porImageButton,ButtonDefaults.imageButtonColors,ButtonDefaults.containerPaintereButtonDefaults.disabledContainerPainter. E mudanças semelhantes para Card. Os pintores são removidos deButtonColorseCardColors. (I8c6a1)- Atualizamos os marcadores de posição para simplificar a API. Agora oferecemos dois modificadores:
Modifier.placeholderShimmerpara aplicar um efeito de brilho no nível do componente eModifier.placeholderpara 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
FadingExpandingLabelquando o texto ocupa várias linhas. (I04eb7). - Atualizamos o padding entre os rótulos primário e secundário nos botões. (I99b7b)
ArcLargefoi reduzido de20sppara18sp, e os espaçamentos entre letras emArcLargeeArcSmallforam atualizados.ConfirmationDialog/OpenOnPhoneDialogagora usam oArcLargepadrã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
AlertDialogagora é reduzido por padrão quando um ícone é fornecido. Isso aproveita melhor o tamanho da tela disponível. (Ief06c) PagerScaffoldDefaults.FadeOutAnimationfoi renomeado comoPagerScaffoldDefaults.FadeOutAnimationSpecO parâmetro "page" emAnimatedPagefoi renomeado comopageIndex. (I701f2).- Atualizamos a nomenclatura da divisão
SurfaceTransformation-applyTransformationdoTransformingLazyColumnemapplyContainerTransformationeapplyContentTransformation, e renomeamoscreateBackgroundPainterparacreateContainerPainter. Mais atualizações de nomenclatura paraTransformationSpeceResponsiveTransformationSpec. (I1c534). - O
AppScaffold backgroundColorfoi renomeado comocontainerColor. (I4e63f).
Correções de bugs
- Correção de um problema no
FadingExpandingLabelem que o texto nem sempre era expandido corretamente. (I0e773). ArcLargefoi reduzido de 20sp para 18sp, e os espaçamentos entre letras emArcLargeeArcSmallforam atualizados. Agora,ConfirmationDialog/OpenOnPhoneDialogusa oArcLargepadrão em vez de substituir por 18sp. (Id39a8).- Atualizamos a animação de cabeçalho para
DatePickereTimePickercom base nisso, para que a animação de fade-out e fade-in funcione como uma animação de mola. (I68963). - Otimizamos
PagerScaffoldevitando a leitura decurrentPageOffsetFractionno 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.
TimePickereDatePickercontinuam aplicandoFontFeatureSetting=tnumpara números tabulares. (I88929). - Corrigimos o foco inicial de entrada do RSB para
TimePickereDatePicker. (I1c773). - O texto padrão em
OpenOnPhoneDialogfoi atualizado para "Confira seu smartphone". (I00a3f). - Atualizamos as ponderações de
ArcLargeeArcMediumde 600 para 599 para contornar um problema em que a ponderação 600 é tratada como negrito (I2a51d). - Atualize os paddings
SwipeToRevealentre 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
PagerScaffoldnão emite mais um componentePager. Em vez disso, ele precisa ser fornecido pelo elemento combinávelcontent. As APIsAnimatedPageesnapWithSpringFlingBehaviouragora são públicas e podem ser usadas com aPagerdo Wear Foundation para alcançar o comportamento anterior doPagerScaffolddo M3. Confira exemplos atualizados. (Ia4724). - Atualização de
PagerState, removendo oPagerStatedo Compose Foundation como classe base e adicionando propriedadescurrentPage,currentPageOffsetFractionepageCount. Atualizamos a interfaceGestureInclusion, renomeando o método paraignoreGestureStart. (I4ae07) - Os parâmetros de ângulo de varredura
LevelIndicatoragora são anotados comFloatRange(0, 360)(I7e636) - Adicionamos
CurvedModifier.clearAndSetSemanticspara oferecer uma maneira de desativar a semântica curva.CurvedTextcontinua definindo a descrição do conteúdo como texto, mastimeTextCurvedTextetimeTextSeparatornã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
HorizontalPagerfoi 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
SurfaceTransformationaos 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 FoundationSwipeToRevealagora é 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 oSwipeDirectionestá 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
TransformingLazyColumnagora usacontentPaddingvazio por padrão em vez de colocar o primeiro e o último item no centro. (I77ab7). - Removemos o
rememberRevealStatedoSwipeToRevealda 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
ScrollIndicatorePageIndicatornã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
CurvedTextStyleusado emConfirmationDialogDefaultseOpenOnPhoneDialogDefaultsfoi atualizado para usar a tipografiaArcLargecom tamanho18spe espaçamento entre letras1.8sp. (Ic9ced). Card,ListHeader,RadioButton,CheckboxButtoneSwitchButtonnã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
TimeTexteScrollIndicatorpara 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
TimeTexteScrollIndicatorem 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
SwipeToRevealusando o modificadoredgeSwipeToDismiss. (I02b07). - Adicionamos um título a
DatePickereTimePickerno TalkBack para informar ao usuário que é preciso rolar a tela para definir data/hora. (Id738d). - O
AnimatedTextagora segue a configuração de redução de movimento. (Ib6578). - A otimização para usar
AppScaffolde 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'sprimaryActionesecondaryAction. A semântica de ações personalizadas precisa ser adicionada diretamente ao conteúdo do componenteSwipeToRevealpelo desenvolvedor. (Ia67f3). - Removemos os prefixos "Button" de tamanhos, estilos de texto e funções de cor em
IconToggleButtonDefaultseTextToggleButtonDefaults(I5471d). - Removemos o
LocalMinimumInteractiveComponentEnforcementexperimental (I4ad8a). - Substituímos a DSL
PickerGroupScopepor um elemento combinável. Por isso, removemos o métodopickerGroupItemdePickerGroupScopee 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
LevelIndicatorpara 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
TransformationSpecdoTransformingLazyColumnà 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,TextButtonShapeseTextToggleButtonShapespara serem consistentes com as classes compose/material3 (I5a081). - Adicionamos um parâmetro
overscrollEffectaScalingLazyColumn,TransformingLazyColumneScreenScaffold. (I0cee8). - Renomeamos o parâmetro
swipeDirectionpararevealDirectionemrememberRevealState. (I7472f). - O Wear Pager agora tem o próprio
PagerScopeem vez de usar oPagerScopedo Compose. (I9195b). - Removemos o elemento combinável
LinearProgressIndicatorContent. UseLinearProgressIndicatordiretamente para que as mudanças nos valores sejam animadas por padrão. (I2c4ad). - Removemos o elemento combinável
CircularProgressIndicatorStatice adicionamos uma função públicaDrawScopedrawCircularProgressIndicatorcom a mesma funcionalidade. UseCircularProgressIndicatordiretamente para que as mudanças sejam animadas por padrão, mas crie seu próprio elemento combinável usandodrawCircularProgressIndicatorse precisar de animações personalizadas. (Ie762f). - Reordenamos os parâmetros em
DrawScope.drawCircularProgressIndicatorpara mover o parâmetrotargetProgresspara cima. (I8ab92). - A API
OpenOnPhoneDialogfoi atualizada para melhorar a clareza e a consistência com outras caixas de diálogo. O parâmetroshowfoi renomeado comovisible, ecurvedTextagora é fornecido pelo autor da chamada em vez de ter um valor padrão. (Idec2d). - Renomeamos
openOnPhoneCurvedTextcomoopenOnPhoneDialogCurvedText(I65bdd). - Adicionamos
ScrollIndicatorColorspara 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,ArcMediumeArcSmallpara seremCurvedTextStyle(Iffc41). - Removemos
ScreenScaffoldDefaults.contentPaddingWithEdgeButton. (Ia923e). - Adicionamos
errorDimaoColorSchemepara 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.material3na versão 1.15.0 doandroidx.core.core(I132e9). - Melhoramos o desempenho da caixa de diálogo usando o
AppScaffoldpara 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,TextButtonShapeseTextToggleButtonShapespara 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
pressedShapeCornerSizeFractiondo métodovariantAnimatedShapeemIconToggleButtoneTextToggleButton(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
ButtonGroupScopedoButtonGroup, substituindo oButtonGroupItembaseado em DSL porModifier.weight,Modifier.minWidtheModifier.enlargeOnPress. (I16c3c) - Na API
ButtonGroup, atualizamos o novoButtonGroupScopebaseado em modificador:enlargeOnPressagora é chamado deanimateWidthe 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.contentColorpara 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.DecreaseIconeSliderDefaults.IncreaseIcon, com valores padrão adequados (I2e1a7). - Renomeamos o parâmetro
spacingemPickerePickerGroupcomoverticalSpacing(Ib75cc) - Removemos
ConfirmationDialogDefaults.successTextefailureTextporque esperamos que os chamadores deConfirmationDialogforneçam strings com mais contexto. Também renomeamosconfirmationCurvedTextparaconfirmationDialogCurvedText. Por fim, renomeamos o parâmetroshowda caixa de diálogo para "visible" (visível) para manter a consistência com outras atualizações recentes nas caixas de diálogo. (I10074). IconButtonrenomeoudisabledImageOpacityparaDisabledImageOpacity. (I5f94a).
Correções de bugs
- Correção de um bug na animação
EdgeButtonpara que o tamanho correto seja usado em cada frame (Id3b58). - Correção de um problema em que
animateContentSizenã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
ScreenScaffoldeEdgeButtonpara facilitar a especificação de padding de conteúdo em telas que incluem umEdgeButton. Na nova API, osizedoEdgeButtoné transmitido apenas para oEdgeButton, e oScreenScaffoldusa um parâmetroedgeButtonSpacingpara o espaçamento entre oEdgeButtone o conteúdo da lista. (I424fd) - Em
DatePicker, renomeamos os parâmetrosminDateparamaxDateeminValidDateparamaxValidDate. EmDatePickerColors, renomeamos o parâmetroselectedPickerContentColorparaactivePickerContentColoreunselectedPickerContentColorparainactivePickerContentColor(Iba17b). - Atualizamos os padrões de
ArcProgressIndicatorparastrokeWidth=6dpe 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âmetroshowparavisiblepara compatibilidade com outras APIs de animação do Compose. Além disso, disponibilizamosConfirmationDialogContent,SuccessConfirmationDialogContenteFailureConfirmationDialogContentpara situações em que os desenvolvedores precisam personalizar as animações da caixa de diálogo de introdução/encerramento. (Iaeb33). - Atualizamos
CircularProgressIndicatorContentparaCircularProgressIndicatorStatic(a variação não animada deCircularProgressIndicator) para que agora possa ser usado na criação deCircularProgressIndicatorcom animações personalizadas. (I1346f) - Corrigimos a ordem dos parâmetros na
ArcProgressIndicator, colocando o parâmetro de modificador primeiro (I4656a). - Melhoramos a API
SwipeToRevealpara 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
LongPressera 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
SwipeToRevealpara expandir o contêiner ao mesmo tempo em que o texto é exibido. (I44cf8). - Melhoria no
SwipeToRevealpara realizar feedback tátil quando o gesto de deslizar passa do limite em que a ação principal é confirmada. (I23efe). - Atualizamos
SwipeToRevealpara 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
scrollTransformparaTransformingLazyColumnfoi refatorado, o que acionou uma mudança na API. (I0c6dc) - Atualizamos
IconToggleButtonShapeseTextToggleButtonShapespara ter dois parâmetros de forma diferentes,uncheckedPressedecheckedPressed(I85dbd). - As opções de mês/dia inválidas agora ficam visíveis no
DatePicker, com um novoinvalidPickerContentColor, ao usarminDateoumaxDate. (If4541). - Atualizamos a API
Stepperpara fornecer slotsincreaseIconedecreaseIcon. O conteúdo deles pode ser criado como de costume no elemento combinável ícone. (Id35da). - Atualizamos
dynamicColorSchemeremovendo o parâmetro opcionaldefaultColorSchemee agora retornandoColorSchemeanulá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
ButtonDefaultspara uso comCompactButton. UmCompactButtonque contém apenas um ícone deve usarButtonDefaults.SmallIconSize = 24.dp, enquanto umCompactButtonque contém ícone e texto deve usarButtonDefaults.ExtraSmallIconSize = 20.dp. Recomendamos queCompactButtonajuste o conteúdo em vez de preencher a largura máxima. Os exemplos foram atualizados para mostrar isso. (I0582c). - Adicionamos
EdgeButtonDefaultscom tamanhos de ícones recomendados para os quatroEdgeButtonSizesdiferentes. Além disso, atualizamos o layoutEdgeButtonpara 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
LinearProgressIndicatore expusemos oLinearProgressIndicatorContent, que fornece o conteúdo visual sem animações. (Idee99). - Adicionamos um novo elemento combinável
CircularProgressIndicatorContentpara mostrar o conteúdo visual deCircularProgressIndicatorsem animações. (Ie33d4) - O
TransformingLazyColumnagora fornece o local de composiçãoLocalTransformingLazyColumnItemScope, queCards,Buttons eListHeaders 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.shapeparaRoundedCornerShape(Iccdf2).
Correções de bugs
- Correção de um bug para respeitar o alfa atual no plano de fundo do
TimeText(I1eb60). - Definimos
TextMotioncomoAnimatedpor 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
ScrollIndicatoraumentando a largura e o tamanho do espaço para melhorar a visibilidade. (Ied7cb) - Corrigimos um bug no
Modifier.scrollTransformao 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
LevelIndicatorem 20% (ou seja, 72 graus). (Idde5c). - Corrigimos o posicionamento de
ScrollIndicatorquandoScalingLazyColumnera usado comAutoCenteringParams. (I387dd) - Atualizamos as cores e a tipografia de
ListHeadereListSubHeader. Além das cores dos controles de alternância emCheckboxButtoneSwitchButton. (I39817). - Corrigimos o posicionamento de
ScrollIndicatoremLazyColumneScalingLazyColumncomContentPadding. (I2bc51). - Correção de um bug na animação de progresso
OpenOnPhoneDialogusando o novoCircularProgressIndicatorContent. (I3e443). - Atualizamos
HorizontalPagerScaffoldeVerticalPagerScaffoldpara 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
EdgeButtonpodia 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
TimeTextpara fornecer conteúdo padrão que mostra a hora. (Id23b3). - Simplificamos o
ScrollInfoProviderparaPagerStateremovendo o parâmetroorientation, que não é mais necessário. O novo comportamento é queTimeTextpermaneça no lugar para paginação horizontal e vertical. (I71767). - O
LocalHapticFeedbackagora fornece uma implementaçãoHapticFeedbackpadrã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,TextButtoneCard, agora realizam o feedback hápticoLONG_PRESSquando 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
LevelIndicatorpara que ele seja mostrado corretamente quando o nível é zero. (Ie95a4). - Atualizamos as animações
HorizontalPageIndicatoreVerticalPageIndicator. (I5c8f3). - Adicionamos uma animação de redução a um ponto ao
ArcProgressIndicatorindeterminado. (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
AlertDialogContenteDialogque compõem a APIAlertDialog. Assim, é possível adicionar personalização, se necessário, como personalizar a animaçãoAlertDialoge manter o layout de conteúdo recomendado. Além disso, adicionamos os parâmetrosModifiereColoraos membrosEdgeButton,ConfirmButtoneDismissButtondeAlertDialogDefaults. (I4eb71). - Atualizamos a API
Placeholderda seguinte forma: renomeamosPlaceholderState.startPlaceholderAnimationparaPlaceholderState.animatePlaceholder,PlaceholderState.isShowContentparaPlaceholderState.isHiddenePlaceholderDefaults.shapeparaPlaceholderDefaults.Shape; renomeamos o parâmetropainterempainterWithPlaceholderOverlayBackgroundBrushparaoriginalPainter; mudamos a visibilidade dePlaceholderState.placeholderProgressionde 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
EdgeButtonda seguinte forma: renomeamos o parâmetro emScreenScaffolddebottomButtonparaedgeButtone transformamosEdgeButtonSizeem 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
IconToggleButtoneTextToggleButtonao clicar (Ieb333). - Adicionada duração mínima à animação de forma
IconButtoneTextButton(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
ScreenScaffolde oScrollIndicatorapós a mudança de nome do Wear Compose FoundationLazyColumnparaTransformingLazyColumn. (I0608b). - O parâmetro
preferredHeightdeEdgeButtonfoi renomeado parabuttonSize, e o valor dele só pode ser escolhido entre quatro constantes na classe de valorEdgeButtonSizerecém-introduzida. (Icdd70) - Mudamos o nome de
ListSubheaderparaListSubHeadere adicionamos valores padrão acessíveis ao público paraListHeadereListSubHeader. (I96730) - Adicionamos novos componentes
HorizontalPagerScaffoldeVerticalPagerScaffoldpara 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
HorizontalPagerScaffolde aoVerticalPagerScaffold, permitindo que os usuários naveguem pelos paginadores usando dispositivos de entrada por seletor giratório. (I9770d). - Fizemos mudanças na API
MotionSchemepara 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. RenomeamosstandardMotionSchemeeexpressiveMotionSchemepara "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
AlertDialogentre 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
HorizontalPageIndicatore adicionamosVerticalPageIndicatorpara uso comVerticalPager(Ic9309). - O
AlertDialogagora 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
SwipeToRevealpara o Wear Material 3 (Ic38b2). - Adicionamos suporte a deslizar bidirecional no
SwipeToRevealpara 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
buttonHeightdeEdgeButtoncomopreferredHeight. (I4fab3). - A versão do Kotlin foi atualizada para 1.9 (I1a14c).
- Renomeamos
OpenOnPhoneDialogDefaults.IconcomoOpenOnPhoneDialogDefaults.OpenOnPhoneIconpara evitar conflitos comIcon(I0f391). - Adicionamos suporte para
ScrollIndicatoremLazyColumn. (Ia546a). - Atualizamos os valores padrão de
TextToggleButtoneIconToggleButton. (I7aaa9). - Simplificamos as APIs
PickerePickerGroup. (Id0653) - Adicionamos
CardDefaults.ShapeeCardDefaults.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,TimePickereDatePicker. (I46c7c) - Atualizamos os paddings em
ConfirmationeOpenOnPhoneDialog. (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
CircularProgressIndicatoreSegmentedCircularProgressIndicator. Quando o progresso exceder 1,0, isso será indicado pela nova coroverflowTrack. (Iaaa3d) - Os
IconToggleButtoneTextToggleButtonredondos 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
EdgeButtoncomColumndevido à necessidade de especificar explicitamente a altura deEdgeButtonemScreenScaffold. (Ie353d). - Adicionamos suporte ao
LazyColumndo Wear Compose com nossoScreenScaffolde uma implementação deScrollInfoProviderparaLazyColumnState. (Ib8d29) - Combinamos
LocalTextMaxLines,LocalTextAligneLocalTextOverflowem um único local de composiçãoLocalTextConfigurationpara 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
IconButtoneTextButton. (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.aligndeRowScope. (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
AppScaffoldeScreenScaffoldà biblioteca Material3, que incluem funcionalidades para coordenar camadas e transições deTimeTexteScrollIndicator. OAppScaffoldfornece um nível superior de componentes de estrutura que ficam acima de todas as telas. Assim, adicionarTimeTextaoAppScaffoldpermite que ele permaneça no lugar enquanto você desliza entre as telas. As telas podem substituir ou ocultar o texto de hora. OScreenScaffoldfornece um slot para oScrollIndicatore anima automaticamente o indicador de rolagem ao rolar, incluindo um tempo limite para ocultar o indicador após a inatividade. (I047d6). - Adicionamos
ScrollIndicatorcom 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
ScrollAwaypara queScreenStageseja 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
ScreenScaffoldpara um botão na parte de baixo (comoEdgeButton), que será mostrado e redimensionado dependendo do conteúdo de rolagem (I032eb) - Adicionamos
Modifier.scrollTransformeModifier.targetMorphingHeightpara adicionar efeitos de movimento do Material3 a itens emLazyColumn. (Ie229a) - Adicionamos
SegmentedCircularProgressIndicatorcomo 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
LinearProgressIndicatorcomo uma alternativa aoCircularProgressIndicatoratual. (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
TimeTextpara reduzir problemas em que o conteúdo subjacente e oTimeTextse 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 componenteStepperatual 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
textdeTimeText. 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
RadioButtoneSplitRadioButton. Esses componentes simplificam a API anterior combinando oSelectableButton(Split) e o controle de rádio filho (If7ae8). - Adicionamos
CheckboxButtoneSplitCheckboxButton. Esses componentes simplificam a API anterior combinando oToggleButton(Split) e o controle de caixa de seleção filho (Ia8f70). - Adicionamos
SwitchButtoneSplitSwitchButton. Esses componentes simplificam a API anterior combinando o(Split)ToggleButtone o controle de alternância filho (I0d349). - Atualizamos a documentação
AnimatedTextpara explicar o comportamento de ultrapassagem. (Iff30a). - Adicionamos
ButtonGrouppara 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
IconButtoneTextButtonquando pressionados. (Iffca5). - Adicionamos uma variação de cor,
FilledVariant, aButton,IconButton,TextButton,CompactButtoneEdgeButton(I65fc3). - Adicionamos o parâmetro
forcedSizeaImageWithScrimPainterpara que os planos de fundo de imagens de botões mantenham o tamanho do componente por padrão. Definir oforcedSize = nulladota oPainter.instrinsicSize. (Ic57af). - Adicionamos o clique longo aos botões (Ib613d).
- O suporte para clique longo também foi adicionado a
IconButtoneTextButton. (I38891). - Adicionamos suporte para clique longo aos cards. (I305d5).
- Adicionamos
LocalTextMaxLines,LocalTextAligneLocalTextOverflowcomoCompositionLocalse os usamos como padrões de parâmetro emText. Os locais de composição agora podem ser usados por componentes comoCheckboxButton,SwitchButtoneRadioButtonpara implementar orientações de UX, mas os parâmetros podem ser substituídos pelos desenvolvedores, se necessário. (Iab841). - Adicionamos
Placeholderpara ajudar a mascarar o conteúdo de componentes como botões e cards até que os dados sejam carregados. (I1a532). - Adicionamos
IconToggleButtonColorseTextToggleButtonColorspara substituirToggleButtonColors, que foi removido. (Ie0bf1).
Correções de bugs
- Atualizamos
Button,FilledTonalButton,OutlinedButton,ChildButton,CompactButtonpara usar os novosCompositionLocalsLocalTextMaxLines,LocalTextAlign,LocalTextOverflowe 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
LevelIndicatorpara6dppara diferenciá-lo doScrollIndicator, que tem uma largura de traço de4dp. (If6f63). - Corrigimos um problema no
TimeTextpara 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
ToggleButtoneRadioButtonpara que as cores desativadas possam ser configuradas. (If13a7). - Adicionamos um novo
CircularProgressIndicatorpara 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
ColorSchemedo 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,ToggleButtoneRadioButton, 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
onSelectedparaonSelectemRadioButton. (I1a971). - Tokenize
RadioButtoneSplitRadioButtone refatore os métodos atuais para reduzir a quantidade de pesquisaCompositionLocaladicionando instâncias em cache de cores e tornando os métodos deRadioButtonColorseSplitRadioButtonColorsinternos. (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,ToggleButtonColorseSplitToggleButtonColorscriando 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
buttonColorspor padrão e removemos ofilledButtonColorsduplicado. (I4fe3b). - Refatoramos os padrões padrão para
ButtonColors,IconButtonColorseTextButtonColorscriando uma instância em cache internamente e reduzindo o uso deCompositionLocal. (I5f51c). - Removemos a sobrecarga de
rememberUpdatedStateem 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.minimumInteractiveComponentSizepara 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/SplitRadioButtoncomo contêineres para controles de seleção, como o controle de rádio. Isso difere doToggleButtonatual porqueRadioButtoné selecionável (e opera em um grupo de seleção), enquantoToggleButtonpode ser ativado/desativado (e é independente). (I61275) - Estamos removendo
LocalContentAlphada 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
MutableInteractionSourcena API foram atualizados para expor umMutableInteractionSourceanulá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 umMutableInteractionSourcee que outros componentes só criem uma instância quando necessário, o que melhora o desempenho desses componentes. Se você não estiver usando oMutableInteractionSourcetransmitido 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-materialewear:compose-material3, que substitui arememberRippledescontinuada. Também adiciona umCompositionLocaltemporário,LocalUseFallbackRippleImplementation, para reverter os componentes do Material para usar as APIsrememberRipple/RippleThemedescontinuadas. 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 umRippleThemepersonalizado. 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
HorizontalPageIndicatore na documentação dela. (I60efc). - Atualizamos
ColorSchemepara 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
ToggleButtoneSplitToggleButtonpara 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,SwitcheRadioButtonpara 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,SwitcheRadioButtonpara que os anúncios de acessibilidade não sejam repetidos. Antes, os papéis semânticos eram duplicados. (Ica281) - Removemos a camada materialcore para
CompactButtone 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
SwipeToDismissBoxcomoBasicSwipeToDismissBox. Isso torna mais clara a distinção entre o componente de nível Foundation e oSwipeToDismissBoxde nível Material3. O último extrai cores doMaterialThemepara 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
indicatorStyledoHorizontalPageIndicatordo Material3. Em vez disso, ele vai seguir o formato da tela do dispositivo (linear ou redondo). (I83728) - Separamos as cores de
SplitToggleButtondas deToggleButtonadicionando 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
IconButtonpara usar tokens do Material Design. (I3f137). - Atualizamos
IconToggleButtonpara usar tokens do Material Design. (I7d263). - Tornamos públicos os construtores de
CheckboxColors,RadioButtonColorseSwitchColors. (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
ListHeadereListSubheaderdo 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
HorizontalPageIndicatorna 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
ExtraSmalldos ícones redondosTextButtoneTextToggleButtonporque 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
ToggleButtonpara material3 (I6bed6).
Mudanças na API
- Ativamos a anotação
FloatRangecomo 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,IconButtoneTextButtonde 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,CheckboxeRadioButton. (Ib918c). - Adicionamos
IconToggleButtoneTextToggleButtonao Material3, um botão de alternância circular com um único slot para ícone e texto, respectivamente. Para diferentes tamanhos deToggleButton, recomendamos usarModifier.touchTargetAwareSizecom os tamanhos fornecidos nos respectivos botões de alternância. (I9f015). - Adicionamos
ListHeadereListSubheaderaos nossos componentes do Material 3. (Ibaefe). - Adicionamos o Material3
SwipeToDismissBox, que chama o novo FoundationSwipeToDismissBoxe fornece valores de cores padrão do tema. (I275fb). - Adicionamos o
InlineSliderdo 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
RoundedCornerShapeem 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
InlineSliderColorsno 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).
SteppereInlineSlideragora aceitam cliques repetidos em pressionamentos longos para que você possa aumentar/diminuir rapidamente o valor deSteppereInlineSlidermantendo 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.rangeSemanticsos 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.foundationpara 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
TextButtonpara usar a função de extensãotoDisabledColorcom 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
TextButtonao Material3, um botão circular com um único slot para texto. Para diferentes tamanhos deTextButton, recomendamos usarModifier.touchTargetAwareSizeeExtraSmallButtonSize,SmallButtonSize,DefaultButtonSizeeLargeButtonSizeIconfornecidos emTextButtonDefaults. OTextButtonpadrã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, useTextButtoncom contorno e defina a borda comoButtonDefaults.outlinedButtonBorder. Para um meio-termo entre contorno e preenchimento, usefilledTonalTextButtonColors. (I667e4). - Adicionamos
Card,OutlinedCard,AppCardeTitleCardà biblioteca Wear Compose Material3.AppCardeTitleCardtambém podem receber a aparência de contorno usandoCardDefaults.outlinedCardColorseCardDefaults.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 construtoresButtonColorsagora 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
IconButtonao Material3, um botão circular com um único slot para ícone/imagem. Há quatro variações:IconButton,FilledIconButton,FilledTonalIconButtoneOutlinedIconButton. Para diferentes tamanhos deIconButton, recomendamos usarModifier.touchTargetAwareSizeeExtraSmallButtonSize,SmallButtonSize,DefaultButtonSizeeLargeButtonSizeIconfornecidos emIconButtonDefaults. Também fornecemosIconButtonDefaults.iconSizeForpara 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
DefaultTextStyleao Wear Compose Material 3, que define oPlatformTextStyle.includeFontPaddingcomo 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.