Compose UI

Componentes fundamentais do Compose UI necessários para interagir com o dispositivo, incluindo layout, desenho e entrada.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
20 de março de 2024 1.6.4 - - 1.7.0-alpha05

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.

GrupoDescrição
compose.animationCrie animações nos aplicativos Jetpack Compose para enriquecer a experiência do usuário.
compose.compilerTransforme funções @Composable e ative otimizações com um plug-in do compilador Kotlin.
compose.foundationCrie 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.materialCrie 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.material3Crie 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.runtimeElementos 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.uiComponentes 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.6.4"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.11"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.ui:ui:1.6.4")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.5.11"
    }

    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.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.7

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 these confirmações.

Novos recursos

  • Introdução da nova API GraphicsLayer para gravar comandos de desenho em uma lista de exibição, bem como outras propriedades que afetam a renderização da lista. Isso fornece um limite de isolamento para dividir uma cena complexa em partes menores que podem ser atualizadas individualmente umas das outras, sem recriar a cena inteira. As transformações feitas em uma GraphicsLayer podem ser feitas sem regravar a lista de exibição. Ao contrário de Modifier.graphicsLayer, GraphicsLayer permite renderizar conteúdo que pode ser composto em outro lugar e é útil em casos de uso animados em que é esperado que o conteúdo seja renderizado em diferentes cenas.

Mudanças na API

  • GraphicsLayer.draw(Canvas) não é mais uma API pública Use a função de extensão DrawScope.drawLayer(GraphicsLayer) para desenhar a camada. (I7a7c0).
  • Divisão de restrictedConstraints() em dois métodos: fitPrioritizingWidth() e fitPrioritizingHeight() (I6d7fd).
  • Introdução do stub HardwareCanvas para uso do Android L (I1c3b5, b/288494724).
  • O framework do Compose foi atualizado para expor um local de composição de GraphicsContext, além de atualizar as implementações dos modificadores DelegateableNode e drawWithCache para expor o acesso ao GraphicsContext para acesso com escopo que vai limpar automaticamente as instâncias de GraphicsLayer quando os modificadores forem removidos. (I64a2f, b/288494724).
  • Introdução de InterceptPlatformTextInput para ajudar a programar testes relacionados ao IME de baixo nível e outros casos de uso de IME de baixo nível. O uso de PlatformTextInputTestOverride foi descontinuado. (I862ed, b/322680547).
  • A função de extensão GraphicsLayer.setOutline(Outline) foi adicionada. (Ib81f4).
  • O construtor de função GraphicsContext foi introduzido para criar uma fábrica e criar instâncias de GraphicsLayer (Ib98d6, b/288494724).
  • A API GraphicsLayer foi exposta para oferecer flexibilidade definida pelo desenvolvedor para capturar 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).
  • Introduza 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 argumento onLinkClicked foi removida Uma API substituta para o suporte a hiperlinks será lançada no futuro. (I107d5).

Correções de bugs

  • A definição de API espera/real GraphicsLayer foi adicionada para oferecer suporte à captura e repetição de comandos de desenho com transformações e efeitos visuais de composição opcionais A interface GraphicsContext foi introduzida para conter dependências gráficas, incluindo a criação e o gerenciamento de instâncias de GraphicsLayer. (I4a8d6, b/288494724).
  • Foi corrigido um problema de interoperabilidade com a pesquisa de foco 1D, em que o foco ficava preso dentro de uma ComposeView incorporada entre outras visualizações (I08fd4).

Contribuição externa

  • A LocalLifecycleOwner foi movida da interface do Compose para lifecycle-runtime-compose. Assim, as APIs auxiliares baseadas no Compose podem ser usadas fora da interface do Compose. Agradecemos a Jake Wharton pela contribuição. (I6c41b, b/328263448).
  • Exponha de maneira consistente as propriedades de ponto flutuante de viés em todos os subtipos de alinhamento com base 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 these confirmações.

Mudanças na API

  • Suporte ao recurso de escrita à mão da stylus para BasicTextField2 em dispositivos após o Android U. (I002e4).
  • Neste CL, estamos adicionando a ação semântica GetScrollViewportLength para podermos exibir informações sobre os componentes que estão sendo rolados no Compose para o sistema de acessibilidade. Esse CL também se aplica ao uso dessa propriedade nas listas roláveis básicas. (Ic5fa2).
  • FocusRequester.createRefs agora é estável (I4d92c, b/261436820).
  • Introdução de DelegatableNode.requireView() para permitir que os nós modificadores recebam o View atual do Android sem ler um local de composição (I40768).
  • Nova API Path.reverse() para inverter a direção de um caminho (I36348).
  • hintLocales foi adicionado a KeyboardOptions para fornecer ao TextFields a capacidade de sugerir IMEs com localidades específicas para predefinir um idioma preferido
  • A propriedade platformLocale foi exposta de Locale que retorna o objeto da plataforma subjacente, 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

  • Apresentação de ContextualFlowRow e FlowRow/Column aprimorados com MaxLines e Overflow Temos o prazer de anunciar melhorias no FlowRow e no FlowColumn experimentais, agora com maxLines e suporte para overflow, além do lançamento de ContextualFlowRow e ContextualFlowColumn. Essa atualização foi criada para oferecer componentes com o melhor desempenho, em que ContextualFlow* é perfeito para um grande número de itens usando uma configuração pequena de maxLines e o botão dinâmico +N para mostrar mais. Além disso, FlowRow e FlowColumn são perfeitos para um pequeno número de itens, menos de 100 itens. Importante: para manter o comportamento em FlowRow ou FlowColumn, em que todos os itens são compostos, independente de se encaixarem no máximo entre eixos, defina overflow como FlowRowOverflow.Visible ou FlowColumnOverflow.Visible durante a inicialização. Confira ContextualFlowRowSample e FlowRowSample para conferir exemplos desses novos recursos em ação. (Ib9135, b/293577082).
  • Foi adicionada a propriedade semântica maxTextLength que precisa ser definida em campos de texto que filtram o número máximo permitido de caracteres (I24d9f, b/170648072).
  • O wrapper Modifier.inspectable foi descontinuado. Essa API vai criar mais invalidações do que o necessário. Por isso, o uso dessa API não é recomendado. Recomendamos que os desenvolvedores implementem o método inspectableProperties() no ModifierNodeElement se quiserem expor as propriedades modificadoras às ferramentas. (Ib3236).
  • Novo construtor para PopupProperties, que permite controle total sobre as sinalizações WindowManager.LayoutParams. (Ibb33e, b/312485503).
  • Introdução de DelegatableNode.requireLayoutCoordinates() como uma maneira de receber o LayoutCoordinates atual de um Modifier.Node sem precisar substituir onPlaced e armazenar as coordenadas em uma propriedade por conta própria (Ia8657).
  • Introdução de DelegatableNode.currentLayoutCoordinates como uma maneira de receber o LayoutCoordinates atual de um Modifier.Node sem precisar substituir onPlaced e armazenar as coordenadas em uma propriedade por conta própria (Iaebaa).
  • BasicTextField2 e APIs relacionadas no pacote androidx.compose.foundation.text2 foram movidas para androidx.compose.foundation.text (I9f635).
  • Uma nova API ApproachLayoutModifierNode foi adicionada para oferecer suporte à criação de lógica de abordagem personalizada em um nó modificador explícito Também foi adicionada uma nova API experimental DeferredTargetAnimation 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 um Path. (I63d04).
  • PathHitTest e Path.contains(Offset) foram adicionados para verificar se um Path contém um ponto específico (I3b218).
  • O TextLayoutResult agora expõe o método getLineBaseline(lineIndex). Isso permite ler o valor de referência de uma linha arbitrária de texto, além das propriedades de conveniência firstBaseline e lastBaseline. (Ide4e8, b/237428541).
  • Adição de um método para comparar apenas as anotações de duas AnnotatedStrings (I32659).

