IU do Compose
androidx.compose.ui
androidx.compose.ui.geometry
androidx.compose.ui.graphics
androidx.compose.ui.platform
androidx.compose.ui.test
(Consulte os documentos de referência da API para acessar todos os pacotes do Compose)
Atualização mais recente | Versão estável | Versão candidata a lançamento | Versão Beta | Versão Alfa |
---|---|---|---|---|
11 de dezembro de 2024 | 1.7.6 | - | - | 1.8.0-alpha07 |
Estrutura
O Compose é uma combinação de sete IDs de grupos do Maven no androidx
. Os grupos
contêm um subconjunto direcionado de funcionalidades, cada um com um conjunto próprio de notas
da versão.
Esta tabela explica os grupos e contém links para cada conjunto de notas da versão.
Grupo | Descrição |
---|---|
compose.animation | Crie animações nos aplicativos Jetpack Compose para enriquecer a experiência do usuário. |
compose.compiler | Transforme funções @Composable e ative otimizações com um plug-in do compilador Kotlin. |
compose.foundation | Crie aplicativos do Jetpack Compose com elementos básicos prontos que podem ser usados para criar suas próprias peças de sistema de design. |
compose.material | Crie IUs do Jetpack Compose com componentes do Material Design prontos para uso. Este é o ponto de entrada de nível mais alto do Compose, projetado para fornecer componentes que correspondam aos descritos em www.material.io. |
compose.material3 | Crie IUs do Jetpack Compose usando componentes do Material Design 3, a nova versão do Material Design. O Material 3 inclui temas e componentes atualizados, além de recursos de personalização do Material You, como cores dinâmicas, e foi desenvolvido para ser coeso com o novo estilo visual do Android 12 e com a interface do sistema. |
compose.runtime | Elementos fundamentais do modelo de programação e do gerenciamento de estado do Compose e do ambiente de execução principal do plug-in Compose Compiler. |
compose.ui | Componentes fundamentais do Compose UI necessários para interagir com o dispositivo, incluindo layout, desenho e entrada. |
Declarar dependências
Para adicionar uma dependência ao Compose, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para 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.compose.ui:ui:1.7.5" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.ui:ui:1.7.5") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
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.
Versão 1.8
Versão 1.8.0-alpha07
11 de dezembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha07
. A versão 1.8.0-alpha07 contém estas confirmações.
Mudanças na API
- Proprietário exposto de
LayoutNode
para ferramentas. (I26f7f). - A composição local
LocalAutofillHighlightColor
usa um tipo de cor. (I0e05b). - O
UrlAnnotation
descontinuado e os métodos dele foram marcados como experimentais. (Ic0021).
Correções de bugs
- Correção da falha
IndexOutOfBoundsException
ao usarLinkAnnotation
dentro do elemento combinávelBasicText
ou Text (be7605, b/374115892). - Correção de um problema em que os campos de texto preenchidos com forma personalizada não cortavam a linha do indicador. (I4f87f, b/380704151).
- Correção de planos de fundo ausentes com capturas de tela longas. (I4d57a).
- Essa biblioteca agora usa anotações de nulidade JSpecify, que são de uso de tipo. Os desenvolvedores do Kotlin precisam usar os seguintes argumentos do compilador para aplicar o uso correto:
-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode
(Idfef8, b/326456246). - Atualização do suporte do Compose para cores HDR e de gama ampla ao executar no Android Q e versões mais recentes (Icd8be, b/379135036).
- As fontes de recurso que não carregam agora usam a fonte padrão em silêncio, em vez do comportamento anterior de gerar uma exceção na medida. (Ib6a49).
- Correção da perda de foco quando
AndroidView
é desconectado e conectado (I53446). - Aceita
requestFocus()
da ação de layout fora dos limites. (Ia8461).
Contribuição externa
- Adição de
BringIntoViewResponderModifierNode
à interface, que oferece uma nova maneira de implementar a funcionalidade "Bring Into View" e permite a implementação no nível da plataforma. (Ia6dd8).
Versão 1.8.0-alpha06
13 de novembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha06
. A versão 1.8.0-alpha06 contém estas confirmações.
Mudanças na API
- Adiciona o modificador
stylusHoverIcon
. (Iff20a, b/331289114). - O gerenciador de preenchimento automático foi alterado para ser uma interface. (I84914, b/376080755).
- Adiciona
requestFocus(FocusDirection)
afocusRequester
eFocusTargetModifierNode
para permitir o foco em uma direção específica. (I5d9ec, b/245755256). FocusProperties.enter
eFocusProperties.exit
foram substituídos poronEnter
eonExit
, usando um escopo de receptor em vez do parâmetroFocusDirection
. (I6e667).- Adição de suporte a preenchimento automático na barra de ferramentas de texto. (Ie6a4c).
- Mudanças na API para
Modifier.focusRestorer()
(I99c03):- O nome do parâmetro foi alterado para "fallback"
- O parâmetro agora é um
FocusRequester
, e não uma lambda - O parâmetro agora não é NULL com Default como o valor padrão
- A anotação
@Experimental
foi removida da interface do gerenciador de preenchimento automático. O recurso ainda está em desenvolvimento para esta versão, mas não queremos introduzir a API @Experimental (Id8398). - O
LocalHapticFeedback
agora oferece uma implementação padrão deHapticFeedback
quando a API Vibrator indica que há suporte para háptica. Os seguintes valores foram adicionados aHapticFeedbackType
:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Os componentes de clique longo do Wear Compose, comoButton
,IconButton
,TextButton
eCard
, agora executam a resposta tátilLONG_PRESS
quando um manipulador de clique longo é fornecido. (I5083d). - Remove
OverscrollConfiguration
eLocalOverscrollConfiguration
e adicionarememberPlatformOverscrollFactory
para criar uma instância de / personalizar parâmetros da implementação padrão de rolagem. Para desativar o overscroll, useLocalOverscrollFactory provides null
em vez deLocalOverscrollConfiguration provides null
. Para mudar a cor / padding do brilho, useLocalOverscrollFactory provides rememberPlatformOverscrollFactory(myColor, myPadding)
em vez deLocalOverscrollConfiguration provides OverscrollConfiguration(myColor, myPadding)
. (Ie71f9, b/255554340, b/234451516). - A API
GlobalAssertions
experimental foi removida. O uso pretendido era executar verificações de acessibilidade. Para isso, consulteenableAccessibilityChecks()
. (I59322).
Versão 1.8.0-alpha05
30 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha05
. A versão 1.8.0-alpha05 contém estas confirmações.
Novos recursos
O preenchimento automático está exposto por uma flag de recurso nesta versão. Estamos trabalhando para melhorar o desempenho e queremos receber feedback inicial sobre as APIs. As APIs vão evoluir antes da versão estável com base no feedback.
- Para ativar o Preenchimento automático, defina
ComposeUiFlags.isSemanticAutofillEnabled
como verdadeiro emonCreate
e use o Snapshot mais recente do Compose. - Essa versão do preenchimento automático oferece suporte ao salvamento manual de credenciais, com a sugestão de senhas fortes e a navegação. Ele também oferece suporte ao preenchimento quando um campo de preenchimento automático recebe o foco ou quando o preenchimento automático é acionado pela barra de ferramentas de texto em componentes de texto. O componente vai ficar destacado para indicar quando o preenchimento automático for concluído.
Mudanças na API
- Modifique a interface de preenchimento automático para seguir a estrutura
expect
/actual
. (I22dce). - Introdução do
CompositionLocal
, que pode ser usado para modificar a tonalidade do destaque de preenchimento bem-sucedido do preenchimento automático. (I32092). - Foi adicionada a API
Modifier.onRectChanged
, que permite assinar a posição e o tamanho relativos à raiz/janela/tela de umLayoutNode
. A API resolve muitos casos de uso que o modificadoronGloballyPositioned
atual resolve, mas com muito menos sobrecarga. Além disso, a API vem com recursos para filtrar e limitar o callback de acordo com as demandas do caso de uso. (Id28c7, b/372765423, b/372757007, b/372994338). - O gerenciador de preenchimento automático foi expandido para incluir as APIs
commit()
ecancel()
, que ajudam os usuários a salvar as credenciais recém-inseridas. (I2da00). - Apresentamos a nova interface
AutofillManager
, que pode ser usada para ajustar a jornada de preenchimento automático dos usuários, e uma flagisSemanticAutofillEnabled
para ativar essa nova versão. (I9d484). - Foi adicionada a API
Modifier.onRectChanged
, que permite assinar a posição e o tamanho relativos à raiz/janela/tela de umLayoutNode
. A API resolve muitos casos de uso que o modificadoronGloballyPositioned
atual resolve, mas com muito menos sobrecarga. Além disso, a API vem com recursos para filtrar e limitar o callback de acordo com as demandas do caso de uso. (I3c8fa). - Adição de propriedades semânticas e tipos de dados para suporte estendido ao preenchimento automático. (I52c7d).
- Todos os métodos no builder
AnnotatedString
agora não são experimentais (Ia89c8, b/261561823).
Correções de bugs
- As visualizações incorporadas ao Compose agora podem receber eventos de seletor giratório se estiverem em foco (I4d53a, b/320510084).
- Correção de um problema em que vários tipos de recursos não eram atualizados nas mudanças de configuração (Ia9b99, b/352336694).
- Correção de um problema que impedia o funcionamento correto do
TextField
ao usar o teclado japonês POBox em alguns dispositivos Sony mais antigos. (Ia9b99, b/373743376). - Correção de um problema com caixas de diálogo exibidas na parte de baixo da tela em vez de centralizadas (Ia2ec, b/373093006).
- A segmentação da API 35+ não força mais as caixas de diálogo a ter
decorFitsSystemWindows
definido como falso. (Ibc94, b/364492593). - Correção de uma falha quando as camadas são movidas entre janelas (por exemplo, caixa de diálogo e conteúdo principal) (I675ba, b/330955281).
Versão 1.8.0-alpha04
16 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha04
. A versão 1.8.0-alpha04 contém estas confirmações.
Mudanças na API
- Adição de callbacks
DelegatableNode#onDensityChange
eDelegatableNode#onLayoutDirectionChange
para permitir a atualização do estado do nó quando ele mudar (I04f3e, b/340662451). - Adiciona
WindowInfo#containerSize
para fornecer o tamanho do contêiner de conteúdo da janela atual. Isso pode ser recuperado usandoLocalWindowInfo
. (Idc38c, b/369334429, b/360343819). - Introdução de uma correção para rolagens aninhadas que são removidas da árvore de nós durante uma movimentação contínua. Agora esses nós vão cancelar o movimento rápido e enviar corretamente o evento
onPostFling
com a velocidade restante. Também estamos lançando a flagNewNestedScrollFlingDispatchingEnabled
para controlar o comportamento em caso de regressões. A flag será removida antes da versão Beta. (I05c37, b/371168883). - O
PointerInputModifierNode#touchBoundsExpansion
foi introduzido. Ele pode ser usado para ampliar os limites de toque de um modificador de entrada de ponteiro único. (Iccf02, b/335339283). - Adiciona
WindowInfo#containerSize
para fornecer o tamanho do contêiner de conteúdo da janela atual. Isso pode ser recuperado usandoLocalWindowInfo
. (I27767, b/369334429, b/360343819). readOnly
foi removido deTextFields
para fixar na versão estável da base. (I3aaba).Paragraph
eParagraphIntrinsics
agora recebem uma lista de todas as anotações aplicadas aoAnnotatedString
. Anteriormente, eles só tinham uma lista deSpanStyles
(I12f80).
Correções de bugs
- Atualizamos a forma como os parágrafos são tratados em
AnnotatedString
. Antes, você só podia criar parágrafos não sobrepostos. Agora, oAnnotatedString
permite parágrafos totalmente sobrepostos que serão mesclados e parágrafos aninhados, em que o parágrafo externo será dividido nos limites do interno, e o estilo do parágrafo interno será mesclado com o estilo do parágrafo externo (Ic9554). - Correção de falha em
AnnotatedString
com umLinkAnnotation
de comprimento zero. (89aac6).
Versão 1.8.0-alpha03
2 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha03
. A versão 1.8.0-alpha03 contém estas confirmações.
Mudanças na API
- Atualização da versão do Kotlin para 1.9 (I1a14c).
- Foi introduzido um novo papel de semântica chamado "Carousel" para emular o comportamento da lista em paginadores para serviços a11y. (Id354b, b/354109776, b/239672673).
invisibleToUser()
foi renomeado comohideFromAccessibility
. A função dele permanece a mesma. Consulte a documentação para mais detalhes. (Ib43a3).
Correções de bugs
- Atualização dos documentos do modificador
SensitiveContent
(Ib0442). - Correção de um problema em que alguns clipes de contorno genéricos eram ignorados em combinação com sombras de elevação em algumas versões do Android
- Correção de um problema em que clipes vazios eram aplicados quando um clipe de contorno genérico era especificado em determinadas versões do Android
- Correção de uma exceção gerada quando o IME está ativo em uma visualização externa e a ação "Próxima" é usada para entrar no foco na
ComposeView
. O comportamento declearFocus()
está alinhado com o comportamento de visualização na API < 28, em queclearFocus()
pode fazer com que a visualização padrão seja focada. - Correção de um problema em que a inserção ocorria em nós separados em
LazyList
, separando o gerenciamento da subcomposição para diferentes passagens de layout. - Correção de um problema em que o teclado de software piscava quando o foco mudava de um
TextField
para umEditText
ou qualquer outro editor baseado em visualização. - Os nós de rolagem aninhados agora enviam eventos
onPostFling
corretamente depois de serem desconectados. - Melhorias gerais de desempenho
Versão 1.8.0-alpha02
18 de setembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha02
. A versão 1.8.0-alpha02 contém estas confirmações.
Mudanças na API
TextOverflow.StartEllipsis
eTextOverflow.MiddleEllipsis
agora estão disponíveis, o que permite colocar reticências no início ou no meio da linha do texto de uma única linha. (I38913, b/185418980).
Correções de bugs
- Correção da
dismissOnClickoutside
do Dalog (39a3d, b/364508685). - Não há mais cortes de sombras do conteúdo da caixa de diálogo (e8e2f, b/363027803).
- Correção de comportamento incorreto quando a pesquisa de foco se move entre o Compose e uma visualização (58377, b/350534714).
Contribuição externa
- O
Map
AlignmentLines
agora aceita tipos concretosVerticalAlignmentLine
ouHorizontalAlignmentLine
. (I02912). - Novo método
ByteArray.decodeToImageBitmap(): ImageBitmap
comum. (I83c21).
Versão 1.8.0-alpha01
4 de setembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.8.0-alpha01
. A versão 1.8.0-alpha01 contém estas confirmações.
Versão 1.7
Versão 1.7.6
11 de dezembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.6
. A versão 1.7.6 contém estas confirmações.
Correções de bugs
- Antes, um erro era gerado sempre que um evento principal era encontrado quando o sistema de foco tinha invalidações pendentes. Agora registramos um erro (I7ea0, b/346370327).
- A anotação experimental foi removida de
SemanticsPropertyReceiver.invisibleToUser()
. Ele será descontinuado na versão 1.8 e substituído porSemanticsPropertyReceiver.hideFromAccessibility()
. (I448f0, b/376479686). - Correção de um problema que impedia o funcionamento correto do
TextField
ao usar o teclado japonês POBox em determinados dispositivos Sony mais antigos. (I94e0e, b/373743376). - Correção de um problema de acessibilidade em que o conteúdo inline de
BasicText
não era anunciado porTalkBack
(I67bcb, b/376479686).
Versão 1.7.5
30 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.5
. A versão 1.7.5 contém estas confirmações.
Correções de bugs
- Correção de problemas em que a elevação e o corte com contornos personalizados não eram renderizados corretamente.
- Correção de uma falha de texto que ocorre com uma
LinkAnnotation
de largura zero. (Ic1e2e). - Corrige um aviso em
Talkback
do botão quando ele é criado como um elemento combinável de texto clicável. (I1f588).
Versão 1.7.4
16 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.4
. A versão 1.7.4 contém estas confirmações.
Versão 1.7.3
2 de outubro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.3
. A versão 1.7.3 contém estas confirmações.
Correções de bugs
- Correção do problema em que a especificação de um clipe de contorno genérico levava a um limite de clipe vazio em algumas versões do Android
- Correção de uma exceção gerada quando o IME está ativo em uma visualização externa e a ação "Próxima" é usada para entrar no foco na
ComposeView
. O comportamento declearFocus()
está alinhado com o comportamento de visualização na API < 28, em queclearFocus()
pode fazer com que a visualização padrão seja focada. - Correção de um problema em que uma
placeOrder
incorreta era usada para invalidação de previsão, corrigindo um caso extremo em que a inserção de previsão era ignorada
Versão 1.7.2
18 de setembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.2
. A versão 1.7.2 contém estas confirmações.
Correções de bugs
- Melhoria no desempenho de informações de nó de acessibilidade e eventos de semântica com a remoção do rastreamento detalhado. (I89156, b/362530618).
- O
ComposeView
não falha mais quando é transmitido com um tamanho de medição excepcionalmente grande (da5db, b/347036173). - Correção de um problema no leitor de tela de acessibilidade em que os avisos
LiveRegion
em botões não eram feitos (f66fa7, b/348590026).
Versão 1.7.1
10 de setembro de 2024
- Não há mudanças nos artefatos do Android. Os artefatos
-desktop
foram removidos, e os artefatos-jvmStubs
e-linuxx64Stubs
foram adicionados. Nenhuma dessas metas é destinada a ser usada. Elas são marcadores de posição para ajudar os esforços do Jetbrains Compose.
Versão 1.7.0
4 de setembro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0
.
Mudanças importantes desde a versão 1.6.0
As mudanças importantes na versão 1.7.0 são abordadas neste post do blog.
Versão 1.7.0-rc01
21 de agosto de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-rc01
. A versão 1.7.0-rc01 contém estas confirmações.
Mudanças importantes
- O módulo ui:ui agora força o requisito de uma versão mínima de foundation:foundation de pelo menos 1.7.0-rc01 ou mais recente. Isso é aplicado para corrigir uma incompatibilidade de comportamento entre a interface e a base em relação às mudanças de
NestedScrollSource
que ocorreram no início da versão 1.7.0-alpha01.
Versão 1.7.0-beta07
7 de agosto de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta07
. A versão 1.7.0-beta07 contém estas confirmações.
Correções de bugs
- As funções
SemanticsNodeInteraction
relacionadas à entrada de textoperformTextReplacement
,performTextInput
eperformTextClearance
agora vão gerar erros de declaração quando forem chamadas emTextFields
somente leitura. (I4ae8f).
Versão 1.7.0-beta06
24 de julho de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta06
. A versão 1.7.0-beta06 contém estas confirmações.
Versão 1.7.0-beta05
10 de julho de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta05
. A versão 1.7.0-beta05 contém estas confirmações.
Correções de bugs
- Correção de um bug em que a mudança do teclado de software fazia com que
TextField
não aceitasse a entrada do novo teclado até que o foco fosse perdido e recuperado - Correção de um problema em que as tentativas de manter o conteúdo da camada causavam efeitos colaterais indesejados ao renderizar com conteúdo
SurfaceView
.
Versão 1.7.0-beta04
26 de junho de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta04
. A versão 1.7.0-beta04 contém estas confirmações.
Correções de bugs
- Evitar falhas ao medir linhas de texto muito grandes (por exemplo, 10.000 caracteres) (8157ab).
- Desative o suporte à renderização de software para a API
GraphicsLayer
. (35ddd8). - Correção de uma falha na lógica de persistência de camadas. (70b13e).
- A otimização de reutilização de objetos de camada foi revertida, porque causava problemas de renderização. (70b13e).
Versão 1.7.0-beta03
12 de junho de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta03
. A versão 1.7.0-beta03 contém estas confirmações.
Versão 1.7.0-beta02
29 de maio de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta02
. A versão 1.7.0-beta02 contém estas confirmações.
Mudanças na API
SemanticsProperties.Editable
foi renomeado comoIsEditable
eSemanticsPropertyReceiver.editable
foi alterado paraisEditable
A propriedade agora é booleana e sempre especificada por campos de texto. (I8acd8).- Renomear o parâmetro de comparação de acessibilidade. (I3d440).
- API atualizada para estilizar os links:
TextLinkStyles
agora faz parte do construtorLinkAnnotation
e do métodoAnnotatedString.fromHtml
(I90b2b). OTextDefaults
também foi removido do material (I5477b).
Correções de bugs
- O
LayoutCoordinates.introducesFrameOfReference
foi renomeado comoLayoutCoordinates.introducesMotionFrameOfReference
para refletir melhor a finalidade dele. A função relacionada foi renomeada para calcular coordenadas com base nessa flag. (I3a330).
Versão 1.7.0-beta01
14 de maio de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-beta01
. A versão 1.7.0-beta01 contém estas confirmações.
Mudanças na API
performCustomAccessibilityActionLabelled
foi renomeado comoperformCustomAccessibilityActionWithLabel
, eperformCustomAccessibilityActionWhere
foi renomeado comoperformCustomAccessibilityActionWithLabelMatching
(I5387f).- O valor
AnnotatedString.hasEqualsAnnotations
agora éhasEqualAnnotations
(I685c0). - Atualizamos a API para receber links com temas do Material Design no texto. Especificamente, foram removidos os métodos do
TextDefaults
para a construção deLinkAnnotations
temáticos e a análise de HTML com links temáticos. Em vez disso, foi adicionada uma classeTextLinkStyles
que permite estilizar os links como um parâmetro para o elemento combinável de texto. (I31b93).
Correções de bugs
- Correção de outros casos de uso ao adicionar dinamicamente modificadores de entrada de ponteiro durante eventos 63e1504
Versão 1.7.0-alpha08
1º de maio de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha08
. A versão 1.7.0-alpha08 contém estas confirmações.
Mudanças na API
- Adiciona suporte a implementações de forma mutável. O
Shape#createOutline
agora é observado dentro de camadas gráficas. Portanto, a leitura de valores de estado dentro delas vai causar invalidações quando o estado mudar, permitindo animações de forma com mais desempenho. (Id1629, b/326070216). isPositionedByParentWithDirectManipulation
foi renomeado comointroducesFrameOfReference
Agora, ele tem o efeito reverso, o que significa que, por padrão, a maioria dosLayoutCoordinates
introduz um frame de referência e, somente quando colocado sob manipulação direta, a propriedade será falsa. Para consultar a posição apenas com aqueles que introduzem um marco de referência, usepositionInLocalFrameOfReference(...)
. OupositionInLocalLookaheadFrameOfReference
de umLookaheadScope
. (Ifc5f7).- As APIs
LookaheadScope
foram estabilizadas (I21507). - Mudança da lambda de ação para
getScrollViewportLength
conforme o feedback do conselho da API. (Ibc74a). - As APIs de esboço
GraphicsLayer
foram atualizadas para consumir parâmetros de ponto flutuante em vez de int. Os valores de sentinelaUnsetOffset/UnsetSize IntSize
foram removidos em favor de constantes não especificadas já existentes em classes inline de tamanho e deslocamento com base em ponto flutuante (I2fb03, b/333863462). - Ao injetar entrada de mouse durante os testes,
MouseInjectionScope.click()
,MouseInjectionScope.doubleClick()
,MouseInjectionScope.tripleClick()
eMouseInjectionScope.longClick()
agora aceitam um parâmetrobutton: MouseButton
para serem mais aplicáveis universalmente. O valor padrão éMouseButton.Primary
para todos os métodos. (I31a23, b/190493367, b/261439695). onClicked
foi renomeado comoonClick
dentro deLinkInteractionListener
. (Iaa35c).TextInclusionStrategy.isInside
foi renomeado comoisIncluded
. Faça com que o tipo de retornoParagraph/MultiParagraph#getRangeForRect()
não seja anulável. (I51f26).
Correções de bugs
- Foi corrigida a captura de capturas de tela longas para contêineres de rolagem com
reverseScrolling=true
. (I7c59c).
Contribuição externa
- Foi adicionado suporte para pré-buscar itens em
LazyLists
aninhados (por exemplo, umLazyColumn
que renderizaLazyRows
aninhados). Essa mudança deve reduzir as quedas de frames durante a rolagem para essesLazyLists
. A implementação padrão é pré-carregar os dois primeiros itens aninhados, mas esse comportamento pode ser controlado pelas novas APIsLazyLayoutPrefetchStrategy(nestedPrefetchItemCount)
eLazyListPrefetchStrategy#onNestedPrefetch
. (I51952).
Versão 1.7.0-alpha07
17 de abril de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha07
. A versão 1.7.0-alpha07 contém estas confirmações.
Mudanças na API
ClickableText
está marcado como descontinuado. Para adicionar links ao texto, crie umAnnotatedString
com umLinkAnnotation
correspondente ao link e transmita esseAnnotatedString
ao elemento combinável de texto. (I34d4b, b/323346994).- Introdução de
ViewConfiguration.HandwritingGestureLineMargin
para gestos de escrita manual. Suporte ao gestoJoinOrSplit
paraBasicTextField
(Ie6e13, b/325660505). - A
FocusProperties.enter
e aFocusProperties.exit
não são mais experimentais.FocusDirection.Enter
eFocusDirection.Exit
não são mais experimentais. OFocusRequester.Cancel
não é mais experimental (I461a1, b/261564106). - Ao consultar as coordenadas do layout, agora é possível usar o argumento
excludeDirectManipulationOffset
para excluir o deslocamento definido pelos layouts pais que posicionaram os filhos usandoPlaceable.PlacementScope.withDirectManipulationPlacement
. Da mesma forma, um layout que muda a posição dos filhos com frequência agora pode posicioná-los usandowithDirectManipulationPlacement
(como Scroll, implementado por padrão). Isso ajuda as animações baseadas emapproachLayout
a serem mais intuitivas, tendo agora a oportunidade de diferenciar qual deslocamento animar e o que aplicar diretamente ao decidir animar a abordagem. (I60ec7). - A flag de recurso para capturas de tela longas foi removida. (I28648, b/329128246).
LazyColumn
agora renderiza cabeçalhos fixos corretamente em capturas de tela longas. (I8d239, b/329296635).- As origens de arrasto e deslizamento rápido
NestedScroll
estão sendo substituídas porUserInput
eSideEffect
para acomodar a definição estendida dessas origens, que agora incluem animações (efeito colateral) e a roda do mouse e o teclado (UserInput
). (I40579) ApproachLayoutModifierNode
eModifier.approachLayout
agora estão na versão estável, com novosisMeasurementApproachInProgress()
eisPlacementApproachInProgress()
para substituir os antigosisMeasurementApproachComplete()
eisPlacementApproachComplete()
, respectivamente.- Remoção de modificador
intermediateLayout
obsoleto (I3e91c). - O nome
GraphicsLayer#buildLayer
foi renomeado para gravar e espelhar os métodos de início/término da gravação das APIs com suporte à Displaylist, comoRenderNode
e Picture. - A
rememberGraphicsLayer
foi atualizada para aproveitarrememberObserver
. (I312c1, b/288494724, b/330758155). - O uso de
UrlAnnotation
foi descontinuado. UseLinkAnnotation.Url
. Se você estiver usando a aplicação de temas do Material Design, use o objetoTextDefaults
para criar a anotação com a aplicação de temas do Material Design (I8d180, b/323346545). - Os links de texto receberam a opção de estilo de estado pressionado, além do estilo normal, com o cursor sobre e com foco (I5f864, b/139312671).
- O elemento
String.parseAsHtml
foi renomeado comoAnnotatedString.Companion.fromHtml
. (I43dcd). - Adição de argumentos de estilo (
linkStyle
,focusedLinkStyle
,hoveredLinkStyle
) e um listener de interação de link ao métodoparseAsHtml
. Ao analisar a string com tags HTML com tags<a>
, o método vai construir umLinkAnnotation.Url
para cada uma dessas tags e transmitir os objetos de estilo e o listener de interação com o link para cada anotação. (I7c977). - A
LinkAnnotation
agora usa os argumentos de estilo com base no estado e umLinkInteractionListener
. Adicione essa anotação aoAnnotatedString
para criar um hiperlink. Ao transmitirfocusedState
e/ouhoveredState
, é possível definir oconfiguration
visual para links quando eles estão focados e/ou com o cursor. (I81ce4, b/139312671). ImeOptions.hintLocales
não é mais anulável. Se você quiser transmitir uma lista de localidades vazia, useLocaleList.Empty
. (Ic5bc4).
Correções de bugs
- Processa com eficiência dados de eventos de entrada históricos inválidos/corrompidos (ignora dados de deslocamento inválidos).
- Correção de eventos de ponteiro inesperados quando um modificador de entrada de ponteiro é adicionado dinamicamente antes de outro modificador de entrada de ponteiro durante um fluxo de eventos de entrada de ponteiro ativo (por exemplo, entre um entrada de cursor e uma saída de cursor [mouse/stylus]).
Versão 1.7.0-alpha06
3 de abril de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha06
. A versão 1.7.0-alpha06 contém estas confirmações.
Novos recursos
- Foi adicionado o método
parseAsHtml
para strings com estilo: ele permite converter uma string marcada com tags HTML emAnnotatedString
. Nem todas as tags são compatíveis. Por exemplo, ainda não é possível mostrar listas com marcadores. (I84d3d, I30626, b/139326648). - Implementamos o suporte experimental para capturas de tela longas em contêineres de rolagem do Compose usando a API oficial do Android (
ScrollCaptureCallback
). Esse recurso é experimental e pode não processar todos os casos corretamente. Por isso, ela está desativada por padrão. Para ativar, defina a flagComposeFeatureFlag_LongScreenshotsEnabled
como verdadeira. (I2b055, b/329296471).
Mudanças na API
fun ClipEntry.getMetadata()
mudou paraval ClipEntry.clipMetadata
. (I50155).- As funções
ClipboardManager.getClipMetadata
eClipboardManager.hasClip
foram removidas. UseclipEntry.getMetadata()
para ler os metadados da entrada de clipe atual. Verifique também se o resultado deClipboardManager.getClip
é nulo ou não para entender se a área de transferência tem um clipe atual. (I50498). - Agora é possível transmitir objetos
GraphicsLayer
para funçõesplaceable.placeWithLayer()
(I1b22f). - Agora,
ClipboardManager.setClip
aceita null para limpar a área de transferência. (I7d2e9). - Foram adicionados IDs de recursos para ajudar a ocultar visualizações usadas como detalhes de implementação nas ferramentas de build (I99531).
- O método de suspensão
GraphicsLayer#toImageBitmap
foi adicionado para oferecer suporte à renderização do conteúdo de um bitmap em umGraphicsLayer
. Essa é uma operação de renderização com aceleração de hardware no nível 22 da API e mais recentes, que oferece suporte a mais de 99% de todos os dispositivos Android. No nível 21 da API do Android, isso volta para a renderização de software. (I9e114). - Método auxiliar para converter um
RectF
do Android emComposeRect
(I39925, b/325660505). - Todos os parâmetros
KeyboardOptions
agora têm um valor não especificado por padrão. O métodoKeyboardOptions.merge
foi adicionado. KeyboardOptions.autoCorrect
emautoCorrectEnabled
foi renomeado e transformado em anulável, em que nulo indica que nenhum valor foi especificado. (Ia8ba0, b/295951492).- A variante
BasicTextField(state)
eBasicSecureTextField
agora usamKeyboardActionHandler
em vez deKeyboardActions
para processar ações realizadas pelo teclado de software. (I58dda).
Versão 1.7.0-alpha05
20 de março de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha05
. A versão 1.7.0-alpha05 contém estas confirmações.
Novos recursos
- Introdução da nova API
GraphicsLayer
para registrar comandos de desenho em uma lista de exibição, além de outras propriedades que afetam a renderização da lista de exibição. Isso fornece um limite de isolamento para dividir uma cena complexa em partes menores que podem ser atualizadas individualmente sem recriar a cena inteira. As transformações feitas em umGraphicsLayer
podem ser feitas sem gravar novamente a lista de exibição. Ao contrário deModifier.graphicsLayer
,GraphicsLayer
permite a renderização de conteúdo combinável em outro lugar e é útil em casos de uso animados em que o conteúdo precisa ser renderizado em cenas diferentes.
Mudanças na API
GraphicsLayer.draw(Canvas)
não é mais uma API pública. Use a função de extensãoDrawScope.drawLayer(GraphicsLayer)
para desenhar a camada. (I7a7c0).restrictedConstraints()
foi dividida em dois métodos:fitPrioritizingWidth()
efitPrioritizingHeight()
(I6d7fd).- Introdução do stub
HardwareCanvas
para uso do Android L (I1c3b5, b/288494724). - Atualização do framework do Compose para expor uma composição
GraphicsContext
local com as implementações de proprietário,DelegateableNode
e modificadordrawWithCache
atualizadas para expor o acesso aoGraphicsContext
para acesso com escopo que limpa automaticamente as instânciasGraphicsLayer
quando os modificadores são desativados. (I64a2f, b/288494724). InterceptPlatformTextInput
foi introduzido para ajudar a escrever testes de baixo nível relacionados ao IME e outros casos de uso de baixo nível do IME. O uso dePlatformTextInputTestOverride
foi descontinuado. (I862ed, b/322680547).- A função de extensão
GraphicsLayer.setOutline(Outline)
foi adicionada. (Ib81f4). - Introdução do construtor de função
GraphicsContext
para criar uma fábrica e criar instâncias deGraphicsLayer
(Ib98d6, b/288494724). - A API
GraphicsLayer
foi exposta para oferecer flexibilidade definida pelo desenvolvedor na captura de comandos de desenho que podem ser usados para desenhar em outro lugar e também aplicar diferentes efeitos visuais ao resultado final. (I80245, b/288494724). - Apresente o
Paragraph#getRangeForRect
, que retorna um intervalo de texto coberto por uma determinada área retangular. (Iee516, b/325660505). - A substituição experimental de
BasicText
com o argumentoonLinkClicked
foi removida Uma API substituta para suporte a hiperlinks será lançada no futuro. (I107d5).
Correções de bugs
- Adição da definição de API expect/actual
GraphicsLayer
para oferecer suporte à captura e reprodução de comandos de desenho com efeitos visuais e transformações de composição opcionais. Introdução da interfaceGraphicsContext
para conter dependências gráficas, incluindo a criação e o gerenciamento de instânciasGraphicsLayer
. (I4a8d6, b/288494724). - Correção de um problema de interoperabilidade com a pesquisa de foco em uma dimensão, em que o foco ficava preso em uma
ComposeView
incorporada a outras visualizações (I08fd4).
Contribuição externa
- O
LocalLifecycleOwner
foi movido da interface do Compose paralifecycle-runtime-compose
para que as APIs auxiliares baseadas no Compose possam ser usadas fora da interface do Compose. Agradecemos a contribuição de Jake Wharton. (I6c41b, b/328263448). - Exiba consistentemente propriedades de ponto flutuante de viés em todos os subtipos de alinhamento baseados em viés. (I69f0f, b/328088992).
Versão 1.7.0-alpha04
6 de março de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha04
. A versão 1.7.0-alpha04 contém estas confirmações.
Mudanças na API
- Suporte ao recurso de escrita à mão com stylus para BasicTextField2 em dispositivos posteriores ao Android U. (I002e4).
- Nesta CL, estamos adicionando a ação semântica
GetScrollViewportLength
para encaminhar informações sobre os componentes rolados no Compose para o sistema a11y. Essa CL também aplica o uso dessa propriedade nas listas roláveis do Foundation. (Ic5fa2). - O
FocusRequester.createRefs
agora é estável (I4d92c, b/261436820). - Introdução de
DelegatableNode.requireView()
para permitir que nós modificadores recebam oView
do Android atual sem ler um local de composição. (I40768). - Nova API
Path.reverse()
para reverter a direção de um caminho (I36348). hintLocales
foi adicionado aKeyboardOptions
para queTextFields
possa sugerir IMEs com localidades específicas para pré-definir um idioma preferido.- Expor a propriedade
platformLocale
deLocale
que retorna o objeto de plataforma, por exemplo,java.util.Locale
. (I921c6).
Versão 1.7.0-alpha03
21 de fevereiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha03
. A versão 1.7.0-alpha03 contém estas confirmações.
Mudanças na API
- Introdução ao
ContextualFlowRow
e aoFlowRow
/Column
aprimorado com MaxLines e Overflow. Temos o prazer de anunciar melhorias nas tagsFlowRow
eFlowColumn
experimentais, que agora oferecem suporte a maxLines e overflow, além da estreia deContextualFlowRow
eContextualFlowColumn
. Essa atualização foi projetada para fornecer componentes de desempenho ideais, em queContextualFlow*
é perfeito para um grande número de itens que usam uma pequena configuraçãomaxLines
e botões dinâmicos +N para ver mais, eFlowRow
eFlowColumn
são perfeitos para um pequeno número de itens, menos de 100. Importante: para manter o comportamento atual emFlowRow
ouFlowColumn
, em que todos os itens são compostos, independentemente de se encaixarem no eixo cruzado máximo, definaoverflow
comoFlowRowOverflow.Visible
ouFlowColumnOverflow.Visible
durante a inicialização. ConfiraContextualFlowRowSample
eFlowRowSample
para ver exemplos desses novos recursos em ação. (Ib9135, b/293577082). - Adição da propriedade semântica
maxTextLength
, que precisa ser definida em campos de texto que filtram o número máximo de caracteres permitidos. (I24d9f, b/170648072). - O wrapper
Modifier.inspectable
foi descontinuado. Essa API vai criar mais invalidações do modificador do que o necessário. Por isso, o uso dela não é recomendado. Recomendamos que os desenvolvedores implementem o métodoinspectableProperties()
emModifierNodeElement
se quiserem expor propriedades de modificador para ferramentas. (Ib3236). - Novo construtor para
PopupProperties
, que permite o controle total sobre as flagsWindowManager.LayoutParams
. (Ibb33e, b/312485503). DelegatableNode.requireLayoutCoordinates()
foi introduzido como uma maneira de acessar aLayoutCoordinates
atual de umModifier.Node
sem precisar substituironPlaced
e armazenar as coordenadas em uma propriedade. (Ia8657).DelegatableNode.currentLayoutCoordinates
foi introduzido como uma maneira de acessar aLayoutCoordinates
atual de umModifier.Node
sem precisar substituironPlaced
e armazenar as coordenadas em uma propriedade. (Iaebaa).BasicTextField2
e as APIs relacionadas no pacoteandroidx.compose.foundation.text2
foram movidas paraandroidx.compose.foundation.text
. (I9f635).- Adição de uma nova API
ApproachLayoutModifierNode
para oferecer suporte à criação de uma lógica de abordagem personalizada em um nó de modificador explícito. Também foi adicionada uma nova API experimentalDeferredTargetAnimation
para animações com destino desconhecido na instanciação. (I60745). - Novas APIs
Path
para consultar a direção de um caminho e extrair contornos de umPath
. (I63d04). - Foram adicionados
PathHitTest
ePath.contains(Offset)
para verificar se umPath
contém um ponto específico. (I3b218). - O
TextLayoutResult
agora expõe o métodogetLineBaseline(lineIndex)
. Isso permite ler a linha de base de uma linha arbitrária do texto, além das propriedades de conveniênciafirstBaseline
elastBaseline
. (Ide4e8, b/237428541). - Foi adicionado um método para comparar apenas as anotações de dois
AnnotatedStrings
. (I32659).
Correções de bugs
- Correção de um problema de compatibilidade com versões anteriores com
SemanticsPropertyReceiver.performImeAction
eSemanticsActions.PerformImeAction
(Id0528, b/322269946).
Versão 1.7.0-alpha02
7 de fevereiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha02
. A versão 1.7.0-alpha02 contém estas confirmações.
Mudanças na API
- Correção de um problema de compatibilidade binária com
SemanticsPropertyReceiver.performImeAction
(I65865, b/322269946). - O construtor
PopupProperties
que usa um parâmetrousePlatformDefaultWidth
não é mais experimental. (I8f8d2). - Foi adicionada uma sobrecarga de
ComposeTestRule.waitUntil
que recebe uma descrição de string da condição a ser incluída na mensagem de tempo limite. (I9413e). - Nova API de semântica
unset()
para remover propriedades de semântica adicionadas na mesma cadeia de modificadores. Nova propriedade semânticaisOpaque
. (I8c583, b/317966058, b/246056649). - O
originalEventPosition
foi removido do método de cópia na API pública dePointerInputChange
(I7bead).
Correções de bugs
- Correção de um bug do a11y que permitia que elementos que não são guias e botões de opção fossem clicáveis quando selecionados. (I2181c).
VelocityTracker
agora terá a correção para adicionar pontos por padrão. A correção ainda pode ser desativada definindoVelocityTrackerAddPointsFix
como falso se houver algum problema. (Ib3877, b/269487059).- Correção da incompatibilidade do binário com versões anteriores em
TextStyle
eParagraphStyle
(I179f0, b/320819734).
Contribuição externa
- Adição de um novo construtor
DialogProperties
sem parâmetros específicos da plataforma. (I45829). - Adição de um novo construtor
PopupProperties
sem parâmetros específicos da plataforma. (I9a038).
Versão 1.7.0-alpha01
24 de janeiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.7.0-alpha01
. A versão 1.7.0-alpha01 contém estas confirmações.
Mudanças na API
ClipboardManager
foi expandido com a adição deClipEntry
eClipMetadata
para oferecer suporte a conteúdo arbitrário, como imagens.- A API
DeviceConfigurationOverride
foi adicionada aoui-test
para permitir a substituição local do comportamento do conteúdo em teste, como especificar um tamanho, local, direção de layout, escala de fonte ou tema disponíveis.
Versão 1.6
Versão 1.6.8
12 de junho de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.8
. A versão 1.6.8 contém estas confirmações.
Correções de bugs
- Correção de inconsistências na escala de fontes quando a escala de fontes é menor que a tabela definida mais baixa. Nesse caso, agora interpolamos entre a escala linear 1x e a tabela definida mais baixa, para que o tamanho da fonte aumente monotonicamente conforme as escalas aumentam. (Icbae3).
Versão 1.6.7
1º de maio de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.7
. A versão 1.6.7 contém estas confirmações.
Versão 1.6.6
17 de abril de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.6
. A versão 1.6.6 contém estas confirmações.
Correções de bugs
- Correção de uma falha rara de
BasicTextField
Versão 1.6.5
3 de abril de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.5
. A versão 1.6.5 contém estas confirmações.
Versão 1.6.4
20 de março de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.4
. A versão 1.6.4 contém estas confirmações.
Versão 1.6.3
6 de março de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.3
. A versão 1.6.3 contém estas confirmações.
Versão 1.6.2
21 de fevereiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.2
. A versão 1.6.2 contém estas confirmações.
Versão 1.6.1
7 de fevereiro de 2024
Lançamento do androidx.compose.ui:ui-*:1.6.1
. A versão 1.6.1 contém estas confirmações.
Correções de bugs
- Correção de um problema de compatibilidade com versões anteriores com
SemanticsPropertyReceiver.performImeAction
eSemanticsActions.PerformImeAction
(Ie0bb2, b/322269946). - Os layouts agora geram um erro ao medir quando um retorna um tamanho anormalmente grande. Esse tipo de erro normalmente acontece quando a medição usa restrições máximas diretamente sem verificar
Constraints.Infinity
. A verificação vai ajudar os desenvolvedores a encontrar problemas com o layout que tem o tamanho errado, em vez de um layout que o contém. (I339a9).
Versão 1.6.0
24 de janeiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.0
. A versão 1.6.0 contém estas confirmações.
Versão 1.6.0-rc01
10 de janeiro de 2024
Lançamento de androidx.compose.ui:ui-*:1.6.0-rc01
. A versão 1.6.0-rc01 contém estas confirmações.
Correções de bugs
- Implementação otimizada de gráficos vetoriais para melhorar a performance minimizando recomposições adicionais.
Versão 1.6.0-beta03
13 de dezembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-beta03
. A versão 1.6.0-beta03 contém estas confirmações.
Novos recursos
- Agora é possível que um
LayoutCoordinates
seja desconectado sem que o nó seja desconectado. Proteção contra isso no Layout Inspector do Compose (If693).
Correções de bugs
PlatformImeOptions
agora é uma classe concreta em vez de uma interface. (If40a4).- Correção de recomposições downstream extras causadas por
LocalSoftwareKeyboardController
eLocalTextInputService
que recebem novos valores sempre que uma raiz é recomposta. (I42190, b/310510985).
Versão 1.6.0-beta02
29 de novembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-beta02
. A versão 1.6.0-beta02 contém estas confirmações.
Versão 1.6.0-beta01
15 de novembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-beta01
. A versão 1.6.0-beta01 contém estas confirmações.
Mudanças na API
- O modificador
DragAndDropTarget
agora recebe oDragAndDropTarget
explicitamente e tem uma lambda para ativar uma sessão de arrastar e soltar. Agora há duas funções de fábrica para umDragAndDropModifierNode
. Um para receber transferências e outro para transferir dados (I69481). - O
maximumFlingVelocity
foi atualizado para ser representado como Float. Atualizamos a documentação para deixar mais claro o conceito demaximumFlingVelocity
. (I8adc7). onDragAndDropStart
na fábricaDragAndDropModifierNode
foi renomeado comoacceptDragAndDropTransfer
acceptsDragAndDropTransfer
foi adicionado ao modificadordragAndDropTarget
para aceitar uma sessão de arrastar e soltar Essa lambda retorna umDragAndDropTarget
viável se houver interesse em uma sessão de arrastar e soltar. Outras lambdas para processar eventos de arrasto foram substituídas por essa. Uma função de fábricaDragAndDropTarget
foi adicionada para receber de sessões de arrastar e soltar (Iebf3a).DragAndDropInfo
foi removido, porqueDragAndDropModifierNode.drag
agora usa parâmetros paratransferData
, tamanho de decoração e decoração de arrastoDrawScope
lambdaDragAndDropTarget
tem métodos para eventos de arrastar e soltar específicos em vez de ser um único método abstratoonDragAndDropEvent
na função de fábrica de umDragAndDropModifierNode
foi renomeado comoonDragAndDropStart
para comunicar melhor que oDragAndDropTarget
fornecido é válido apenas para uma determinada sessão de arrastar e soltarO
DragAndDropEventType
foi removido (I645b1).PlatformTextInputModifierNode.runTextInputSession
foi renomeado comoestablishTextInputSession
. (I03cd0).Melhoramos os nomes de API de nó que podem ser percorridos para torná-los mais compreensíveis. (Ia4474).
Substitua
OriginalText
porTextSubstitution
. (Ifa5a8).PlatformTextInputModifierNode.textInputSession
foi renomeado comorunTextInputSession
(Ie9c6b).Os filhos de
SubcomposeLayout
(e layouts comoLazyColumn
com base nele) que são retidos para serem reutilizados no futuro são considerados desativados. A nova API de testeassertIsDeactivated()
foi introduzida para testar esses nós. O restante das APIs de teste vai filtrar os nós desativados por padrão. (I2ef84, b/187188981).FocusDirection.In
eFocusDirection.Out
foram removidos. UseFocusDirection.Enter
eFocusDirection.Exit
(I2f660).As APIs
SwipeToReveal
do Material Design (para cards e ícones) agora dependem de uma API baseada em slot (como recomendado pelo Compose) em vez de instâncias baseadas em classe de dados para criar esses slots. Essa é uma mudança importante. Consulte a demonstração e o exemplo de código para conferir exemplos de como usar a nova API. (Ia8943).O construtor
FontStyle(int)
foi descontinuado. UseFontStyle.Normal
ouFontStyle.Italic
. (I66610).A interface
FontScalable
foi renomeada comoFontScaling
(Ie804a).
Correções de bugs
- O
SoftwareKeyboardController.show()
não vai mais mostrar o teclado de software se nenhum editor de texto estiver em foco. (I2165a, b/301477279). - Os eventos de tecla de hardware para chaves que não receberam um evento de desativação na mesma visualização do Compose agora serão ignorados. (Ib37b4, b/305518328).
- Adição de suporte ao renderizador para o gradiente em varredura em
ArcLine
. (I4d5bb). - Implemente equals e hashcode para
PageSize.Fixed
. (Ie3ede, b/300134276). - Correção do problema de compatibilidade binária com a mudança de margem da janela (Iee695).
- A camada principal do Material Design foi removida do ícone/botão do Material3, porque os microbenchmarks mostram um desempenho melhor sem ela. (I55555).
- Os
TestDispatcher
s transmitidos comoeffectContext
para os testes do Compose agora serão usados para criar os relógios de teste e de frame. (Ia7178).
Versão 1.6.0-alpha08
18 de outubro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha08
. A versão 1.6.0-alpha08 contém estas confirmações.
Mudanças na API
- A lambda
onDrawDragShadow
deModifier.dragAndDrawSource
foi renomeada comodrawDragDecoration
, e o parâmetro de tamanho deDragAndDropInfo
foi renomeado comodragDecorationSize
. (Id0e30, b/303904810). - Introdução de
SemanticsNodeInteraction.isDisplayed()
eSemanticsNodeInteraction.isNotDisplayed()
para verificar se um nó correspondente está visível ou não sem também declarar nele. (I2c196, b/302100809). - Introduzimos um valor
Unspecified
especial para os camposTextAlign
,TextDirection
,Hyphens
eLineBreak
doParagraphTextStyle
para substituirnull
. Como essas classes são in-line, ao substituir o nullable por "Unspecified", evitamos o boxing de tipo primitivo. Construtores, getters e outros métodos emTextStyle
e no estilo de parágrafo foram atualizados para aceitar os parâmetros mencionados como tipos não nulos. (I4197e, b/299490814). - Adição de sobrecarga de
GoogleFont
para ler umGoogleFont
do XML. (If8f59). - Tornou
LoremIpsum
PreviewParameterProvider
uma turma aberta. (I41bf5, b/266918816, b/300116360).
Correções de bugs
- A
FontFamilyResolver
agora usaDispatchers.Main
para corrotinas de gerenciamento de cache. (Ie8dd9). - O
AndroidViewBinding
agora remove de forma síncrona as instâncias deFragment
infladas, incluindo umFragmentContainerView
no layout como parte doonRelease
usandocommitNow
(em vez docommit
usado anteriormente), corrigindo problemas com o método do Editar ao vivo com a substituição da composição após as mudanças. (I58fbf).
Versão 1.6.0-alpha07
4 de outubro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha07
. A versão 1.6.0-alpha07 contém estas confirmações.
Mudanças na API
PlatformTextInputMethodTestOverride
foi introduzido para escrever testes para editores de texto personalizados. (Id159b).- Adiciona o modificador
dragAndDropSource
para iniciar sessões de arrastar e soltar e o modificadordragAndDropTarget
para receber de sessões de arrastar e soltar. (Ib7828, b/286038936). - Foram adicionadas coleções
ColorList
eColorSet
que evitam alocações. (I744bd). - A flag temporária
DisableNonLinearFontScalingInCompose
foi adicionada para desativar o dimensionamento de fonte não linear. DefinaDisableNonLinearFontScalingInCompose = true
nos seus testes se precisar de tempo para limpá-los. Essa flag será removida no Compose 1.6.0-beta01. (Ic9486).
Correções de bugs
- Análise otimizada de drawables vetoriais XML. (Ibb015).
Versão 1.6.0-alpha06
20 de setembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha06
. A versão 1.6.0-alpha06 contém estas confirmações.
Mudanças na API
- Otimizações adicionais nos ícones do Material Design. (I3e08d).
- Adiciona a capacidade de percorrer a árvore de modificadores para cima/para baixo para encontrar nós semelhantes. (I2d234).
- Adição do callback
onRestoreFailed()
ao modificadorfocusRestorer()
(Ie1d43). - Foram adicionadas anotações do androidx a várias APIs gráficas para especificar
ColorInt
,FloatRange
,IntRange
,Size
e muito mais. (Id65c8, b/290950582). showSystemUi=true
foi adicionado à definição dePreviewScreenSizes
(Ib61d3).
Mudanças de comportamento
- O Compose agora usa escala de fonte não linear para melhorar a legibilidade e a acessibilidade. Quando a escala da fonte for maior que 100% nas configurações do sistema, o texto pequeno vai aumentar de tamanho normalmente, mas o texto grande vai aumentar apenas um pouco. Além disso, as alturas de linha definidas em SP são ajustadas automaticamente para permanecerem proporcionais à altura pretendida da escala de 100%. Consulte as práticas recomendadas para dimensionamento de fontes para mais informações. (I11518)
Versão 1.6.0-alpha05
6 de setembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha05
. A versão 1.6.0-alpha05 contém estas confirmações.
Mudanças na API
- Ative a captura de conteúdo no
AndroidComposeViewAccessibilityDelegateCompat
. (Ib2969). - As velocidades de lançamento em componentes de visualização, como
ScrollView
eRecyclerView
, são limitadas aViewConfiguration.ScaledMaximumFlingVelocity
. O Compose agora contém a própria versão demaximumFlingVelocity
, que agora se aplica aDraggable
. (Ibf974). - Adição de lixeira inicial para oferecer suporte a APIs de arrastar e soltar da plataforma. (If84ce).
- Adição de
deviceId
aRotaryScrollEvent
(Iba3bf). - A API Devices
ui-tooling
foi atualizada para incluir dispositivos mais recentes (Ib25b4).
Versão 1.6.0-alpha04
23 de agosto de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha04
. A versão 1.6.0-alpha04 contém estas confirmações.
Mudanças na API
- Foi adicionado um método para desativar
ReusableComposition
, removendo observações, mas mantendo os nós no lugar. A composição desativada pode ser ativada novamente chamandosetContent
. (Ib7f31). - A interface
ReusableComposition
foi adicionada para gerenciar o ciclo de vida e a reutilização de subcomposições. (I812d1, b/252846775). - O
Modifier.focusGroup
foi promovido para APIs estáveis. (I7ffa3). - Foram adicionadas anotações do androidx a várias APIs gráficas para especificar
ColorInt
,FloatRange
,IntRange
,Size
e muito mais. (I70487, b/290950582). - A API
ColorFilter
foi atualizada para ter tipos de subclasses concretos para melhorar a capacidade de inspeção de parâmetros. (I5fe29). - A biblioteca wear-tooling-preview foi introduzida para listar dispositivos Wear válidos que podem ser usados para pré-visualizações de interface (Ib036e).
- A interface
FontScalable
foi criada para processar a parte de dimensionamento de fontes da interface Density. (I2cf3f).
Versão 1.6.0-alpha03
9 de agosto de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha03
. A versão 1.6.0-alpha03 contém estas confirmações.
Mudanças na API
- Novo tipo de transição de entrada/saída que dimensiona o conteúdo com base no tamanho do contêiner durante a animação de entrada/saída. A função e a interface combináveis
LookaheadScope
agora estão estáveis. (Ifb2ce). - Foi adicionado suporte à configuração de
privateImeOptions
(Idb772).
Correções de bugs
- O
PopupPositionProvider.calculatePosition
vai atualizar automaticamente a posição do pop-up quando o estado lido no cálculo for alterado. (I676a1, b/292257547). - Correção de campos de texto que mostram o teclado e podem ser editados quando
readOnly
é verdadeiro. Também corrigimos o teclado que não aparecia quandoreadOnly
era alterado de verdadeiro para falso enquanto estava em foco (I34a19, b/246909589). - Aplicação ampliada de declarações globais em testes de interface. (I1f90d).
Versão 1.6.0-alpha02
26 de julho de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha02
. A versão 1.6.0-alpha02 contém estas confirmações.
Mudanças na API
- Adicionamos uma interface de localizador de serviços que pode ser implementada por implementadores de composição, permitindo que uma implementação de composição delegue a outra composição a delegação de pesquisas de serviço para a composição original. Ele não deve ser chamado diretamente e é usado para ativar a criação de APIs experimentais no ambiente de execução que podem ser encontradas em versões agrupadas do Composer, como o módulo de interface. (I296b9).
- A API
PlatformTextInput*
foi redesenhada por completo. (I6c93a, b/274661182, b/267235947, b/277380808). - A
SoftwareKeyboardController
e aLocalSoftwareKeyboardController
não são mais experimentais.LocalSoftwareKeyboardController
também é umaCompositionLocal
adequada. (I4c364). LookaheadLayout
eLookaheadLayoutScope
foram descontinuados em algumas versões e agora foram removidos. As APIs de substituição sãoLookaheadScope
que podem funcionar com qualquer layout. (I12ac3).- A
SemanticsNodeInteraction.requestFocus
foi adicionada como uma maneira mais conveniente e detectável de solicitar o foco nos testes. (Ie8722). - Foram adicionadas APIs experimentais para registrar declarações globais, que serão usadas por frameworks de teste no futuro. (I12d77).
Correções de bugs
- A primeira invocação do callback
update
deAndroidView
agora será adiada até que a visualização seja anexada, em vez de ser executada quando a composição que introduz oAndroidView
for aplicada. Isso corrige um bug em que o callbackupdate
não era invalidado se um estado lido fosse modificado imediatamente por um efeito (Ie9438, b/291094055).
Versão 1.6.0-alpha01
21 de junho de 2023
Lançamento de androidx.compose.ui:ui-*:1.6.0-alpha01
. A versão 1.6.0-alpha01 contém estas confirmações.
Novos recursos
- Suporte a antecipação em
LazyList
. Isso permite queLazyList
na passagem de previsão ignore qualquer animação (por exemplo, animação de posicionamento de item,AnimatedVisibility
etc.) e calcule o tamanho e a posição da previsão para todas as filhas. Depois da transmissão de previsão, os filhos deLazyList
podem ser animados de forma independente da realidade, como visto na transmissão de previsão.
Mudança de comportamento: o includeFontPadding agora é falso por padrão no Compose
includeFontPadding
agora é falso por padrão (21d806) no Compose.
includeFontPadding
é um atributo legado que controla se é necessário incluir ou não padding extra na parte de cima da primeira e da última linha do texto para acomodar os caracteres que podem se estender acima ou abaixo das linhas de base do texto.
Atualizar essa versão do Compose vai modificar a renderização de todos os textos na interface, removendo o padding extra na parte de cima da primeira e da última linha de cada texto exibido.
Dependendo dos requisitos da interface e das métricas de fonte que você está usando, as mudanças serão mínimas. No entanto, você pode encontrar problemas, como: - Testes de capturas de tela corrompidos. Corrija a interface, se necessário, e gere novamente as imagens de referência. - O texto está ligeiramente desalinhado. Remova ou adicione paddings negativos personalizados, se necessário.
Você pode ativar o includeFontPadding
usando PlatformTextStyle
para cada texto:
Text(
text = myText,
style = TextStyle(
lineHeight = 2.5.em,
platformStyle = PlatformTextStyle(
includeFontPadding = true/false
)
/* … */
)
)
Você pode ativar o includeFontPadding
para todos os textos configurando seus estilos do Material. Os nomes dos parâmetros variam entre o M2 e o M3.
val Typography = Typography(
body1 = TextStyle(
fontFamily = /* … */,
fontSize = /* … */,
platformStyle = PlatformTextStyle(
includeFontPadding = false
)
/* … */
)
)
MaterialTheme(
typography = Typography,
/* … */
)
Saiba mais sobre o includeFontPadding
do Compose na documentação para desenvolvedores e nesta postagem do blog.
Se você tiver problemas/bugs relacionados a essa mudança, informe um bug usando o rastreador de problemas.
Mudanças na API
- Suporte a
InputConnection#requestCursorUpdates
(I0c69b). - Adição de
FocusRequester.saveFocusedChild
eFocusRequester.restoreFocusedChild
(Ic557e, b/272302679, b/275157318). - O tipo
ResourceResolutionException
foi adicionado para agrupar os throwables gerados ao tentar carregar recursos de bitmap com uma descrição do caminho do recurso que não foi carregado. (I19f44, b/230166331, b/278424788). - Acessibilidade otimizada para desempenho e alocações de memória. (Iede48).
- Adição de ações e propriedades semânticas para oferecer suporte à tradução de texto. (I4a6bc).
- Nova propriedade em
IntrinsincMeasureScope
e nas implementações dela (por exemplo,MeasureScope
) para indicar se a passagem de medida atual é uma passagem de previsão. (I7a812). - A API
DrawScope
foi atualizada para introduzir a capacidade de redirecionar a renderização para uma tela diferente com densidade/direção de layout e tamanho alternativos. - O
DrawContext
foi atualizado para oferecer suporte à configuração de densidade e direção do layout, além de tornar a tela configurável. (Ie1f9b, b/225408150). Paragraph#fillBoundingBoxes
foi adicionado para calcular caixas delimitadoras de caracteres. (If30ee).- Adição de um conjunto de
MultiPreviews
comuns (Ia5a27).
Correções de bugs
- A interface
FocusTargetModifierNode
foi adicionada e pode ser usada para criar umFocusTarget
personalizado. (I9790e). - Os parâmetros
fallback*
no construtorTextMeasurer
foram renomeados comodefault*
. (I940a5). SemanticsPropertyReceiver.performImeAction
foi renomeado comoonImeAction
, eSemanticsActions.PerformImeAction
foi renomeado comoOnImeAction
(I8e841).- A roda foi adicionada para diferenciar uma rolagem do mouse de um arrasto na rolagem aninhada (especificamente, em
NestedScrollConnection
). (Ie57e4) - Adição da API
asComposePaint
para substituirtoComposePaint
, já que o objeto retornado envolve oandroid.graphics.Paint
original (I22b4c). - O
SemanticsProperties.imeAction
foi descontinuado e substituído por um novo parâmetro paraSemanticsActions.performImeAction
. (I4a587). - Adição de suporte à seleção por mouse. A seleção por toque vai expandir por palavra e encolher por caractere. (Ic0c6c, b/180639271).
- Os métodos
Paragraph
que geravamAssertionError
para deslocamentos fora dos limites agora geramIllegalArgumentException
, comoMultiParagraph
. (I549d3, b/243338896).
Versão 1.5
Versão 1.5.4
18 de outubro de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.4
. A versão 1.5.4 contém estas confirmações.
Versão 1.5.3
4 de outubro de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.3
. A versão 1.5.3 contém estas confirmações.
Correções de bugs
- (b/301209788) Às vezes, o
TextField
aplicava comandos anteriores incorretamente ao focalizar e inserir entradas em coreano, o que levava à perda de caracteres.
Versão 1.5.2
27 de setembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.2
. A versão 1.5.2 contém estas confirmações.
Correções de bugs
- Adição de uma solução alternativa para falhas quando a API de rolagem de acessibilidade era acessada pela linha de execução em segundo plano.
- Correção de nós não conectados que são adicionados à árvore semântica.
Versão 1.5.1
6 de setembro de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.1
. A versão 1.5.1 contém estas confirmações.
Correções de bugs
- Correção de campos de texto que mostram o teclado e podem ser editados quando
readOnly
é verdadeiro. Também corrigimos o teclado que não aparecia quandoreadOnly
era alterado de verdadeiro para falso enquanto estava em foco (I34a19, b/246909589).
Versão 1.5.0
9 de agosto de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0
. A versão 1.5.0 contém estas confirmações.
Versão 1.5.0-rc01
26 de julho de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-rc01
. A versão 1.5.0-rc01 contém estas confirmações.
Correções de bugs
- Correção de uma falha que ocorria quando
SubcomposeLayout
era usado dentro demovableContentOf()
.
Versão 1.5.0-beta03
28 de junho de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-beta03
. A versão 1.5.0-beta03 contém estas confirmações.
Correções de bugs
- Adição da interface FocusTargetModifierNode, que pode ser usada para criar um FocusTarget personalizado. (Ifb1d6).
- Correção de um problema com elementos combináveis de caixa de diálogo e pop-up que podiam fazer com que a janela filha não fosse redimensionada como esperado quando
usePlatformDefaultWidth=true
. (I112ee).
Versão 1.5.0-beta02
7 de junho de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-beta02
. A versão 1.5.0-beta02 contém estas confirmações.
Mudanças na API
- Adição da API
asComposePaint
para permitir o consumo de uma instânciaandroid.graphics.Paint
no Compose
Correções de bugs
- Adição da API
asComposePaint
para substituirtoComposePaint
, já que o objeto retornado envolve oandroid.graphics.Paint
original (I22b4c).
Versão 1.5.0-beta01
24 de maio de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-beta01
. A versão 1.5.0-beta01 contém estas confirmações.
Mudanças na API
- Alocações removidas em recomposição, animações de cores e
AndroidComposeView
(Ib2bfa). - Foi adicionado o auxiliar divertido
CacheDrawModifierNode()
para permitir a delegação (Icf8f9). - Apresentação da propriedade
isLookingAhead
, acessível emMeasureScope
, para observar os resultados de previsão e influenciar o cartão principal, se necessário. (Ibf4c3). - Nova propriedade de semântica
traversalIndex
, um float usado para reordenar nós na travessiaTalkBack
(valores mais baixos vêm antes). (I9a81b, b/186443263). - Renomeação da propriedade semântica
isContainer
paraisTraversalGroup
(I121f6). ColorProducer
agora tem umoperator fun invoke
em vez deproduce
(I4a9a2).- A API de transformação
Path
foi adicionada para aplicar transformações de translação/escala/rotação a objetos de caminho. (I23434, b/233772232). - O método de
ColorProducer
é chamado deproduce
. (I78bde). toFrameworkColorSpace
foi renomeado comotoAndroidColorSpace
(I4f547).ColorLambda
foi renomeado comoColorProducer
. (I73b1a).- Introdução de APIs para converter entre os tipos de espaço de cores do Android e do Compose. (Ie7db4, b/279979665).
- Um parâmetro de cor foi adicionado a
BasicText
para permitir a animação ou a configuração eficiente da cor do texto (Iffd88, b/246961787). TextRange.constrain
foi renomeado comoTextRange.coerceIn
(I31be2).- Adição de
TextStyle.merge(...)
otimizado com a lista de parâmetros completa. (Iad234, b/246961787). - Estabilização de várias APIs de texto, incluindo
Brush
,DrawStyle
,TextMotion
,DrawScope.drawText
,Paragraph.paint(Brush)
eMultiParagraph.paint(Brush)
. (I2f740, b/261581564, b/261581931, b/261561245). - O uso de
PlatformTextStyle.includeFontPadding
não foi descontinuado. Nossa intenção original era remover o campo, mas o feedback mostra que os desenvolvedores precisam dessa opção de configuração. Portanto, a descontinuação foi removida do campo (I98e96, b/277703184). - O método
TextRange.constrain
público foi adicionado. (I97912). - Os
UrlAnnotation
s emAnnotatedString
s agora podem ser abertos por serviços de acessibilidade, comoTalkBack
. (If4d82, b/253292081). - Ação semântica
InsertTextAtCursor
adicionada para campos de texto (I11ed5). - O construtor
LineHeightStyle.Alignment(topRatio)
foi promovido para a API estável. (I79c32, b/261565383). - A
TextMeasurer
e as APIs relacionadas não são mais experimentais. (I74647, b/261581753). - Ação semântica
PerformImeAction
adicionada para invocar a ação IME em nós de editores de texto. (Ic606f, b/269633506). - As APIs
PlatformTextInput
não são mais experimentais para Android. (I668eb). - O nome do parâmetro de valor para
Enum.valueOf
foi alterado (Ia9b89). - Mais exceções geradas por enumeração valueOf (I818fe).
- Introdução de uma nova API
PlatformTextInputAdapter
de baixo nível para criar implementações de entrada de texto personalizadas que se comunicam diretamente com as APIs da plataforma. (I58df4). - O parâmetro
BlendMode
foi adicionado aos métodosDrawScope.drawText
,Paragraph.paint
eMultiParagraph.paint
para oferecer suporte a diferentes algoritmos de mesclagem ao desenhar texto na tela. (I57508). Font.MaximumAsyncTimeout
foi renomeado comoFont.MaximumAsyncTimeoutMillis
. Apenas renomear. (I07af5).- Atualização dos valores de DPI dos dispositivos de referência
@Preview
(Id6151, b/254528382). - Os parâmetros
brush
ealpha
foram adicionados aBasicText
para permitir a animação ou configuração eficiente do pincel de texto. - Tipos lambda sem caixa foram definidos para Float, Double, Long, Int e Short em :ui:ui-unit (I6f18d, b/246961787).
Correções de bugs
- Remoção de várias alocações no rastreamento da velocidade do ponteiro (I26bae).
- Alocação reduzida no layout e no gerenciamento de entrada do ponteiro (I5333a).
- Otimização do uso da memória de vetor e da renderização das primeiras imagens (I2f3c6).
- A alocação foi removida ao desenhar linhas e pontos com o Canvas (I9f535).
- Adição de documentos a
AndroidFont.fontVariationSettings
(I7d9e2).
Contribuição externa
- Melhoria no desempenho e redução de alocações nas APIs Vector (I906cb).
Versão 1.5.0-alpha04
10 de maio de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-alpha04
. A versão 1.5.0-alpha04 contém estas confirmações.
Novos recursos
- Melhorias na delegação de
Modifier.Node
Foi adicionada uma capacidade aprimorada de delegar a outras instâncias deModifier.Node
de umDelegatingNode
. Isso pode ser feito com as APIsdelegate
eundelegate
. Antes dessa mudança, todas as APIs do nó de delegação precisavam ser delegadas explicitamente para o nó delegado. Após essa mudança, as interfaces de nó serão delegadas implicitamente, a menos que oDelegatingNode
as substitua explicitamente. (67352bc).
Mudanças na API
- Introdução de
NestedScrollModifierNode
, umaNestedScroll Modifier.Node
que pode ser delegada para. (I69513). - Foram adicionados os parâmetros
onReset
eonRelease
ao elemento combinávelAndroidViewBinding
, espelhando o elemento combinávelAndroidView
e ativando o suporte à reutilização de visualizações comViewBinding
. (I00b1e, b/276802519). - Atualizamos a API Path do Compose para oferecer suporte a operações de reversão para casos de uso de manipulação frequente de Path com reutilização mais rápida. (I7b797).
- Adição de
TextStyle.merge(...)
otimizado com a lista de parâmetros completa. (Iad234, b/246961787). - Estabilização de várias APIs de texto, incluindo
Brush
,DrawStyle
,TextMotion
,DrawScope.drawText
,Paragraph.paint(Brush)
eMultiParagraph.paint(Brush)
. (I2f740, b/261581564, b/261581931, b/261561245). - O uso de
PlatformTextStyle.includeFontPadding
não foi descontinuado. Nossa intenção original era remover o campo, mas o feedback mostra que os desenvolvedores precisam dessa opção de configuração. Portanto, a descontinuação foi removida do campo (I98e96, b/277703184).
Correções de bugs
- Correção de regressão em que o teclado não aparecia para campos de texto em caixas de diálogo não criadas pelo elemento combinável
Dialog
. (I82551, b/262140644).
Versão 1.5.0-alpha03
19 de abril de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-alpha03
. A versão 1.5.0-alpha03 contém estas confirmações.
Novos recursos
- Novo comportamento padrão para
SubcomposeLayout
emLookaheadScope
:SubcomposeLayouts
que não têm slots condicionais (por exemplo,TabRow
,Scaffold
,BoxWithConstraints
etc.) agora funcionam bem com animações de previsão.
Mudanças na API
- A nova
intermediateMeasurePolicy
padrão que reutiliza a política de medição da passagem de previsão permite que os subtiposSubcomposeLayout
sem slots condicionais, comoScaffold
,TabRow
eBoxWithConstraints
, funcionem com a previsão por padrão. (Id84c8). - O recompilador criado para uma janela do Android agora só bloqueia chamadas para
withFrameNanos
em vez de toda a composição quando recebe uma notificaçãoON_STOP
. Isso significa que as janelas associadas a atividades interrompidas vão continuar sendo recompostas para mudanças de dados, mas as animações ou qualquer outro autor da chamada dewithFrameNanos
serão bloqueadas. (Id9e7f, b/240975572). - Muda
motionEventSpy
para estável. (Ic5ec4, b/261560988). - O método
TextRange.constrain
público foi adicionado. (I97912). PlatformTextStyle.includeFontPadding
não está mais obsoleto para incentivar os desenvolvedores a usar essa API de compatibilidade para alternar e testar a configuraçãoincludeFontPadding
como falso. (I98e96, b/277703184).
Versão 1.5.0-alpha02
5 de abril de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-alpha02
. A versão 1.5.0-alpha02 contém estas confirmações.
Mudanças na API
- Nova API
SubcomposeLayout
que usa uma política de medição intermediária adicional para processar a lógica de medição/layout durante animações baseadas em previsão. (I017d3). - O PointerInput agora é preguiçoso e usa Modifier.Node para melhorar o desempenho. Leia sobre a mudança de comportamento menor. (15dab9).
- Mudança de APIs experimentais para estáveis com eventos de chave. (I9c7d8, b/261566839, b/261567368).
- Mudança de APIs experimentais para estáveis em
PointerInputChange
. (I1b543, b/261560988, b/261565762, b/261565749). - Adiciona uma maneira de instanciar um
SuspendingPointerInputModifierNode
para implementações mais complexas deModifier.Node
. (Ic4933). - Os
UrlAnnotation
s emAnnotatedString
s agora podem ser abertos por serviços de acessibilidade, comoTalkBack
. (If4d82, b/253292081). - Uma API foi adicionada para interceptar teclas de hardware antes que elas sejam enviadas ao teclado virtual (I4f4c6, b/186800395).
- Ação semântica
InsertTextAtCursor
adicionada para campos de texto (I11ed5). - As ações de teste relacionadas a texto (por exemplo,
performTextInput
) agora vão solicitar o foco diretamente, usando a ação semântica, em vez de clicar no campo. (I6ed05).
Correções de bugs
- As ações de teste de texto agora exigem que os campos de texto sejam ativados. (Iab328).
Versão 1.5.0-alpha01
22 de março de 2023
Lançamento de androidx.compose.ui:ui-*:1.5.0-alpha01
. A versão 1.5.0-alpha01 contém estas confirmações.
Mudanças na API
- Modifier.intermediateLayout agora não exige um LookaheadScope explícito. O bloco de medição em intermediateLayout tem IntermediateMeasureScope como receptor, que fornece CoroutineScope, LookaheadScope e MeasureScope convenientes (Ibe2e5).
- O LookaheadLayout foi substituído pelo LookaheadScope, que não é mais um layout. Isso permite que o conteúdo filho em um LookaheadScope seja controlado diretamente pela MeasurePolicy do pai. (Ibe2e5).
- Adição de
Modifier.Node#coroutineScope
para permitir que Modifier.Nodes inicie corrotinas. (I76ef9). - Permitir que Modifier.Nodes leia CompositionLocals implementando a interface CompositionLocalConsumerModifierNode. (Ib44df).
- Propagação da classe @Deprecated para a propriedade. (I882d1).
Versão 1.4
Versão 1.4.3
3 de maio de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.3
. A versão 1.4.3 contém estas confirmações.
Correções de bugs
- Correção de um problema em que o
AndroidView
podia não ser exibido corretamente quando usado com determinados modificadores (I4dc77, b/274797771). - Correção de um bug na pesquisa de foco 2D que afetava os menus
DropDown
(b/276811828). - Correção de um bug em propriedades de entrada/saída de foco personalizadas que só executavam o bloco de entrada/saída na primeira vez que a lambda era invocada (b/277234245).
- Correção de uma regressão no sistema de foco que causava uma falha ao ler
focusProperties
(b/271324781, b/274897776).
Versão 1.4.2
19 de abril de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.2
. A versão 1.4.2 contém estas confirmações.
Correções de bugs
- Correção de um problema em que o
AndroidView
não reutilizava os modificadores corretamente, o que poderia resultar em comportamento inesperado e falhas (Ib67ee, b/275919849). - Foi corrigida a regressão em que o teclado não aparecia para campos de texto em caixas de diálogo não criadas pelo elemento combinável
Dialog
(I82551, b/262140644).
Versão 1.4.1
5 de abril de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.1
. A versão 1.4.1 contém estas confirmações.
Correções de bugs
- Correção de um problema com
ParentDataModifier
que não afetaAndroidView
(b/274797771).
Versão 1.4.0
22 de março de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0
. A versão 1.4.0 contém estas confirmações.
Mudanças importantes desde a versão 1.3.0
- Adição de uma nova API
PinnableContainer
, que permite a fixação de itens de lista lentos para que eles não sejam descartados quando a rolagem passar dos limites. Por exemplo,Modifier.focusable()
usa esse mecanismo para fixar o item em foco no momento (Ib8881, b/259274257, b/195049010). - O sistema de foco foi reescrito usando as novas APIs
Modifier.Node
experimentais (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589). - Adição da propriedade semântica
IsContainer
em plataformas. Essa propriedade vai ser usada em uma mudança posterior, que determina a ordem de travessia com base no significado semântico de elementos como plataformas (I63379). - Adição de um novo papel de acessibilidade
DropdownList
. Ele pode ser usado para replicar o comportamento daTalkBack
ao colocar o foco noandroid.widget.Spinner
. (I177e5, b/236159001). - Agora, você pode usar
PlatformTextStyle(emojiSupportMatch)
para desativar o processamento de suporte a emojis em um único parágrafo (Ia7100, b/139326806). - Os testes de interface do Android Compose agora vão executar transmissões de layout para cada frame ao executar frames para ficar ociosos (por exemplo, com
waitForIdle
). Isso pode afetar testes que são executados em frames individuais de animações de layout (I8ea08, b/222093277). - Adição de
TextMotion
experimental aoTextStyle
para definir o texto comoStatic(default)
ou animado. UseTextMotion.Animated
se o texto for dimensionado, transladado ou girado usando uma animação (I24dd7).
Versão 1.4.0-rc01
8 de março de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0-rc01
. A versão 1.4.0-rc01 contém estas confirmações.
Mudanças na API
- Foi adicionada uma sobrecarga da função combinável
AndroidView
, que aceita o parâmetroonReset
. Ele permite que as instâncias de visualização sejam reutilizadas quando o nó delas na composição é descartado e reutilizado de maneira compatível. Isso é especialmente útil paraLazyRows
eLazyColumns
de visualizações. (I3f10d, b/230099236). - Introdução de uma nova API
PlatformTextInputAdapter
de baixo nível para criar implementações de entrada de texto personalizadas que se comunicam diretamente com as APIs da plataforma. (I58df4).
Correções de bugs
- A ação semântica
SetText
doBasicTextField
agora vai atualizar o buffer de texto usando o mesmo caminho de código das atualizações de IME e as funções de teste (por exemplo,performTextReplacement
). - As funções de teste de texto
performTextClearance
,performTextReplacement
eperformTextSelection
agora usamSemanticsActions
. (I0807d, b/269633168, b/269624358).
Versão 1.4.0-beta02
22 de fevereiro de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0-beta02
. A versão 1.4.0-beta02 contém estas confirmações.
Mudanças na API
- A API
modifierElementOf()
foi removida. Estenda diretamente deModifierNodeElement
. (I2256b). - Adicionamos um novo callback
Modifier.Node.onReset()
, que permite redefinir alguns estados locais para processar corretamente o caso em que oLayout
será reutilizado (por exemplo, como um item deLazyColumn
). Corrigimos oFocusTargetModifierNode
para redefinir corretamente o estado focado. (I65495, b/265201972). - O parâmetro
BlendMode
foi adicionado aos métodosDrawScope.drawText
,Paragraph.paint
eMultiParagraph.paint
para oferecer suporte a diferentes algoritmos de mesclagem ao desenhar texto na tela. (I57508).
Correções de bugs
- O algoritmo de ordem de foco de acessibilidade foi aprimorado. Por exemplo, as barras de cima/de baixo são lidas primeiro/por último com mais frequência (74e9c5).
Versão 1.4.0-beta01
8 de fevereiro de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0-beta01
. A versão 1.4.0-beta01 contém estas confirmações.
Mudanças na API
PinnableContainer.PinnedHandle.unpin()
foi renomeado comorelease()
(I4667a).- Adição de
waitUntilNodeCount
,waitUntilAtLeastOneExists
,waitUntilExactlyOneExists
ewaitUntilDoesNotExist
como API experimental emComposeTestRule
, ampliando a APIwaitUntil
para passar a aceitar qualquer correspondente e qualquer contagem de nós. ConsulteComposeTestRule
para acessar mais documentos sobre o assunto (Ifa1b9, b/226934294). - O
Font.MaximumAsyncTimeout
foi renomeado comoFont.MaximumAsyncTimeoutMillis
(I07af5). - O
GoogleFont.Provider.AllFontsListUri
foi removido e vinculado a ele no ktdoc (I16f29).
Correções de bugs
- Adição de documentos a
AndroidFont.fontVariationSettings
(I7d9e2).
Versão 1.4.0-alpha05
25 de janeiro de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0-alpha05
. A versão 1.4.0-alpha05 contém estas confirmações.
Mudanças na API
- Introdução de novas sobrecargas experimentais para a função
runComposeUiTest
e as funçõescreate*ComposeRule
que aceitam parâmetrosCoroutineContext
. O contexto vai ser usado para a composição de teste e todas as chamadasLaunchedEffect
erememberCoroutineScope()
na composição (I10614, b/265177763). - Nova API para rastrear a velocidade unidimensional (If5a82).
- Agora,
FocusRequester
está marcado como@Stable
(I580ee). - Remoção de uma anotação experimental do construtor
DialogProperties
, que usa um parâmetrousePlatformDefaultWidth
(Ic4048). - Uma função foi adicionada à posição de cálculo e à tangente a uma distância em um caminho, com
PathMeasure.getPosition()
ePathMeasure.getTangent()
(I3b47c). - O setter público exposto acidentalmente foi removido em
PlatformParagraphStyle
(I07f47). - Mais tipos/nulidade de funções inline/descontinuadas e ocultas (I24f91).
AnnotatedString.hasStringAnnotations
foi adicionado para consultar anotações com alocações zero (I94dfe, b/246960758).- Nova sobrecarga para a função
TextMeasurer.measure
, que usa umString
como texto (I47b2d, b/242705342). - As APIs
LineBreak
eHyphens
no TextStyle tiveram upgrade para a versão estável (Ic1e1d).
Contribuição externa
- Os métodos
notifyFocusedRect
emTextInputSession
eTextInputService
não foram descontinuados novamente (I23a04, b/262648050).
Versão 1.4.0-alpha04
11 de janeiro de 2023
Lançamento de androidx.compose.ui:ui-*:1.4.0-alpha04
. A versão 1.4.0-alpha04 contém estas confirmações.
Novos recursos
- Adição de uma nova API
PinnableContainer
, que permite a fixação de itens de lista lentos para que eles não sejam descartados quando a rolagem passar dos limites. Por exemplo,Modifier.focusable()
usa esse mecanismo para fixar o item em foco no momento (Ib8881, b/259274257, b/195049010). - O sistema de foco foi reescrito usando as novas APIs
Modifier.Node
experimentais (I7f4d7, b/247708726, b/255352203, b/253043481, b/247716483, b/254529934, b/251840112, b/251859987, b/257141589). - Adição da propriedade semântica
IsContainer
em plataformas. Essa propriedade vai ser usada em uma mudança posterior, que determina a ordem de travessia com base no significado semântico de elementos como plataformas (I63379). - Adição do novo papel de acessibilidade
DropdownList
. Ele pode ser usado para replicar o comportamentoTalkBack's
ao colocar o foco noandroid.widget.Spinner
(I177e5, b/236159001). - Agora, você pode usar
PlatformTextStyle(emojiSupportMatch)
para desativar o processamento de suporte a emojis em um único parágrafo (Ia7100, b/139326806). - Os testes de interface do Android Compose agora vão executar transmissões de layout para cada frame ao executar frames para ficar ociosos (por exemplo, com
waitForIdle
). Isso pode afetar testes que são executados em frames individuais de animações de layout (I8ea08, b/222093277). - Adição de
TextMotion
experimental aoTextStyle
para definir o texto comoStatic(default)
ou animado. UseTextMotion.Animated
se o texto for dimensionado, transladado ou girado usando uma animação (I24dd7).
Mudanças na API
- O argumento
maxSize: IntSize
foi substituído emdrawText
porsize: Size
para ficar inline com outras funçõesDrawScope
. Osize
é definido comoSize.Unspecified
por padrão, o que não afeta o comportamento padrão anterior (Icd27d). - Remoção do construtor de fonte experimental descontinuado (I8a724, b/261435386).
- A classe de dados
Group
das ferramentas de interface agora tem um campoisInline
, que indica se o grupo é destinado a uma chamada para uma função combinável inline. Se oisInline
fortrue
, a chamada vai ser para uma função combinável inline. No entanto, o valor pode ser falso em chamadas para funções combináveis inline que são de módulos compilados com uma versão do plug-in do compilador do Compose que não gera informações sobre a função inline (Idb846). - Upgrade de várias APIs anteriormente experimentais para a versão estável.
- A API Rotary Scroll Event agora é estável (I42ad3, b/261561229).
- A API
FontVariation
agora é estável (I8779f, b/241016309). - Todos os construtores
Font()
agora são APIs estáveis (I5948b, b/261435386). - O
DeviceFontFamilyName
agora é estável (I8b640, b/261435386). - O construtor
AndroidFont
comvariationSettings
agora é uma API estável e pode ser usado para criar novos tipos de descritores de fonte (I5adcc, b/261565807). - A API
createFontFamilyResolver
agora é estável. Ela pode ser usada para capturar exceções não detectadas durante o carregamento de fonte assíncrono (Ibb481, b/261435386). - A API
Font.loadingStrategy
agora é estável (I5937c, b/261435386). - A API
GoogleFont
agora é estável (Ic90b0, b/261435386). - A API
TextUnit(float, TextUnitType)
agora é estável (I90c84, b/261561612). - A API
pluralStringResource
agora é estável (I09849, b/261439703).
Versão 1.4.0-alpha03
7 de dezembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.4.0-alpha03
. A versão 1.4.0-alpha03 contém estas confirmações.
Mudanças na API
ExperimentalComposeUiApi
foi removida dePointerIcon
(I23af8).- Ações foram introduzidas à página de acessibilidade:
PageUp
,PageDown
,PageLeft
,PageRight
. Essas opções estão disponíveis apenas na API 29 (Ida4ab). - A visualização do parâmetro
rememberNestedScrollConnection
foi atualizada de visualização raiz para host (Ia5200). - Adição de uma API Modifier para consultar informações de rolagem de ancestrais (I2ba9d, b/203141462).
Clickable
foi usado para atrasar corretamente as interações de pressionamento quando gestos podem se tornar eventos de rolagem.- Os elementos
Clickables
foram corrigidos para passar a atrasar ondulações corretamente quando usados dentro de umScrollable ViewGroup
. - As gavetas e planilhas foram atualizadas para atrasar corretamente os pressionamentos, em casos em que gestos podem se tornar eventos de rolagem.
CompositingStrategy.Always
foi renomeado comoOffscreen
para indicar que agraphicsLayer
sempre vai ser renderizada em um buffer intermediário (I47dc1).- A sobrecarga de layout com vários slots de conteúdo agora está estável (I10566, b/248294649).
- As novas APIs experimentais
PerfettoTrace.record {}
ePerfettoTraceRule
foram adicionadas para capturar rastros do Perfetto, também conhecidos como rastreamentos do sistema, como parte de um teste para inspecionar o comportamento e a performance (I3ba16). - Em testes de interface que usam uma regra do Compose, as continuações retomadas durante callbacks
withFrameNanos
não são enviadas até que todos os callbacks de frames sejam executados. Esse é o mesmo comportamento que o Compose apresenta quando é executado normalmente. No entanto, testes que dependem do comportamento antigo podem falhar. Isso só afeta o código que chamawithFrameNanos
ouwithFrameMillis
diretamente e tem uma lógica fora dos callbacks que é transmitida para essas funções e pode precisar ser movida para dentro deles. Exemplos de mudanças em testes de animação estão disponíveis no CL. - Foi adicionado o parâmetro opcional
onPerformTraversals: (Long) -> Unit
ao construtorTestMonotonicFrameClock
e à função de fábrica para executar o código depois de callbackswithFrameNanos
, mas antes de retomar as corrotinas dos autores das chamadas (Idb413, b/254115946, b/222093277, b/255802670). - Adição de EmojiCompat ao Compose (Ibf6f9, b/139326806).
- Adição de um novo parâmetro de plano de fundo a
@Preview
para incluir suporte a cores dinâmicas (I9f512).
Correções de bugs
- As notificações de captura de tela agora são enviadas depois que o
Recomposer
termina de aplicar as mudanças. (Iad6c0, b/222093277). - Mudanças foram introduzidas em
captureToImage
para permitir a captura de tela de várias janelas. Isso é útil para testes de capturas de tela que usam pop-ups do Compose (I169c5).
Atualizações de dependência
- O Compose UI e o Compose Material agora dependem do Lifecycle 2.5.1 (I05ab0, b/258038814).
Versão 1.4.0-alpha02
9 de novembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.4.0-alpha02
. A versão 1.4.0-alpha02 contém estas confirmações.
Mudanças na API
- Atualização do
GraphicsLayerScope
para expor o tamanho atual dographicsLayer
. Isso é útil para calcular as transformações dagraphicsLayer
como uma função do tamanho do elemento combinável. (If8c43,b/181387080). - Lançamento da
CompositingStrategy
para determinar quando usar uma camada combinável fora da tela para renderizar o conteúdo dagraphicsLayer
. O Auto mantém o comportamento padrão, que usa internamente uma camada se um Alfa ou umRenderEffect/Overscroll
for empregado. Ele sempre introduz um buffer fora da tela onde oModulateAlpha
evita usar um e prefere modular cada uma das instruções de desenho gravadas nagraphicsLayer
. OModulateAlpha
ainda vai empregar um buffer fora da tela para usos relacionados aRenderEffect/Overscroll
(I25e82, b/256382834). invalidateSubtree()
foi adicionado aModifier.Node
para permitir a invalidação de hierarquias inteiras de layout e desenho (I4bd90).- O
rememberNestedScrollInteropConnection
foi promovido a estável. Introduzida a capacidade de transmitir uma visualização raiz pararememberNestedScrollInteropConnection
. Com isso, visualizações personalizadas podem reagir melhor às restrições de rolagem, principalmente em visualizações não padrão, comoModalBottomSheetDialog
(I9e107). - Adição da interface
ObserverNode
, que pode ser usada pelas implementações deModifier.Node
que precisam ser notificadas quando um valor lido muda (I5728b, b/247716483). - Adição de um novo construtor ao
Paint
, que aceita umandroid.graphics.Paint
nativo. Também foi adicionada uma função de extensãotoComposePaint()
para converter um objeto Paint nativo atual no Compose Paint (Ica91b). - Adição do novo
FontFamily.Resolver.resolveAsTypeface
para uso no Android (I8950b). - Adição do
ToolingState
para permitir que as ferramentas mudem os estados internos do elemento combinável (Ie6614). - Refatoração de ferramentas para oferecer melhor suporte às novas animações adicionadas (I8677b).
- O parâmetro
minLines
foi adicionado ao Text,TextField
eOutlinedTextField
do Material e Material 3, o que permite definir a altura mínima do componente em termos de número de linhas (I4af1d).
Versão 1.4.0-alpha01
24 de outubro de 2022
Lançamento de androidx.compose.ui:ui-*:1.4.0-alpha01
. A versão 1.4.0-alpha01 contém estas confirmações.
Mudanças na API
- Um novo método,
awaitEachGesture()
, para detectores de gestos foi adicionado. Ele funciona de forma semelhante aforEachGesture()
, mas o loop sobre gestos opera inteiramente dentro doAwaitPointerEventScope
. Assim, os eventos não podem ser perdidos entre iterações. - O uso de
forEachGesture()
foi descontinuado e substituído porawaitEachGesture()
, porque permite que os eventos sejam perdidos entre gestos (Iffc3f, b/251260206). - A reciclagem de objetos de acessibilidade no AndroidX foi descontinuada. Descobrimos que mudanças de performance são insignificantes até mesmo nas versões com suporte mais antigas (I0a961).
DrawStyle
foi adicionado como um atributo experimental aTextStyle
eSpanStyle
para permitir a exibição de texto contornado (If24b8, b/155421273).AnnotatedString.Builder
agora implementakotlin.text.Appendable
(I1a061, b/231030444).AnnotatedString.Builder
agora tem um métodoappend(AnnotatedString, start: Int, end: Int)
para anexar uma substring de umaAnnotatedString
e os estilos de interseção.- O parâmetro
DrawStyle
foi adicionado às funções de pinturaParagraph
eMultiParagraph
para permitir a exibição de texto destacado (Ic8102, b/155421273).
Contribuição externa
- Agradecemos a
vighnesh
por adicionar dispositivos de TV às visualizações (Ie15cd).
Versão 1.3
Versão 1.3.3
11 de janeiro de 2023
Lançamento de androidx.compose.ui:ui-*:1.3.3
. A versão 1.3.3 contém estas confirmações.
Correções de bugs
- Correção de uma falha que às vezes ocorre no Android 9 quando a atividade salva o estado da visualização do Compose (I0b755, b/260322832).
Versão 1.3.2
7 de dezembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.2
. A versão 1.3.2 contém estas confirmações.
Correções de bugs
- Atualização para usar o Profobuf 3.21.8, que evita um alerta de segurança em
protobuf-javalite:3.19.4
(CVE-2022-3171) (b/255545055).
Versão 1.3.1
9 de novembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.1
. A versão 1.3.1 contém estas confirmações.
Versão 1.3.0
24 de outubro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0
. A versão 1.3.0 contém estas confirmações.
Mudanças importantes desde a versão 1.2.0
- Novo pacote experimental de APIs
LookaheadLayout
que ativa comportamentos de animação que antes não eram possíveis. - Novo pacote de API experimental
Modifier.Node
que é uma alternativa de melhor performance paraModifier.composed
. - Suporte aprimorado para encartes de janela.
- Suporte para botões direcionais e teclado de hardware em LazyLists.
- A elevação máxima suportada em caixas de diálogo e pop-ups foi reduzida para 8 dp. Essa é uma mudança interruptiva de comportamento para alguns sistemas de design personalizados com base nas notas da versão beta01.
- Muitas pequenas melhorias não interruptivas na API
- Várias correções de bugs e melhorias no desempenho.
Versão 1.3.0-rc01
5 de outubro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-rc01
. A versão 1.3.0-rc01 contém estas confirmações.
Mudanças na API
- Adição da nova API Hyphens experimental para oferecer suporte à hifenização automática em texto (Iaa869).
Correções de bugs
- As fontes
DeviceFontFamilyName
não vão definir as configurações de variaçãowght
eital
por padrão, em vez de usar a configuração de plataforma para aTypeface
carregada (Ia7a6d, b/246989332). - Correção do vazamento de memória
LazyColumn
:onModifierLocalsUpdated
não estava sendo chamado com o valor padrão quando os modificadores eram reutilizados (b/230168389).
Versão 1.3.0-beta03
21 de setembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-beta03
. A versão 1.3.0-beta03 contém estas confirmações.
Mudanças na API
- Adiciona opções para personalizar a quebra de linha em "Texto" (I86907)
- O argumento
size:IntSize
comconstraints: Constraints
no métodoTextMeasurer.measure
foi mudado para oferecer suporte a restrições de largura mínima (I37530, b/242707525)
Correções de bugs
- A API
BackHandler
da AndroidX Activity agora funciona em um elemento combinávelDialog
(I35342)
Versão 1.3.0-beta02
7 de setembro de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-beta02
. A versão 1.3.0-beta02 contém estas confirmações.
Mudanças na API
- Adição de uma sobrecarga experimental para o Layout, que aceita uma lista de várias lambdas de conteúdo combinável. Isso permite outra forma de colocar itens mensuráveis de ameaça em diferentes lambdas de conteúdo (Ic1b4e).
Mudanças nas APIs Focus experimentais:
FocusDirection.In
eFocusDirection.Out
foram descontinuados e substituídos porFocusDirection.Enter
eFocusDirection.Exit
(Ia4262, b/183746982).- Foram adicionadas duas novas propriedades de foco de entrada e saída com o objetivo de especificar um comportamento personalizado para
FocusManager.moveFocus(Enter)
eFocusManager.moveFocus(Exit)
(I5f3f9, b/183746982). - Agora é possível usar
FocusRequester.Cancel
para cancelar uma mudança de foco.FocusRequester.Cancel
pode ser usado em qualquer uma destas propriedades de foco: para cima, para baixo, para a esquerda, para a direita, próximo, anterior, iniciar, encerrar, entrar e sair (Ib300f).
Versão 1.3.0-beta01
24 de agosto de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-beta01
. A versão 1.3.0-beta01 contém estas confirmações.
Refatoração de nós do modificador
A camada que processa instâncias de Modifier/Modifier.Element
e coordena o comportamento delas em LayoutNodes
foi refatorada em grande parte. No momento, essa refatoração não afetou a API pública de nenhum dos modificadores no Compose e pode ser vista como apenas uma mudança de implementação. Apesar disso, essa é uma mudança importante por vários motivos (Ie4313).
Resumo das mudanças
As APIs experimentais Modifier.Node
foram adicionadas para permitir que o estado seja mantido em uma instância que vai ser retida com o ciclo de vida do nó de layout e alocada por nó de layout e por uso da classe Modifier.Element
que produziu o material.
De um modo geral, essa abstração oferece um mecanismo alternativo para produzir modificadores com estado sem depender da mecânica da API Modifier.composed
.
Riscos
Essa mudança é estritamente binária e compatível com versões anteriores. Ela foi criada para oferecer suporte a versões anteriores, tanto em termos de comportamento observável como também prático e racional. Portanto, poucos subsistemas do Compose não foram afetados por essa refatoração. Além disso, é provável que o comportamento tenha mudado de formas que não foram abordadas em nossos testes e ainda não foram encontradas e corrigidas.
Faça upgrade para esta versão com cautela. Entre em contato caso isso gere algum erro.
APIs experimentais
Várias APIs experimentais foram adicionadas, todas relacionadas ao novo conceito de um "nó do modificador". Modifier.Nodes são criados como resultado de
fun modifierElementOf(…): Modifier
abstract class ModifierNodeElement
abstract class Modifier.Node
abstract class DelegatingNode
interface LayoutModifierNode
interface DrawModifierNode
interface SemanticsNode
interface PointerInputNode
interface ModifierLocalNode
interface ParentDataModifierNode
interface LayoutAwareModifierNode
interface GlobalPositionAwareModifierNode
interface IntermediateLayoutModifierNode
Mudança de comportamento interruptiva
A elevação máxima suportada em caixas de diálogo e pop-ups foi reduzida para 8 dp.
A elevação máxima suportada para caixas de diálogo e pop-ups do Compose foi reduzida de 30 dp para 8 dp. Essa mudança afeta pop-ups e caixas de diálogo personalizados do Material Design e da interface. Ela foi feita para reduzir um bug de acessibilidade nas versões do Android anteriores à S e para garantir que os serviços de acessibilidade dentro dessas janelas possam interagir com o conteúdo da caixa de diálogo ou do pop-up.
Essa mudança só vai afetar pessoas que criarem uma implementação de caixa de diálogo ou pop-up personalizada com uma elevação definida para níveis maiores que 8 dp. Nesses casos, o ideal é reduzir a elevação da caixa de diálogo ou do pop-up. Se precisar desativar esse novo comportamento, bifurque a caixa de diálogo ou pop-up com o conjunto de elevação preferido. Essa ação não é recomendada, já que a acessibilidade pode ser afetada de forma negativa, e cabe ao desenvolvedor garantir que a parte de baixo da caixa de diálogo ou pop-up seja interativa e legível pelos serviços de acessibilidade.
Mudanças na API
- Foi corrigido um problema em que o
painterResource
não atualizava as mudanças de configuração (I58e73, b/228862715). rememberTextMeasurer
não usa mais parâmetrosFontFamily.Resolver
,Density
ouLayoutDirection
. Use o construtorTextMeasurer
para fornecer valores personalizados para esses parâmetros (Ia1da3).- A propriedade
DialogProperties.decorFitsSystemWindows
foi adicionada para permitir que caixas de diálogo ofereçam suporte aWindowInsets
(I57742, b/229378542). - Construtores de fontes foram movidos de volta para o arquivo Kotlin original a fim de manter a compatibilidade binária. Nenhuma mudança desde a última versão estável (Ieb2f3).
- Foi removido um operador desnecessário para várias definições de igual. Essa mudança não teve nenhum efeito (I6c309).
FontVariation.Setting
é uma interface selada para permitir futuras APIs de limitação (I11021, b/143703328).CompositionGroup.findParameters
foi adicionada aSlotTree.kt
. Essa mudança permite que as ferramentas extraiam parâmetros para umCompositionGroup
sem precisar analisar toda a tabela de slots (I124fe).
Versão 1.3.0-alpha03
10 de agosto de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-alpha03
. A versão 1.3.0-alpha03 contém essas confirmações.
Mudanças na API
LayoutCoordinates.findRootCoordinates()
agora é público (I7fa37, b/204723384).- Foi adicionada uma API experimental para acessar
LayoutCoordinates
noPlacementScope
. Isso informa aos desenvolvedores onde o layout atual deve posicionar os filhos em relação à posição deles (I5482b, b/238632578). LayoutCoordinates.transformFrom
foi adicionado para receber a transformação de uma Matrix de um conjunto deLayoutCoordinates
para outro (Ic5ab1, b/238632578).- O uso de
SemanticsModifier.id
foi descontinuado, e o ID semântico foi movido paraLayoutInfo.semanticsId
(Iac808, b/203559524). - As fontes de recursos agora oferecem suporte para a configuração de variações de fonte (API 26 ou mais recentes) (I900dd, b/143703328).
- Adição de suporte a fontes variáveis em
DeviceFontFamilyNameFont
(Ic1279, b/143703328). - Os construtores de fontes agora aceitam uma lista de
FontVariation.Setting
para configurar fontes variáveis em dispositivos O+ (I11a9d, b/143703328). - A API
FontVariation
foi adicionada para definir e usar fontes variáveis (I3c40c, b/143703328). - O construtor
LineHeightStyle.Alignment
agora é público (experimental) (I4bbbe, b/235876330). - O Paragraph agora é esperado|real e definido para Android e computador (Id387e, b/239962983).
- O Paragraph da interface agora é a interface Paragraph selada. Não há casos de uso para criar subclasses de parágrafos. Recomendamos entrar em contato se essa mudança afetar você (If5247, b/239962983).
- A anotação experimental foi removida de
PlatformTextStyle
eLineHeightStyle
(I64bef). - O uso de
TextInputService.show|hideSoftwareKeyboard
foi descontinuado. UseSoftwareKeyboardController
no código do app eTextInputSession
no código de gerenciamento de IME (I14e4c, b/183448615). - Foi adicionada uma nova API para os tipos de animação já existentes (I26179).
Correções de bugs
@RequiresPermission
foram adicionadas a APIs que exigem a concessão da permissãoPOST_NOTIFICATIONS
no SDK 33 e versões mais recentes (Ie542e, b/238790278).
Versão 1.3.0-alpha02
27 de julho de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-alpha02
. A versão 1.3.0-alpha02 contém estas confirmações.
Mudanças na API
- Foi adicionada uma nova propriedade
PointerInputChange#pressure
para recuperar a pressão (I45a5e, b/205164819). rememberTextMeasurer
foi adicionado para criar e lembrar facilmente de instâncias deTextMeasurer
na composição (I8d66e).Rect
,RoundRect
eMutableRect
agora oferecem suporte à sintaxein
do Kotlin para chamar a funçãocontains
(Ie42b0, b/238642990).- Foram removidas funções desnecessárias do
KeyInjectionScope
, já que elas podem ser facilmente implementadas com partes mais simples da API. As funções que foram removidas incluempressKeys
,keysDown
ekeysUp
(I81d77). - Nomes de constantes e parâmetros foram refatorados em
KeyInjectionScope
para incluir o sufixo "Millis", em que as unidades dessas constantes e parâmetros são milissegundos (Iabef5). - O método
toStringForLog()
foi adicionado aEditCommand
para ajudar a resolver problemas de edição de texto (I53354, b/228862731). - Foi adicionada a função de extensão
drawText
emDrawScope
para fornecer uma maneira de renderizar texto com vários estilos em elementos combináveis e modificadores que operam em umDrawScope
, comoCanvas
edrawBehind
(I16a62, b/190787898). - Foi introduzida uma nova API experimental chamada
TextMeasurer
, que permite a computação arbitrária de layout de texto para criar resultados idênticos aBasicText
, independentemente do ambiente de execução do Compose (I17101). mapTree
foi adicionada aSlotTree.kt
. Isso permite que as ferramentas inspecionemSlotTree
sem fazer uma cópia na memória primeiro, como o asTree. Para o Layout Inspector, isso oferece uma melhoria de desempenho de aproximadamente um fator 10 (I5e113).- A visualização do Compose passou por mudanças para ser armazenada em arquivos de saída binários e permitir que os desenvolvedores programem e reutilizem anotações
MultiPreview
de bibliotecas (I85699, b/233511976).
Correções de bugs
- Ao adicionar eventos
InputEventChange
ao rastreadorVelocity
, vamos considerar agora deltas, em vez de posições. Isso garante que a velocidade seja calculada corretamente para todos os casos, mesmo se o elemento de destino é movido (Icea9d, b/216582726, b/223440806, b/227709803). - Foi corrigida uma NPE causada por
AnnotatedString.toUpperCase
quando há anotações (I0aca2, b/210899140).
Versão 1.3.0-alpha01
29 de junho de 2022
Lançamento de androidx.compose.ui:ui-*:1.3.0-alpha01
. A versão 1.3.0-alpha01 contém estas confirmações.
Mudanças na API
- Novo
LookaheadLayout
que permite a pré-visualização antes da medição ou layout finais. Isso possibilita um pré-cálculo do layout quando há mudanças, permitindo que a medição ou o layout pós-visualização usem o tamanho ou a posição pré-calculados para animar o tamanho e as posições de acordo com a segmentação. Ainda não é possível usarSubcomposeLayouts
, mas isso será oferecido em uma versão futura (I477f5). - Adição do parâmetro Alfa opcional à variação Brush de
TextStyle
eSpanStyle
para modificar a opacidade de todo oText
(Ic2fac, b/234117635). - O tipo de anotação
UrlAnnotation
e os métodos associados foram lançados para oferecer suporte a linksTalkBack
emAnnotatedString
s (I1c754, b/231495122). - A funcionalidade utilitária foi movida para o ambiente de execução (I4f729).
Correções de bugs
- O componente
TextLayoutResult.getLineForOffset
não é gerado (Idc5d6, b/235876324).
Contribuição externa
- Uma nova API,
WindowInfo.keyboardModifiers
, foi adicionada para observar o estado dela dentro de funções combináveis ou via snapshotFlow (Icdb8a).
Versão 1.2
Versão 1.2.1
10 de agosto de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.1
. A versão 1.2.1 contém estas confirmações.
Correções de bugs
- O nullpoint do inspetor foi corrigido (b/237987764).
- Foi corrigida a exceção de transmissão de classe durante o método remember no inspetor (b/235526153).
Versão 1.2.0
27 de julho de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0
. A versão 1.2.0 contém estas confirmações.
Mudanças importantes desde a 1.1.0
Melhorias na travessia de foco:
- A rolagem orientada por foco de listas lentas agora funciona usando a nova API principal
BeyondBoundsLayout
. - Novas APIs de personalização de comportamento em
FocusOrder
eFocusProperties
. - Comportamento aprimorado com teclado físico ou controle remoto de TV.
- A rolagem orientada por foco de listas lentas agora funciona usando a nova API principal
Novas APIs para:
- Encartes de janela
- Primitivos importantes para animações orientadas por gestos, infinitas e de layout
- Recursos de
GraphicsLayer
, incluindoRenderEffect
Várias correções de bugs e melhorias no desempenho.
Versão 1.2.0-rc03
29 de junho de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-rc03
. A versão 1.2.0-rc03 contém estas confirmações.
- Nenhuma mudança desde a versão 1.2.0-rc02.
Versão 1.2.0-rc02
22 de junho de 2022
androidx.compose.ui:ui-*:1.2.0-rc02
é lançado. A versão 1.2.0-rc02 contém estas confirmações.
Versão 1.2.0-rc01
15 de junho de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-rc01
. A versão 1.2.0-rc01 contém estas confirmações.
Mudanças na API
- As interfaces em bibliotecas de composição agora são criadas usando métodos de interface padrão do jdk8 (I5bcf1).
- Funções de ordem superior foram adicionadas à interface
KeyInjectionScope
para injetar pressionamentos de teclas enquanto outras teclas estão pressionadas ou ativadas. Essas funções incluemwithKeysDown
,withKeysToggled
, entre outras. Também foram adicionadas propriedades para conferir se uma tecla meta específica está inativa. Por exemplo,isCtrlDown
para conferir se uma tecla de controle está pressionada. ConsulteKeyInjectionScope
para consultar a documentação sobre cada função (I9f6cd, b/229831515). - Uma interface
OverscrollEffect
experimental foi introduzida para permitir o uso de efeitos de rolagem personalizados, assim como sobrecargas deModifier.scrollable
que a aceitam. - A
LocalOverScrollConfiguration
experimental foi movida defoundation.gesture
para o pacote básico e renomeada comoLocalOverscrollConfiguration
(If19fb, b/204650733). - A função
runComposeUiTestWithoutActivity {}
foi renomeada comorunEmptyComposeUiTest {}
, o que faz com que ela fique alinhada àcreateEmptyComposeRule()
(I6fed7).
Versão 1.2.0-beta03
1º de junho de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-beta03
. A versão 1.2.0-beta03 contém estas confirmações.
Mudanças na API
pressKeyTimes
,isCapsLockOn
e amigos foram adicionados aKeyInjectionScope
. Além disso, a API agora oferece suporte a padrões de injeção combinados de mouse e teclado, como ao clicar em um botão do mouse com a tecla meta pressionada (I4c8da, b/229831515).- Foi adicionado suporte experimental à injeção de eventos de tecla Use
performKeyInput
para enviar eventos de tecla ou os envie pela propriedadekey
doMultiModalInjectionScope
durante um gesto de entrada multimodal comperformMultiModalInput
. ConsulteKeyInjectionScope
para ver a documentação da API (Ic5000, b/229831515). - Foi adicionada uma nova
GoogleFont.Provider.AllFontsListUri
para acessar a fonte canônica da Internet do Google Fonts com suporte no Android. - Melhoria nas mensagens de erro geradas quando o GoogleFonts falha ao carregar no Compose (I0416c).
Correções de bugs
- Ao adicionar eventos
InputEventChange
ao rastreador de velocidade, vamos considerar agora deltas em vez de posições. Isso garante que a velocidade seja calculada corretamente para todos os casos, mesmo se o elemento de destino é movido (I51ec3, b/216582726, b/223440806, b/227709803). - A configuração
Show Layout Bounds
vai ser aplicada a elementos combináveis imediatamente após ser alternada do bloco de configurações rápidas, sem que você precise sair e entrar novamente na atividade (I843d5, b/225937688). - A pesquisa de string de acessibilidade não aciona o carregamento de fontes. Anteriormente, ela tentava carregar fontes para
StyleSpans
, o que causava falhas se oFontFamily.Resolver
tivesse sido substituído (I4609d). - Pressionar a tecla de excluir o próximo caractere quando o cursor estiver no final de um campo de texto não vai mais causar falhas.
DeleteSurroundingTextCommand
eDeleteSurroundingTextInCodePointsCommand
agora exigem que os argumentos do construtor não sejam negativos (Ica8e6, b/199919707).
Versão 1.2.0-beta02
18 de maio de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-beta02
. A versão 1.2.0-beta02 contém estas confirmações.
Mudanças na API
- Reutilizar a funcionalidade em outros tipos de visualização (I19f39).
Correções de bugs
ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer
foi renomeado comoDisposeOnDetachedFromWindowOrReleasedFromPool
para indicar melhor quando os descartes ocorrem, em vez de apenas quando não ocorrem (If15ca).
Versão 1.2.0-beta01
11 de maio de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-beta01
. A versão 1.2.0-beta01 contém estas confirmações.
Novos recursos
- Esta é a primeira versão Beta da 1.2.
Mudanças na API
- Foi adicionado o
BeyondBoundsInterval
experimental, que pode ser usado por implementações personalizadas deLazyList
ao definir o layout de itens além dos limites visíveis (Ifabfb, b/184670295). - As versões codificadas de
Modifier.composed
agora são APIs estáveis (Ie65e4, b/229988420). - Simplificação da API
rememberNestedScrollConnection
para usar locais combináveis para coletar as informações de visualização atuais (I67ca7). - A anotação
@ComposableTarget
e as anotações marcadas por@ComposableTargetMarker
agora podem ser usadas no escopo do arquivo com o prefixo@file
. Usar uma anotação de destino no escopo do arquivo faz com que o compilador suponha que todas as funções combináveis do arquivo sejam destinadas ao aplicador associado. Por exemplo, o uso de@file:UiComposable
declara que todas as funções@Composable
segmentam o aplicador da interface do Compose. Uma função que precisa segmentar outro aplicador precisa fornecer explicitamente a anotação do marcador de destino para o aplicador desejado (I40804). Introduzida uma nova API de teste experimental e independente da plataforma: uma
interface ComposeUiTest
e umafun runComposeUiTest(block: ComposeUiTest.() -> Unit)
, que podem ser usadas para executar testes da interface do Compose sem a necessidade de umaTestRule
. Para executar um teste sem umaComposeTestRule
, transmita o teste como lambda pararunComposeUiTest
e use os métodos e membros no escopo do receptorComposeUiTest
, que são os mesmos deComposeContentTestRule
.As
fun runAndroidComposeUiTest(block: AndroidComposeUiTest.() -> Unit)
e osinterface AndroidComposeUiTest
específicos do Android são adicionados para fornecer acesso à atividade subjacente, de forma semelhante àAndroidComposeTestRule
. Para ter ainda mais controle, você mesmo pode instanciar umclass AndroidComposeUiTestEnvironment
.A implementação para computadores é o
class DesktopComposeUiTest
, mas nenhuma função de execução específica para computadores é oferecida no momento.A migração de um teste de
ComposeTestRule
paraComposeUiTest
pode ser feita desta maneira (exemplo no Android). De:@RunWith(AndroidJUnit4::class) class MyTest { @get:Rule val rule = createComposeRule() @Test fun test() { rule.setContent { Text("Hello Compose!") } rule.onNodeWithText("Hello Compose!").assertExists() } }
Para:
@RunWith(AndroidJUnit4::class) class MyTest { @Test @OptIn(ExperimentalTestApi::class) fun test() = runComposeUiTest { setContent { Text("Hello Compose!") } onNodeWithText("Hello Compose!").assertExists() } }
Por enquanto,
ComposeContentTestRule
eComposeTestRule
não são estendidos a partir deComposeUiTest
. Isso significa que as funções de extensão emComposeUiTest
ainda não podem ser chamadas na interfaceTestRule
. QuandoComposeUiTest
se qualificar para a API estável,ComposeContentTestRule
eComposeTestRule
serão modificadas para serem estendidas deComposeUiTest
(Ib4e90).LineHeightBehavior
foi renomeado comoLineHeightStyle
.LineVerticalAlignment
foi renomeado comoLineHeightStyle.Alignment
.A classe
LineHeightTrim
foi renomeada comoLineHeightStyle.Trim
.Os valores padrão do construtor de
LineHeightStyle
foram removidos (I582bf, b/181155707).Brush
foi adicionado aTextStyle
eSpanStyle
para fornecer uma maneira de desenhar texto com coloração gradiente (I53869, b/187839528).Os atributos
trimFirstLineTop
etrimLastLineBottom
doLineHeightBehavior
foram mudados para uma única enumeração:LineHeightTrim
. OsLineHeightTrim
têm valores de quatro estados definidos por dois booleanos,FirstLineTop
eLastLineBottom
, Both e None (Ifc6a5, b/181155707).Adição de
LineHeightBehavior
aTextStyle
eParagraphStyle
.LineHeightBehavior
controla se a altura da linha é aplicada à parte de cima da primeira linha e à parte de baixo da última linha. Ele também define o alinhamento da linha no espaço fornecido peloTextStyle(lineHeight)
.Por exemplo, é possível conseguir um comportamento semelhante ao que o CSS define com
LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false)
.As configurações de
trimFirstLineTop
etrimLastLineBottom
só funcionarão corretamente quandoincludeFontPadding
for falso (I97332, b/181155707).As funções
PlatformParagraphStyle.lerp
ePlatformSpanStyle.lerp
foram mudadas para serem funções de nível superior (I9a268).
Correções de bugs
- A documentação de
PointerInputChange::copy
agora informa corretamente que se trata de uma cópia superficial (I182f5). - Suporte a reticências quando a altura é limitada e não cabe em todas as linhas de texto (Ie528c, b/168720622).
includeFontPadding
ativado por padrão. É possível desativar oincludeFontPadding
usando o atributoTextStyle.platformTextStyle
. Em breve, vamos mudar o comportamento padrão. Até lá, temos tempo para integrar melhor as mudanças da altura da linha (aosp/2058653) e resolver os problemas de recorte doTextField
(I01423, b/171394808).
Contribuição externa
- O
MouseInjectionScope.scroll(delta = someDelta)
agora é invertido no Android quando rolamos verticalmente. Se someDelta for positivo, a rolagem será para baixo (Ifb697, b/224992993).
Versão 1.2.0-alpha08
20 de abril de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha08
. A versão 1.2.0-alpha08 contém estas confirmações.
Mudanças na API
- As funções
pluralStringResource
foram marcadas como experimentais para permitir que a evolução apoie melhor a internacionalização no futuro (If24e4). - Paragraph e MultiParagraph agora aceitam o parâmetro Constraints. A transmissão de
Constraints.maxHeight
é um ambiente autônomo no momento, mas vai permitir alguns cálculos no futuro, como o uso de reticências com base na altura (I6afee, b/168720622). SubcomposeSlotReusePolicy.getSlotsToRetain()
agora aceita uma classe personalizada semelhante a MutableSet, que não permite adicionar novos itens a ela (Icd314).- PointerIcon agora é uma interface
@Stable
(I9dafe). - O consumo parcial (para baixo OU na posição) foi descontinuado em
PointerInputChange
. Useconsume()
para consumir a mudança completamente. Você pode usarisConsumed
para determinar se outra pessoa já consumiu a mudança. - Agora, o
PointerInputChange::copy()
sempre faz uma cópia superficial. Isso significa que se uma cópia dePointerInputChange
for consumida, todas as outras também serão. Se você quiser criar umaPointerInputChange
desvinculada, use o construtor (Ie6be4, b/225669674). - Foi ativada a interoperabilidade de rolagem aninhada entre a View e o Compose na direção Compose > View. Isso significa que um elemento pai combinável pode receber deltas de rolagem aninhados em uma visualização de rolagem aninhada (If7949, b/174348612).
- Nova
SemanticsProperty testTagsAsResourceId
, que pode ser usada para adequar o Compose aos testes do UIAutomator projetados para o sistema de visualização (I39c20). - Mostra todos os pesos disponíveis para fontes de sistemas no Android ao usar
FontFamily.SansSerif
. Isso usa internamente os nomes de fontes substitutas, como sans-serif-medium, nas APIs de 21 a 28. Essa é uma mudança de comportamento, já que apenas os pesos 400 e 700 tinham suporte das APIs de 21 a 28 (I380fe, b/156048036, b/226441992). - Os instrutores Paragraph e MultiParagraph reordenaram os argumentos de posicionamento antes dos argumentos opcionais (Idafaa).
AndroidFont
agora usa typefaceLoader como um parâmetro construtor (I2c971).
Versão 1.2.0-alpha07
6 de abril de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha07
. A versão 1.2.0-alpha07 contém estas confirmações.
Mudanças na API
- A nova função
Snapshot.withoutReadObservation { ... }
foi adicionada. Ela permite que os usuários executem a lambda transmitida sem se inscreverem nas mudanças de valores de estado lidos durante esse bloco. Ela pode ser útil em casos de uso quando você quiser se beneficiar das leituras/gravações seguras para linhas de execução baseadas em snapshots, mas quiser ler o valor sem causar uma recomposição ou uma nova medição desnecessárias (I9f365, b/214054486). - A propriedade de extensão
consumeWindowInsets
daComposeView
permite que os desenvolvedores desativem o consumo deWindowInsets
do Android. Isso permite separarComposeViews
na hierarquia para que elas apliquemWindowInsets
sem interferirem umas nas outras (I0ef08, b/220943142). KeyboardType.Decimal
foi adicionado como alternativa aKeyboard.Number
para a inclusão específica de separador decimal no editor de método de entrada (Iec4c8, b/209835363).PointerEventType.Scroll
ePointerEvent.scrollDelta
agora são APIs estáveis (I574c5, b/225669674).- A interoperabilidade de rolagem aninhada entre a View e o Compose para classes de visualização colaborativas foi ativada. Isso significa que o Compose agora pode enviar deltas de rolagem para um elemento pai da visualização (cooperante) (I5d1ac, b/174348612).
- A interface
FontFamily.Resolver
foi atualizada para integrar a configuração de acessibilidade de texto em negrito em todo o sistema (I6c1e7). - O uso de
Font(AssetManager, String, ...)
foi descontinuado e substituído porFont(String, AssetManager, ...)
. Essa é uma API experimental (I1c7a4). - Foi adicionado um novo descritor de fonte
Font(DeviceFontFamilyName)
. Como opção, você pode pesquisar fontes instaladas no sistema durante cadeias de substitutos de fonte (I30468, b/219754572). - Foi adicionada uma configuração de compatibilidade temporária para
includeFontPadding
em TextStyle/ParagraphStyle.includeFontPadding
pode ser alterado porTextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false))
. Essa é uma opção de configuração temporária para ativar a migração e vai ser removida (If47be, b/171394808). - A extensão
GoogleFont.Provider.isAvailableOnDevice
foi adicionada para ajudar na depuração (I64e31). - Foi adicionado o construtor
GoogleFont.Provider
para uso com@ArrayRes
(Ic5ee1, b/225984280). - O
Compose GoogleFont
agora é chamado deFont(GoogleFont)
. A API permanece estável (I125f2).
Correções de bugs
- A verificação de lint foi adicionada a material/Scaffold para garantir que o padding interno esteja sendo usado (Ifb111).
Versão 1.2.0-alpha06
23 de março de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha06
. A versão 1.2.0-alpha06 contém estas confirmações.
Mudanças na API
- Adição da ação semântica
RequestFocus
para solicitar foco no destino focalizável (I17b71). - A análise de drawables vetoriais foi atualizada para oferecer suporte ao espelhamento automático a fim de virar o conteúdo de um
VectorPainter
, se a direção atual do layout for RTL (I79cd9, b/185760237). As cores de sombra/ambiente foram atualizadas para serem parâmetros finais do
Modifier.graphicsLayer
para suporte à API (I3f864, b/160665122).Adição de implementações padrão às cores de sombra/ambiente no
GraphicsLayerScope
para garantir mudanças não interruptivas na API.Adição do tempo de evento aos eventos RSB (Ief8ae).
A
FocusOrder
foi mesclada comFocusProperties
, efocusProperties()
agora tem todos os recursos defocusOrder()
.FocusOrder
efocusOrder()
foram descontinuados. A funçãofocusOrder()
que aceita umfocusRequester
precisa ser substituída por um modificadorfocusRequester()
em combinação comfocusProperties()
. Isso permite que os modificadores tenham uma separação mais forte de problemas (I601b7).O upgrade de
RecyclerView
eCompose
agora vai resultar em uma performance de rolagem muito melhor para RecyclerViews com as visualizações do Compose como filhas.ViewCompositionStrategy.Default
foi adicionado como uma forma de recuperar a estratégia padrão integrada.Acréscimo de
ViewCompositionStrategy.DisposeOnDetachedFromWindowIfNotInPoolingContainer
, que é a nova estratégia padrão e gerencia os contêineres de pooling corretamente, como a RecyclerView (If7282).Foi adicionado suporte à anotação de classes de anotações, com a @Preview como uma primeira etapa para adicionar o recurso Multipreview. Essas anotações podem ser usadas para métodos de funções combináveis ou outras classes de anotação, que poderiam ser consideradas ndiretamente anotadas com a @Preview fornecida (I12eff).
Dispositivos de referência adicionados à lista de dispositivos para a @Preview (I071c9).
Correções de bugs
- As APIs de gráficos vetoriais foram atualizadas para usar a anotação combinável @VectorComposable adequada em vez de @UiComposable (I942bc).
- Remoção de crossinline de
AnnotatedString.Builder.withStyle
(If84d5).
Contribuição externa
- compose-ui: adição das propriedades
ambientShadowColor
espotShadowColor
aoGraphicsLayerScope
(I1ba1a, b/160665122). - Agora há suporte para os recursos plurais usando as funções
pluralStringResource
(Ib2f23, b/191375123).
Versão 1.2.0-alpha05
9 de março de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha05
. A versão 1.2.0-alpha05 contém estas confirmações.
Mudanças na API
- A interface
TextToolbar
agora usa argumentos lambda em vez deActionCallback
(Ib2eb9, b/197950089). - Atualização da nulidade no núcleo e na appcompat para corresponder ao Tiramisu DP2 (I0cbb7).
- A interface medida agora expõe a propriedade parentData (I3313f).
- O
Modifier.onPlaced
e a interfaceOnPlacedModifier
agora estão na versão estável (Ib5482). - Oba! A animação do Compose agora permite a configuração "Escala de duração do Animator" das Opções do desenvolvedor (I5a4fc, b/161675988).
- Foi adicionado um modificador
BeyondBoundsLayout
local (If8b51, b/184670295). - Texto: o includeFontPadding agora fica desativado por padrão. Os
problemas de recorte resultantes de
includeFontPadding=false
foram corrigidos e nenhum corte deve ocorrer para scripts altos (I31c84, b/171394808).
Correções de bugs
ComposeContentTestRule.setContent
agora gera umaIllegalStateException
se você tenta definir conteúdo quando já há um (I888a5, b/199631334).- A falha causada pelo conteúdo da área de transferência durante a leitura no Android foi corrigida (I06020, b/197769306).
- Exemplos de rolagem RSB aprimorados (I6a596).
Contribuição externa
- Atualização para usar as corrotinas Kotlinx 1.6.0 (I3366d).
Versão 1.2.0-alpha04
23 de fevereiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha04
. A versão 1.2.0-alpha04 contém estas confirmações.
Mudanças na API
Adicionados os elementos
ComposableTarget
,ComposableTargetMarker
eComposableOpenTarget
, que permitem gerar relatórios sobre o tempo de compilação quando uma função combinável é chamada para um aplicador que não foi projetado para uso.Na maioria dos casos, as anotações podem ser inferidas pelo plug-in do compilador do Compose. Portanto, o uso direto delas é raro. Os casos que não podem ser inferidos incluem a criação e o uso de um applier personalizado, funções combináveis abstratas (como métodos de interface), campos ou variáveis globais que são lambdas combináveis (as variáveis locais e os parâmetros são inferidos) ou o uso de
ComposeNode
ou funções combináveis relacionadas.Para appliers personalizados, as funções combináveis que chamam
ComposeNode
ouReusableComposeNode
precisam adicionar uma anotaçãoComposableTarget
à função e a qualquer tipo de parâmetro lambda combinável. No entanto, é recomendável criar uma anotação comComposableTargetMarker
e, em seguida, usar essa anotação marcada em vez de usar aComposableTarget
diretamente. Uma anotação combinável marcada comComposableTargetMarker
é equivalente a umaComposbleTarget
com o nome totalmente qualificado da classe de atributo como o parâmetro do applier. Para conferir um exemplo de como usar aComposableTargetMarker
, consulteanroidx.compose.ui.UiComposable
(I38f11).Font(resId, ...)
agora usa loadStrategy em uma API estável (Ief3d2).FontLoadingStrategy
agora é uma API estável (I1ee35, b/174162090).Suporte ao carregamento de fonte assíncrono no texto (I77057, b/214587005).
A API Bridge foi adicionada para converter o
Font.ResourceLoader
personalizado emFontFamily.Resolver
(Ia0060).
Correções de bugs
- O
FontFamily.Resolver
fornecido é transmitido para subcomposições, como Popup. - O
Font.ResourceLoader
fornecido é transmitido para subcomposições, como Popup (I48fa5).
Versão 1.2.0-alpha03
9 de fevereiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha03
. A versão 1.2.0-alpha03 contém estas confirmações.
Mudanças na API
- Os métodos
notifyFocusedRect
nas classesTextInputSession
eTextInputService
foram descontinuados e não serão chamados. UseBringIntoViewRequester
(Ia4302, b/192043120, b/216842427, b/178211874). - Introdução do método
destroyDisplayListData
na classe de stubRenderNode
(I1e659, b/216660268). - Adição de uma nova API que permite medir previamente os filhos do
SubcomposeLayout
que você pré-determinou (I857ea). Adição de
movableContentOf
, que converte uma lambda combinável em uma que move o estado e os nós correspondentes para qualquer novo local em que ela é chamada. Quando a chamada anterior sai da composição, o estado é temporariamente preservado e, se uma nova chamada para o lambda entrar nela, o estado e os nós associados serão movidos para o local da nova chamada. Se nenhuma nova chamada for adicionada, o estado vai ser removido permanentemente e os observadores serão notificados.Se uma lambda
movableContentOf
é chamada várias vezes na mesma composição, novos estados e nós são criados para cada chamada. À medida que as chamadas saem da composição e novas entram, o estado é movido das primeiras chamadas de saída para as de entrada na ordem em que são chamadas. Remoção permanente de todos os estados não reivindicados por novas chamadas (Ib4850).O
FontFamilyResolver
agora está disponível peloLocalFontFamilyResolver.current
.createFontFamilyResolver(context)
ecreateFontFamilyResolver(context, coroutineScope)
foram adicionados para criar novos resolvedores da FontFamily fora do uso do Compose.Os elementos Paragraph e MultiParagraph agora usam o
FontFamily.Resolver
.O
TextLayoutResult.layoutInput.fontFamilyResolver
agora contém o resolvedor usado para esse layout. OTextLayoutResult.layoutInput.resourceLoader
foi descontinuado porque ele não é mais usado (Id5a45, b/174162090).Suporte ao carregamento de fontes assíncrono e opcional, com comportamento substituto. Esse caminho é usado pelo Text e TextField e exposto usando o FontFamilyResolver.
Suporte para o pré-carregamento de fontes usando o
FontFamilyResolver.preload
.O
FontFamilyResolver.setAsyncLoadContext
permite definir o contexto de corrotina global usado para carregar fontes assíncronas (I87fe8, b/174162090).Adição de
AndroidFont
, uma nova API de baixo nível, para fornecer novos tipos de descritores de recursos de fonte no Android. Por exemplo, carregar fontes de um back-end específico do app, localizar opcionalmente fontes pré-instaladas no dispositivo ou carregar uma fonte de um recurso que não é fornecido pelas fábricas de fontes atuais.A API
Font.ResourceLoaded
foi expandida para oferecer suporte ao carregamento de fonte opcional e assíncrono. Não é recomendável que os desenvolvedores de aplicativos usem essa API diretamente. Para adicionar novos tipos de fonte, consulteAndroidFont
.A função da extensão
Font.AndroidResourceLoader
permite criar umFont.ResourceLoader
quando estiver fora da composição.O parâmetro
loadingStrategy
foi adicionado às fontes baseadas em recursos para autorizar o carregamento assíncrono quando a fonte do recurso se refere a fontes XML para download (Ie5aea, b/174162090).O construtor
Typeface(FontFamily)
foi descontinuado. Ele era usado anteriormente para pré-carregar fontes, o que pode levar até 10 segundos no caso de fontes para download. Com fontes disponíveis para download, essa chamada pode ser bloqueada por 10 segundos. Em vez disso, useFontFamilyResolver.preload
.O uso de
fontResource(FontFamily): Typeface
foi descontinuado. Ele era usado anteriormente para pré-carregar fontes, o que pode levar até 10 segundos no caso de fontes para download. Em vez disso, useFontFamilyResolver.preload
(If8e7c, b/174162090).O uso do construtor
SubcomposeLayoutState
que aceitamaxSlotsToRetainForReuse
foi descontinuado. Em vez disso, há um novo construtor que aceita aSubcomposeSlotReusePolicy
, uma nova interface que permite um controle mais granular sobre quais slots são retidos para reutilização futura (I52c4d).As funções HSV e HSL são expostas em
Color
como uma API não experimental. O espaço de cores do Oklab agora é uma API pública (I08fb6, b/180731008).A classe
AndroidComposeTestRule.AndroidComposeStatement
foi descontinuada, porque não deveria estar na API pública e não ajudava você em nada (Ibc46b).Renomeação da classe kt gerada internamente (Ia0b9e, b/174162090).
Remoção de
FontLoadingStrategy.values
(I42a9d, b/174162090).O carregador de fonte global agora é chamado de
FontFamilyResolver
(I4f773, b/174162090).O novo sistema de carregamento de fontes é usado para computadores (I9ce5c, b/174162090).
FontFamily.Resolver.resolve
retornaState<Any>
(I4406c, b/174162090).
Correções de bugs
- Os TextFields agora são mantidos acima do teclado quando estão
em foco, e o teclado é mostrado quando o modo de entrada simples é
ADJUST_PAN
(I8eaeb, b/190539358, b/192043120). - O computador usa a composição local para o
FontFamily.Resolver
. - O uso do
FontLoader
para computadores foi descontinuado. - Nova fábrica
createFontFamilyResolver
no computador (I6bbbb, b/174162090). - O tipo de entrada do teclado de software não pisca mais ao mudar o foco entre os campos de texto (I1bf50, b/187746439).
Versão 1.2.0-alpha02
26 de janeiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha02
. A versão 1.2.0-alpha02 contém estas confirmações.
Mudanças na API
Modifier.onRotaryScrollEvent()
eModifier.onPreRotaryScrollEvent()
foram adicionados para dispositivos Wear com um botão lateral giratório (I18bf5, b/210748686).- A extensão
View.createLifecycleAwareRecomposer
experimental foi adicionada (I0cde6).
Contribuição externa
PointerEvent.scrollDelta.y
agora está invertido no Android (retornando 1 em vez de -1 quando a roda do mouse é inclinada para a direita) (Ia9811).
Versão 1.2.0-alpha01
12 de janeiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.2.0-alpha01
. A versão 1.2.0-alpha01 contém estas confirmações.
Mudanças na API
FontFamily.canLoadSynchronously
foi descontinuada. Essa propriedade não tem significado semântico (Ica5ef).- O campo de identidade foi adicionado a
CompositionData
para gerar IDs invariáveis no Layout Inspector (Ic116e). - Foram adicionados IDs de dispositivos Wear OS à lista de dispositivos de pré-lançamento (I93232).
Atualizações de dependência
- Agora depende do Kotlin
1.6.10
.
Versão 1.1
Versão 1.1.1
23 de fevereiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.1.1
. A versão 1.1.1 contém estas confirmações.
Correções de bugs
- A
NullPointerException
emandroidx.compose.ui.platform.RenderNodeLayer.updateDisplayList
foi corrigida (aosp/1947059, b/206677462). - A falha causada pelo conteúdo da área de transferência durante a leitura no Android foi corrigida (I06020, b/197769306).
- RTL corrigido no elemento
LazyVerticalGrid
(aosp/1931080, b/207510535).
Versão 1.1.0
9 de fevereiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.1.0
. A versão 1.1.0 contém estas confirmações.
Mudanças importantes desde a versão 1.0.0
- Suporte estável para o efeito de rolagem do Android 12.
- Melhorias no dimensionamento da área de toque.
- Observe que, em relação ao Compose 1.0, os componentes do Material agora expandem o espaço de layout para satisfazer ao tamanho da área de toque das diretrizes de acessibilidade (links em inglês) do Material Design. Por exemplo, a área de toque do botão será expandida para um tamanho mínimo de 48 x 48 dp, mesmo que você defina um tamanho menor para o botão. Isso alinha o Compose Material ao mesmo comportamento dos Componentes do Material Design para ser consistente se você combinar visualizações e o Compose. Essa mudança também garante que, ao criar a interface usando os componentes do Compose Material, os requisitos mínimos para a acessibilidade da área de toque sejam atendidos.
- Suporte estável para a Coluna de navegação.
- Upgrade de várias APIs anteriormente experimentais para a versão estável.
- Compatibilidade com as versões mais recentes do Kotlin.
Versão 1.1.0-rc03
26 de janeiro de 2022
Lançamento de androidx.compose.ui:ui-*:1.1.0-rc03
. A versão 1.1.0-rc03 contém estas confirmações.
Correções de bugs
- Atualização de compatibilidade com o Compose Material 1.1.0-rc03.
Versão 1.1.0-rc01
15 de dezembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-rc01
. A versão 1.1.0-rc01 contém estas confirmações.
Correções de bugs
- Correção de um bug que causava erro nas ações de rolagem de acessibilidade (I7cbfb).
SemanticsNodeInteraction.captureToImage()
agora também funciona quandoHardwareRenderer.isDrawingEnabled()
éfalse
, permitindo o funcionamento durante a chamada (Idf3d0).
Versão 1.1.0-beta04
1º de dezembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-beta04
. A versão 1.1.0-beta04 contém estas confirmações.
Novos recursos
- Foi adicionada compatibilidade com o Kotlin
1.6.0
.
Mudanças na API
- Limpeza de nulidade em
androidx.core.view
(I7078a, b/204917439). - APIs experimentais que permitem que os usuários consumam a PointerInputchange como um todo ou verifiquem se foi consumida ou não foram adicionadas (I2e59d).
- Suporte adicionado a eventos da roda de rolagem do mouse na camada de IU (Ia14eb, b/198214718).
- Sobrecargas experimentais de
Modifier.composed
que aceitam chaves para comparação por igualdade e se qualificam para pular otimizações foram adicionadas (Ice799, b/205851704). - A
ComposeNotIdleException
agora é uma extensão deException
em vez deThrowable
diretamente. Isso significa que as cláusulas de captura que capturavamException
agora podem detectarComposeNotIdleException
s, o que não aconteceria anteriormente (I9c217).
Correções de bugs
- As alças de texto não são movidas quando a visibilidade do IME (editor de método de entrada, na sigla em inglês) muda (I25f2e).
Versão 1.1.0-beta03
17 de novembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-beta03
. A versão 1.1.0-beta03 contém estas confirmações.
Mudanças na API
- O novo modificador Modifier.onPlaced foi adicionado para permitir que a mudança de posição seja observada. Portanto, é possível fazer outras mudanças no deslocamento do modificador filho com base na mudança de posição observada (I558fd).
- Remoção de
InjectionScope.flush()
eInjectionScope.dispose()
. A limpeza de todos os eventos e o descarte do escopo agora acontecem no fim do método perform*Input() chamado, como antes (I2bed8). - Remoção de
MultiModalInjectionScope.Touch
eMultiModalInjectionScope.Mouse
. Para injetar eventos de toque e mouse em gestos multimodais, agora é possível usarMultiModalInjectionScope.touch()
eMultiModalInjectionScope.mouse()
, os quais aceitam um lambda que tem o escopo receptor dessa modalidade (Idde18).
Correções de bugs
- O valor padrão de
durationMillis
emTouchInjectionScope.swipeWithVelocity
agora é calculado de modo que o deslizamento seja viável (I19deb).
Versão 1.1.0-beta02
3 de novembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-beta02
. A versão 1.1.0-beta02 contém estas confirmações.
Mudanças na API
- Adição da API BringIntoView experimental, que permite enviar uma solicitação aos elementos pais de rolagem para mostrar um item (Ib918d, b/195353459).
- Novas APIs de animação para suporte a ferramentas. Mais especificamente, elas permitem que as ferramentas inspecionem as animações e as configurações delas em transições (I4116e).
Contribuição externa
- Adição de Modifier.pointerHoverIcon (I95f01).
Versão 1.1.0-beta01
27 de outubro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-beta01
. A versão 1.1.0-beta01 contém estas confirmações.
Mudanças na API
- Adição da API experimental
BringIntoView
, que permite enviar uma solicitação aos elementos pais para que eles rolem a fim de mostrar um item (Ib918d, b/195353459). - Novas APIs de animação para suporte a ferramentas. Mais especificamente, elas permitem que as ferramentas inspecionem as animações e as configurações delas em transições (I4116e).
Versão 1.1.0-alpha06
13 de outubro de 2021
androidx.compose.ui:ui-*:1.1.0-alpha06
é lançado. A versão 1.1.0-alpha06 contém estas confirmações.
Mudanças na API
- Remoção da
ExperimentalComposeUiApi
doViewRootForInspector
eLayoutInfo.ownerViewId
(I5c2e3). - Adição de uma sobrecarga sem filhos para o Layout, com eficiência aprimorada (Ib0d9a).
- Remoção da
InternalCompilerApi
dos métodos do Composer que precisam ser chamados entre módulos (I1aa0b). SemanticsNodeInteraction.performSemanticsAction
agora retorna aSemanticsNodeInteraction
em que a função foi chamada (I9e5db).- O LocalInputModeManager CompositionLocal foi adicionado para detectar TouchMode/NonTouchMode (I6a83c, b/175899786).
- A
viewConfiguration: ViewConfiguration
foi adicionada aoLayoutInfo
para permitir que os consumidores recebam o valor correto para itens como tempo limite do pressionamento longo (I76ca6).- A
viewConfiguration: ViewConfiguration
foi adicionada aoInjectionScope
para permitir que os testes ajustem a injeção de entrada com base em fatores como o tempo limite do pressionamento longo ou a tolerância de toque. - A duração padrão do gesto de tocar e manter pressionado e de toque duplo na
entrada de toque e do mouse foi mudada para ter como base os valores em
InjectionScope.viewConfiguration
.
- A
- Implementação do ExpedDropdownMenu com base na ExpedDropdownMenuBox com TextField e DropdownMenu (If60b2).
- O dismissOnOutsideClick foi adicionado à PopupProperties, substituindo dismissOnClickOutside, que foi descontinuado. A nova propriedade recebe a posição do clique e os limites de âncoras, fornecendo um controle mais preciso sobre a necessidade de invocar onDismissRequest. Isso pode ser útil, por exemplo, para evitar que a âncora seja dispensada ao ser tocada.
- O updateAndroidWindowManagerFlags foi adicionado à PopupProperties, oferecendo controle de baixo nível sobre as sinalizações transmitidas pelo pop-up para o WindowManager do Android. O parâmetro da lambda vão ser as flags calculadas com base nos valores de PopupProperties que resultam em flags do WindowManager, por exemplo, focalizável. O resultado da lambda serão as flags finais transmitidas para o WindowManager do Android. Por padrão, o updateAndroidWindowManagerFlags não muda as flags calculadas com base nos parâmetros. Essa API precisa ser usada com cuidado, somente nos casos em que o pop-up tem requisitos de comportamento muito específicos (I6e9f9).
- O uso de
Recomposer.state
foi descontinuado e substituído peloRecomposer.currentState
para mudar o tipo para um StateFlow (Ic2ab3, b/197773820). flush()
edispose()
foram adicionados aInjectionScope
. Use-os quando quiser transferir todos os eventos na fila imediatamente e quando quiser descartar o escopo, respectivamente (Ifb73a).performScrollToNode(matcher: SemanticsMatcher)
, que rola um contêiner rolável até o conteúdo correspondente, foi adicionado (Ic1cb8).- O
InjectionScope
agora implementaDensity
, permitindo que você converta facilmente entre px e dp noperformTouchInput
e amigos (I8fe1f).
Correções de bugs
- O AndroidView agora propaga LocalLifecycleOwner e LocalSavedStateRegistryOwner para a própria visualização via ViewTreeLifecycleOwner e ViewTreeSavedStateRegistryOwner (I38f96, b/179708470).
- Foi corrigido o SwipeToDismissBox do WearOS, que às vezes não processava ações de deslizar (I9387e).
- O tempo padrão entre os eventos de entrada injetados foi modificado de 10 ms para 16 ms. Isso pode mudar o resultado dos testes que realizam gestos de entrada, como um gesto de deslizar específico (I829fd).
Versão 1.1.0-alpha05
29 de setembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha05
. A versão 1.1.0-alpha05 contém estas confirmações.
Mudanças na API
- O suporte à comunicação entre modificadores foi adicionado (Id5467, b/198826874).
- Ponteiros históricos experimentais foram adicionados ao PointerEventChange (Ic1fd8, b/197553056, b/199921305).
density: Density
elayoutDirection: LayoutDirection
foram adicionados aLayoutInfo
, permitindo que os consumidores deLayoutInfo
interpretem as dimensões e a posição expostas emLayoutInfo
corretamente (I002f1).- O suporte experimental à injeção de eventos de mouse foi adicionado. Use
performMouseInput
para começar a enviar eventos de mouse ou envie eventos de mouse usando a propriedadeMouse
doMultiModalInjectionScope
durante um gesto de entrada multimodal comperformMultiModalInput
. Consulte oMouseInjectionScope
para ver a documentação disponível da API (Iaa4a8, b/190493367).
Correções de bugs
- Correção do suporte à acessibilidade para roláveis lentos e não lentos, em relação à rolagem (I6cdb0).
- Melhoria do
TouchInjectionScope.swipeWithVelocity
. Agora, ele aceita uma variedade maior de variáveis de entrada e sugerirá mudanças na entrada se não for possível criar um gesto de deslizar (I40fbe, b/182477143).
Versão 1.1.0-alpha04
15 de setembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha04
. A versão 1.1.0-alpha04 contém estas confirmações.
Mudanças na API
- A classe
PointerEvent
agora tem umPointerEventType
para oferecer suporte a eventos de passagem do cursor (I091fa). - Permite que os filhos aceitem a entrada de ponteiro fora dos limites de entrada do ponteiro do pai. Os pais podem interceptar essas chamadas com uma propriedade PointerInputScope.alwaysInterceptChildEvents (I9eae3, b/192479655).
performGesture
eGestureScope
foram descontinuados e substituídos porperformTouchInput
eTouchInjectionScope
(Ia5f3f, b/190493367).- A propriedade
touchBoundsInRoot
foi adicionada àSemanticsNode
, que inclui o tamanho mínimo da área de toque para que os desenvolvedores possam garantir que ela atenda aos valores mínimos de acessibilidade (I2e14b, b/197751214). - Refeita a implementação do elemento inspecionável (I927bc, b/191017532).
- Mudança do nome de parâmetro do elemento inspecionável para corresponder ao composto (I3a482, b/191017532).
performTouchInput
eTouchInjectionScope
foram adicionados para substituirperformTouchInput
eTouchInjectionScope
, abrindo o caminho para outras modalidades (como o mouse).TouchInjectionScope
tem os mesmos métodos que oGestureScope
, com exceção demovePointerTo
emovePointerBy
, que foram renomeados comoupdatePointerTo
eupdatePointerBy
. Todos os outros métodos são os mesmos.O comportamento da
TouchInjectionScope
é quase idêntico ao daGestureScope
, com dois pequenos detalhes:- Ao enviar um evento para baixo enquanto os ponteiros eram movidos sem
enviar um evento de movimento (em outras palavras, a função
updatePointerTo()
era usada, mas não amove()
, e depois a funçãodown()
era chamada), a implementação anterior avançava o horário do evento e enviava um evento de movimento antes de enviar o evento para baixo. A nova implementação ainda envia o evento de movimento, mas não avança o horário do evento nesse cenário específico. - Ao enviar um evento para cima enquanto os ponteiros eram movidos sem enviar um evento de movimento (semelhante ao exemplo acima), a implementação anterior avançava o horário do evento e enviava um evento de movimento antes de enviar o evento para cima. A nova implementação não faz nem uma coisa nem outra: as novas posições dos ponteiros serão refletidas apenas pelo evento para cima.
Por fim, a
TouchInjectionScope
introduz um novo métodocurrentPosition(pointerId: Int)
para receber a posição atual do ponteiro específico (If1191, b/190493367).- Ao enviar um evento para baixo enquanto os ponteiros eram movidos sem
enviar um evento de movimento (em outras palavras, a função
Correções de bugs
- Permissão para que o clipe amplie os limites da área de toque além da região do clipe para que ela respeite o tamanho mínimo (I43e10, b/171509422).
- Adoção de suporte à rolagem esticada em dispositivos com Android 12 (Iccf3c, b/171682480).
Versão 1.1.0-alpha03
1º de setembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha03
. A versão 1.1.0-alpha03 contém estas confirmações.
Novos recursos
- O Compose
1.1.0-alpha03
foi atualizado para depender do Kotlin1.5.30
(I74545).
Mudanças na API
- Adição de
Modifier.inspectable
para unir outros modificadores (I1909b, b/191017532). - A API
BlurredEdgeTreatment
foi adicionada para simplificar os casos de uso de desfoque em combinações mais usadas de flags de recorte e TileModes. A maioria dos casos de uso envolve permitir que o conteúdo desfocado seja renderizado fora dos limites do conteúdo original e desfocar regiões fora desses limites com preto transparente. Ou, ainda, recortar conteúdo para limites de conteúdo com amostragem da borda mais próxima para kernels de desfoque que se estendem além dos limites de conteúdo (I6b4b7, b/166927547). - Foi adicionado suporte ao RenderEffect no Compose para computador. O OffsetEffect e o modificador de desfoque foram adicionados como uma maneira simples de introduzir efeitos visuais de desfoque em uma parte da hierarquia combinável (I0f6aa, b/166927547).
- Introdução da API RenderEffect
que pode ser configurada opcionalmente em
um
Modifier.graphicsLayer
para mudar o conteúdo da camada em si. Isso pode ser usado para desfocar o conteúdo de elementos combinável e elementos filhos em uma hierarquia de composições. (I47c4d, b/166927547) - AwaitPointerEventScope agora tem withTimeout() e withTimeoutOrNull() (I507f0, b/179239764, b/182397793)
- Adição de um tamanho mínimo da área de toque da ViewConfiguration para uso na entrada de semântica e ponteiros para garantir a acessibilidade (Ie861c).
- Foi adicionado suporte a TileMode.Decal, que é útil para definir o comportamento do Edge para RenderEffects baseados em desfoque (I7e8ed, b/166927547).
performScrollToIndex
,performScrollToKey
,hasScrollToIndexAction
ehasScrollToKeyAction
agora são APIs estáveis (I142ae, b/178483889)- Um método de teste para receber os limites cortados foi adicionado (I6b28e).
Correções de bugs
- Remoção do método isBounded de BlurredEdgeTreatment para conferir explicitamente se o parâmetro de forma é nulo (I85d68).
Versão 1.1.0-alpha02
18 de agosto de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha02
. A versão 1.1.0-alpha02 contém estas confirmações.
Mudanças na API
- O PointerEvent agora oferece suporte à leitura do estado do botão do mouse e do modificador do teclado (I6310c, b/180075467).
- Os gestos injetados agora usam o horário do MainTestClock como a
fonte da verdade do tempo. O horário atual para eventos injetados em
performGesture
será inicializado no horário atual do MainTestClock (Ifb364, b/192064452). - Adição do construtor
DpRect(DpOffset, DpSize)
(I2cf16, b/194219828) - Adição da classe DpSize (I7abb1, b/194219828)
Correções de bugs
- A análise de XML de gráficos vetoriais foi atualizada para oferecer suporte a ColorStateLists como propriedades de tonalidade de cor raiz em VectorDrawables (I86915, b/195668138).
Versão 1.1.0-alpha01
4 de agosto de 2021
Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha01
. A versão 1.1.0-alpha01 contém estas confirmações.
Mudanças na API
RelocationRequester.bringIntoView
agora aceita um retângulo como parâmetro, o que nos permite mostrar uma parte de um elemento combinável (Ice2c5, b/194330245).- A classe
AnimatedImageVector
e as APIs relacionadas agora estão no novo móduloandroidx.compose.animation:animation-graphics
(I60873). - Adição de modificador experimental para lidar com solicitações de realocação (I65a97, b/178211874).
A API BrushPainter foi adicionada para oferecer suporte ao desenho de um pincel arbitrário em um Painter, semelhante ao ColorPainter.
Atualização da API Brush para que ela tenha um parâmetro de tamanho intrínseco que seja consultado na BrushPainter (Ia2752, b/189466433).
Atualização do método DrawScope#drawImage, que consome os retângulos de origem e destino para consumir um parâmetro FilterFilter opcional. Isso é útil para pixel art, que precisa ficar pixelada ao ser ampliada. O elemento combinável BitmapPainter + Image foi atualizado para também consumir um parâmetro FilterFilter opcional (Ie4fb0, b/180311607).
Adição do método
GestureScope.advanceEventTime
para oferecer mais controle sobre o tempo dos eventos em um gesto (Ibf3e2).
Correções de bugs
- Para oferecer melhor suporte ao encadeamento de
modificadores de desenho, a implementação do Modifier.paint
precisa chamar drawsContent.
Anteriormente, Modifier.paint era esperado para um nó de folha na
cadeia de modificadores, mas isso o impedia
de ser configurado em um contêiner combinável (como uma caixa)
ou de adicionar outras decorações na parte de cima, como
Modifier.paint().border()
. Com o Modifier.paint chamando drawContent depois de desenhar o conteúdo do pintor especificado, temos uma consistência de comportamento melhor com o padrão do modificador (Ibb2a7, b/178201337, b/186213275). - Agora, as caixas de diálogo seguem o comportamento de tamanho da plataforma. Defina
usePlatformDefaultWidth
como falso para substituir esse comportamento. (Iffaed, b/192682388). - A
InfiniteAnimationPolicy
foi movida para :compose:ui (I5eb09, b/160602714). - A rolagem usando ações semânticas para listas lentas e componentes de rolagem regulares agora é animada (Id9066, b/190742024).
Versão 1.0
Versão 1.0.5
3 de novembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.5
. A versão 1.0.5 contém estas confirmações.
Correções de bugs
- Uma falha de rastreamento de instâncias derivedStateOf foi corrigida (aosp/1792247).
Versão 1.0.4
13 de outubro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.4
. A versão 1.0.4 contém estas confirmações.
Atualizações de dependência
- Atualização para depender do Kotlin
1.5.31
.
Versão 1.0.3
29 de setembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.3
. A versão 1.0.3 contém estas confirmações.
Atualizações de dependência
- Atualização para depender do Kotlin
1.5.30
.
Versão 1.0.2
1º de setembro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.2
. A versão 1.2.0 contém estas confirmações.
Atualização para aceitar a versão 1.0.2
do Compose. O Compose 1.0.2
ainda é compatível com o Kotlin 1.5.21
.
Versão 1.0.1
4 de agosto de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.1
. A versão 1.0.1 contém estas confirmações.
Atualizações de dependência
- Atualização para depender do Kotlin
1.5.21
.
Versão 1.0.0
28 de julho de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0
. A versão 1.0.0 contém estas confirmações.
Principais recursos da versão 1.0.0
Esta é a primeira versão estável do Compose. Confira mais detalhes na postagem do blog oficial sobre o lançamento do Compose (link em inglês).
Problemas conhecidos
Se você está usando o Android Studio Bumblebee Canary 4 ou o AGP
7.1.0-alpha04
/7.1.0-alpha05
, pode encontrar esta falha:java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
Para corrigi-la, aumente temporariamente a minSdkVersion para 24+ no arquivo
build.gradle
. Esse problema será corrigido na próxima versão do Android Studio Bumblebee e no AGP7.1
(b/194289155).
Versão 1.0.0-rc02
14 de julho de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-rc02
. A versão 1.0.0-rc02 contém estas confirmações.
Correções de bugs
- Agora, as caixas de diálogo seguem o comportamento de tamanho da plataforma. Defina
usePlatformDefaultWidth
como falso para substituir esse comportamento. (Iffaed, b/192682388).
Versão 1.0.0-rc01
1º de julho de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-rc01
. A versão 1.1.0-rc01 contém estas confirmações.
Novos recursos
- Divisão do módulo de interface em
ui-tooling
eui-tooling-preview
(Iefa28, b/190649014).
Mudanças na API
- Remoção de
FocusManager#moveFocusIn
eFocusManager#moveFocusOut
experimentais obsoletos (I227d7, b/170154986, b/186567354, b/168510304) - Agora, o Canvas oferece suporte ao parâmetro contentDescription para acessibilidade (Ib547c).
- Renomeação de
useDefaultMaxWidth
emPopupProperties
parausePlatformDefaultWidth
(I05710). - Agora, as caixas de diálogo podem usar toda a largura da tela (I83929, b/190810877).
- Foi adicionado suporte experimental a representações de cores HSV e HSL (Id7cf8, b/180731008).
Mudanças de comportamento
- O Compose
@Preview
agora oferece umLocalActivityResultRegistryOwner
que permite visualizar os elementos combináveis que usam APIs comorememberLauncherForActivityResult()
, que dependem do proprietário já existente (Ib13d1, b/185693006). - O Compose
@Preview
agora oferece umLocalOnBackPressedDispatcherOwner
que permite visualizar os elementos combináveis que usam APIs comoBackHandler
, que dependem do proprietário já existente (Ia1c05, b/185693006).
Correções de bugs
InfiniteAnimationPolicy
foi movido paraandroidx.compose.ui:ui
(I5eb09, b/160602714).- AnimatedImageVector foi temporariamente removido para mudar a estrutura do módulo (I41906, b/160602714).
Versão 1.0.0-beta09
16 de junho de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta09
. A versão 1.0.0-beta09 contém estas confirmações.
Mudanças na API
- Os tipos enumerados Role e LiveRegionMode foram mudados para classes in-line com construtor privado (Id1890).
- A KeyboardCapitalization foi convertida em uma classe in-line (Id5a1c).
- Mudança de HapticFeedbackType para uma classe in-line (I255ec).
- Modifier.pointerInteropFilter é @ExperimentalComposeUiApi (Iede6c).
- TextAlign, FontSynthesis e TextDirection agora são classes in-line (I212fe).
- Mudança de TextOverflow para uma classe in-line (I433af).
- FontStyle agora é uma classe in-line (I9e48b).
Correções de bugs
- Por enquanto, as constantes de chave são @ExperimentalComposeUiApi. O código de consumo pode declarar constantes particulares antes da estabilização (Ia5d48).
- Agora, os testes do Compose podem ser executados no Robolectric. Até o momento,
as seguintes limitações foram identificadas:
- Não há bitmap nativo, então
ImageBitmap()
leva a uma NullPointerException. - Não há desenho, então
captureToImage()
vai aguardar indefinidamente a próximo transmissão de desenho (ou seja, há impasses). - Nenhuma fonte foi carregada. Por isso, todo texto será medido de forma incorreta. Todos os caracteres têm uma altura fixa de aproximadamente 20 px e largura de 1 px.
ComposeTestRule.waitUntil {}
não gera a linha de execução principal enquanto está aguardando, ficando efetivamente igual aComposeTestRule.mainClock.advanceTimeUntil {}
. Provavelmente mais limitações vão ser identificadas no futuro (I284fa).
- Não há bitmap nativo, então
Regras de perfil adicionadas
Nesta versão, adicionamos as regras de perfil aos seguintes módulos do Compose (I14ed6):
- androidx.compose.animation
- androidx.compose.animation-core
- androidx.compose.foundation
- androidx.compose.foundation-layout
- androidx.compose.material
- androidx.compose.material-ripple
- androidx.compose.runtime
- androidx.compose.ui
- androidx.compose.ui.geometry
- androidx.compose.ui.graphics
- androidx.compose.ui.text
- androidx.compose.ui.text
- androidx.compose.ui.unit
- androidx.compose.ui.util
O que são as regras de perfil?
As regras de perfil para uma biblioteca são especificadas em um arquivo de texto
baseline-prof.txt
localizado no diretóriosrc/main
ou equivalente. O arquivo especifica uma regra por linha. Nesse caso, uma regra é um padrão para a correspondência de métodos ou classes na biblioteca. A sintaxe dessas regras é um superconjunto do formato de perfil do ART legível que é usado junto comadb shell profman --dump-classes-and-methods ...
. Essas regras podem ter uma das duas formas destinadas a métodos ou classes.Uma regra de método tem o seguinte padrão:
<FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
E uma regra de classe tem o seguinte padrão:
<CLASS_DESCRIPTOR>
Aqui,
<FLAGS>
é um ou mais dos caracteresH
,S
eP
, para indicar se esse método precisa ser sinalizado como "Hot" (frequente), "Startup" (de inicialização) ou "Post Startup" (pós-inicialização).O
<CLASS_DESCRIPTOR>
é o descritor da classe à qual o método desejado pertence. Por exemplo, a classeandroidx.compose.runtime.SlotTable
teria o descritorLandroidx/compose/runtime/SlotTable;
.A
<METHOD_SIGNATURE>
é a assinatura do método e inclui o nome, os tipos de parâmetro e os tipos de retorno do método. Por exemplo, o métodofun isPlaced(): Boolean
emLayoutNode
tem a assinaturaisPlaced()Z
.Esses padrões podem ter caracteres curinga (
**
,*
e?
) para que uma única regra inclua vários métodos ou classes.
O que as regras fazem?
Um método com a flag
H
indica que ele é um método "hot" (frequente) e precisa ser compilado com antecedência.Um método com a flag
S
indica que ele é chamado na inicialização e precisa ser compilado com antecedência para evitar o custo da compilação e interpretação dele no momento da inicialização.Um método com a flag
P
indica que ele é chamado após a inicialização.A presença de uma classe nesse arquivo indica que ela é usada durante a inicialização e precisa ser pré-alocada no heap para evitar o custo do carregamento dela.
Como isso funciona?
- As bibliotecas podem definir essas regras que serão empacotadas nos artefatos do AAR. Quando um app é criado com esses artefatos, essas regras são mescladas e usadas para criar um perfil do ART binário, compacto e específico para o app. O ART poderá usar esse perfil quando o app for instalado em dispositivos para compilar antecipadamente um subconjunto específico do app e melhorar o desempenho dele, especialmente a primeira execução. Isso não terá efeito nos aplicativos depuráveis.
Versão 1.0.0-beta08
2 de junho de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta08
. A versão 1.0.0-beta08 contém estas confirmações.
Mudanças na API
- A enumeração
NestedScrollSource
foi substituída por uma classe in-line (Ie321b, b/187055290). FocusManager.clearFocus(forcedClear = true)
foi renomeado comoFocusManager.clearFocus(force = true)
(Ia0c41).- Os usos de tipos enumerados para classes inline foram refatorados para evitar problemas com a adição de instruções quando novos valores de tipos enumerados são adicionados (I2b5eb).
- A
@ExperimentalComposeUiApi
foi removida dasPopupProperties
(I01fa6). - O
PointerType
foi mudado de uma enumeração para uma classe in-line (If5058). - As propriedades de semântica de ContentDescription e Text não são mais valores únicos, mas sim listas. Isso permite mesclá-las sem alterações em vez de como concatenações. Também disponibilizamos APIs de teste melhores para usar essas mudanças (Ica6bf, b/184825850).
- A função
Modifier.focusModifier()
foi descontinuada e substituída porModifier.focusTarget()
(I6c860). Modifier.onSizeChanged()
eModifier.onGloballyPositioned()
não são mais funções in-line (I727f6, b/186109675).- A enumeração
KeyboardType
foi substituída por uma classe in-line (I73045, b/187055290). - A enumeração
FocusState
foi substituída por uma interfaceFocusState
(Iccc1a, b/187055290). - A enumeração ImeAction foi substituída por uma classe in-line (I18be5, b/187055290).
- A
PlaceholderVerticalAlign
foi convertida em uma classe in-line (If6290). - TextUnitType agora é uma classe in-line (I4cba9).
- As funções
AnnotatedString.withAnnotation
agora são ExperimentalTextApi em vez de ExperimentalComposeApi (I0cd0a).- O construtor TextUnit com TextUnitType agora é ExperimentalTextApi em vez de ExperimentalComposeApi.
Correções de bugs
- Correção do bug introduzido na versão beta07 em que os itens LazyColumn/Row eram exibidos parcialmente após a rolagem (I8c9ac, b/188566058).
- Agora,
detectDragGesures
,detectVerticalGestures
edetectHorizontalGestures
consomem a mudança de posição automaticamente, sem necessidade de chamar change.consumePositionChange nos callbacks onDrag (I42fc4, b/185096350, b/187320697). - LayoutModifiers que forneciam linhas de alinhamento foram corrigidos. Foi corrigido um bug em que o elemento pai não era medido novamente quando as linhas de alinhamento dos elementos filhos mudavam (I4401f, b/174315652).
- O
Modifier.onGloballyPositioned()
foi mudado para informar as coordenadas desse modificador na cadeia de modificadores, e não as coordenadas de layout depois de aplicar todos os modificadores. Isso significa que agora a ordem dos modificadores afeta as coordenadas que seriam informadas (Ieb67d, b/177926591).
Versão 1.0.0-beta07
18 de maio de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta07
. A versão 1.0.0-beta07 contém estas confirmações.
Mudanças na API
- A interface
ViewRootForInspector
foi adicionada para uso no inspetor (Ib70df). SubcomposeLayoutState
agora é compatível com a configuração de contagem de slots reutilizáveis. O layout vai manter os slots de contagem ativos, em vez de os descartar, para reutilizar o slot na próxima vez que um novo for necessário (Ieb981).- A enumeração KeyEventType foi substituída por uma classe in-line (Id670a, b/187055290).
- A enumeração
FocusDirection
foi substituída por uma classe in-line (Ib6d03, b/187055290, b/184086802). - Foi adicionada a possibilidade de elevar o estado de SubcomposeLayout, que permite pré-compor o conteúdo em um slotId obrigatório e faz a próxima medição ser transmitida mais rapidamente, já que, quando tentarmos subcompor com o slotId fornecido da próxima vez, não vai haver composições necessárias (I42580, b/184940225).
- Uma alça de seleção de clipe foi adicionada (Iff80d, b/183408447).
- As APIs não utilizadas relacionadas ao suporte do LayoutInspector foram removidas (I2ac78).
Correções de bugs
- LazyColumn/Row manterá até dois itens visíveis anteriormente ativos (não descartados), mesmo quando eles já tiverem rolado para fora da tela. Isso permite que o componente reutilize as subcomposições ativas quando precisarmos compor um novo item, o que melhora o desempenho de rolagem (Ie5555).
- Os
TextGeomerticTransform
eTextDecoration
emAnnotatedString
serão aplicados conforme fornecidos (I61900, b/184760917).
Versão 1.0.0-beta06
5 de maio de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta06
. A versão 1.0.0-beta06 contém estas confirmações.
Mudanças na API
- Resolução de conflitos com o gesto de navegação (I1145e).
@ComposeCompilerApi
não mais@RequiresOptIn
(Iab690).- Novas APIs de acessibilidade CollectionInfo e CollectionItemInfo, que permitem marcar a coleção e os itens relacionados para serviços de acessibilidade (Id54ef, b/180479017).
- Novo
SemanticsActions.ScrollToIndex
para rolar uma lista com itens indexados até um item com determinado índice, eSemanticsProperties.IndexForKey
para conferir o índice de um item de uma lista com itens com chave. As duas ações são implementadas por LazyList.- Novo
SemanticsNodeInteraction.performScrollToIndex
, que rola uma lista até o índice especificado, eSemanticsNodeInteraction.performScrollToKey
, que rola uma lista até o item com a chave especificada (I4fe63, b/178483889, b/161584524).
- Novo
- A ownerViewId foi adicionada a GraphicLayerInfo (I19f62).
- Novas sobrecargas de Font() para carregar fontes de recursos, File e FileDescriptor (I5d382).
- Novo
error
da API de acessibilidade, que permite marcar um nó com uma entrada inválida (I12997, b/180584804, b/182142737). - Adicionadas sobrecargas de
Font()
para carregar fontes de recursos, File e FileDescriptor (I43007). - Suporte para salvar a AnnotatedString no
TextFieldValue.Saver
. As funções utilitáriasaddTtsAnnotation
e withAnnotation foram adicionadas aoAnnotatedString.Builder
(I8cbdc, b/178446304). - Nova função do construtor TextUnit
TextUnit(value: Float, type: TextUnitType)
(I7ecce, b/178446304).
Versão 1.0.0-beta05
21 de abril de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta05
. A versão 1.0.0-beta05 contém estas confirmações.
Mudanças na API
- Adição de
FocusManager.moveFocus(In)
eFocusManager.moveFocus(Out)
experimentais (Ic5534, b/183746743) - Adição da API experimental
performTextInputSelection
(I2dcbb, b/178510628) - O uso da interface
InputEventCallback
foi descontinuado. Não era possível usar a interface em nenhuma API pública, e não havia utilidade no código (I34a02, b/184003208). - Função
TextLayoutResult/createTextLayoutResult
com uso suspenso. Trata-se de uma função pública não utilizada que foi adicionada para teste. A função não faz nada que possa ser utilizado para compor APIs de texto. A função está com uso suspenso e será removida mais tarde (I80413).
Correções de bugs
- Foram corrigidas ações de rolagem de acessibilidade em
ACTION_SCROLL_FORWARD
,ACTION_SCROLL_BACKWARD
,accessibilityActionScrollLeft
,accessibilityActionScrollUp
,accessibilityActionScrollRight
eaccessibilityActionScrollDown
. Em vez de rolar até o final, agora a rolagem é feita por uma tela na direção indicada (Ieccb0). - Os arquivos AndroidManifest de ui-test-manifest e ui-tooling-data agora são compatíveis com o Android 12 (I6f9de, b/184718994).
Versão 1.0.0-beta04
7 de abril de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta04
. A versão 1.0.0-beta04 contém estas confirmações.
Mudanças na API
hideSoftwareKeyboard
eshowSoftwareKeyboard
emSoftwareKeyboardController
foram renomeados comohide()
eshow()
, respectivamente.- Fornecida a interface completa do CompositionLocal para LocalSoftwareKeyboardController, possibilitando que ela seja definida, já que é especialmente útil em testes (I579a6).
- Adição da API de acessibilidade LiveRegion. Se o nó estiver marcado como uma região ativa, os serviços de acessibilidade notificarão automaticamente o usuário sobre as mudanças (Idcf6f, b/172590946).
- Introdução de TextOverflow.Visible (Ic8f89).
Correções de bugs
- Corrigido o problema que ocorria quando os itens de
LazyColumn
/LazyRow
localizados nas bordas eram posicionados incorretamente depois da rolagem rápida (Ie4d13, b/183877420). AndroidViewBinding
agora remove corretamente os fragmentos inflados pelaFragmentContainerView
quando oAndroidViewBinding
é removido da hierarquia combinável (Ib0248, b/179915946).AndroidViewBinding
agora aninha corretamente os fragmentos inflados ao usar aFragmentContainerView
quando aComposeView
está dentro de umFragment
, corrigindo problemas ao salvar e restaurar o estado dele (I70eb0, b/179915946).- O Compose ViewBinding agora depende do
Fragment
1.3.2
e mostra de maneira consistente os fragmentos inflados usandoFragmentContainerView
após as mudanças na configuração (I0743d, b/179915946).
Versão 1.0.0-beta03
24 de março de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta03
. A versão 1.0.0-beta03 contém estas confirmações.
Mudanças na API
- Verificação adiada para dependências da ViewTree e da ComposeView (I8dbbf, b/182466548).
- Parâmetros
startX
/endX
estartY
/endY
opcionais foram adicionados às funçõesswipeUp
/swipeDown
/swipeLeft
/swipeRight
noGestureScope
(I49e2d, b/182063305).
Versão 1.0.0-beta02
10 de Março de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-beta02
. A versão 1.0.0-beta02 contém estas confirmações.
Mudanças na API
- Adicionada nova API de local de composição,
LocalSoftwareKeyboardController
, para substituir a interface SoftwareKeyboardController anterior no TextField (I5951e, b/168778053). - Adicionada nova API local de composição,
LocalSoftwareKeyboardController
, para substituir a interface SoftwareKeyboardController anterior no TextField (I84472, b/168778053). - Os seguintes
SemanticsMatcher
s foram removidos:hasWidth(width, tolerance)
hasHeight(height, tolerance)
hasLeftPosition(left, tolerance)
hasTopPosition(top, tolerance)
hasRightPosition(right, tolerance)
hasBottomPosition(bottom, tolerance)
(If16bd)
- Marcamos o seguinte
SemanticsMatchers
como @ExperimentalTestApi:hasWidth(width, tolerance)
hasHeight(height, tolerance)
hasLeftPosition(left, tolerance)
hasTopPosition(top, tolerance)
hasRightPosition(right, tolerance)
hasBottomPosition(bottom, tolerance)
(Ia600c)
- Os seguintes
SemanticsMatcher
s foram adicionados:hasWidth(width, tolerance)
hasHeight(height, tolerance)
hasLeftPosition(left, tolerance)
hasTopPosition(top, tolerance)
hasRightPosition(right, tolerance)
hasBottomPosition(bottom, tolerance)
(I2f502)
Correções de bugs
- Aplicação de restrições ao uso público de APIs experimentais (I6aa29, b/174531520).
androidx.compose.ui:ui
não depende mais de AppCompat ou Fragment. Se você estiver usando uma ComposeView no aplicativo com Fragment e/ou AppCompat, confira se está usando o AppCompat/Fragment 1.3 ou mais recente. Essas versões são necessárias para definir corretamente os proprietários do ciclo de vida e de estado salvo necessários para uma ComposeView (I1d6fa, b/161814404).- Foram corrigidos
rememberSaveable { mutableStateOf(0) }
corrompidos quando usados dentro de um destino navigation-compose (I1312b, b/180042685, b/180701630). - Adicionada nova API de local de composição,
LocalSoftwareKeyboardController
, para substituir a interface SoftwareKeyboardController anterior no TextField (I658b6, b/168778053). - Correção da rara NoSuchElementException no
tearDownRegistry()
deComposeRootRegistry
(Iddce1).
Versão 1.0.0-beta01
24 de fevereiro de 2021
Lançamento do androidx.compose.ui:ui-*:1.0.0-beta01
. A versão 1.0.0-beta01 contém estas confirmações.
Esta é a primeira versão do Compose 1.0.0 Beta.
Mudanças na API
- O callback onStart foi adicionado a
detectDragGestures
(I67269, b/179995594). - Modificadores de tamanho para intrínsecos não são mais experimentais (I15744).
- O MeasureBlocks foi renomeado como MeasurePolicy, que se tornou uma interface divertida. As APIs de layout foram atualizadas / simplificadas para usar MeasurePolicy (Icab48, b/167662468, b/156751158).
InteractionState
foi substituído por[Mutable]InteractionSource
.- As interfaces são responsáveis por emitir / coletar eventos de interação.
- Em vez de transmitir
interactionState = remember { InteractionState() }
para componentes comoButton
eModifier.clickable()
, useinteractionSource = remember { MutableInteractionSource() }
. - Em vez de
Interaction.Pressed in interactionState
, use as funções de extensão em InteractionSource, como InteractionSource.collectIsPressedAsState(). - Para casos de uso complexos, use InteractionSource.interactions para observar o fluxo de interações. Consulte as amostras e a documentação do InteractionSource para mais informações
- (I85965, b/152525426, b/171913923, b/171710801, b/174852378).
- Adição da interface AccessibilityMananger e LocalAccessibilityMananger em CompositionLocals (I53520).
- Os métodos LayoutCoordinates descontinuados foram removidos. Use a função em vez da propriedade para positionInParent e boundsInParent (I580ed, b/169874631, b/175142755).
- Typealiases substituídos por tipos subordinados:
ColorStop
agora éPair<Float, Color>
SpanStyleRange
agora é AnnotatedString.RangeParagraphStyleRange
agora éAnnotatedString.Range<ParagraphStyle>
StringAnnotation
agora éAnnotatedString.Range<String>
- (I8dd1a)
- Criação da nova TextInputSession para sessões de entrada pelos componentes de texto de baixo nível, como o CoreTextField (I8817f, b/177662148).
- Placeable agora expõe measuredSize, representando o tamanho em que o layout filho é realmente medido. Esse tamanho pode não respeitar as restrições de medidas (Ib2729, b/172560206, b/172338608).
- Foi adicionado o modificador selectionGroup, que permite marcar a coleção de Tabs ou RadioButtons para fins de acessibilidade (Ie5c29).
A
defaultFactory
paracompositionLocalOf
estaticCompositionLocalOf
agora é obrigatória, não opcional.Essa mudança remove um possível erro para tipos não anuláveis, em que nenhuma fábrica padrão era fornecida. Anteriormente, isso forneceria uma referência nula para um tipo não anulável.
Para tipos anuláveis, considere fornecer
{ null }
como a fábrica padrão.Não recomendamos o uso de locais com tipos não anuláveis, a menos que um padrão simples possa ser fornecido. Se não houver esse padrão, o lambda
defaultFactory
gerará uma exceção. No entanto, isso significa que os consumidores do local terão uma dependência implícita sendo fornecida, mas não aplicada pelo sistema de tipos (Ifbd2a).Métodos de módulos de interface descontinuados foram removidos (I646f6).
Os modificadores de tamanho foram renomeados. Modifier.width/height/size foi renomeado como requiredWidth/requiredHeight/requiredSize. Modifier.preferredWidth/preferredHeight/preferredSize foi renomeado como width/height/size (I5b414).
O
Modifier.tapGestureFilter
foi removido. UseModifier.pointerInput { detectTapGestures(...) }
(I266ed, b/175294473).O consumo parcial foi removido do sistema de entrada do ponteiro. A forma recomendada de coordenar o consumo parcial é Modifier.nestedScroll (Ie9c9b).
A orientação foi movida para o pacote básico. VelocirtTracker foi movido de ui.gesture para ui.input.pointer (Iff4a8, b/175294473).
imageResource e vectorResource agora são funções de extensão nos elementos complementares ImageBitmap e ImageVector, respectivamente. As funções
load{Image,Vector,Font}Resource
foram excluídas (I89130).AnimationClockObservable e subclasses foram removidos. AnimatedFloat foi removido (Icde52, b/177457083).
Providers foi renomeado como CompositionLocalProvider.
- O construtor Composition não aceita mais um parâmetro chave e foi descontinuado.
- A currentCompositeKeyHash foi transformada em uma propriedade combinável de nível superior, em vez de uma função combinável de nível superior.
- CompositionData e CompositionGroup foram movidos para o namespace androidx.compose.runtime.tooling.
- ComposableLambda foi transformada em uma interface em vez de uma classe concreta e não tem mais parâmetros de tipo.
- ComposableLambdaN foi transformada em uma interface em vez de uma classe concreta e não tem mais parâmetros de tipo.
- A função snapshotFlow foi movida para o namespace androidx.compose.runtime.
- O método de mesclagem de SnapshotMutationPolicy não é mais experimental.
- A função clearRoots de nível superior de @TestOnly foi removida. Ela não é mais necessária.
- As funções keySourceInfoOf e resetSourceInfo foram removidas. Elas não são mais necessárias.
- Composer.collectKeySourceInformation foi removido. Ele não é mais necessário.
- Os métodos isJoinedKey, joinedKeyLeft e joinedKeyRight foram removidos. Eles não são mais necessários.
- Várias APIs de nível superior foram movidas e reorganizadas em arquivos diferentes. Devido à semântica de classe de arquivos do Kotlin, essa mudança corrompe a compatibilidade binária, mas não a compatibilidade com a fonte. Portanto, isso não vai ser um problema para a maioria dos usuários
- (I99b7d, b/177245490).
ComponentActivity.setContent()
foi removido de compose:ui. Use o deandroidx.activity:activity-compose:1.3.0-alpha01
.viewModel()
eLocalViewModelStoreOwner
foram removidos de compose:ui. Use os deandroidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01
(I6f36b).O Modifier.scrollable foi reformulado. Agora, ele usa a interface Scrollable em vez da classe ScrollableController (I4f5a5, b/174485541, b/175294473).
O suporte a CustomEvens do PointerInputModifier foi removido (I02707, b/175294473).
SnapshotStateObserver não é mais experimental (Id2e6a).
Algumas APIs descontinuadas foram excluídas (Ice5da, b/178633932).
longPressGestureFilter e doubleClickGestureFilter foram removidos. Use Modifier.pointerInput com funções auxiliares, como detectTapGestures (I2fedf, b/175294473).
Foram removidos os usos refatorados da API String.format em vários métodos toString para não aproveitar o String.format internamente (Id1290).
Declarações dp foram removidas (I798d2).
Remoção de androidx.compose.runtime:runtime-dispatch (I55feb).
As ações de texto agora verificam o foco automaticamente (I13777, b/179648629).
Remoção de
runBlockingWithManualClock
(I15cdc, b/179664814).A posição de rolagem em Modifier.verticalScroll()/horizontalScroll() agora é representada com o Ints (I81298).
FlingConfig foi renomeado como FlingBehavior e agora permite a personalização da animação suspensa em vez da redução de valores predefinidos (I02b86, b/175294473).
Foi adicionada uma função auxiliar útil para definir a mesma ação para todos os callbacks ImeAction (I63447, b/179226323).
O callback SoftwareKeyboardController foi removido de todos os campos de texto para ser substituído por uma nova API em breve (Iae869, b/168778053).
FontSpan e FontWeigthStyleSpan não são mais usados e foram removidos (Ie5b56, b/177423444).
Foram feitas as seguintes mudanças na API do Material Design:
- Adição do parâmetro contentPadding a Top/BottomAppBar para permitir a personalização do padding padrão.
- Reordenados parâmetros no BackdropScaffold para seguir as diretrizes da API para parâmetros obrigatórios antes dos opcionais.
- O parâmetro
icon
em BottomNavigationItem foi movido para depois deselected
eonClick
. - O parâmetro
alwaysShowLabels
em BottomNavigationItem foi renomeado comoalwaysShowLabel
. - Os parâmetros
bodyContent
em alguns componentes foram renomeados comocontent
. - Parâmetros reordenados em
ButtonDefaults.buttonColors()
. Como o tipo dos parâmetros não mudou, isso não vai causar um erro no seu código. Confira se está usando parâmetros nomeados ou atualize a ordem manualmente; caso contrário o código não vai funcionar da mesma forma que antes. - Adição do parâmetro
secondaryVariant
adarkColors()
. Essa cor costuma ser a mesma quesecondary
no tema escuro, mas é adicionada para consistência e maior personalização. - Como ElevationDefaults e animateElevation() não eram muito usados / úteis, eles foram removidos da plataforma da API pública.
onValueChangeEnd
emSlider
foi renomeado comoonValueChangeFinished
e transformado em anulável.- O parâmetro
text
emSnackbar
foi renomeado comocontent
para manter a consistência. - Adição do parâmetro
contentPadding
aDropdownMenuItem
para permitir a personalização do padding padrão. Além disso,content
passou a ser uma extensão emRowScope
. ModalDrawerLayout
foi renomeado comoModalDrawer
.BottomDrawerLayout
foi renomeado comoBottomDrawer
- (I1cc66).
Correções de bugs
- Adição da API para usar recursos AnimatedVectorDrawable no Compose. Use
animatedVectorResource para carregar um XML
<animated-vector>
como um AnimatedImageVector e anime-o com painterFor (I8ea91). - Adição da nova API local combinável LocalSoftwareKeyboardController para substituir a interface SoftwareKeyboardController anterior no TextField (I658b6, b/168778053).
Versão 1.0.0-alpha12
10 de fevereiro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha12
. A versão 1.0.0-alpha12 contém estas confirmações.
Mudanças na API
- O suporte a ViewGroups foi removido do UiApplier. Os elementos combináveis emitView com uso descontinuado foram removidos (Ifb214).
- Agora, Modifier.pointerInput requer que as chaves remember indiquem quando a corrotina de detecção de entrada do ponteiro precisa ser reiniciada para novas dependências (I849cd).
- CompositionReference foi renomeada como ComposeContext (I53fcb).
- Bounds foi renomeado como DpRect (I4b32a).
- Atualização de testes: hasText() vai conferir se há texto de entrada e de etiqueta/dica/marcador no campo de texto (Iab803).
- O elemento combinável viewModel() e o objeto LocalViewModelStoreOwner foram movidos para androidx.lifecycle.viewmodel.compose. Para usá-los, adicione uma dependência separada do androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 (I7a374).
- Permissão de ação anulável em AccessibilityAction e mudança de rótulo de ação em AccessibilityAction e CustomAccessibilityAction de CharSequence para String (I0dc82).
- Para se adequar melhor às convenções de nomenclatura com ImageBitmap e ImageVector, o ImagePainter foi renomeado como BitmapPainter para o VectorPainter paralelo (Iba381, b/174565889).
- Melhoria das APIs de teste de substring que agora usam substrings como argumentos (Icbe78).
- Foi adicionado um
Modifier.focusOrder()
, que aceita um FocusRequester sem especificar uma ordem de foco personalizada como lambda. Isso é útil quando precisamos apenas especificar uma referência, mas não uma ordem de foco personalizada para um elemento combinável (I4f52a, b/179180978). - ComponentActivity.setContent foi movido para androidx.activity.compose.setContent no módulo androidx.activity:activity-compose (Icf416).
- Os métodos de desestruturação e copy() foram removidos de várias classes em que raramente eram usados (I26702, b/178659281).
- O pop-up foi movido para ser específico da plataforma. AndroidPopupProperties foi renomeado como PopupProperties, e
isFocusable
foi movido para um parâmetrofocusable
emPopupProperties
(Ieeea5). - Caixa de diálogo movida para ser específica da plataforma. Renomeação de AndroidDialogProperties para DialogProperties (I4ef69, b/179138130).
- LayoutNode passou a ser interno (I8a7b1, b/175103944).
- Constraints.enforce foi substituído por Constraints.constrain (I8b8ea).
- O uso de loadFontResource foi descontinuado. Use fontResource. O uso de imageResource, loadImageResource, vectorResource e loadVectorResource foi descontinuado. Use painterResource (I6b809).
- Por motivos de performance, a semântica ScrollAxisRange agora usa lambdas que retornam Floats em vez de valores Float diretos (If4a35, b/178657186).
- A semântica EditableText foi adicionada para marcar o texto de entrada editável do campo para acessibilidade e os métodos de teste correspondentes para conferir a semântica (I8e07a).
- OwnerLayer/OwnerScope/OwnerSnapshotObserver passaram a ser internos (I4ffaf, b/175103944)
- toIntPx() foi renomeado como roundToPx() (I9b7e4, b/173502290).
- IntBounds foi renomeado como IntRect, e a API foi aprimorada (I1f6ff).
- A API Snapshot foi atualizada para ser mais consistente com as diretrizes da API, bem como com a ocultação de classes de implementação internas da API pública (Id9e32).
- Adicionadas ações de semântica de expansão e recolhimento. Expand e halfExpand foram adicionados em ModalBottomSheetState (Ib5064).
- O uso de Modifier.dragGestureFilter foi descontinuado. Use
Modifier.pointerInput { detectDragGestures (...)}
. Outra opção é usar Modifier.draggable para arrastar apenas um eixo (I0ba93, b/175294473). - Ambients foi renomeado para corresponder à renomeação de Ambient como CompositionLocal. Ambients costumava ser chamado de AmbientFoo. Agora, CompositionLocals será chamado de LocalFoo (I2d55d).
- O BaseTextField de uso descontinuado foi removido. Use BasicTextField (I71368).
- A seleção foi movida para a base (I7892b).
- Da mesma forma que removemos o elemento combinável
state { 0 }
e agora promovemos o uso deremember { mutableStateOf(0) }
, também vamos remover o elemento combinávelsavedInstanceState { 0 }
. UserememberSaveable { mutableStateOf(0) }
para salvar e restaurar automaticamente se o tipo usado dentro de MutableState puder ser armazenado no pacote. Se você transmitia um objeto de economia personalizado, agora vai precisar usar uma nova sobrecarga de rememberSaveable, que tem o parâmetrostateSaver
. O uso será assim:val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) }
(Ib4c26, b/177338004). - Adição de semântica de senha para acessibilidade (I231ce).
- ProgressBarRangeInfo.Indeterminate foi adicionado para marcar barras de progresso indeterminadas para acessibilidade (I6fe05).
- O uso dos utilitários
emptyContent()
e(@Composable () -> Unit).orEmpty()
foi descontinuado por não terem mais valor ou impacto positivo na performance (I0484d). snapshotFlow
ewithMutableSnapshot
não são mais experimentais (I6a45f).- Os recompositores agora podem ser fechados. Os recompositores fechados continuarão a recomposição até que as corrotinas filhas sejam compostas. Recomposer.shutDown foi renomeado para eliminar o contraste com o fechamento (Ib6d76).
- UiSavedStateRegistry foi renomeado como SaveableStateRegistry, AmbientUiSavedStateRegistry foi renomeado como AmbientSaveableStateRegistry, e ambos foram movidos para o pacote androidx.compose.runtime.saveable (I30224).
- O artefato androidx:compose:runtime:runtime-saved-instance-state foi renomeado como androidx:compose:runtime:runtime-saveable (I6dcac).
- Várias APIs antigas que tiveram o uso descontinuado no pacote da interface foram excluídas (I2f2dc).
- O uso do artefato compose:runtime-dispatch foi descontinuado. A interface MonotonicFrameClock agora pode ser encontrada em compose:runtime, e a classe AndroidUiDispatcher pode ser encontrada em compose:ui (Ib5c36).
- As classes Outline.* não são mais classes de dados (I4879e, b/178001427).
view.captureToImage()
foi removido sem nenhuma substituição (I7fcd2).- A API ColorMatrix, usada para modificar valores RGB de conteúdo de origem da API Refactored ColorFilter, foi introduzida para ser uma interface e corresponder à implementação de PathEffect (Ica1e8).
- Adição do parâmetro layoutDirection ao createOutline de Shape. Isso permite criar formas com reconhecimento da direção do layout (I57c20, b/152756983).
- O uso de onImeActionPerformed foi descontinuado. Agora, use KeyboardActions (If0bbd, b/179071523).
- Adicionado um elemento de
contexto de corrotina
InfiniteAnimationPolicy
que vai ser aplicado em animações infinitas. Por padrão, nenhuma política é instalada, exceto durante a execução de testes comComposeTestRule
(I50ec4, b/151940543). - canDrag foi removido de Modifier.scrollable (Id66e7, b/175294473).
- Renomeação de LayoutCoordinates.parentCoordinates como LayoutCoordinates.parentLayoutCoordinates para permitir uma nova propriedade parentCoordinates. A propriedade parentCoordinates agora oferece os LayoutCoordintes do modificador pai. Isso tornará os casos de uso mais completos para onSizeChanged() e onGloballyPositioned() (Idfbfd, b/177926591).
- O uso de tapGestureFilter, doubleTapGestureFilter, longPressGestureFilter e pressIndicaitonGestureFilter foi descontinuado. Use Modifier.clickable ou Modifier.pointerInput com a função detectTapGestures (I6baf9, b/175294473).
- O unregisterProvider de SaveableStateRegistry foi removido. Agora, registerProvider() retorna o objeto SaveableStateRegistry.Entry, que você pode usar para cancelar inscrição (Ic4274, b/178583739).
- rememberSavedInstanceState() foi renomeado como rememberSaveable() e movido para o pacote androidx.compose.runtime.saveable (I1366e, b/177338004).
- Remoção de CoreText e CoreTextField da API pública.
- .
- A sobrecarga SelectContainer descontinuada foi removida
- (I99c19).
- Os testes em que o Compose é usado em hierarquias adicionadas ou removidas diretamente do WindowManager agora são mais estáveis (Ie81ed, b/175765614).
- Recomposer.current() foi removido. Por padrão, [Abstract]ComposeView agora usa recompositores criados de forma lenta e com escopo de janela gerados pelo ViewTreeLifecycleOwner para a janela. As marcações de animação com base em withFrameNanos e em recomposição vão ser pausadas enquanto o ciclo de vida do host estiver parado (I38e11).
- O Recomposer.runningRecomposers agora oferece um StateFlow global de RecomposerInfo somente leitura para observar o estado de composição em andamento no processo. Use essa API em vez de Recomposer.current(), que agora teve o uso descontinuado (If8ebe).
- Saver, listSaver(), mapSaver() e autoSaver foram movidos de androidx.compose.runtime.savedinstancestate para androidx.compose.runtime.saveable (I77fe6).
- Os EditCommands aceitam AnnotatedString. No entanto, essa é uma mudança apenas na API, e a edição de texto em vários estilos ainda não foi implementada (I4c3ea).
- O tempo de atividade e a duração foram removidos (Ib9bf4, b/177420019).
- ComposeData.asTree() e APIs relacionadas foram movidas para o módulo ui-tooling-data separado e marcadas como experimentais (Ic95b8).
- Os parâmetros em RounderCornerShape, CutCornerShape e CornerBasedShape foram renomeados de esquerda/direita para início/fim para oferecer suporte ao espelhamento automático do formato na direção RTL. AbsoluteRounderCornerShape e AbsoluteCutCornerShape foram introduzidos para os casos em que o espelhamento automático não é desejado (I61040, b/152756983).
A API à qual o plug-in do compilador do Compose é destinado foi refatorada para usar uma interface em vez de uma classe concreta. A interface também não usa mais um parâmetro de tipo.
Essa é uma mudança interna que não afeta a compatibilidade do código-fonte, mas é uma alteração interruptiva binária (I3b922, b/169406779).
Remoção da função pública StringBuilder.deleteAt não intencional (Id6ed9).
Correções de bugs
- ComposeViews colocadas em hierarquias de visualização que são filhas de outra composição agora hospedam composições filhas dos ancestrais (I92883).
- A API imageFromResource do Compose foi atualizada para reutilizar o cache de drawable de recurso ao carregar objetos ImageBitmap (If3627, b/178751994).
Versão 1.0.0-alpha11
28 de janeiro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha11
. A versão 1.0.0-alpha11 contém estas confirmações.
Mudanças na API
- WithConstraints foi reformulada como BoxWithConstraints e movida para foundation.layout (I9420b, b/173387208).
- O uso de Key.DPadUp foi descontinuado. Use Key.DirectionUp (Iab335, b/177954892).
- A interface do proprietário é interna a partir de agora (If8e35).
- Adição da API FocusManager.moveFocus() para mover o foco de forma programática (I045cb, b/177681839).
- Mudança de PopupPositionProvider para usar coordenadas relativas à janela em vez de coordenadas globais. Renomeação de parentGlobalBounds como anchorBounds e mudança de windowGlobalBounds para windowSize: IntSize (I2994a).
- Duration e Uptime vão ser substituídos por milissegundos Long, e essa etapa vai remover a dependência de entrada do ponteiro nessas classes (Ia33b2, b/175142755, b/177420019).
- AmbientSavedStateRegistryOwner foi adicionado de forma semelhante aos já existentes AmbientLifecycleOwner e AmbientViewModelStoreOwner (I9a3e8, b/176756365).
- A API de gráficos vetoriais foi atualizada para ser oferecer suporte à análise de tonalidades aplicada à raiz dos gráficos vetoriais (Id9d53, b/177210509).
- Adição de toolType a PointerInputChange para diferenciar dispositivos (Iac787, b/175142755).
- AmbientWindowManager foi renomeado como AmbientWindowInfo (I2686a, b/177084714, b/177084983).
- O uso dos métodos de coordenadas globais foi descontinuado, e foram criados novos métodos de coordenadas baseados em janela (Iee284).
- Modifier.toolingGraphicsLayer, que adiciona um modificador de camada gráfica quando a inspeção é ativada, foi adicionado (I315df).
- FocusRequester.createRefs agora está marcado como experimental, já que pode sofrer mudanças (I2d898, b/177000821).
- SemanticsPropertyReceiver.hidden foi renomeada como invisibleToUser e marcada como @ExperimentalComposeUiApi. AccessibilityRangeInfo foi renomeado como ProgressBarRangeInfo. stateDescriptionRange foi renomeado como progressBarRangeInfo. AccessibilityScrollState foi renomeado como ScrollAxisRange. horizontalAccessibilityScrollState foi renomeado como horizontalScrollAxisRange. verticalAccessibilityScrollState foi renomeado como verticalScrollAxisRange (Id3148).
- PointerInputData foi removido, e PointerInputChange foi modificado para fornecer todos os campos de PointerInputData. PointerInputEvent e PointerInputEventData agora são internos porque não são usados em nenhuma API pública (Ifff97, b/175142755).
- Atualização da implementação de densidade do GraphicsLayerScope para oferecer compatibilidade com as conversões de dp em pixels brutos (Ied528, b/176819695).
- A API de matriz foi atualizada para seguir a ordem principal das linhas e fornecer constantes de índice com o objetivo de auxiliar nas conversões entre diferentes representações de matrizes e corresponder à lógica de conversão do framework entre SkMatrix e Matrix4 internamente (I432e6).
- Remoção dos métodos monotonicFrameAnimationClockOf experimentais (Ib753f, b/170708374).
- String.fintPrecedingBreak e String.fingFollowingBreak foram movidos para a InternalTextApi (I657c4).
- androidx.compose.ui.util.isSurrogatePair foi removido da API pública (Ia9494).
- TransformedText.transformedText foi renomeado como TransformedText.text
- TransformedText não é mais uma classe de dados (Ie672a).
data class
foi removido das seguintes classes:- InlineTextContent
- LocaleList (I605c7).
- As seguintes classes não são mais classes de dados:
- AnnotatedString
- ParagraphStyle
- SpanStyle
- TextStyle
- FontWeight
- TextDecoration
- TextGeometricTransform
- TextIndex
- TextLayoutResult
- TextLayoutInput (Iaff99).
- Alteração de VisualTransformation para ser uma interface funcional (I3bba4).
- Adição de um tipo de parâmetro de referência de função (I5e1bd).
- Adição de limites transformados ao InspectorNode (Ice42f).
Correções de bugs
- Os elementos onCommit, onDispose e onActive foram descontinuados e substituídos pelas APIs SideEffect e DisposableEffect (If760e).
Mudanças nas funções de fábrica de Font/FontFamily/Typeface
- Foram adicionadas funções de fábrica que começam com letra maiúscula.
- Funções antigas de fábrica com letras minúsculas foram descontinuadas.
- As novas funções de fábrica retornam a FontFamily em vez das subclasses.
- Os construtores das subclasses foram ocultados para que só possam ser construídos pelas funções de fábrica.
- Renomeação de Font.asFontFamily como Font.toFontFamily (I42aa7).
Adição de
ComposeContentTestRule
, que estendeComposeTestRule
e definesetContent
, que foi removido deComposeTestRule
. Foi adicionado um método de fábricacreateEmptyComposeRule()
que retorna umaComposeTestRule
e não inicia uma atividade para você. Use isso quando quiser iniciar a atividade durante o teste, por exemplo, usandoActivityScenario.launch
(I9d782, b/174472899).animateAsState agora é animateFooAsState, em que Foo é o tipo da variável que está sendo animada. Por exemplo, Float, Dp, Offset etc (Ie7e25).
O parâmetro de descrição de conteúdo foi adicionado a Image e Icon. Ele é usado para fornecer a descrição para os serviços de acessibilidade (I2ac4c).
Remova displaySize, porque isso precisa ser evitado. Normalmente, é melhor usar o tamanho de onRoot() ou pelo menos o tamanho da janela (I62db4).
OnSizeChanged estava relatando o tamanho do conteúdo do layout. Agora, ele informa o tamanho na posição em que está na cadeia do modificador (I36b78, b/177562900).
A API emit() e todas as sobrecargas foram descontinuadas e renomeadas como ComposeNode. As APIs são idênticas, apenas um nome diferente para seguir as convenções de nomenclatura do Compose (I4137b).
TextFieldValue aceita AnnotatedString. No entanto, essa é uma mudança apenas na API, e a edição de texto em vários estilos ainda não foi implementada.
initial
foi removido dos parâmetros do construtor EditingBuffer (I326d5).
Os elementos invalidate e compositionReference() foram descontinuados e substituídos por currentRecomposeScope e rememberCompositionReference, respectivamente (I583a8).
AnnotatedString foi alterada para ser estendida de kotlin.CharSequence. Portanto, length e subSequence agora são funções de instância, e as funções de extensão foram removidas (Iaf429).
O RememberObserver substituiu o CompositionLifecycleObserver, e o uso de CompositionLifecycleObserver foi descontinuado.
RememberObserver
é uma substituição deCompositionLifecycleObserver
com semânticas modificadas e métodos renomeados. A mudança para a nova API pode ser feita de maneira mecânica para objetos que são lembrados apenas uma vez e continua a ser a prática recomendada. No entanto, se uma referência foi lembrada mais de uma vez em uma composição,onRemembered
é chamado para cada referência em queonEnter
é chamado apenas uma vez.onEnter
era chamado várias vezes quando o objeto era usado em subcomposições, comoWithConstraints
eScaffold
, tornando a única garantia de chamada deonEnter
não confiável, e foi removido paraRememberObserver
.A interface
RememberObserver
adiciona a funçãoonAbandoned
, que é chamada se a instância deRememberObserver
é retornada do callback transmitido pararemember
, mas não é lembrada no estado de composição e, portanto, a chamada deonRemembered
nunca ocorre. Isso poderá ocorrer se uma exceção encerrar a composição antes de ela ser concluída ou se a composição for descartada porque o estado para o qual ela estava produzindo uma composição não é mais atual ou necessário. Se a instância deRememberObserver
após a recomendação de referência única acima estiver rastreando um recurso externo,onForgotten
eonAbandoned
vão indicar que o recurso não é mais necessário. Se o objeto estiver rastreando o trabalho iniciado ou os recursos alocados emonRemembered
, a funçãoonAbandoned
pode ser ignorada, porque não vai ser chamada se aonRemembered
for chamada (I02c36).Operações aritméticas entre 2 ou mais TextUnits foram suspensas. As funções TextUnit.Sp e TextUnit.Em foram descontinuadas para dar preferência às funções de extensão, como Int.sp e Int.em (I48369).
Recursos em bibliotecas sem recursos declarados explicitamente como públicos (por exemplo, com public.xml) agora são particulares por padrão (Ia1dcc, b/170882230).
O uso de ScrollableColumn/Row foi descontinuado. O uso do ScrollableColumn é menos eficiente se comparado ao LazyColumn quando você tem um conteúdo de rolagem grande, porque com o LazyColumn, só é possível escrever, medir ou desenhar elementos visíveis. Para evitar que os usuários escolhessem uma forma não eficiente, decidimos descontinuar o uso de ScrollableColumn e de ScrollableRow e, em vez disso, promover o uso de LazyColumn e LazyRow. Os usuários ainda podem decidir que não precisam do comportamento lento e usar os modificadores diretamente como Column(Modifier.verticalScroll(rememberScrollState())) (Ib976b, b/170468083).
Novo método de fábrica
items(count: Int)
para o escopo de LazyColumn/LazyRow/LazyVerticalGrid. Agora,items(items: List)
eitemsIndexed(items: List)
são funções de extensão, então você vai precisar fazer a importação delas manualmente quando forem usadas. Novas sobrecargas de extensão para matrizes:items(items: Array)
eitemsIndexed(Array)
(I803fc, b/175562574).Use ImeAction.None em vez de ImeAction.NoAction.
- Use ImeAction.Default em vez de ImeAction.Unspecified (Ie1bcc).
Experimente usar o TestCoroutineDispatcher nos testes (I532b6).
TextInputService.onStateUpdated foi renomeado como updateState (Id4853).
A Transition baseada em TransitionDefinition foi descontinuada (I0ac57).
TextUnitType.Inherit foi removido. Use TextUnitType.Unspecified (I9ff64).
Versão 1.0.0-alpha10
13 de janeiro de 2021
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha10
. A versão 1.0.0-alpha10 contém estas confirmações.
Alteração interruptiva
A reestruturação da API do compilador interno permite criar lotes de mudanças nos nós gerados como resultado da composição na fase de "aplicar mudanças", após a conclusão de todas as funções
@Composable
.Essa é uma mudança comportamental que pode afetar o código do aplicativo, já que os nós não estão mais disponíveis em APIs internas e experimentais até que as mudanças sejam aplicadas. Isso pode ser resolvido com código circundante com dependências em um composto
SideEffect
para adiar a execução do código até que os nós tenham sido criados e inicializados (I018da).
Mudanças na API
- Adicionado o elemento Modifier.focusOrder(), que pode ser usado para especificar uma ordem de travessia de foco personalizada (I90cf5, b/175899543, b/170155556, b/170155429).
- O elemento focusObserver descontinuado foi removido. Use onFocusChanged ou onFocusEvent (I3ecb9, b/175156387).
- Mudanças na API EditOperations.
- Renomeação de EditOperation como EditCommand.
- Adição do sufixo Command para implementações concretas do EditOperation.
- EditCommands não são mais classes de dados.
- Renomeação da função EditOperation.process como applyTo.
- Renomeação de InputEventListener como InputEventCallback
- (I0a366).
- Remoção de Px Squared, PxCubed, PxInverse. Alteração de Size.center() para ser uma propriedade (I973f7).
- O módulo ui-test agora vai poder configurar a criação de Recompositores para IUs em teste (Ibebd8).
- Modificação de Velocity para ter partes de componentes e operações matemáticas (Ib0447).
@ExperimentalTesting
foi renomeado para@ExperimentalTestApi
para ser consistente com anotações de API experimentais semelhantes (Ia4502, b/171464963).- Renomeação de Color.useOrElse() como Color.takeOrElse() (Ifdcf5).
- Foram removidas as classes DpInverse, Dp Squared e DpCubed (I4d62b).
- Constraints#satisfiedBy foi renomeado como isSatiendedBy (I9cf5c).
- Adição de callback para notificar o proprietário quando os limites do layoutnode mudam (I72fd1).
- Adição de isSpecified, isUnspecified e useOrElse para classes in-line com uma constante Unspecified (I93f7b, b/174310811).
Expansão das APIs [Abstract]ComposeView para permitir a reciclagem de visualizações baseadas no Compose, descartando a composição delas para recriar novamente mais tarde. Foram adicionadas APIs para instalar e descobrir Recomposers e CompositionReferences com escopo de janela para criar composições filhas.
Adição do ViewComposeStrategy para configurar a estratégia de descarte de composição do [Abstract]ComposeViews. O comportamento padrão é descartar na remoção da janela (I860ab).
Remoção da API public Any.identityHashCode() (I025d7).
A API toStringAsFixed foi removida e substituída por String.format para uso direto (Iaba6b).
Adição de Toggle a Strings.kt de fundação (I4a5b7, b/172366489).
O nativeClass foi movido para o módulo ui e definido como interno. Atualização dos usos de nativeClass em implementações equivalentes para usar "is MyClass" (I4f734).
O uso de Modifier.focus() e Modifier.focusRequester() foi descontinuado. Use Modifier.focusModifier() e Modifier.focusReference() (I75a48, b/175160751, b/175160532, b/175077829).
Introdução do SelectionRegistrar.notifySelectableChange para notificar atualizações do Selectable ao SelectionManager (I6ff30, b/173215242).
Lançamento da propriedade Outline.bounds para receber o retângulo delimitador para várias implementações de contorno (I16e74, b/175093504).
O uso de TestUiDispatcher foi descontinuado. Em vez disso, use Dispatchers.Main (Ic171f, b/175385255).
ImeOptions e KeyboardOptions não são mais uma classe de dados (I3c898, b/16868431).
Mudanças na API VisualTransformation
- Renomeação de OffsetMap como OffsetMapping.
- Renomeação de OffsetMapping.identityOffsetMap como OffsetMapping.Identity.
- PasswordTransformation não é mais uma classe de dados.
- OffsetMapping foi movido para o próprio arquivo
- (I0bdf3).
Position foi renomeado como DpOffset e getDistance() foi removido (lb2dfd).
Mudança de Dp.isFiinite() para um Dp.isFiite (I50e00).
Correções de bugs
- O Recomposer agora expõe um fluxo do estado atual, permitindo o monitoramento da sua atividade e da atividade de efeitos associados (Ifb2b9).
- O keyEvent nativo agora pode ser acessado pelo keyEvent.nativeKeyEvent (I87c57, b/173086397).
animate()
agora é substituído poranimateAsState()
, que retorna umState<T>
em vez deT
. Isso permite uma performance melhor, já que o escopo de invalidação pode ser restrito ao local em que o valor do State é lido (Ib179e).- Adição da API Semantics Role e adição de Role como um parâmetro de SemanticsModifier clicável, selecionável e alternável. Modifier.progressSemantics foi mudado para que o controle deslizante também possa usá-lo (I216cd).
- Nova API baseada em corrotina
Animatable
que garante exclusividade mútua entre as animações.- Nova DecayAnimationSpec para oferecer suporte à animação de redução multidimensional
- (I820f2, b/168014930).
Versão 1.0.0-alpha09
16 de dezembro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha09
. A versão 1.0.0-alpha09 contém estas confirmações.
Mudanças na API
- O KeyEvent.Alt de uso descontinuado agora foi removido. Use KeyEvent.isAltPressed (Idd695).
- O uso de Modifier.keyInputFilter e Modifier.previewKeyInputFilter foi descontinuado. Use Modifier.onKeyEvent e Modifier.onPreviewKeyEvent (Idbf1b, b/175156384).
- O uso de Modifier.focusObserver foi descontinuado. Use Modifier.onFocusChanged ou Modifier.onFocusEvent (I30f17, b/168511863, b/168511484).
- Para suspender as APIs de entrada de ponteiro, HandlePointerInputScope foi renomeado como AwaitPointerEventScope, e handlePointerInput() como awaitPointerEventScope() (Idf0a1, b/175142755).
- A API Autofill agora é experimental e requer ativação (I0a1ec).
- Adição de declarações de desestruturação para criar instâncias de FocuSRequester (I35d84, b/174817008).
- accessibilityLabel foi renomeado como contentDescription. accessibilityValue foi renomeado como stateDescription (I250f2).
- Eventos personalizados foram removidos da API de entrada do ponteiro de suspensão (Ia54d5, b/175142755).
- Várias novas funções foram introduzidas no SelectionRegistrar, e onPositionChange foi renomeado notifyPositionChange (Ifbaf7).
- Mais membros de LayoutNode marcados como internos (I443c6).
- Introdução de LayoutInfo para ser usado por ferramentas e testes (I9b190).
- AndroidOwner agora é interno (Ibcad0, b/170296980).
- A anotação de ExperimentalPointerInput foi removida (Ia7a24).
- Adição do sistema de rolagem aninhado. Consulte Modifier.nestedScroll para mais detalhes (I36e15, b/162408885).
- subcomposeInto(LayoutNode) agora é interno (Id724a).
A interface
Applier
foi modificada para simplificar a criação de árvores de baixo para cima, em vez de cima para baixo.O método
insert()
foi renomeado comoinsertTopDown()
.Um novo método,
insertBottomUp()
, foi adicionado.Uma Applier insere nós na árvore que está editando com
insertTopDown()
ouinsertBottomUp()
, dependendo de qual apresenta melhor desempenho.Algumas árvores, como
LayoutNode
eView
, são muito mais eficientes para criação de baixo para cima do que de cima para baixo. Antes dessa mudança, uma pilha de inserções era necessária para implementar de baixo para cima. Ela precisava ser copiada para cada Applier, que precisava da construção de baixo para cima para ter bom desempenho. Com essa mudança, umApplier
substitui uminsertBottomUp()
para criar uma árvore de baixo para cima, einsertTopDown()
para criar a árvore de cima para baixo (Icbdc2).Adição das propriedades dismissOnBackPress e dismissOnClickOutside às AndroidDialogProperties. Elas permitem configurar quando o lambda onDismissRequest da caixa de diálogo será invocado (If5e17).
Adição da API painterResource para lidar com o carregamento opaco de objetos Painter de formatos de recursos rasterizados (como PNGs) ou VectorDrawables. Os consumidores não precisam mais determinar o tipo de recurso com antecedência e podem chamar esse método para receber um objeto Painter para uso em elementos combináveis Image ou modificadores de Painter (I2c703, b/173818471).
Adição de Modifier.clearAndSetSemantics para limpar a semântica dos descendentes e definir novas (I277ca).
O ContentDrawScope foi movido para o módulo ui-graphics para ser usado com o DrawScope (Iee043, b/173832789).
Introdução da API de gráficos PathEffect para fornecer padrões diferentes para formas traçadas. O elemento NativePathEffect foi descontinuado e substituído pela implementação real/esperada do PathEffect (I5e976, b/171072166).
Interfaces IdlingResource foram adicionadas ao Compose como variantes com suporte do Compose dos recursos de inatividade do Espresso. Elas podem ser registradas e ter o registro cancelado usando ComposeTestRule (I433f3).
Remoção do registro (ou do cancelamento do registro) global de ComposeIdlingResource e do registro (ou do cancelamento do registro) global dos relógios para ComposeIdlingResource (I32660).
Correções de bugs
- Lambdas em modificadores de deslocamento agora retornam IntOffset em vez de Float (Ic9ee5, b/174137212, b/174146755).
Remoção de SlotTable, SlotReader e SlotWriter da API pública. Antes, eles eram marcados como InternalComposeAPI. Agora, eles são internos do módulo do Compose.
CompositionData e CompositionGroup foram adicionados como substitutos da API de IU para extrair as informações da composição. Elas são públicas, mas não são destinadas para uso fora da API de interface, já que fornecem as informações brutas que a API de interface interpreta (I31a9c).
ShaderBrush foi refatorado para criar lentamente uma instância de sombreador quando as informações de dimensionamento do ambiente de desenho estão disponíveis. Isso é útil para definir gradientes que ocupam os limites de desenho completos de um elemento combinável no momento da composição, sem precisar fazer implementações DrawModifier personalizadas.
As APIs do construtor de função de gradiente foram descontinuadas e substituídas pelos métodos de fábrica em um objeto Gradient (I511fc, b/173066799).
LazyColumnFor, LazyRowFor, LazyColumnForIndexed e LazyRowForIndexed foram descontinuados. Use LazyColumn e LazyRow (I5b48c).
BuildCompat.isAtLeastR suspenso (Idb37e).
Adição da função de fábrica buildAnnotatedString para criar uma AnnotatedString. Descontinuação do uso da função builder da annotatedString (Idfe0b).
Remoção dos métodos de extensão em Float e Double para converter valores em radianos. Agora essa é uma função particular no PathParser de implementação, que é o único lugar em que isso era usado (I25f52).
Versão 1.0.0-alpha08
2 de dezembro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha08
. A versão 1.0.0-alpha08 contém estas confirmações.
Mudanças na API
- A ação semântica Dismiss foi adicionada (I2b706).
- As APIs DrawModifier foram movidas do pacote androidx.compose.ui para androidx.compose.ui.draw. Foi criado o arquivo DrawModifierDeprecated.kt para incluir os métodos typealiases/helper para ajudar na migração das APIs descontinuadas para as atuais (Id6044, b/173834241).
- Modifier.drawLayer foi renomeado como Modifier.graphicsLayer. Além disso, as classes relacionadas foram atualizadas para GraphicsLayer, de acordo com o feedback da API (I0bd29, b/173834241).
- Novos métodos placeable.placeWithLayer() e placeable.placeRelativeWithLayer() foram adicionados para permitir que layouts personalizados e modificadores de layout coloquem um filho na introdução de uma camada gráfica para os desenhos deles. Com isso, podemos primeiramente otimizar os desenhos refeitos, para que, quando precisarmos mover um filho, não seja necessário redesenhar o conteúdo. Em segundo lugar, podemos aplicar transformações de desenho a um filho (Ibd8f6, b/170296989, b/171493718, b/173030831).
<T>
foi removido da declaração de SubcomposeLayout. Você pode usá-lo sem especificar um tipo agora (Ib60c8).- Adição de APIs Modifier.scale/rotate
como conveniências para drawLayer.
- O elemento
Modifier.drawOpacity
foi renomeado comoModifier.alpha
. Modifier.drawShadow
foi renomeado comoModifier.shadow
(I264ca, b/173208140).
- O elemento
- Tornou os campos de posição e de tempo de atividade do PointerInputData não anuláveis (Id468a).
- Agora, o MaterialTheme define as cores corretas para as alças e para o segundo plano da seleção. Apps que não são do Material podem usar manualmente AmbientTextSelectionColors para personalizar as cores usadas para seleção (I1e6f4, b/139320372, b/139320907).
- WindowManager.isWindowFocused foi adicionado para conferir se a janela do host está em foco, assim como um WindowFocusObserver que fornece um callback de onWindowFocusChanged (I53b2a, b/170932874).
- A API TransformOrigin foi atualizada
para que a sintaxe de desestruturação retorne
pivotFractionX
epivotFractionY
comocomponent1
ecomponent2
(If43c4, b/173586560). - Uma verificação de lint foi adicionada para posicionamento e nomeação do parâmetro lambda combinável e conferir a consistência com as diretrizes do Compose.
Também ocorreu a migração de algumas APIs usando
children
como o nome da lambda final paracontent
, de acordo com a verificação e as orientações do lint (Iec48e). - Uma API foi adicionada para conferir se as teclas modificadoras Alt, Ctrl, Meta ou Shift eram pressionadas quando um evento de tecla era enviado (I50ed9).
- Uma nova sobrecarga de
Modifier.drawLayer()
foi adicionada. É necessário um bloco de lambdas em um novo GraphicsLayerScope, onde você define os parâmetros de camada de uma forma que permite pular a recomposição e o novo layout quando a mudança de estado acontece. O DrawLayerModifier agora é interno como forma de preparo para a migração da lógica para o método placeable.placeWithLayer() do LayoutModifier (I15e9f, b/173030831). - Ambientes nomeados com
Ambient
como sufixo foram descontinuados e substituídos por novas propriedades prefixadas com Ambient, seguindo outras diretrizes da API Compose e Ambients (I33440). androidx.compose.ui.text.Typeface
foi movido paraandroidx.compose.ui.text.font.Typeface
(Ic2b81).- Renomeação do argumento semântico, mergeAllDescendants como mergeDescendants (Ib6250).
- Nova API de entrada do ponteiro de suspensão para detector de gesto de arrastar, incluindo o bloqueio de orientação (Icef25).
- VectorAsset foi renomeado como ImageVector. VectorAsset foi movido e renomeado como Builder para ser uma classe interna de ImageVector, de acordo com as diretrizes da API. Foram adicionados typealias de VectorAssetBuilder para vincular ImageVector.Builder para compatibilidade (Icfdc8).
- ImageAsset e métodos relacionados foram renomeados como ImageBitmap (Ia2d99).
- O parâmetro zIndex foi adicionado a place() do PlacementScope. Agora, Modifier.zIndex() funciona como um LayoutModifier, e qualquer layout personalizado pode definir zIndexes para seus filhos diretamente no bloco de canais (I711f7, b/171493718).
- Propriedades semânticas de base movidas para interface (I6f05c).
- O uso de place(Offset) e placeRelative(Offset) foi descontinuado. Use sobrecargas com deslocamentos int (I4c5e7).
- Remoção de APIs descontinuadas anteriormente: Modifier.onPositioned foi removida; agora use Modifier.onGloballyPositioned. Modifier.onDraw foi removida; agora use Modifier.onDrawBehind. Modifier.plus foi removida, então use Modifier.then. Color.Unset foi removida, então use Color.Unspecified. A classe PxBounds foi removida, então use a Rect (Ie9d02, b/172562222).
- A interface Alignment foi atualizada e transformada em funcional (I46a07, b/172311734).
- O detector de gestos de toque, dois toques, tocar e manter pressionado e indicação de pressionamento foi adicionado usando a nova entrada de ponteiro de suspensão. Alguns utilitários também foram adicionados, o que facilita a gravação de detectores de gesto próprios pelos desenvolvedores (I00807).
id
foi renomeado comolayoutId
paraLayoutIdParentData
. OMeasurable.id
foi renomeado comoMeasurable.layoutId
(Iadbcb, b/172449643).- Novo detector de gestos multitoque, incluindo auxiliares para detectar rotação, zoom e movimento (Ic459d).
- Introdução às APIs SweepGradientShader e SweepGradientBrush (Ia22c1).
- O controle de tempo em testes (TestAnimationClock e os usos dele) agora é experimental (I6ef86, b/171378521).
Foram adicionadas APIs de rolagem baseadas em corrotinas:
LazyListState.snapToItem e LazyListState.smoothScrollBy e APIs de nível inferior foram adicionadas para controle de rolagem. Essas APIs fornecem uma interface de suspensão para controlar a rolagem, que aguarda até que a rolagem seja concluída antes de retornar (Ie5642).
Modifier.focusable precisa ser adicionado na base. Use-o para adicionar comportamentos focalizáveis a um componente, com semântica e acessibilidade corretas (I41eb9, b/152525426, b/162865824).
Fornecer implementações padrão de métodos e propriedades na AnimationClockTestRule, que podem ser delegadas ao
clock
dela (I7ea3d e b/173399709).AndroidComposeTestRule agora pode aceitar telas de início de atividades personalizadas (Ib8288, b/153623653, b/154135019).
O uso de TextLayoutResult.getLineVisibleEnd foi descontinuado. Como substituto, TextLayoutResult.getLineEnd agora tem um novo parâmetro visibleEnd (I73282).
API TextFieldValue atualizada.
- TextFieldValue.composition agora é somente leitura.
- Remoção da exceção gerada para intervalo de seleção inválido (I4a675, b/172239032).
Compatibilidade com TtsAnnotation para mecanismo de conversão de texto em voz (I54cc6).
Novas APIs para executar animações em corrotinas (Ied662).
Correções de bugs
- O parâmetro de alinhamento do Box foi renomeado como contentAlignment (I2c957).
- Os modificadores offsetPx foram renomeados como offset. Agora, eles usam parâmetros lambda em vez de State (Ic3021, b/173594846).
- Adição do parâmetro resetInput para TextInputService#onStateUpdated (I3e8f5, b/172239032, b/171860947).
- Uma verificação de lint foi adicionada para parâmetros Modifier em funções combináveis. Essa verificação de lint confere a nomenclatura, o tipo de retorno, o valor padrão e a ordem do parâmetro para garantir consistência com as diretrizes do Compose (If493b).
- Opção temporariamente adicionada para permitir que o TestAnimationClock seja orientado pelo MonotonicFrameClock (I1403b, b/173402197).
- Adição do wrapper Android Typeface. Você pode carregar um Android
Typeface usando a função
typeface
, ou seja,typeface(Typeface.DEFAULT)
. Além disso,typefaceFromFontFamily()
foi renomeado comotypeface()
(I52ab7). - Foi adicionada uma verificação de lint para conferir se as funções de fábrica do Modifier estão definidas como extensões nele. Assim, elas podem ser encadeadas juntas (I07981).
- Remoção do antigo módulo ui-test e dos stubs dele (I3a7cb).
- O Recomposer não aceita mais um EmbeddingContext. As dependências de programação necessárias são adquiridas no effectCoroutineContext. O FrameManager foi descontinuado. As integrações de plataforma precisam inicializar o próprio gerenciamento global de snapshots (I02369).
- Transmissão de informações de estilo para o nó de acessibilidade (If5e8d).
- TextUnit.Inherit renomeado como TextUnit.Unspecified para consistência com outras unidades (Ifce19).
Compose UI: versão 1.0.0-alpha07
11 de novembro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha07
. A versão 1.0.0-alpha07 contém estas confirmações.
Mudanças na API
- A classe
inline ScaleFactor foi adicionada para representar fatores de escala
para os eixos horizontal e vertical
independentes uns dos outros a fim de
oferecer suporte a casos de uso de escalonamento não uniforme.
- Adição do método computeScaleFactor ao ContentScale.
- ContentScale.FillBounds foi adicionado para realizar o escalonamento não uniforme e esticar os limites de src para ocupar completamente o destino.
- Adição de métodos de operador para calcular parâmetros ScaleFactor com parâmetros Size
- (Ic96a6, b/172291582).
- Adição das fábricas BiasAlignment e BiasAbsoluteAlignment para criar alinhamentos (Iac836, b/169406772).
- Permissão para um desenvolvedor limpar o foco à força (I90372).
- Foi corrigido um bug em que a elevação não era desenhada para visualizações dentro do Compose (If7782).
- Criação da API onDrawBehind dentro do ContentDrawScope para corresponder à convenção de nomenclatura de Modifier.drawBehind (I4fc3a, b/171955269).
- Adicionado suporte à distância da câmera para complementar rotaçãoX/rotaçãoY de transformações 3D em APIs de camada (I40213, b/171492100).
- SelectContainer foi adicionado sem o callback (Ibfadb).
- A anotação ExperimentalSubcomposeLayoutApi foi removida. SubcomposeLayout agora pode ser usado sem adicionar @OptIn (I708ad).
- FirstBaseline e LastBaseline foram movidos para o pacote androidx.compose.ui.layout (Ied2e7).
- Remoção da opacidade do modificador drawShadow() por ele ser confuso (I82c62, b/171624638).
- MeasureResult foi removido do MeasureScope (Ibf96d, b/171184002).
- Vários símbolos relacionados ao layout foram movidos de androidx.compose.ui para androidx.compose.layout.ui (I0fa98, b/170475424).
- O FocusState2 descontinuado foi removido (I686cb, b/168686446).
- O ZIndexModifier agora é interno (I1808b, b/171493718).
- O tipo de retorno do método de interpolação linear nos parâmetros Size foi atualizado para retornar um Size não nulo a fim de evitar caixas de seleção desnecessárias (Ib0044).
- TestMonotonicFrameClock foi adicionado para testar código que depende do MonotonicFrameClock do Compose para aguardar eventos de frame de composição usando runBlockingTest do kotlinx-coroutines-test (I4402f).
- Remoção de GestureScope.localToGlobal (I15299, b/171462785).
- O localizador de
onAllNodesWithSubstring
foi adicionado (I81dd7, b/171462889). - O uso do módulo androidx.ui.test foi descontinuado. Migre para androidx.compose.ui.test e androidx.compose.ui.test.junit4 (I452e8).
Correções de bugs
- captureToBitmap foi movido para captureToImage (I86385).
- O elemento foundation.Text foi descontinuado e substituído por material.Text. Para uma API de texto básica e discreta que não consome valores de um tema, consulte androidx.compose.foundation.BasicText (If64cb).
- Atualização de TextFields para aceitar KeyboardOptions (Ida7f3).
- Renomeação de KeyboardOptions como ImeOptions (I82f36).
- KeyboardType e ImeAction foram movidos para KeyOptions (I910ce).
- provideDefault foi adicionado como alternativa para fornecer ambientes e pode ser usado para especificar valores de ambiente que só vão ser definidos quando não houver um valor de ambiente já fornecido (Id6635, b/171024925).
- O uso de BaseTextField foi descontinuado. Use BasicTextField (I896eb).
- Introdução do módulo ui-test-junit4 (Ib91f8).
- Renomeação de
relativePaddingFrom
comopaddingFrom
. O modificadorpaddingFromBaseline
foi adicionado como conveniência para especificar distâncias de limites de layout para linhas de base de texto (I0440a, b/170633813). - LaunchedTask foi renomeado como LaunchedEffect para fins de consistência com as APIs SideEffect e DisposableEffect. Para incentivar as práticas recomendadas, o uso de LaunchedEffect sem parâmetros de assunto não será permitido (Ifd3d4).
- Introdução de recursos combináveis que são recompostos quando a configuração é atualizada (I6387c, b/167352819).
- O Recomposer agora exige um CoroutineContext na construção (Ic4610).
- Soma dos valores
zIndex
quando váriosModifier.zIndex()
são aplicados. Antes, o primeiro estava ganhando (Ic514c, b/170623936). - Mudanças na implementação interna de SlotTable que não afetarão a API pública (If9828).
- Adição da opção IME (editor de método de entrada, na sigla em inglês) de correção automática do teclado (I57b8d).
- androidx.ui.test movido para androidx.compose.ui.test (I9ffdb).
- Remoção de KeyboardOptions.toImeOptions da API pública (Ic2e45).
Contribuição externa
- Desativação da publicação de artefato interno androidx.compose.ui:ui-text-android (Ib93fa).
Versão 1.0.0-alpha06
28 de outubro de 2020
androidx.compose.ui:ui-*:1.0.0-alpha06
é lançado. A versão 1.0.0-alpha06 contém estas confirmações.
Mudanças na API
- Recomposer agora é um ComposeReference e um pai de composição válido. Agora, o Recomposer explícito é obrigatório em menos lugares (I4036f).
- O uso de VectorPainter foi substituído por rememberVectorPainter para indicar melhor que a API combinável usa internamente o método "remember" para manter dados entre composições (Ifda43).
- A API Modifier.drawWithCache foi atualizada para expor ContentDrawScope como um escopo de receptor em vez de DrawScope para fornecer às implementações a capacidade de reordenar comandos de desenho. Isso é útil para casos de uso de mistura/tonalização, em que os pixels do conteúdo precisam ser renderizados primeiro para que o algoritmo correspondente do modo de mistura seja aplicado corretamente (Ie7ec8).
- SimpleContainer movido para PopupTestUtils.kt (I78c57).
- ConsumedData não é mais uma classe de dados. Consulte https://android-review.googlesource.com/c/platform/frameworks/support/+/1455219 para mais detalhes (I1737f).
- Handle Position Rtl foi corrigido (I6e1e0).
- Refatoração de DrawScope e
ContentDrawScope para que sejam interfaces
em vez de classes abstratas.
- Criação da implementação CanvasDrawScope do DrawScope.
- Implementações refatoradas do DrawScope para usar o CanvasScope.
- Criação do DrawContext para unir dependências para o DrawScope.
- Métodos descontinuados no DrawScope foram removidos (I56f5e).
- Alteração interruptiva: o valor de retorno foi removido de
PointerInputFilter.onPointerEvent(...)
, já que o único valor que poderia ser mudado nos eventos de ponteiro é o dos dados de consumo. Em vez de retornar dados dePointerInputFilter.onPointerEvent(...)
, agora é possível mudar os dados de consumo dos PointerEvents transmitidos (I6acd0). - MeasureScope e IntrinsicMeasureScope foram transformados em interfaces (I1a087, b/170461665).
- Ocultação da função de mesclagem para AlignmentLine (I9da1a, b/170612900, b/170611568).
- Adição da capacidade de especificar informações do inspetor no modificador composto (Idee08, b/163494569).
- Adição da opção SelectAll no menu de seleção (Ief02b).
- DrawTransform.rotate foi atualizado para usar
um parâmetro de rotação padrão do centro para corresponder
à documentação.
- DrawScope.rotateRad foi atualizado para consumir um Offset de modo que o ponto de rotação corresponda a outros métodos de transformação.
- O uso da sobrecarga DrawScope.rotateRad que consumia pontos flutuantes para as coordenadas x e y da rotação foi descontinuado
- (Iffcbb, b/170434992).
Correções de bugs
- A verificação de lint da API para MissingGetterMatchingBuilder está ativada para androidx (I4bbea, b/138602561).
- Adição de teste (I6b8ae).
- Ativação de transições em ComposeTestRule. Remoção da opção para ativar o cursor piscante na ComposeTestRule (If0de3).
- Adição da opção IME (editor de método de entrada, na sigla em inglês) KeyboardCapitalization (I8ac38).
- Adição da opção de teclado de linha única para CoreTextField (I72e6d).
- SimpleContainer foi movido para PopupTestUtils.kt (I65c3e).
- A API Radius foi renomeada como CornerRadius para expressar melhor a forma de uso dela no Compose. Atualização da documentação para indicar que raios negativos dos cantos são fixados a zero (I130c7, b/168762961).
- Melhoria da interoperabilidade do Android ao continuar enviando MotionEvents às visualizações filhas do Android que retornam um valor falso para onTouchEvent em todas as ações, exceto
ACTION_DOWN
(I94c5a e b/170320973). - Box agora é uma função inline (Ibce0c, b/155056091).
Contribuição externa
- Suporte a diferentes localidades para
AnnotatedString.capitalize
eAnnotatedString.decapitalize
(I4aa7f).
Versão 1.0.0-alpha05
14 de outubro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha05
. A versão 1.0.0-alpha05 contém estas confirmações.
Mudanças na API
- Adição de uma DSL para especificar informações do inspetor (Ic9a22).
- LongPress movido para Text (Iff2bc).
- O Modifier.pointerInput experimental suspende o modificador de entrada (Ia77d2).
- Adição de ações de acessibilidade para copiar/colar/cortar (I6db4f).
- Remoção do construtor público para AndroidOwner (Iacaef).
- Pop-ups e caixas de diálogo agora herdam FLAG_SECURE da janela mãe. Adição de opção para configurar isso explicitamente (I64966, b/143778148, b/143778149)
Os dados de consumo agora são mutáveis. Além disso, chamadas para funções de extensão que usam consumo agora não retornam mais um novo PointerInputChange, mas mudam o PointerInputChange fornecido.
Essa é a primeira etapa de um processo de duas etapas para tornar os dados do PointerEvent mutáveis, de forma que outros dados de ponteiro não possam ser editados pelo código do usuário. A segunda etapa será remover o tipo de retorno
List<PointerInputChange>
dePointerInputFilter.onPointerEvent(...)
(Id067e).Desativação de Selection em Text, e uma Demo (Ie7e97).
onGloballyPosition agora é uma função in-line (I15830).
OnPositionedModifier foi renomeado como OnGloballyPositionedModifier, e onPositioned() foi renomeado como onGloballyPositioned(). (I587e8, b/169083903).
A propriedade hasPendingMeasureOrLayout foi adicionada ao Owner, informando se ele tem algum trabalho de layout pendente (I3d9f8, b/169038599).
Uma API foi adicionada para limpar programaticamente o foco (Ie1dc2, b/161487952).
PointerInputFilter.onPointerInput(...)
foi removido.PointerInputFilter.onPointerEvent(...)
precisa ser usado no lugar dele (I6f04a)Mudanças no Size
- Remoção de Size.getFlipped
- Remoção de Size.rem
- Size.truncDiv foi removido (Ief44d, b/169790720).
Como parte da padronização de valores de sentinela para classes inline, Color.Unset foi renomeada como Color.Unspecified para consistência com outras classes inline (I97611, b/169797763).
Introdução de TextOverflow.None. Quando overflow for "None", o Text não vai mais ser processado e vai informar o tamanho real para o LayoutNode (I175c9, b/158830170).
O parâmetro de escopo em AnnotatedString.Builder.addStringAnnotation foi renomeado para marcar a consistência da API (I7c8cb)
Correções de bugs
- O desempenho de rolagem de LazyColumn/Row foi melhorado com menos trabalho na subcomposição em cada rolagem. O novo método hasInvalidations() foi adicionado para a classe Composition. O método hasPendingChanges() do Recomposer foi renomeado como hasInvalidations() (Ib2f32, b/168293643, b/167972292, b/165028371).
- Atualização dos parâmetros Size.Unspecified para Float.NaN, em vez de Float.POSITIVE_INFINITY. As implementações do Painter foram atualizadas para conferir o Size.Unspecified, assim como Sizes não finitos (I95a7e).
- Agora, a ordem das chamadas place() em Layouts personalizados define a ordem de desenho para os filhos (Ibc9f6).
- Foi adicionado suporte a AnnotatedString para conversão do SpannableString para acessibilidade (Ief907).
- Foram adicionados stubs para classes Android que estão em plataformas mais antigas a fim de evitar o uso de reflexão, quando possível (Ia1790).
- Correção de bug: se a exibição do teclado de software causava a tradução do app, as coordenadas da entrada do ponteiro ficavam incorretas (Ic4cec, b/163077821)
Versão 1.0.0-alpha04
1º de outubro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha04
. A versão 1.0.0-alpha04 contém estas confirmações.
Mudanças na API
- OwnerScope foi adicionado para permitir a coleta de escopos de observação de desenho e layout quando eles deixam de ser válidos (Ic4cf8).
- OnRemeasuredModifier e onSizeChanged() foram adicionados para receber um callback quando o layout do conteúdo é medido novamente e quando o tamanho muda, respectivamente (I657cf, b/154108792).
- Adição de ação semântica de clique longo (I6281b, b/156468846).
- Agora, o FocusManager é privado (I7872f).
Atualização da implementação para criar uma implementação dedicada do DrawCacheModifier em vez de adicionar propriedades opcionais no DrawModifier.
Atualização da documentação para vários métodos (Ibd166).
TextRange agora é inline para evitar a criação de objetos (Id034b).
PlacementScope#parentWidth e PlacementScope#parentLayoutDirection não podem mais ser lidos do bloco de posição de um layout personalizado (Icc1ae, b/168295623).
Adição de AccessibilityScrollState às propriedades semânticas (Ifeda9).
Modifier.drawWithCache foi adicionado para oferecer suporte à criação de um objeto de desenho que recria condicionalmente dependências a informações de tamanho/estado (I376dc).
O ParagraphConstraints foi removido. Agora, a largura é transmitida diretamente para o Paragraph (Ica712).
Correções de bugs
- Atualização de várias APIs Graphics
- As APIs de transformação de escala e rotação foram atualizadas para consumir um único parâmetro Offset para representar a coordenada dinâmica em vez de parâmetros de flutuação separados para as coordenadas x/y em DrawScope e DrawTransform.
- Os métodos Rect.expandToInclude e Rect.join foram removidos.
- Documentação do Radius atualizada para informar oval, além de elíptico.
- Foi adicionada documentação para indicar que o construtor público da classe Radius in-line não pode ser chamado diretamente, mas os objetos Radius precisam ser instanciados pelos construtores de função deles.
- Remoção das APIs RoundRect para consultar topRight, bottomRight, bottomCenter etc.
- O uso de Rect.shift foi descontinuado e substituído por Rect.translate.
- Remoção das APIs RoundRect.grow e Rect.shrink.
- Renomeação de RoundRect.outerRect para Rect.boundingRect.
- Remoção dos métodos RoundRect.middleRect/tallMiddleRect/wideMiddleRect e Rect.isStadium.
- Renomeação de RoundRect.longestSide para RoundRect.maxDimension.
- Renomeação de RoundRect.shortestSide para RoundRect.minDimension.
- Mudança de RoundRect.center para que seja uma propriedade em vez de uma função.
- O construtor RoundRect foi atualizado para consumir propriedades do Radius em vez de parâmetros individuais para valores de raio x/y.
- As APIs Size, que pressupunham ser um retângulo com origem em 0,0, foram removidas.
- Adição de uma API de destruição ao Radius.
- Migração de várias funções de extensão RoundRect para serem propriedades
- (I8f5c7, b/168762961).
- O uso de foundation.Box foi descontinuado. Use foundation.layout.Box (Ie5950, b/167680279).
- Stack foi renomeado como Box. O uso do elemento Box anterior vai ser descontinuado e substituído pelo novo Box em compose.foundation.layout. O comportamento do novo Box quando tem vários filhos é os empilhar um em cima do outro. Isso é diferente do Box anterior, que se comportava de maneira semelhante à Column (I94893, b/167680279).
- O uso de parâmetros de decoração do Box foi descontinuado. Se você quiser ter decorações/padding na sua caixa, use Modifiers, como Modifier.background, Modifier.border, Modifier.padding (Ibae92, b/167680279).
- Atualização de várias APIs Graphics
- As APIs DrawScope foram atualizadas com métodos de transformação com escopo para indicar que a transformação só é aplicada dentro do callback e removida depois dele ser invocado.
- Atualização da documentação do clipPath para se referir ao Path em vez do retângulo arredondado.
- Correção do espaçamento na documentação para o parâmetro correto em clipPath.
- DrawScope.drawCanvas foi renomeado como drawIntoCanvas, e o parâmetro de tamanho foi removido.
- Renomeação de parâmetros dx/dy no método de inset como horizontal e vertical.
- Recuo extra adicionado, fornecendo o mesmo valor de recuo a todos os quatro limites.
- A documentação sobre o método do recuo que indicava que o recuo seria aplicado a todos os quatro lados foi removida.
- Atualização da documentação da classe Rect.
- Os comentários sobre os parâmetros Rect foram atualizados para corresponder ao estilo kdoc.
- Rect.join e Rect.expandToInclude foram removidos.
- Foi criada uma sobrecarga para Rect.translate(offset) e o Rect.shift foi descontinuado
- (If086a, b/167737376).
- Anotação de rootAnimationClockFactory, transitionEnabled, blinkingCursorEnabled e textInputServiceFactory com @VisibleForTesting, tornando-as APIs internas e ocultando o kdoc delas (I554eb, b/168308412).
- SelectContainer foi removido do topo para desativar a seleção padrão e evitar comportamentos inesperados. É possível usar especificamente um SelectionContainer para agrupar o conteúdo que precisa ser selecionável (I8dfe0, b/158459594).
Versão 1.0.0-alpha03
16 de setembro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha03
. A versão 1.0.0-alpha03 contém estas confirmações.
Mudanças na API
- Remoção das ações de semântica de rolagem para frente/para trás. Adição de etapas em AccessibilityRangeInfo (Ia47b0).
- Remoção de
onInvalidate()
doOwner
:OwnedLayer
processa a invalidação (Ica72b, b/162061312). Remoção dos métodos de operador na API Size que consomem parâmetros Offset. O resultado dessas operações não é claro, e o tipo de resultado é inesperado para elas. Ex.: "size - offset" retorna um deslocamento ou um resultado de tamanho com a diferença?
Também foram removidos os métodos descontinuados na classe Size (Iec902, b/166514214).
Correções de bugs
- Foram corrigidos itens de LazyColumn, que às vezes eram desenhados incorretamente, causando falhas em algumas condições (Ibcf17, b/163066980, b/165921895).
- O elemento DpConstraints e as APIs que o usavam foram descontinuados (I90cdb, b/167389835).
createAndroidComposeRule
eAndroidInputDispatcher
foram movidos deandroidx.ui.test.android
paraandroidx.ui.test
(Idef08, b/164060572).- Os usos da gravidade foram renomeados de forma consistente para align ou alignment nas APIs de layout (I2421a, b/164077038).
- onNode e outros métodos globais foram adicionados à ComposeTestRule, porque os atuais vão ser descontinuados (Ieae36).
Versão 1.0.0-alpha02
2 de setembro de 2020
Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha02
. A versão 1.0.0-alpha02 contém estas confirmações.
Mudanças na API
- Remoção de callback para notificar o proprietário quando os limites do layoutnode mudam (If654e, b/166106882).
- Foi adicionado suporte a parâmetros de tipo de preenchimento em caminhos de gráficos vetoriais para oferecer suporte a cortes de formas, de acordo com as regras de preenchimento de caminho evenOdd ou NonZero (I43dd2).
- O tempo de atividade e a velocidade agora são classes in-line (I48f4a).
- Duration agora é uma classe inline (I565eb).
- Adição de callback para notificar o proprietário quando os limites do layoutnode mudam Ic40b3
Foi corrigido um problema em que o construtor da função Rect com deslocamento e raio criava o retângulo na ordem esquerda, direita, cima e baixo em vez de esquerda, cima, direita e baixo.
Os métodos complementares descontinuados no Rect foram removidos e substituídos por construtores de funções.
Adição de testes para verificar métodos em Rect.kt (I08460, b/165822356).
Correções de bugs
- Adição de MutableRect, um retângulo que pode ser modificado (I71bd2, b/160140398).
- A Matrix4 foi substituída por Matrix. Todas as outras partes do pacote vectormath foram removidas Ibd665, b/160140398
A convenção de chamada para funções combináveis mudou. Essa é uma alteração interruptiva binária. Todas as bibliotecas precisam ser recompiladas para funcionar com essa versão do plug-in compilador do Compose.
Essa mudança não cria uma alteração interruptiva no nível da origem, uma vez que as únicas APIs que foram modificadas são APIs do compilador que têm uma permissão explícita (I7afd2, b/158123185).
Foi corrigida a falha que podia ocorrer durante o envio para um PointerInputFilter e fazia com que o PointerInputFilter fosse removido de forma síncrona I58f25
Versão 1.0.0-alpha01
26 de agosto de 2020
androidx.compose.ui:ui-*:1.0.0-alpha01
é lançado. A versão 1.0.0-alpha01 contém estas confirmações.
Versão 0.1.0-dev
Versão 0.1.0-dev17
19 de agosto de 2020
Lançamento de androidx.compose.ui:ui-*:0.1.0-dev17
. A versão 0.1.0-dev17 contém estas confirmações.
Mudanças na API
- O uso de
emitView
foi descontinuado. UseAndroidView
, se possível, para emitir Views dentro do Compose. A composição direta de Views e ViewGroups não vai estar disponível no futuro, a menos que sejam folhas combináveis. Nesse caso, a composição direta é possível usando o AndroidView (I29b1e, b/163871221). - O uso de
FocusState2
foi descontinuado e substituído porFocusState
(Ia8b79, b/160822876, b/160923332). - As sobrecargas descontinuadas de AndroidView foram removidas (I946b9, b/163802393).
- Agora, as emissões personalizadas podem declarar que um ou mais setters podem ser ignorados e recompostos independentemente da emissão (Ibbd13).
As classes Vector foram mudadas para não serem mais classes de dados, já que a mesma instância de objeto é usada na composição.
A flag mutableStateOf em VectorPainter foi adicionada para redesenhar condicionalmente se o conteúdo do vetor for mudado.
Refatoração da instância VectorComponent para fazer parte do VectorPainter enquanto é reutilizada em composições.
GroupComponent e PathComponent foram atualizados para que os campos de nome fossem mutáveis (Ieae45, b/151378808).
Removidos
onChildPositioned
eOnChildPositionedModifier
. Os desenvolvedores precisam usaronPositioned
eOnPositionedModifier
no layout filho (I4522e, b/162109766).Offset agora é uma classe inline (Iaec70).
Adição de um parâmetro modificador a SelectionContainer (I4aada, b/161487952).
Remoção do FocusModifier obsoleto (I0b4ba, b/160922116, b/160821157, b/162441435, b/160822875, b/160921940).
Adição do lambda
mergePolicy
aSemanticsPropertyKey
. É possível usá-la para definir uma política personalizada para a mesclagem de semântica mergeAllDescendants. A política padrão será usar o valor pai se já estiver presente. Caso contrário, o valor filho (Iaf6c4, b/161979921).Constraints agora é uma classe in-line (I88736).
Adição de FocusManager, que move a lógica de foco comum de AndroidComposeView (I528ef, b/161487952, b/162206799).
Atualização de nomes de PointerEventPass para a versão Alfa (Ifda6f).
IntOffset agora é uma classe inline (Iac0bf).
IntSize agora é uma classe inline (I2bf42).
PlacementScope.placeAbsolute()
foi renomeado comoPlacementScope.place()
, e oPlacementScope.place()
anterior foi renomeado comoPlacementScope.placeRelative()
. Por essa razão, o métodoPlacementScope.place()
não espelhará de forma automática a posição em contextos da direita para a esquerda. Se você quiser o espelhamento, usePlacementScope.placeRelative()
(I873ac, b/162916675).AlertDialog agora usa FlowRow para botões (I00ec1, b/161809319, b/143682374).
Transformação de alguns utilitários de teste em não públicos porque não estavam onde precisavam estar. Isso será disponibilizado ao público no futuro (I32ab1).
Organização refatorada do código de entrada do ponteiro (Ie3f45).
O elemento PxBounds foi descontinuado e substituído por Rect. Atualização de todos os usos de PxBounds com rect e adição de descontinuação/substituição por anotações para auxiliar na migração (I37038, b/162627058).
Remoção de KeyEvent2. Use KeyEvent (Ied2d0, b/162097587).
KeyEvent tem uma propriedade Unicode que pode ser usada para receber o caractere Unicode gerado pela combinação de estado especificada de tecla e tecla meta (If3afc).
Transformação do evento personalizado DelayUp e das classes relacionadas em uma API de ativação, já que é muito provável que sejam mudados (I56d6f).
Dois PointerEventPasses que não são mais necessários foram removidos (I3dd9d).
Adição de cor, sombra e TextDecoration de parâmetro a Paragraph.paint. Essa função é útil para evitar a recriação desnecessária de parágrafos (I81689).
Correções de bugs
- Remoção dos callbacks onFocusChanged do TextField. Use Modifier.focusObserver (I51089, b/161297615).
- O uso de Modifier.drawBorder foi descontinuado. Use Modifier.border. A classe de dados Border foi substituída por BorderDraw (I4257d, b/158160576).
As chamadas FrameManager descontinuadas foram removidas.
As APIs combináveis internas mudaram para reduzir a quantidade de sobrecarga a fim de rastrear objetos de estado, como
mutableStateof()
(I80ba6).Remoção de VerticalScroller e HorizontalScroller. Use ScrollableColumn/Row. Modifier.drawBackground foi removido. Use Modifier.background (I73b0d, b/163019183).
Correção da falha que ocorria quando algo que salvava o estado era usado dentro do loop. Agora, é permitido ter a mesma chave em savedInstanceState(), a API UiSavedStateRegistry está ajustada para esse novo requisito (I4ab76, b/160042650, b/156853976, b/159026663, b/154920561).
O elemento combinável
state { ... }
foi descontinuado e substituído pelas chamadas explícitas deremember { mutableStateOf(...) }
para maior clareza. Isso reduz a plataforma geral da API e o número de conceitos de gerenciamento de estado e corresponde ao padrãoby mutableStateOf()
para delegação de propriedade de classe (Ia5727).RRect foi renomeado como RoundRect para se ajustar melhor aos padrões de nomenclatura do Compose. Construtores de função semelhantes foram criados para RRect, e os construtores de função RRect foram descontinuados (I5d325).
Versão 0.1.0-dev16
5 de agosto de 2020
androidx.compose.ui:ui-*:0.1.0-dev16
é lançado. A versão 0.1.0-dev16 contém estas confirmações.
Mudanças na API
- O uso de OnChildPositioned foi descontinuado. Use OnPositioned no filho (I87f95, b/162109766).
- O uso de setViewContent foi descontinuado. Use setContent (I7e497, b/160335130).
- Adição da API AndroidViewBinding para inflar e compor recursos de layout com base em ViewBinding (I081c6).
- KeyEvent2 foi substituído por KeyEvent (I2d770, b/162097585).
- Adicionado suporte à tecla de hardware Alt (I9036b).
- O uso de FocusManager foi descontinuado. Use Modifier.focus(), Modifier.focusObserver() e Modifier.focusRequester() (I74ae4, b/162211322).
- loadVectorResource é compatível com atributos trimPath (I808fe).
- A caixa de diálogo foi movida para a interface (I47fa6).
- Remoção de dois PointerEventPasses que não são mais necessários (I33ca7).
- Foi implementado o PointerInteropModifier, que permite receber MotionEvents e interagir com o Compose como se você estivesse implementando uma visualização do Android (Ieb08c).
- O modificador de tag descontinuado foi removido. Use layoutId (Idaa05, b/162023919).
- As APIs com suporte à leitura da direita para a esquerda foram atualizadas. LayoutDirectionAmbient foi adicionado e pode ser usado para ler e mudar a direção do layout. Modifier.rtl e Modifier.ltr foram removidos (I080b3).
- Adicionado suporte ao corte de caminho em gráficos vetoriais (Ie16c9, b/158188351).
- Foi adicionado o Modifier.layout(), que permite criar um modificador de layout personalizado conveniente (I73b69, b/161355194).
- Uma nova API AndroidView foi adicionada, e as já existentes foram descontinuadas (I5bcfd).
- O uso de Modifier.plus foi descontinuado. Use Modifier.then. "Then" tem um sinal mais forte de ordem, mas também proíbe o tipo
Modifier.padding().background() + anotherModifier
, que interrompe a cadeia e é mais difícil de ler (Iedd58, b/161529964). - Subclasses de visualização [Abstract]ComposeView foram adicionadas para hospedar conteúdo do Compose em uma hierarquia de visualizações (I46357).
Row
eColumn
agora executam funções in-line reduzindo significativamente a sobrecarga de uso (I75c10).- SubcomposeLayout foi adicionado. Ele é um primitivo de baixo nível que permite compor os filhos durante a medição se quisermos usar alguns valores disponíveis posteriormente, durante a medição para a composição da subárvore. Por exemplo, WithConstraints não é implementado usando SubcomposeLayout (I25cc8).
SemanticsNode.positionInRoot
foi adicionada para receber a posição de um SemanticNodes em relação à raiz da hierarquia do Compose (Icdf26, b/161336532).- Passagem dos MotionEvents do Android para o Compose e de volta para o Android (I14be8, b/158034713).
- Remoção de dropdownPopup (I00430).
- Correção da posição do pop-up em telas cortadas (Idd7dd).
- Adição da ação de acessibilidade para receber o TextLayoutResult (I9d6e6).
- Adição de RemeasurementModifier, que permite medir novamente o layout de maneira síncrona. Em geral, você não precisa dele, já que a nova medida de layout é feita automaticamente, mas o usamos em LazyColumnItems durante a rolagem (I5f331, b/160791058).
- Remoção de getLineEllipsisOffset/getLineEllipsisCount. Use getLineVisibleEnd/getLineEnd/isLineEllipsized (I85aa2).
- Adição de Marks/Annotations para seguir práticas recomendadas (I66b20).
- Exposição de mais APIs de linha em TextLayoutResult (I79bd2).
- Os conversores de vetor integrados para converter unidades integradas agora podem ser acessados por meio de Foo.VectorConverter. Por exemplo: Dp.VectorConverter, Color.VectorConverter, Float.VectorConverter etc. (I3e273).
Correções de bugs
- Resolução de variados problemas de API (I077bc).
- Remoção da interface OffsetBase não utilizada.
- Alinhamento das classes Offset e IntOffset para que tenham uma superfície de API consistente.
- IntOffset.Origin foi renomeado como IntOffset.Zero para ser consistente com a API Offset.
- O método nativeCanvas foi movido da interface Canvas para que os consumidores possam criar as próprias instâncias.
- A classe stub EmptyCanvas foi criada para refatorar DrawScope para ser um parâmetro não nulo em vez de lateinit e garantir a não nulidade do campo.
- Os tipos enumerados ClipOp foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados FilterQuality foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados StrokeJoin foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados PointMode foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados PaintingStyle foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados PathFillType foram renomeados para seguir o padrão Pascal Case.
- Os tipos enumerados StrokeCap foram renomeados para seguir o padrão Pascal Case.
- Atualização da implementação de DrawCache para não usar mais parâmetros lateinit.
- Atualização de DrawScope para não usar mais delegação lenta para os parâmetros internos fillPaint e strokePaint.
- Atualização do composto Image para evitar o uso do Box e ter menos sobrecarga.
- Atualização da classe Outline para ter anotações @Immutable.
- PathNode foi atualizado para ter anotações @Immutable em cada instrução de caminho.
- A subcomposição Vector foi atualizada para remover verificações condicionais redundantes para fins de igualdade, já que o Compose já as processa.
- O uso de métodos construtores complementares de Rect foi descontinuado e substituído por construtores de função.
- As classes Brush e construtores de função foram atualizados com APIs @Immutable e @Stable.
- Atualização da enumeração VertexMode para seguir o padrão Pascal Case.
- Atualização do método DrawScope selectPaint para substituir condicionalmente os parâmetros de traço na pintura quando eles tiverem mudado.
- Atualização de Size para adicionar a desestruturação da API, renomear UnspecifiedSize para Unspecified e remover métodos não utilizados.
- Atualização do consumo da API BlendMode para mapear adequadamente entre os modos BlendModes e PorterDuff do framework do Android, dependendo do nível da API. Introdução da API BlendMode#isSupported para determinar se BlendMode é compatível com o dispositivo antes de ser usado (I0ef42).
- Adição de LazyItemScope no parâmetro itemContent de listas Lazy. Ele fornece modificadores para preencher o tamanho máximo pai, que resolve o caso de uso quando o item precisa preencher a janela de visualização, e o Modifier.fillMaxSize() normal não funciona, já que o item é medido com restrições de infinito (Ibd3b2, b/162248854).
SemanticsNodeInteraction.performPartialGesture
foi removido. UseSemanticsNodeInteraction.performGesture
(Id9b62).LazyColumnItems
foi renomeado comoLazyColumnFor
.LazyRowItems
foi renomeado comoLazyRowFor
(I84f84).- Nivelação do pacote
foundation.shape.corner
parafoundation.share
(I46491, b/161887429). AndroidComposeTestRule
foi renomeado comocreateAndroidComposeRule
(I70aaf).- Adição de mais APIs a
TextLayoutResult
(Id7e04). FilledTextField
do Material Design foi renomeado comoTextField
, e oTextField
de base foi renomeado comoBaseTextField
a fim de facilitar a descoberta e o uso da API mais simples desejada (Ia6242, b/155482676).- Modifier.drawBackground foi renomeado como Modifier.background (I13677).
Versão 0.1.0-dev15
22 de julho de 2020
Lançamento de androidx.compose.ui:ui-*:0.1.0-dev15
. A versão 0.1.0-dev15 contém estas confirmações.
Atualização de dependências
- Para usar a versão
0.1.0-dev15
do Compose, será necessário atualizar suas dependências de acordo com os novos snippets de código mostrados acima em Como declarar dependências.
Mudanças na API
- O uso de FocusModifier foi descontinuado e substituído por Modifier.focus, Modifier.focusRequester e Modifier.focusObserver. Os elementos FocusState e FocusDetailedState foram descontinuados e substituídos por FocusState2 (I46919, b/160822875, b/160922136).
- Adição de um modificador para observar a mudança do estado do foco (I05866, b/160924455, b/160923326).
- Adição de um modificador para solicitar mudanças de foco (I8dd73, b/161182057, b/160924778).
- Ajuste no menu da Barra de Ferramentas Google para mostrar os comandos de copiar, recortar e colar corretamente (Id3955).
- As propriedades de semântica de valor único agora usam um estilo de chamada.
Por exemplo, "semantics {hidden = true}" agora é escrito como:
semantics { hidden() }
(Ic1afd, b/145951226, b/145955412). - Adição de Modifier.focus para substituir o FocusModifier (Ib852a, b/160924778).
- FloatingToolbar foi adicionado à seleção do TextField (Ie8b07).
- Adição de uma anotação de API experimental à API relacionada a entrada de chaves (I53c0a).
- Adição de uma anotação de API experimental a todas as APIs relacionadas a foco (I53b24, b/160903352).
- Adição de FocusState2, que substituirá FocusDetailedState (I0a3ba, b/160822595).
- Adição de ExperimentalFocus, que é uma anotação @OptIn para a API Focus (I1544b, b/160820961).
- Foi adicionada uma classe de unidade IntBounds, que representa os limites de pixels inteiros do layout. A API de PopupPositionProvider foi atualizada para usar essa classe (I0d8d0, b/159596546).
- Applier agora requer um método clear() para descartar composições (Ibe697).
- O uso de KeyEvent foi descontinuado e substituído por KeyEvent2 (I68730).
- Adição de uma nova sinalização opcional, useUnmergedTree, aos localizadores de teste (I2ce48).
- Criação da API experimental LayoutNode (I4f2e9).
Adição de métodos de cópia a vários tipos de classe in-line, incluindo:
- Offset
- Size
- Radius
- Motion
TransformOrigin
O método de objeto complementar Size.copy foi descontinuado e substituído pelo método de cópia de instância (Ife290, b/159905651).
Pop-ups, caixas de diálogo e menus agora herdam o MaterialTheme contextual (Ia3665, b/156527485).
TextDirection foi renomeado como ResolveTextDirection (I3ff38).
O parâmetro de direção do layout foi removido do bloco de medida da função Layout(). No entanto, a direção do layout está disponível dentro do callback com o objeto do escopo da medida (Ic7d9d).
SelectionHandles foi refatorado para reutilização (I420e0).
Clickable foi removido. Use Modifier.clickable (I84bdf).
TestTag e Semantics foram excluídos. Agora, use Modifier.testTag e Modifier.semantics (I15ff0, b/158841414).
Antes da mudança, o plug-in do compilador do Compose interceptava chamadas a construtores dentro de uma função @Composable se houvesse um (I5205a, b/158123804).
Modifier.tag foi renomeado como Modifier.layoutId para evitar confusão com Modifier.testTag (I995f0).
Agora, as posições de Int da linha de alinhamento retornadas de Placeable#get(AlignmentLine) não são nulas. Se a linha de alinhamento consultada estiver ausente, AlignmentLine.Unspecified será retornado (I896c5, b/158134875).
Foi adicionado um parâmetro modificador ao elemento combinável AndroidView (I48a88, b/158746303).
O uso de Semantics() foi descontinuado. Use Modifier.semantics() (I72407, b/158841414).
Adicionado o elemento combinável viewModel(), que permite criar ou usar o ViewModel já criado de forma semelhante a como ele funciona em Activity ou Fragment (I5fdd1).
Uso de IntPx substituído por Int e o de IntPxPosition por IntOffset. IntPxSize foi substituído por IntSize (Ib7b44).
Para consolidar o número de classes usadas para representar informações de tamanho, padronize o uso da classe Size em vez de PxSize. Isso fornece os benefícios de uma classe in-line para usar um long para empacotar dois valores de pontos flutuantes e representar a largura e a altura como flutuantes (Ic0191).
Para consolidar o número de classes usadas para representar informações de posicionamento, padronize o uso da classe Offset em vez de PxPosition. Isso fornece os benefícios de uma classe inline para usar um valor long para empacotar dois valores de pontos flutuantes e representar os deslocamentos x e y como flutuantes (I3ad98).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração, a fim de depender apenas de tipos primitivos e Dp para os parâmetros de pixel. Classe Px excluída na íntegra (I3ff33).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração para depender apenas de tipos primitivos e Dp para os parâmetros de pixel (I086f4).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração para depender apenas de tipos primitivos e Dp para os parâmetros de pixel (Id3434).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração a fim de depender apenas de tipos primitivos e Dp para os parâmetros de pixel (I97a5a).
O uso de TestTag foi descontinuado. Use Modifier.testTag (If5110, b/157173105).
A implementação padrão, de ambiente autônomo, de ParentDataModifier#modifyParentData foi removida. Ela era equivalente a não implementar a interface primeiro (I0deaa).
A ScaleFit descontinuada foi removida. Use ContentScale (Ifbc5b).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração a fim de depender apenas de tipos primitivos e de Dp para os parâmetros de pixel (I19d02).
O componente DropdownMenu foi adicionado ao ui-material, uma implementação do menu do Material Design (I9bb3d).
O método LayoutTag() descontinuado foi removido. Use Modifier.tag(). O Modifier.matchParent() descontinuado foi removido. Use Modifier.matchParentSize() (If8044).
O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração para depender apenas de tipos primitivos e Dp para os parâmetros de pixel (I57bff).
O Modifier.semantics voltou a ser usado para permitir o uso de componentes de alto nível (I4cfdc).
Consolidadas as implementações de CanvasScope para que agora existam apenas DrawScope e ContentDrawScope. CanvasScope foi renomeado como DrawScope. DrawScope foi atualizado para implementar a interface de Density e fornecer LayoutDirection. A subclasse DrawScope foi excluída em ContentDrawScope. Painter e PainterModifier foram atualizados para não manter mais uma propriedade RTL, porque DrawScope já fornece isso de maneira automática (I1798e).
DoubleTapGestureFilter agora desambigua SingleTapGestureFilter na árvore (If92b1).
A API Alignment foi atualizada, e foi adicionado suporte ao alinhamento absoluto, que não vai ser espelhado automaticamente no contexto RTL (I38cd3).
Mudança na API DrawLayer Modifiers: outlineShape foi renomeada como Shape e tem o valor padrão RectangleShape, agora não anulável. clipToOutline foi renomeado como clip. clipToBounds foi removido porque é o mesmo que clip == true com RectangleShape (I7ef11, b/155075735).
As APIs combináveis de nível superior que expõem uma tela foram atualizadas para expor CanvasScope. Isso elimina a necessidade dos consumidores manterem seus próprios objetos do Paint. Os consumidores que ainda precisam de acesso a um Canvas podem usar o método de extensão drawCanvas, que fornece um callback para emitir comandos de desenho (I80afd).
A API WithConstraints lambda final mudou. Agora, em vez de dois parâmetros, ela tem um escopo de receptor que, além de restrições e layoutDirection, fornece as propriedades minWidth, maxWidth, minHeight e maxHeight no Dp (I91b9a, b/149979702).
LayoutModifier2 foi renomeado como LayoutModifier (Id29f3).
A interface LayoutModifier descontinuada foi removida (I2a9d6).
As funções de medições intrínsecas em Layout e LayoutModifier2 agora têm um receptor IntrinsicMeasureScope que fornece uma API de consulta intrínseca com a direção de layout propagada implicitamente (Id9945).
Os filhos de Layout e LayoutModifier podem ser medidos com uma direção de layout diferente (Ibd731).
Um novo Modifier.zIndex() foi adicionado para controlar a ordem do desenho dos filhos no mesmo layout pai. A propriedade elevation em DrawLayerModifier foi renomeada como shadowElevation e não controla mais a ordem do desenho. A ordem dos parâmetros para DrawShadow foi modificada: o elevation agora é o primeiro e o shape o segundo, com RectangleShape como padrão (I20150, b/152417501).
Remoção de onSizeChange e onPositionChange em Owner (I5c718).
Constraints2, uma cópia de Constraints que só aceita valores de restrições do Int em vez de IntPx, foi adicionado. IntPx vai ser removido, e todas as restrições inteiras vão ser consideradas pixels como o Android.
- Adição de IntSize também, que acabará substituindo IntPxSize (I4b43a).
Alignment se tornou instanciável com valores arbitrários. Alignments 1D foi adicionado (Ia0c05).
alignToSiblings agora aceita um Measured em vez de Placeable (I5788d).
-
- ScaleFit foi renomeado como ContentScale.
- O ContentScale foi movido de ui-graphics para ui-core para ficar no mesmo módulo que a API Alignment.
- FillMaxDimension foi renomeado como Crop.
- ContainerMinDimension foi renomeado como Fit.
- Fit foi renomeado como Inside para melhor correspondência.
- Equivalentes de ImageView.ScaleType
- Foi adicionada a documentação que indica que a combinação de Crop e Alignment.Center alcança o mesmo resultado que ImageView.ScaleType.CENTER_CROP, que Fit usado com Alignment.Center alcança o mesmo resultado que ImageView.ScaleType.CENTER_INSIDE e que Inside usado com Alignment.Center alcança o mesmo resultado que ImageView.ScaleType.CENTER_INSIDE.
Compatibilidade com RTL para modificadores de desenho (I0aaf9).
Lançamento da API para inflar o Android Views no XML. Consulte a demonstração do ViewInCompose para ver mais detalhes (I42916).
Melhora na API DrawModifier:
- O escopo do receptor foi definido para draw() ContentDrawScope.
- Todos os parâmetros em draw() foram removidos.
- DrawScope tem a mesma interface que o antigo CanvasScope.
- ContentDrawScope tem o método drawContent() (Ibaced, b/152919067).
positionInParent e boundsInParent foram adicionados para LayoutCoordinates (Icacdd, b/152735784).
DrawLayerModifier e drawLayer() agora definem clickToBounds e clipToOutline como falsos por padrão (I0eb8b, b/152810850).
LayoutResult foi renomeado como MeasureResult (Id8c68).
Adição de LayoutModifier2, uma nova API para definir modificadores de layout. LayoutModifier foi suspensa (If32ac).
O Modifier plus operator foi substituído por funções de extensão de fábrica (I225e4).
As propriedades translationX/Y foram adicionadas para oferecer suporte ao ajuste da lista de exibição para comandos de desenho de determinada camada. Isso é útil para mover conteúdos em resposta a animações ou eventos de toque (I8641c).
Os parâmetros pivotX e pivotY foram adicionados às APIs Layer para oferecer suporte à rotação e ao dimensionamento em torno de um determinado ponto em uma camada (Icf7c3).
Adição de OnPositionedModifier e OnChildPositionedModifier para substituir as funções compostas OnPositioned e OnChildPositioned (I2ec8f).
Adição de LayerModifier, um modificador que permite adicionar um RenderNode a um Layout. Ele permite definir o recorte, a opacidade, a rotação, o dimensionamento e as sombras. Ele vai substituir o RepaintBoundary (I7100d, b/150774014).
A direção do layout passou a ser propagada do nó de layout pai para os filhos. Adição de modificador de direção de layout (I3d955).
O componente Stack é compatível com a direcionalidade da direita para a esquerda (Ic9e00).
Foi adicionado suporte inicial ao layout RTL no Compose (Ia5519).
Density e DensityScope foram unidos em uma única interface. Agora você pode usar DensityAmbient.current em vez de ambientDensity(). Em vez de withDensity(density), apenas with(density) (I11cb1).
O LayoutCoordinates foi mudado para fazer com que providedAlignmentLines seja um Set em vez de um Map e fazer com que LayoutCoordinates implemente o operador get() em vez de extrair um valor. Isso facilita a modificação de um ou mais valores do conjunto sem criar uma nova coleção para cada modificador (I0245a).
LayoutGoordinates não tem mais uma propriedade de posição. A propriedade de posição não faz sentido ao considerar LayoutModifiers, rotação ou dimensionamento. Em vez disso, os desenvolvedores precisam usar parentCoordinates e childToLocal() para calcular a transformação de um LayoutCoordinate em outro.
LayoutCoordinates usa IntPxSize para a propriedade Size em vez de PxSize. Os layouts usam tamanhos de pixel inteiros, então todos os tamanhos de layout precisam usar números inteiros, e não valores de pontos flutuantes (I9367b).
Melhorias na superfície da API de Constraints (I0fd15)
Foi criada a API CanvasScope, que envolve um objeto Canvas, para expor uma superfície de API de desenho declarativa e sem estado. As transformações estão contidas no próprio escopo do receptor, e as informações de dimensionamento também têm escopo para os limites inseridos correspondentes. Não é necessário que um consumidor mantenha o próprio objeto de estado Paint para configurar operações de desenho.
- Inclusão do CanvasScopeSample, bem como atualização do app de demonstração para incluir uma demonstração gráfica declarativa (Ifd86d).
Foi removida a API MaskFilter, que não é usada porque tem uso limitado e não é otimizada para aceleração de hardware na maioria dos casos de uso (I54f76).
RectangleShape movido de androidx.ui.foundation.shape.* para androidx.ui.graphics.* (Ia74d5, b/154507984).
Todos os usos anuláveis de Color foram substituídos na API por não anuláveis e usam Color.Unset em vez de null (Iabaa7).
Introdução do parâmetro opcional rect extra a ImagePainter para permitir o desenho de uma subseção de ImageAsset subjacente (I0ea9e).
Adição de Unset Color para representar um valor não definido sem Colors embaladas (If901a).
Adição dos métodos de extensão Canvas.rotate e Canvas.scale para consumir coordenadas dinâmicas opcionais para transformações. O padrão deles é o canto superior esquerdo da atual tradução de Canvas.
O Canvas.rotateRad também foi movido para ser um método de extensão para fins de consistência (Ibaca6).
Criação da API PixelMap para oferecer compatibilidade com consultas de informações de pixel de um ImageAsset (I69ad6).
toFrameworkRect/toFrameworkRectF foi renomeado como toAndroidRect/toAndroidRectF para corresponder à convenção de nomenclatura para conversões de objetos entre o Compose e as APIs do framework do Android sobre os quais elas são realizadas. Os documentos dessas APIs também foram atualizados (I86337).
A API VectorPainter foi adicionada para substituir a API de subcomposição já existente em gráficos vetoriais. O resultado da subcomposição é um objeto VectorPainter em vez de um DrawModifier. Os elementos combináveis DrawVector foram descontinuados e substituídos por elementos VectorPainter.
A API Image(Painter) foi renomeada como PaintBox(Painter). Foi criado o elemento combinável Vector, que se comporta como o Image, mas com um VectorAsset em vez de um ImageAsset (I9af9a, b/149030271).
Image foi renomeado como ImageAsset para diferenciar melhor os dados do Image e o futuro composto Image, usado para participar do layout e desenhar conteúdo. Foi criado o método de extensão _Body:Created em android.graphics.Bitmap, Bitmap.asImageAsset(), para criar uma instância de um ImageAsset útil para combinar o desenvolvimento de aplicativos para Android tradicionais com o framework do Compose (Id5bbd).
Adição de TextDirection.Content (I48f36).
Adição do operador TextDecoration.plus (I0ad1a).
Force
foi removido dos valores de enum TextDirectionAlgorithm (Icc944).TextDirectionAlgorithm foi renomeado como TextDirection (I75ce8).
Implementação de LongpressAndDrag para seleção de TextField (I17919).
Adição de AnnotatedString.getStringAnnotations que retorna todas as anotações dentro do intervalo (I1fa00).
O nome do pacote foi mudado para Locale e LocaleList de androidx.ui.text para androidx.ui.intl (I8132c).
O cursor do TextField tem uma animação intermitente (Id10a7).
Mudança de API: AnnotatedString(builder: Builder) foi renomeada como anotadorString(builder: Builder) (Ia6377).
Mudança de API: AnnotatedString.Item foi renomeada como AnnotatedString.Range (I2d44d).
AnnotatedString.Builder.addAnnotationString foi renomeada como addStringAnnotation (I5059e).
Agora é possível ocultar/mostrar o teclado do software usando o SoftwareKeyboardController que é entregue pelo callback onTextInputStarted (I8dc44, b/151860051).
O operador mais foi adicionado para o estilo (texto/parágrafo/período) que delega para a função merge() (Ia1add).
FontWeight.lerp não se ajusta mais. Ainda é uma classe de dados (I521c2).
O construtor FontWeight agora é público, não é mais uma classe de dados (Id6b1f).
getLineStart, getLineEnd, getEllipsisOffset e getEllipsisCount foram adicionados a TextLayoutResult (IBc801).
O módulo ui-text foi renomeado como ui-text-core (I57dec).
Foi removida a classe Size, que não é usada porque há uma classe Size duplicada no módulo ui-geometry sendo consumida (I1b602).
Adição do Adapterlist, um componente de lista de rolagem que apenas compõe e apresenta os itens visíveis. Os problemas conhecidos atualmente incluem o fato de que ele só é vertical e não processa integralmente todos os casos de mudança nos filhos (Ib351b).
Adição de parâmetros de padding, borda, forma e plano de fundo a Box (I05027, b/148147281).
Correções de bugs
- O callback onFocusChange em campos de texto foi renomeado como onFocusChanged (Ida4a1).
- O uso de VerticalScroller e HorizontalScroller foi descontinuado. Use ScrollableColumn e ScrollableRow para ter uma experiência integrada com o comportamento e os parâmetros de Column/Row, ou Modifier.verticalScroll e Modifier.horizontalScroll no seu elemento. Da mesma forma, o elemento ScrollerPosition foi descontinuado e substituído pelo ScrollState (I400ce, b/157225838, b/149460415, b/154105299).
runOnIdleCompose
foi renomeado comorunOnIdle
(I83607).- Várias APIs de teste foram renomeadas para serem mais intuitivas. Todas as APIs findXYZ foram renomeadas como onNodeXYZ. Todas as APIs doXYZ foram renomeadas como performXYZ (I7f164).
- Agora é possível compor a interface do Compose dentro de ViewGroups sem precisar de uma nova composição. Consulte ViewInteropDemo para ver um exemplo (I9ab0b, b/160455080).
- Adição de sortWith e removeRange ao MutableVector (Icccf7).
- Implemente as alças de seleção para arrastar para mudar a seleção de TextField (I27032).
- Remoção da classe inline do Shader que encapsulava a classe NativeShader. NativeShader foi renomeada como Shader. A classe in-line Shader encapsulada não adicionava valor à superfície da API e era uma classe in-line. Portanto, use a classe NativeShader diretamente (I25e4d).
O PainterModifier foi refatorado para não fornecer mais dimensionamento com base nas restrições e no parâmetro ContentScale fornecidos. As implementações do Painter dimensionam o próprio conteúdo de desenho com base no tamanho especificado do DrawScope em que estão sendo desenhados.
Foi corrigido o problema em que o bitmap de cache de VectorPainter era dimensionado para o tamanho padrão em vez de para o tamanho fornecido para desenhar.
ImagePainter foi atualizado para dimensionar o próprio conteúdo em vez de confiar em PainterModifier para fazer isso por ele (I6ba90).
Adição da função withFrameNanos de nível superior para tempo de animação (Ie34c5).
A anotação @Untracked foi descontinuada. Substitua por @ComposableContract(tracked=false) (Id211e).
O uso de androidx.ui.foundation.TextFieldValue e androidx.ui.input.EditorValue foi descontinuado. Os elementos TextField, FilledTextField e CoreTextField que usam esse tipo também foram descontinuados. Use androidx.ui.input.TextFieldValue (I4066d, b/155211005).
Foi corrigido o problema em que o envio de entrada do ponteiro causava uma falha se PointerInputFilters era removido por meio de subcomposição durante o envio. Isso já foi corrigido (I1f48b, b/157998762).
Foi corrigido o problema em que o envio de entrada do ponteiro causava uma falha se PointerInputFilters era removido por meio de subcomposição durante o envio. Isso já foi corrigido (Iab398, b/157998762).
Classe de raio refatorada para ser uma classe in-line. Os métodos de criação complementares foram removidos e substituídos pelo construtor de função com parâmetro padrão para que o raio ao longo do eixo y corresponda ao parâmetro obrigatório de raio do eixo x.
DrawScope.drawRoundRect foi atualizado para consumir um único parâmetro de raio, em vez de dois valores flutuantes separados para o raio ao longo dos eixos x e y (I46d1b).
O composto Recompose não é mais uma abstração útil. A maioria das recomposições precisa acontecer como resultado de atribuições MutableState. Para qualquer coisa além disso, é recomendável usar a função
invalidate
para acionar uma recomposição do escopo atual (Ifc992).O uso da classe Px foi substituído em várias classes do Compose como parte do grande esforço de refatoração para depender apenas de tipos primitivos e Dp para os parâmetros de pixel (Iede0b).
Muda a estratégia de geração de código do compilador do Compose. Antes da mudança, ele transformava chamadas em funções compostas. Com essa mudança, agora transformamos o corpo de uma função combinável e deixamos o local de chamadas praticamente inalterado.
Isso significa que a maior parte da lógica que se comunica com o ambiente de execução do Compose acontece no início do corpo da função e não no local de chamadas.
Essa deve ser uma mudança compatível com a fonte para todo o uso do Compose. A maioria dos usuários do Compose não precisa atualizar nenhum código como resultado dessa mudança.
Para oferecer suporte a esse trabalho, a assinatura JVM de todas as funções compostas mudou. Uma função combinável que aceita um único parâmetro é transformada em uma função que aceita três parâmetros. Os parâmetros adicionais são o Composer, um número inteiro "chave", um inteiro de bitmask usado para propagar metadados por meio de chamadas.
O Compose agora também transforma argumentos padrão em uma função composta. Ele faz isso sem introduzir uma sobrecarga padrão sintética adicional da própria função. Portanto, essa mudança resultará na definição de menos funções.
Mudanças comportamentais intencionais conhecidas resultantes disso:
- Algumas chamadas serão ignoradas.
- As expressões compostas em expressões de argumento padrão agora são corretamente inscritas e processadas.
Esse trabalho incluiu algumas otimizações: 1. O resultado das comparações de parâmetros é propagado pelo gráfico de chamadas para outras funções combináveis. Isso resulta em menos comparações no tempo de execução e reduz o tamanho da tabela de slots, além de gerar mais pulos de funções combináveis que não foram ignoradas anteriormente. 2. Os parâmetros que são determinados como "estáticos" no momento da compilação não são mais comparados ou armazenados no ambiente de execução. Isso reduz o número de comparações e o tamanho da tabela de slots. 3. A estrutura do controle de fluxo do corpo das funções é usada para minimizar o número de grupos gerados. Isso reduz o tamanho da tabela de slots e resulta em menos trabalho para o ambiente de execução. 4. Parâmetros de envio e destinatário não utilizados para funções não são incluídos para determinar a possibilidade de pular a função, quando não são usados dentro do corpo da função.
A maioria das mudanças interruptivas foi feita em APIs a que o compilador é destinado diretamente. O uso típico do Compose não vai ser afetado: 1. Composer::startExpr foi removido. 2. Composer::endExpr foi removido. 3. O Composer::call foi descontinuado. 4. As sobrecargas que não são varargs de
key
foram removidas. Use a versãovararg
daqui em diante. 5. A anotação Pivotal foi descontinuada. Usekey
como substituto. 6. ScopeUpdateScope::updateScope foi modificado para esperar uma Function3 em vez de Function1. 7. restartableFunction e restartableFunctionN foram atualizados para incluir outros parâmetros de tempo de compilação (I60756, b/143464846).Modificadores descontinuados do LayoutAlign foram removidos (I10877).
A classe RepaintBoundary foi removida e substituída por DrawLayerModifier (I00aa4).
Agora, Button, FloatingActionButton e Clickable têm um parâmetro
enabled
separado. Alguns dos parâmetros no Button foram renomeados ou reordenados (I54b5a).ButtonStyle foi substituído por funções distintas, e a sobrecarga de texto (string) foi removida. Confira exemplos atualizados para informações de uso (If63ab, b/146478620, b/146482131).
Alterações interruptivas na API de ambientes. Consulte o registro e a documentação do
Ambient<T>
para ver detalhes (I4c7ee, b/143769776).O comportamento padrão de TextDirection agora é determinado por LayoutDirection. Por exemplo, se LayoutDirection é RTL, TextDirection padrão vai ser RTL. Antes era TextDirection.ContentOrLtr/Rtl (I4e803).
Correção de bug: quando o peso e o estilo da fonte são aninhados em uma AnnotatedString, o texto não é renderizado de maneira correta (I77a9d).
Foram adicionados parâmetros comumente usados a Text(). Se você está criando um estilo de texto local para transmitir um pequeno número desses parâmetros, como Text(style = TextStyle(textAlign = TextAlign.Center)), pode fornecer os parâmetros diretamente: Text(textAlign = TextAlign.Center) (I82768).
O módulo ui-android-text foi renomeado como ui-text-android (I68cbe).