Correções de bugs

  • Correção de um problema de compatibilidade com versões anteriores usando SemanticsPropertyReceiver.performImeAction e SemanticsActions.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âmetro usePlatformDefaultWidth, não é mais experimental (I8f8d2).
  • Foi adicionada uma sobrecarga de ComposeTestRule.waitUntil, que usa uma descrição de string da condição para incluir na mensagem de tempo limite (I9413e).
  • Nova API semântica unset() para remover propriedades semânticas que são adicionadas na mesma cadeia de modificadores Nova propriedade semântica isOpaque. (I8c583, b/317966058, b/246056649).
  • Remoção de originalEventPosition do método de cópia na API pública de PointerInputChange (I7bead).

Correções de bugs

  • Correção de um bug de acessibilidade que permitia que botões sem guias e botões de opção fossem clicáveis quando selecionados (I2181c).
  • Agora o VelocityTracker vai ter a correção para adicionar pontos por padrão. Se houver algum problema, a correção poderá ser desativada definindo VelocityTrackerAddPointsFix como "false". (Ib3877, b/269487059).
  • Foi corrigida a incompatibilidade do binário com versões anteriores em TextStyle e ParagraphStyle (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

  • O ClipboardManager foi expandido adicionando ClipEntry e ClipMetadata para oferecer suporte a conteúdo arbitrário, como imagens
  • A API DeviceConfigurationOverride foi adicionada à ui-test para permitir a substituição local do comportamento do conteúdo em teste, por exemplo, para especificar um tamanho, uma localidade, uma direção do layout, uma escala de fonte ou um tema disponíveis.

Versão 1.6

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 usando SemanticsPropertyReceiver.performImeAction e SemanticsActions.PerformImeAction (Ie0bb2, b/322269946).
  • Os layouts agora emitem um erro ao medir quando um deles 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 ajudará os desenvolvedores a encontrar problemas no layout com o tamanho errado em vez de em um layout que o contenha. (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

  • A implementação de gráficos vetoriais foi otimizada para melhorar a performance minimizando outras recomposições

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 separar um LayoutCoordinates sem que o nó também seja. 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).
  • Foram corrigidas outras recomposições downstream causadas por LocalSoftwareKeyboardController e LocalTextInputService que recebevam novos valores toda vez que uma raiz era 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 o DragAndDropTarget de recebimento explicitamente e tem uma lambda para ativar uma sessão de arrastar e soltar Agora, há duas funções de fábrica para um DragAndDropModifierNode. Um para receber transferências e outro para transferir dados (I69481).
  • Atualização de maximumFlingVelocity para ser representado como Float Atualizamos a documentação para esclarecer a unidade maximumFlingVelocity. (I8adc7).
  • onDragAndDropStart na fábrica DragAndDropModifierNode foi renomeado como acceptDragAndDropTransferO acceptsDragAndDropTransfer foi adicionado ao modificador dragAndDropTarget para aceitar em uma sessão de arrastar e soltar Essa lambda retorna um DragAndDropTarget viável se estiver interessado em uma sessão de arrastar e soltar. Outras lambdas para processar eventos de arrastar foram substituídas por esta. Uma função de fábrica DragAndDropTarget foi adicionada para receber sessões de arrastar e soltar (Iebf3a).
  • A DragAndDropInfo foi removida porque um tipo DragAndDropModifierNode.drag agora usa parâmetros para a transferData, o tamanho da decoração e a lambda DrawScope da decoração de arrastar.

    DragAndDropTarget tem métodos para eventos de arrastar e soltar específicos em vez de ser um único método abstrato.

    O onDragAndDropEvent na função de fábrica de uma DragAndDropModifierNode foi renomeado como onDragAndDropStart para informar melhor que o DragAndDropTarget fornecido é válido apenas para uma determinada sessão de arrastar e soltar.

    O DragAndDropEventType foi removido (I645b1).

  • PlatformTextInputModifierNode.runTextInputSession foi renomeado como establishTextInputSession (I03cd0).

  • Melhora os nomes das APIs de nó transversais para torná-los mais compreensíveis. (Ia4474).

  • Substitua OriginalText por TextSubstitution. (Ifa5a8).

  • PlatformTextInputModifierNode.textInputSession foi renomeado como runTextInputSession (Ie9c6b).

  • Os filhos de SubcomposeLayout (e layouts como LazyColumn baseados nele) que são retidos para serem reutilizados no futuro são considerados desativados. Foi introduzida uma nova API de teste assertIsDeactivated() para testar esses nós. O restante das APIs de teste filtra os nós desativados por padrão. (I2ef84, b/187188981).

  • FocusDirection.In e FocusDirection.Out foram removidos e usam FocusDirection.Enter e FocusDirection.Exit (I2f660).

  • As APIs do Material Design SwipeToReveal (para cards e ícones) agora dependem de uma API baseada em slots, conforme recomendado pelo Compose, em vez de instâncias baseadas em classe de dados para criar esses slots Essa é uma alteração interruptiva. Consulte a demonstração e o exemplo de código para saber como usar a nova API. (Ia8943).

  • O construtor FontStyle(int) foi descontinuado. Use FontStyle.Normal ou FontStyle.Italic (I66610).

  • A interface FontScalable foi renomeada como FontScaling (Ie804a).

Correções de bugs

  • 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 pressionamento de tecla do hardware para teclas que não receberam um evento Para baixo na mesma visualização do Compose agora serão ignorados (Ib37b4, b/305518328).
  • Foi adicionado suporte ao renderizador para Sweep Gradient 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 do encarte da janela (Iee695).
  • Remoção da camada do Material Core para o ícone/botão do Material3, já que as microcomparações mostram um melhor desempenho sem ela (I55555).
  • TestDispatchers transmitidos como o effectContext para testes do Compose agora serão usados para criar os clocks de teste e 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 foi renomeada como drawDragDecoration em Modifier.dragAndDrawSource, e o parâmetro de tamanho DragAndDropInfo foi renomeado como dragDecorationSize. (Id0e30, b/303904810).
  • Introduza SemanticsNodeInteraction.isDisplayed() e SemanticsNodeInteraction.isNotDisplayed() para verificar se um nó correspondente está visível ou não, sem fazer uma declaração nele. (I2c196, b/302100809).
  • Foi introduzido um valor Unspecified especial para os campos TextAlign, TextDirection, Hyphens e LineBreak do ParagraphTextStyle para substituir null. Como essas classes são inline, ao substituir anulável por não especificado, evitamos o boxe de tipo primitivo. Construtores, getters e outros métodos em TextStyle e no estilo Paging foram atualizados para aceitar os parâmetros mencionados como tipos não nulos. (I4197e, b/299490814).
  • A sobrecarga GoogleFont foi adicionada para ler um GoogleFont do XML (If8f59).
  • Transformou LoremIpsum PreviewParameterProvider em uma turma aberta. (I41bf5, b/266918816, b/300116360).

Correções de bugs

  • FontFamilyResolver agora usa Dispatchers.Main para corrotinas de gerenciamento de cache. (Ie8dd9).
  • Agora, o AndroidViewBinding remove de forma síncrona instâncias de Fragment infladas incluindo um FragmentContainerView no seu layout como parte do onRelease usando commitNow (em vez do commit que estava usando anteriormente). Isso corrige problemas com o método da Edição em tempo real para substituir a composição após 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

  • Introdução de PlatformTextInputMethodTestOverride para criar testes para editores de texto personalizados (Id159b).
  • O modificador dragAndDropSource foi adicionado para iniciar sessões de arrastar e soltar e o modificador dragAndDropTarget para receber sessões de arrastar e soltar. (Ib7828, b/286038936).
  • Foram adicionadas coleções ColorList e ColorSet que evitam alocações (I744bd).
  • Adição da sinalização temporária DisableNonLinearFontScalingInCompose para desativar o dimensionamento de fontes não linear. Defina DisableNonLinearFontScalingInCompose = true nos testes se você precisar de tempo para limpá-los. Essa flag vai 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

  • Mais otimizações para ícones do Material Design. (I3e08d).
  • Adiciona a capacidade de percorrer a árvore modificadora para cima/para baixo para encontrar nós semelhantes. (I2d234).
  • Adição do callback onRestoreFailed() ao modificador focusRestorer() (Ie1d43).
  • Adição de anotações androidx a várias APIs gráficas para especificar ColorInt, FloatRange, IntRange, Size e muito mais (Id65c8, b/290950582).
  • Adição de showSystemUi=true à definição PreviewScreenSizes (Ib61d3).

Mudanças de comportamento

  • O Compose agora usa dimensionamento 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 tamanho do texto pequeno aumentará normalmente, mas o texto já grande aumentará apenas um pouco. Além disso, a altura das linhas definidas no SP será ajustada automaticamente para se manter proporcional à altura pretendida da escala de 100%. Consulte as Práticas recomendadas de dimensionamento de fonte 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 em AndroidComposeViewAccessibilityDelegateCompat. (Ib2969).
  • As velocidades de lançamento em componentes de visualização, como ScrollView e RecyclerView, têm o limite de ViewConfiguration.ScaledMaximumFlingVelocity. O Compose agora contém a própria versão de maximumFlingVelocity, que agora se aplica a Draggable (Ibf974).
  • Adição de scaffolding inicial para oferecer suporte a APIs de arrastar e soltar da plataforma (If84ce).
  • Adição de deviceId a RotaryScrollEvent (Iba3bf).
  • A API ui-tooling Devices 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

  • Adição de um método para desativar ReusableComposition, removendo observações, mas mantendo os nós no lugar A composição desativada pode ser ativada novamente chamando setContent. (Ib7f31).
  • A interface ReusableComposition foi adicionada para gerenciar o ciclo de vida e reutilizar subcomposições (I812d1, b/252846775).
  • Modifier.focusGroup foi promovida para APIs estáveis. (I7ffa3).
  • Adição de anotações 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, melhorando a inspeção dos parâmetros (I5fe29).
  • A biblioteca wear-tooling-preview foi introduzida para listar dispositivos Wear válidos que podem ser usados para visualizações da interface (IB036e).
  • Criamos a interface FontScalable para processar a parte de dimensionamento de fonte 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 animado durante a entrada e saída da animação. A interface e a diversão combináveis LookaheadScope agora estão estáveis (Ifb2ce).
  • Foi adicionado suporte à configuração de privateImeOptions (Idb772).

Correções de bugs

  • Agora, o PopupPositionProvider.calculatePosition vai atualizar automaticamente a posição do pop-up quando o estado lido no cálculo mudar (I676a1, b/292257547).
  • Correção dos campos de texto que mostram o teclado e podem ser editados quando readOnly é definido como verdadeiro Também foi corrigido o teclado que não era exibido quando readOnly mudava de verdadeiro para falso durante o foco (I34a19, b/246909589).
  • Aplicação expandida 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

  • Adição de uma interface de localizador de serviços que pode ser implementada por implementadores do Compose, permitindo uma implementação de composição que delega para outro serviço de delegação de composição pesquisas na composição original Isso não precisa ser chamado de "directy" e é usado para permitir a criação de APIs experimentais no ambiente de execução que podem ser encontradas em versões unidas do compositor, como o módulo de interface faz. (I296b9).
  • A API PlatformTextInput* foi completamente reformulada. (I6c93a, b/274661182, b/267235947, b/277380808).
  • A SoftwareKeyboardController e a LocalSoftwareKeyboardController não são mais experimentais. LocalSoftwareKeyboardController agora também é um CompositionLocal adequado (I4c364).
  • LookaheadLayout e LookaheadLayoutScope foram descontinuados em algumas versões e agora foram removidos. As APIs de substituição são LookaheadScope, que podem funcionar com qualquer layout. (I12ac3).
  • Adição de SemanticsNodeInteraction.requestFocus como uma maneira mais conveniente e detectável de solicitar foco em testes (Ie8722).
  • Foram adicionadas APIs experimentais para registrar declarações globais, para serem usadas em testes de estruturas no futuro. (I12d77).

Correções de bugs

  • A primeira invocação do callback update de AndroidView agora será adiada até que a visualização seja anexada, em vez de ser executada quando a composição que introduz o AndroidView for aplicada Isso corrige um bug em que o callback update não seria invalidado se um estado lido fosse mudado 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 antecipado em LazyList. Isso permite que o LazyList no passe de visualização prévia ignore qualquer animação (por exemplo, animação de posição de item, AnimatedVisibility etc.) e calcule o tamanho e a posição da prévia de todos os filhos. Após a aprovação prévia, os filhos de LazyList podem ser animados de forma independente da realidade, conforme mostrado

Mudança de comportamento: includeFontPadding agora é falsa 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 primeira e na última linha do texto para acomodar caracteres que possam se estender acima ou abaixo das linhas de base do texto.

A atualização dessa versão do Compose vai modificar a forma como todos os textos são renderizados na interface. Para isso, vamos remover o padding extra na primeira e na última linha de cada texto que você mostrar.

Dependendo dos requisitos da sua interface e das métricas de fonte que você está usando, as mudanças precisam ser mínimas. No entanto, você pode encontrar bloqueadores, como: - Testes de captura de tela corrompidos. Corrija a interface, se necessário, e gere novamente as imagens douradas. - O texto está um pouco desalinhado. Remova ou adicione paddings negativos personalizados, se necessário.

É possível ativar o includeFontPadding usando PlatformTextStyle para cada texto:

Text(
 text = myText,
 style = TextStyle(
   lineHeight = 2.5.em,
   platformStyle = PlatformTextStyle(
     includeFontPadding = true/false
   )
   /* … */
  )
)

É possível ativar includeFontPadding em todos os textos configurando os estilos do Material Design. 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 do desenvolvedor e nesta postagem do blog (links em inglês).

Se você tiver problemas/bugs relacionados a essa alteração, registre um bug usando o Issue Tracker.

Mudanças na API

  • Suporte a InputConnection#requestCursorUpdates (I0c69b).
  • Adição de FocusRequester.saveFocusedChild e FocusRequester.restoreFocusedChild (Ic557e, b/272302679, b/275157318).
  • O tipo ResourceResolutionException foi adicionado para unir 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 alocações de desempenho e memória. (Iede48).
  • Adição de propriedades e ações semânticas para oferecer suporte à tradução de texto. (I4a6bc).
  • Nova propriedade em IntrinsincMeasureScope e as respectivas implementações (por exemplo, MeasureScope) para indicar se a passagem de medição atual é antecipada. (I7a812).
  • A API DrawScope foi atualizada para introduzir a capacidade de redirecionar a renderização para uma tela diferente, com densidade/direção do layout e tamanho alternativos
  • Atualização de DrawContext para oferecer suporte à configuração de densidade e direção do layout, além de tornar a tela configurável. (Ie1f9b, b/225408150).
  • Adição de Paragraph#fillBoundingBoxes para calcular caixas delimitadoras de caracteres. (If30ee).
  • Um conjunto de MultiPreviews comuns foi adicionado (Ia5a27).

Correções de bugs

  • Adição da interface FocusTargetModifierNode, que pode ser usada para criar um FocusTarget personalizado (I9790e).
  • Os parâmetros fallback* no construtor TextMeasurer foram renomeados como default*. (I940a5).
  • SemanticsPropertyReceiver.performImeAction foi renomeado como onImeAction, e SemanticsActions.PerformImeAction foi renomeado como OnImeAction (I8e841).
  • Adição da roda para diferenciar uma rolagem do mouse de uma ação de arrastar na rolagem aninhada, especificamente, em NestedScrollConnection (Ie57e4).
  • A API asComposePaint foi adicionada para substituir toComposePaint, já que o objeto retornado envolve o android.graphics.Paint original (I22b4c).
  • O SemanticsProperties.imeAction foi descontinuado e substituído por um novo parâmetro para SemanticsActions.performImeAction (I4a587).
  • Agora é possível selecionar usando o mouse. A seleção baseada em toque vai expandir por palavra e encolher por caractere. (Ic0c6c, b/180639271).
  • Os métodos Paragraph que geravam AssertionError para deslocamentos fora dos limites agora geram IllegalArgumentException da mesma forma que o MultiParagraph. (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 incorretamente comandos anteriores ao focar e inserir entradas em coreano, levando à 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 solução alternativa para falhas quando a API de rolagem de acessibilidade era acessada da linha de execução em segundo plano
  • Correção dos nós não anexados que estão sendo 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 dos campos de texto que mostram o teclado e podem ser editados quando readOnly é definido como verdadeiro Também foi corrigido o teclado que não era exibido quando readOnly mudava de verdadeiro para falso durante o 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 da falha que ocorria quando SubcomposeLayout é usado dentro de movableContentOf()

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 os elementos combináveis de caixa de diálogo e pop-up que poderia fazer com que a janela filha não fosse redimensionada conforme o 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

  • A API asComposePaint foi adicionada para permitir o consumo de uma instância de android.graphics.Paint para uso no Compose.

Correções de bugs

  • A API asComposePaint foi adicionada para substituir toComposePaint, já que o objeto retornado envolve o android.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 foram removidas na recomposição, animações de cores e AndroidComposeView (Ib2bfa).
  • A diversão auxiliar CacheDrawModifierNode() foi adicionada para permitir delegação (Icf8f9).
  • Introdução da propriedade isLookingAhead, acessível pelo MeasureScope, para observar os resultados antecipados e influenciar a passagem principal, se desejado. (Ibf4c3).
  • Nova propriedade semântica traversalIndex, um ponto flutuante usado para reordenar os nós na travessia de TalkBack (valores menores vêm antes). (I9a81b, b/186443263).
  • Renomeação da propriedade semântica isContainer para isTraversalGroup (I121f6).
  • ColorProducer agora tem um operator fun invoke em vez de produce (I4a9a2).
  • A API Transform Path foi adicionada para aplicar transformações de translação/escala/rotação aos objetos de caminho. (I23434, b/233772232).
  • O método do ColorProducer é chamado de produce. (I78bde).
  • toFrameworkColorSpace foi renomeado como toAndroidColorSpace (I4f547).
  • O ColorLambda foi renomeado como ColorProducer (I73b1a).
  • Introdução de APIs para converter entre os tipos de espaço de cores do Android e do Compose. (Ie7db4, b/279979665).
  • Adição de um parâmetro de cor a BasicText para permitir a animação ou a definição eficiente de cores do texto (Iffd88, b/246961787).
  • TextRange.constrain foi renomeado como TextRange.coerceIn (I31be2).
  • Adição de TextStyle.merge(...) otimizado com lista completa de parâmetros (Iad234, b/246961787).
  • Estabilização de várias APIs Text que incluem Brush, DrawStyle, TextMotion, DrawScope.drawText, Paragraph.paint(Brush) e MultiParagraph.paint(Brush) (I2f740, b/261581564, b/261581931, b/261561245).
  • O uso de PlatformTextStyle.includeFontPadding 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).
  • UrlAnnotations em AnnotatedStrings agora podem ser abertos por serviços de acessibilidade como TalkBack (If4d82, b/253292081).
  • Adição da ação semântica InsertTextAtCursor a campos de texto (I11ed5).
  • O construtor LineHeightStyle.Alignment(topRatio) é promovido para uma API estável. (I79c32, b/261565383).
  • O TextMeasurer e as APIs relacionadas não são mais experimentais (I74647, b/261581753).
  • Adição da ação semântica PerformImeAction para invocar a ação do IME (editor de método de entrada, na sigla em inglês) nos nós do editor de texto (Ic606f, b/269633506).
  • As APIs PlatformTextInput não são mais experimentais para Android (I668eb).
  • O nome do parâmetro de valor de Enum.valueOf mudou (Ia9b89).
  • mais exceções geradas a partir do tipo enumerado valueOf (I818fe).
  • Introdução da 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étodos DrawScope.drawText, Paragraph.paint e MultiParagraph.paint para oferecer suporte a diferentes algoritmos de combinação ao desenhar texto no Canvas. (I57508).
  • O Font.MaximumAsyncTimeout foi renomeado como Font.MaximumAsyncTimeoutMillis Somente renomear. (I07af5).
  • Atualização dos valores de DPI dos dispositivos de referência @Preview (Id6151, b/254528382).
  • Os parâmetros brush e alpha foram adicionados a BasicText para permitir uma animação ou configuração eficiente do pincel de texto.
  • Foram definidos tipos de lambda sem box para Float, Double, Long, Int e Short em :ui:ui-unit (I6f18d, b/246961787).

Correções de bugs

  • Várias alocações foram removidas no rastreamento de velocidade do ponteiro (I26bae).
  • Alocações reduzidas no gerenciamento de entrada de ponteiro e layout foram reduzidas (I5333a).
  • Otimização do uso de memória vetorial e da renderização de primeiros frames (I2f3c6).
  • Alocações ao desenhar linhas e pontos com o Canvas foram removidas (I9f535).
  • Adição de documentos a AndroidFont.fontVariationSettings (I7d9e2).

Contribuição externa

  • Melhoria no desempenho e redução das 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 do Modifier.Node Adição de uma capacidade aprimorada de delegar a outras instâncias do Modifier.Node a partir de um DelegatingNode. Isso pode ser feito com as APIs delegate e undelegate. Antes dessa mudança, todas as APIs do nó delegado precisavam ser delegadas explicitamente ao nó delegado. Após essa mudança, as interfaces de nó serão delegadas implicitamente, a menos que sejam substituídas explicitamente por DelegatingNode. (67352bc).

Mudanças na API

  • Introduza NestedScrollModifierNode, uma NestedScroll Modifier.Node que pode ser delegada. (I69513).
  • Os parâmetros onReset e onRelease foram adicionados ao elemento combinável AndroidViewBinding, espelhando o elemento AndroidView e ativando o suporte à reutilização de visualizações com ViewBinding (I00b1e, b/276802519).
  • A API Compose Path foi atualizada para oferecer suporte a operações de retrocesso e casos de uso de manipulação frequente de caminhos com reutilização mais rápida (I7b797).
  • Adição de TextStyle.merge(...) otimizado com lista completa de parâmetros (Iad234, b/246961787).
  • Estabilização de várias APIs Text que incluem Brush, DrawStyle, TextMotion, DrawScope.drawText, Paragraph.paint(Brush) e MultiParagraph.paint(Brush) (I2f740, b/261581564, b/261581931, b/261561245).
  • O uso de PlatformTextStyle.includeFontPadding 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 da regressão em que o teclado não era mostrado para campos de texto dentro de 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 em LookaheadScope: SubcomposeLayouts que não têm slots condicionais (por exemplo, TabRow, Scaffold, BoxWithConstraints etc.) agora funcionam bem com animações de prévia.

Mudanças na API

  • O novo intermediateMeasurePolicy padrão, que reutiliza a política de medição da passagem de pré-lançamento, permite que subtipos de SubcomposeLayout sem slots condicionais, como Scaffold, TabRow e BoxWithConstraints, funcionem com Lookahead por padrão. (Id84c8).
  • O recompositor criado para uma janela do Android agora só vai bloquear chamadas para withFrameNanos, em vez de toda a composição, quando receber uma notificação ON_STOP Isso significa que janelas associadas a atividades interrompidas continuarão sendo recompostas para mudanças de dados, mas as animações ou qualquer outro autor de chamada de withFrameNanos serão bloqueadas (Id9e7f, b/240975572).
  • Muda o motionEventSpy para a versão estável. (Ic5ec4, b/261560988).
  • O método TextRange.constrain público foi adicionado (I97912).
  • O uso de PlatformTextStyle.includeFontPadding não foi mais descontinuado para incentivar os desenvolvedores a usar essa API de compatibilidade para mudar e testar a configuração includeFontPadding "false". (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 outra política de medida intermediária para processar a lógica de medida/layout durante animações baseadas em visualização antecipada. (I017d3).
  • PointerInput agora é lento e usa Modifier.Node para melhorar o desempenho. Leia sobre a pequena mudança de comportamento. (15dab9).
  • Mudanças nas APIs experimentais para a versão estável com eventos Key (I9c7d8, b/261566839, b/261567368).
  • As APIs experimentais foram mudadas para a versão estável em PointerInputChange (I1b543, b/261560988, b/261565762, b/261565749).
  • Foi adicionada uma maneira de instanciar um SuspendingPointerInputModifierNode para implementações de Modifier.Node mais complexas (Ic4933).
  • UrlAnnotations em AnnotatedStrings agora podem ser abertos por serviços de acessibilidade como TalkBack (If4d82, b/253292081).
  • Adição de uma API para interceptar teclas de hardware antes que elas sejam enviadas ao teclado de software (I4f4c6, b/186800395).
  • Adição da ação semântica InsertTextAtCursor a campos de texto (I11ed5).
  • As ações de teste relacionadas a texto (por exemplo, performTextInput) agora vão solicitar 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 estejam 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 medida no intermediateLayout tem IntermediateMeasureScope como receptor, o que fornece CoroutineScope, LookaheadScope e MeasureScope convenientes (Ibe2e5).
  • O LookaheadLayout foi substituído por 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).
  • Implemente a interface CompositionLocalConsumerModifierNode para permitir que Modifier.Nodes leia CompositionLocals. (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 AndroidView pode não ser disposto 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).
  • Foi corrigido um bug nas propriedades de entrada/saída de foco personalizado que apenas 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 durante a leitura de 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

  • Foi corrigido um problema em que o AndroidView não reutilizava os modificadores corretamente, possivelmente resultando em comportamentos inesperados e falhas (Ib67ee, b/275919849).
  • Correção da regressão em que o teclado não era mostrado para campos de texto dentro de 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 afetava AndroidView (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. Isso pode ser usado para replicar o comportamento de TalkBack ao colocar o foco no android.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 ao TextStyle para definir o texto como Static(default) ou animado. Use TextMotion.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âmetro onReset. Ele permite que instâncias de visualização sejam reutilizadas quando o nó delas na composição é descartado e reutilizado de forma compatível. Isso é especialmente útil para LazyRows e LazyColumns de visualizações. (I3f10d, b/230099236).
  • Introdução da 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 do BasicTextField agora atualiza o buffer de texto usando o mesmo caminho de código que as atualizações do IME e as funções de teste (por exemplo, performTextReplacement).
  • As funções de teste de texto performTextClearance, performTextReplacement e performTextSelection agora usam SemanticsActions. (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 de ModifierNodeElement. (I2256b).
  • Adição de um novo callback Modifier.Node.onReset(), que permite redefinir algum estado local para processar corretamente o caso quando o Layout for reutilizado (por exemplo, como um item de LazyColumn). FocusTargetModifierNode foi corrigido para redefinir corretamente o estado em foco (I65495, b/265201972).
  • O parâmetro BlendMode foi adicionado aos métodos DrawScope.drawText, Paragraph.paint e MultiParagraph.paint para oferecer suporte a diferentes algoritmos de combinação ao desenhar texto no Canvas. (I57508).

Correções de bugs

  • O algoritmo de ordem de foco da acessibilidade foi melhorado. Por exemplo, as barras de cima e de baixo são lidas com mais frequência primeiro e por último, respectivamente (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 como release() (I4667a).
  • Adição de waitUntilNodeCount, waitUntilAtLeastOneExists, waitUntilExactlyOneExists e waitUntilDoesNotExist como API experimental em ComposeTestRule, ampliando a API waitUntil para passar a aceitar qualquer correspondente e qualquer contagem de nós. Consulte ComposeTestRule para acessar mais documentos sobre o assunto (Ifa1b9, b/226934294).
  • O Font.MaximumAsyncTimeout foi renomeado como Font.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ções create*ComposeRule que aceitam parâmetros CoroutineContext. O contexto vai ser usado para a composição de teste e todas as chamadas LaunchedEffect e rememberCoroutineScope() 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âmetro usePlatformDefaultWidth (Ic4048).
  • Uma função foi adicionada à posição de cálculo e à tangente a uma distância em um caminho, com PathMeasure.getPosition() e PathMeasure.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 um String como texto (I47b2d, b/242705342).
  • As APIs LineBreak e Hyphens no TextStyle tiveram upgrade para a versão estável (Ic1e1d).

Contribuição externa

  • Os métodos notifyFocusedRect em TextInputSession e TextInputService 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 comportamento TalkBack's ao colocar o foco no android.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 ao TextStyle para definir o texto como Static(default) ou animado. Use TextMotion.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 em drawText por size: Size para ficar inline com outras funções DrawScope. O size é definido como Size.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 campo isInline, que indica se o grupo é destinado a uma chamada para uma função combinável inline. Se o isInline for true, 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 com variationSettings 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 de PointerIcon (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 um Scrollable 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 como Offscreen para indicar que a graphicsLayer 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 {} e PerfettoTraceRule 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 chama withFrameNanos ou withFrameMillis 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 construtor TestMonotonicFrameClock e à função de fábrica para executar o código depois de callbacks withFrameNanos, 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 do graphicsLayer. Isso é útil para calcular as transformações da graphicsLayer 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 da graphicsLayer. O Auto mantém o comportamento padrão, que usa internamente uma camada se um Alfa ou um RenderEffect/Overscroll for empregado. Ele sempre introduz um buffer fora da tela onde o ModulateAlpha evita usar um e prefere modular cada uma das instruções de desenho gravadas na graphicsLayer. O ModulateAlpha ainda vai empregar um buffer fora da tela para usos relacionados a RenderEffect/Overscroll (I25e82, b/256382834).
  • invalidateSubtree() foi adicionado a Modifier.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 para rememberNestedScrollInteropConnection. Com isso, visualizações personalizadas podem reagir melhor às restrições de rolagem, principalmente em visualizações não padrão, como ModalBottomSheetDialog (I9e107).
  • Adição da interface ObserverNode, que pode ser usada pelas implementações de Modifier.Node que precisam ser notificadas quando um valor lido muda (I5728b, b/247716483).
  • Adição de um novo construtor ao Paint, que aceita um android.graphics.Paint nativo. Também foi adicionada uma função de extensão toComposePaint() 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 e OutlinedTextField 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 a forEachGesture(), mas o loop sobre gestos opera inteiramente dentro do AwaitPointerEventScope. Assim, os eventos não podem ser perdidos entre iterações.
  • O uso de forEachGesture() foi descontinuado e substituído por awaitEachGesture(), 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 a TextStyle e SpanStyle para permitir a exibição de texto contornado (If24b8, b/155421273).
  • AnnotatedString.Builder agora implementa kotlin.text.Appendable (I1a061, b/231030444).
  • AnnotatedString.Builder agora tem um método append(AnnotatedString, start: Int, end: Int) para anexar uma substring de uma AnnotatedString e os estilos de interseção.
  • O parâmetro DrawStyle foi adicionado às funções de pintura Paragraph e MultiParagraph 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 para Modifier.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ção wght e ital por padrão, em vez de usar a configuração de plataforma para a Typeface 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 com constraints: Constraints no método TextMeasurer.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ável Dialog (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 e FocusDirection.Out foram descontinuados e substituídos por FocusDirection.Enter e FocusDirection.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) e FocusManager.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âmetros FontFamily.Resolver, Density ou LayoutDirection. Use o construtor TextMeasurer 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 a WindowInsets (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 a SlotTree.kt. Essa mudança permite que as ferramentas extraiam parâmetros para um CompositionGroup 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 no PlacementScope. 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 de LayoutCoordinates para outro (Ic5ab1, b/238632578).
  • O uso de SemanticsModifier.id foi descontinuado, e o ID semântico foi movido para LayoutInfo.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 e LineHeightStyle (I64bef).
  • O uso de TextInputService.show|hideSoftwareKeyboard foi descontinuado. Use SoftwareKeyboardController no código do app e TextInputSession 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ão POST_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 de TextMeasurer na composição (I8d66e).
  • Rect, RoundRect e MutableRect agora oferecem suporte à sintaxe in do Kotlin para chamar a função contains (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 incluem pressKeys, keysDown e keysUp (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 a EditCommand para ajudar a resolver problemas de edição de texto (I53354, b/228862731).
  • Foi adicionada a função de extensão drawText em DrawScope para fornecer uma maneira de renderizar texto com vários estilos em elementos combináveis e modificadores que operam em um DrawScope, como Canvas e drawBehind (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 a BasicText, independentemente do ambiente de execução do Compose (I17101).
  • mapTree foi adicionada a SlotTree.kt. Isso permite que as ferramentas inspecionem SlotTree 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 rastreador Velocity, 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 usar SubcomposeLayouts, mas isso será oferecido em uma versão futura (I477f5).
  • Adição do parâmetro Alfa opcional à variação Brush de TextStyle e SpanStyle para modificar a opacidade de todo o Text (Ic2fac, b/234117635).
  • O tipo de anotação UrlAnnotation e os métodos associados foram lançados para oferecer suporte a links TalkBack em AnnotatedStrings (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 e FocusProperties.
    • Comportamento aprimorado com teclado físico ou controle remoto de TV.
  • Novas APIs para:

    • Encartes de janela
    • Primitivos importantes para animações orientadas por gestos, infinitas e de layout
    • Recursos de GraphicsLayer, incluindo RenderEffect
  • 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

Lançamento de androidx.compose.ui:ui-*:1.2.0-rc02. 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 incluem withKeysDown, 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. Consulte KeyInjectionScope 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 de Modifier.scrollable que a aceitam.
  • A LocalOverScrollConfiguration experimental foi movida de foundation.gesture para o pacote básico e renomeada como LocalOverscrollConfiguration (If19fb, b/204650733).
  • A função runComposeUiTestWithoutActivity {} foi renomeada como runEmptyComposeUiTest {}, 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 a KeyInjectionScope. 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 propriedade key do MultiModalInjectionScope durante um gesto de entrada multimodal com performMultiModalInput. Consulte KeyInjectionScope 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 o FontFamily.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 e DeleteSurroundingTextInCodePointsCommand 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 como DisposeOnDetachedFromWindowOrReleasedFromPool 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 de LazyList 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 uma fun runComposeUiTest(block: ComposeUiTest.() -> Unit), que podem ser usadas para executar testes da interface do Compose sem a necessidade de uma TestRule. Para executar um teste sem uma ComposeTestRule, transmita o teste como lambda para runComposeUiTest e use os métodos e membros no escopo do receptor ComposeUiTest, que são os mesmos de ComposeContentTestRule.

    As fun runAndroidComposeUiTest(block: AndroidComposeUiTest.() -> Unit) e os interface 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 um class 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 para ComposeUiTest 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 e ComposeTestRule não são estendidos a partir de ComposeUiTest. Isso significa que as funções de extensão em ComposeUiTest ainda não podem ser chamadas na interface TestRule. Quando ComposeUiTest se qualificar para a API estável, ComposeContentTestRule e ComposeTestRule serão modificadas para serem estendidas de ComposeUiTest (Ib4e90).

  • LineHeightBehavior foi renomeado como LineHeightStyle.

  • LineVerticalAlignment foi renomeado como LineHeightStyle.Alignment.

  • A classe LineHeightTrim foi renomeada como LineHeightStyle.Trim.

  • Os valores padrão do construtor de LineHeightStyle foram removidos (I582bf, b/181155707).

  • Brush foi adicionado a TextStyle e SpanStyle para fornecer uma maneira de desenhar texto com coloração gradiente (I53869, b/187839528).

  • Os atributos trimFirstLineTop e trimLastLineBottom do LineHeightBehavior foram mudados para uma única enumeração: LineHeightTrim. Os LineHeightTrim têm valores de quatro estados definidos por dois booleanos, FirstLineTop e LastLineBottom, Both e None (Ifc6a5, b/181155707).

  • Adição de LineHeightBehavior a TextStyle e ParagraphStyle. 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 pelo TextStyle(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 e trimLastLineBottom só funcionarão corretamente quando includeFontPadding for falso (I97332, b/181155707).

  • As funções PlatformParagraphStyle.lerp e PlatformSpanStyle.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 o includeFontPadding usando o atributo TextStyle.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 do TextField (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. Use consume() para consumir a mudança completamente. Você pode usar isConsumed 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 de PointerInputChange for consumida, todas as outras também serão. Se você quiser criar uma PointerInputChange 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 da ComposeView permite que os desenvolvedores desativem o consumo de WindowInsets do Android. Isso permite separar ComposeViews na hierarquia para que elas apliquem WindowInsets sem interferirem umas nas outras (I0ef08, b/220943142).
  • KeyboardType.Decimal foi adicionado como alternativa a Keyboard.Number para a inclusão específica de separador decimal no editor de método de entrada (Iec4c8, b/209835363).
  • PointerEventType.Scroll e PointerEvent.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 por Font(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 por TextStyle(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 de Font(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 com FocusProperties, e focusProperties() agora tem todos os recursos de focusOrder(). FocusOrder e focusOrder() foram descontinuados. A função focusOrder() que aceita um focusRequester precisa ser substituída por um modificador focusRequester() em combinação com focusProperties(). Isso permite que os modificadores tenham uma separação mais forte de problemas (I601b7).

  • O upgrade de RecyclerView e Compose 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 e spotShadowColor ao GraphicsLayerScope (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 de ActionCallback (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 interface OnPlacedModifier 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 uma IllegalStateException 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 e ComposableOpenTarget, 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 ou ReusableComposeNode precisam adicionar uma anotação ComposableTarget à função e a qualquer tipo de parâmetro lambda combinável. No entanto, é recomendável criar uma anotação com ComposableTargetMarker e, em seguida, usar essa anotação marcada em vez de usar a ComposableTarget diretamente. Uma anotação combinável marcada com ComposableTargetMarker é equivalente a uma ComposbleTarget com o nome totalmente qualificado da classe de atributo como o parâmetro do applier. Para conferir um exemplo de como usar a ComposableTargetMarker, consulte anroidx.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 em FontFamily.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 classes TextInputSession e TextInputService foram descontinuados e não serão chamados. Use BringIntoViewRequester (Ia4302, b/192043120, b/216842427, b/178211874).
  • Introdução do método destroyDisplayListData na classe de stub RenderNode (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 pelo LocalFontFamilyResolver.current.

  • createFontFamilyResolver(context) e createFontFamilyResolver(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. O TextLayoutResult.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, consulte AndroidFont.

  • A função da extensão Font.AndroidResourceLoader permite criar um Font.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, use FontFamilyResolver.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, use FontFamilyResolver.preload (If8e7c, b/174162090).

  • O uso do construtor SubcomposeLayoutState que aceita maxSlotsToRetainForReuse foi descontinuado. Em vez disso, há um novo construtor que aceita a SubcomposeSlotReusePolicy, 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 retorna State<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() e Modifier.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 em androidx.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 quando HardwareRenderer.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 de Exception em vez de Throwable diretamente. Isso significa que as cláusulas de captura que capturavam Exception agora podem detectar ComposeNotIdleExceptions, 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() e InjectionScope.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 e MultiModalInjectionScope.Mouse. Para injetar eventos de toque e mouse em gestos multimodais, agora é possível usar MultiModalInjectionScope.touch() e MultiModalInjectionScope.mouse(), os quais aceitam um lambda que tem o escopo receptor dessa modalidade (Idde18).

Correções de bugs

  • O valor padrão de durationMillis em TouchInjectionScope.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

Lançamento de androidx.compose.ui:ui-*:1.1.0-alpha06. A versão 1.1.0-alpha06 contém estas confirmações.

Mudanças na API

  • Remoção da ExperimentalComposeUiApi do ViewRootForInspector e LayoutInfo.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 a SemanticsNodeInteraction 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 ao LayoutInfo para permitir que os consumidores recebam o valor correto para itens como tempo limite do pressionamento longo (I76ca6).
    • A viewConfiguration: ViewConfiguration foi adicionada ao InjectionScope 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.
  • 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 pelo Recomposer.currentState para mudar o tipo para um StateFlow (Ic2ab3, b/197773820).
  • flush() e dispose() foram adicionados a InjectionScope. 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 implementa Density, permitindo que você converta facilmente entre px e dp no performTouchInput 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 e layoutDirection: LayoutDirection foram adicionados a LayoutInfo. Isso permite que os consumidores de LayoutInfo interpretem as dimensões e a posição expostas em LayoutInfo 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 propriedade Mouse do MultiModalInjectionScope durante um gesto de entrada multimodal com performMultiModalInput. Consulte o MouseInjectionScope 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 um PointerEventType 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 e GestureScope foram descontinuados e substituídos por performTouchInput e TouchInjectionScope (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 e TouchInjectionScope foram adicionados para substituir performTouchInput e TouchInjectionScope, abrindo o caminho para outras modalidades (como o mouse).

    TouchInjectionScope tem os mesmos métodos que o GestureScope, com exceção de movePointerTo e movePointerBy, que foram renomeados como updatePointerTo e updatePointerBy. Todos os outros métodos são os mesmos.

    O comportamento da TouchInjectionScope é quase idêntico ao da GestureScope, com dois pequenos detalhes:

    1. 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 a move(), e depois a função down() 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.
    2. 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étodo currentPosition(pointerId: Int) para receber a posição atual do ponteiro específico (If1191, b/190493367).

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 Kotlin 1.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 e hasScrollToKeyAction 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ódulo androidx.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 AGP 7.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 e ui-tooling-preview (Iefa28, b/190649014).

Mudanças na API

  • Remoção de FocusManager#moveFocusIn e FocusManager#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 em PopupProperties para usePlatformDefaultWidth (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 um LocalActivityResultRegistryOwner que permite visualizar os elementos combináveis que usam APIs como rememberLauncherForActivityResult(), que dependem do proprietário já existente (Ib13d1, b/185693006).
  • O Compose @Preview agora oferece um LocalOnBackPressedDispatcherOwner que permite visualizar os elementos combináveis que usam APIs como BackHandler, que dependem do proprietário já existente (Ia1c05, b/185693006).

Correções de bugs

  • InfiniteAnimationPolicy foi movido para androidx.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 a ComposeTestRule.mainClock.advanceTimeUntil {}. Provavelmente mais limitações vão ser identificadas no futuro (I284fa).

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ório src/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 com adb 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 caracteres H, S e P, 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 classe androidx.compose.runtime.SlotTable teria o descritor Landroidx/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étodo fun isPlaced(): Boolean em LayoutNode tem a assinatura isPlaced()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 como FocusManager.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 das PopupProperties (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 por Modifier.focusTarget() (I6c860).
  • Modifier.onSizeChanged() e Modifier.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 interface FocusState (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 e detectHorizontalGestures 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 e TextDecoration em AnnotatedString 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, e SemanticsProperties.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, e SemanticsNodeInteraction.performScrollToKey, que rola uma lista até o item com a chave especificada (I4fe63, b/178483889, b/161584524).
  • 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árias addTtsAnnotation e withAnnotation foram adicionadas ao AnnotatedString.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) e FocusManager.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 e accessibilityActionScrollDown. 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 e showSoftwareKeyboard em SoftwareKeyboardController foram renomeados como hide() e show(), 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 pela FragmentContainerView quando o AndroidViewBinding é removido da hierarquia combinável (Ib0248, b/179915946).
  • AndroidViewBinding agora aninha corretamente os fragmentos inflados ao usar a FragmentContainerView quando a ComposeView está dentro de um Fragment, 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 usando FragmentContainerView 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 e startY/endY opcionais foram adicionados às funções swipeUp/swipeDown/swipeLeft/swipeRight no GestureScope (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 SemanticsMatchers 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 SemanticsMatchers 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() de ComposeRootRegistry (Iddce1).

Versão 1.0.0-beta01

24 de fevereiro de 2021

Lançamento de 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 como Button e Modifier.clickable(), use interactionSource = 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.Range
    • ParagraphStyleRange 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 para compositionLocalOf e staticCompositionLocalOf 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. Use Modifier.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 de androidx.activity:activity-compose:1.3.0-alpha01. viewModel() e LocalViewModelStoreOwner foram removidos de compose:ui. Use os de androidx.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 de selected e onClick.
    • O parâmetro alwaysShowLabels em BottomNavigationItem foi renomeado como alwaysShowLabel.
    • Os parâmetros bodyContent em alguns componentes foram renomeados como content.
    • 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 a darkColors(). Essa cor costuma ser a mesma que secondary 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 em Slider foi renomeado como onValueChangeFinished e transformado em anulável.
    • O parâmetro text em Snackbar foi renomeado como content para manter a consistência.
    • Adição do parâmetro contentPadding a DropdownMenuItem para permitir a personalização do padding padrão. Além disso, content passou a ser uma extensão em RowScope.
    • ModalDrawerLayout foi renomeado como ModalDrawer.
    • BottomDrawerLayout foi renomeado como BottomDrawer
    • (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âmetro focusable em PopupProperties (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 de remember { mutableStateOf(0) }, também vamos remover o elemento combinável savedInstanceState { 0 }. Use rememberSaveable { 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âmetro stateSaver. 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 e withMutableSnapshot 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 com ComposeTestRule (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).
  • Renomeação de TransformedText.transformedText para 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 estende ComposeTestRule e define setContent, que foi removido de ComposeTestRule. Foi adicionado um método de fábrica createEmptyComposeRule() que retorna uma ComposeTestRule e não inicia uma atividade para você. Use isso quando quiser iniciar a atividade durante o teste, por exemplo, usando ActivityScenario.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 de CompositionLifecycleObserver 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 que onEnter é chamado apenas uma vez. onEnter era chamado várias vezes quando o objeto era usado em subcomposições, como WithConstraints e Scaffold, tornando a única garantia de chamada de onEnter não confiável, e foi removido para RememberObserver.

    A interface RememberObserver adiciona a função onAbandoned, que é chamada se a instância de RememberObserver é retornada do callback transmitido para remember, mas não é lembrada no estado de composição e, portanto, a chamada de onRemembered 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 de RememberObserver após a recomendação de referência única acima estiver rastreando um recurso externo, onForgotten e onAbandoned vão indicar que o recurso não é mais necessário. Se o objeto estiver rastreando o trabalho iniciado ou os recursos alocados em onRemembered, a função onAbandoned pode ser ignorada, porque não vai ser chamada se a onRemembered 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) e itemsIndexed(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) e itemsIndexed(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).
  • A API EditOperations foi modificada.
    • 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 por animateAsState(), que retorna um State<T> em vez de T. 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 como insertTopDown().

    Um novo método, insertBottomUp(), foi adicionado.

    Uma Applier insere nós na árvore que está editando com insertTopDown() ou insertBottomUp(), dependendo de qual apresenta melhor desempenho.

    Algumas árvores, como LayoutNode e View, 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, um Applier substitui um insertBottomUp() para criar uma árvore de baixo para cima, e insertTopDown() 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 como Modifier.alpha.
    • Modifier.drawShadow foi renomeado como Modifier.shadow (I264ca, b/173208140).
  • 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 e pivotFractionY como component1 e component2 (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 para content, 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 para androidx.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 como layoutId para LayoutIdParentData. O Measurable.id foi renomeado como Measurable.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 como typeface() (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 introduzida para representar fatores de escalonamento 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 como paddingFrom. O modificador paddingFromBaseline 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ários Modifier.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

Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha06. 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).
  • DrawScope e ContentDrawScope foram refatorados para serem 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 de PointerInputFilter.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 e AnnotatedString.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> de PointerInputFilter.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 encarte como horizontal e vertical.
    • Foi adicionada uma sobrecarga do encarte, que fornece o mesmo valor de encarte a todos os quatro limites.
    • A documentação sobre o método do encarte que indicava que o encarte 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() do Owner: 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 e AndroidInputDispatcher foram movidos de androidx.ui.test.android para androidx.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

Lançamento de androidx.compose.ui:ui-*:1.0.0-alpha01. 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. Use AndroidView, 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 por FocusState (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 e OnChildPositionedModifier. Os desenvolvedores precisam usar onPositioned e OnPositionedModifier 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 a SemanticsPropertyKey. É 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 como PlacementScope.place(), e o PlacementScope.place() anterior foi renomeado como PlacementScope.placeRelative(). Por essa razão, o método PlacementScope.place() não espelhará de forma automática a posição em contextos da direita para a esquerda. Se você quiser o espelhamento, use PlacementScope.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 de remember { 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ão by 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).
  • Dois PointerEventPasses que não são mais necessários foram removidos (I33ca7).
  • Implementação de 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 e Column 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 correções amplas de API (I077bc).
    1. Remoção da interface OffsetBase não utilizada.
    2. Alinhamento das classes Offset e IntOffset para que tenham uma superfície de API consistente.
    3. IntOffset.Origin foi renomeado como IntOffset.Zero para ser consistente com a API Offset.
    4. O método nativeCanvas foi movido da interface Canvas para que os consumidores possam criar as próprias instâncias.
    5. 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.
    6. Os tipos enumerados ClipOp foram renomeados para seguir o padrão Pascal Case.
    7. Os tipos enumerados FilterQuality foram renomeados para seguir o padrão Pascal Case.
    8. Os tipos enumerados StrokeJoin foram renomeados para seguir o padrão Pascal Case.
    9. Os tipos enumerados PointMode foram renomeados para seguir o padrão Pascal Case.
    10. Os tipos enumerados PaintingStyle foram renomeados para seguir o padrão Pascal Case.
    11. Os tipos enumerados PathFillType foram renomeados para seguir o padrão Pascal Case.
    12. Os tipos enumerados StrokeCap foram renomeados para seguir o padrão Pascal Case.
    13. Atualização da implementação de DrawCache para não usar mais parâmetros lateinit.
    14. Atualização de DrawScope para não usar mais delegação lenta para os parâmetros internos fillPaint e strokePaint.
    15. Atualização do composto Image para evitar o uso do Box e ter menos sobrecarga.
    16. Atualização da classe Outline para ter anotações @Immutable.
    17. PathNode foi atualizado para ter anotações @Immutable em cada instrução de caminho.
    18. A subcomposição Vector foi atualizada para remover verificações condicionais redundantes para fins de igualdade, já que o Compose já as processa.
    19. O uso de métodos construtores complementares de Rect foi descontinuado e substituído por construtores de função.
    20. As classes Brush e construtores de função foram atualizados com APIs @Immutable e @Stable.
    21. Atualização da enumeração VertexMode para seguir o padrão Pascal Case.
    22. Atualização do método DrawScope selectPaint para substituir condicionalmente os parâmetros de traço na pintura quando eles tiverem mudado.
    23. 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. Use SemanticsNodeInteraction.performGesture (Id9b62).
  • LazyColumnItems foi renomeado como LazyColumnFor. LazyRowItems foi renomeado como LazyRowFor (I84f84).
  • Nivelação do pacote foundation.shape.corner para foundation.share (I46491, b/161887429).
  • AndroidComposeTestRule foi renomeado como createAndroidComposeRule (I70aaf).
  • Adição de mais APIs a TextLayoutResult (Id7e04).
  • FilledTextField do Material Design foi renomeado como TextField, e o TextField de base foi renomeado como BaseTextField 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
    • Tamanho
    • 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).

  • (I45f09, b/152842521)

    • 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).

  • Mudança do nome do pacote 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 como runOnIdle (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:

    1. Algumas chamadas serão ignoradas.
    2. 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ão vararg daqui em diante. 5. A anotação Pivotal foi descontinuada. Use key 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).