tv

Declarar dependências

Para adicionar dependências em tv-foundation e tv-material, é preciso adicionar o repositório Maven do Google ao seu projeto. Consulte a seção 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:

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-alpha09"
    implementation "androidx.tv:tv-material:1.0.0-alpha09"
}

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-alpha09")
    implementation("androidx.tv:tv-material:1.0.0-alpha09")
}

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.

Não há notas de versão para este artefato.

Versão 1.0.0

Versão 1.0.0-alpha04

8 de fevereiro de 2023

Lançamento de androidx.tv:tv-foundation:1.0.0-alpha04 e androidx.tv:tv-material:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Novos recursos

• Em linhas, colunas e grades lentas, a tabela dinâmica vai ser substituída, se necessário, para que todo o item seja visualizado (11d7e40).
• Foram adicionadas personalização de cores da guia em estados diferentes (21b2925).
• O carrossel agora aceita animações personalizadas com rolagem manual para frente e para trás (431494a).

Mudanças na API

• Renomeação de androidx.tv.material como androidx.tv.material3 e nivelamento da estrutura do pacote em androidx.tv.material3 (I6ca52).
• O indicador na linha "Carousel Indicator" (Indicador do carrossel) agora é um slot que pode ser personalizado pelo desenvolvedor (268af2a).
• focusableItem foi renomeado como immersiveListItem. Os usuários precisam adicionar manualmente o modificador focusable() ou clickable() com immersiveListItem (5dd5078) (b/263061052).
• O timeToDisplayMillis foi renomeado como autoScrollDurationMillis no componente do carrossel (431494a).
• O uso de CarouselItem agora é restrito para Carousel (431494a).
• O componente do carrossel agora aceita ContentTransforms como a definição da animação em vez de EnterTransition e ExitTransitions (431494a).
• Introdução da API PinnableContainer propagada por listas lentas usando um local de composição que permite fixar o item atual (Ib8881, b/259274257, b/195049010).
• A propriedade mainAxisItemSpacing foi adicionada a TvLazyListLayoutInfo e TvLazyGridLayoutInfo (I37765).

Correções de bugs

• A linha da guia foi atualizada para garantir que ela processe a contagem de guias de 0 ou 1 corretamente (I44009), (1c01525), (b/264018028).
• Foi corrigida a falha na pesquisa de foco quando TvLazyColumn contém uma TvLazyRow vazia (e11b4fe), (b/260299091).
• O modificador clickable agora funciona com ImmersiveList (5dd5078), (b/263061052).
• A tecla "Voltar" agora é processada e usada para sair do carrossel em destaque (84c138c).
• O carrossel não perde o foco após vários pressionamentos de tecla rápidos (799489f).
• O carrossel não perde o foco após pressionamentos de tecla longos (b2cf37e).
• Correção de falhas ocorridas quando a contagem de slides do carrossel mudava (b261247).

Versão 1.0.0-alpha03

7 de dezembro de 2022

Lançamento de androidx.tv:tv-foundation:1.0.0-alpha03 e androidx.tv:tv-material:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Novos recursos

• Agora, TabRow está disponível como uma API experimental e permite que os usuários adicionem as principais barras de navegação aos apps. Geralmente, dispositivos de TV esperam que as guias carreguem quando o título delas está focado na linha de guias.
• Indicadores específicos de TV, como o sublinhado e o em forma de pílula são oferecidos prontos para uso. Os usos de exemplo podem ser encontrados em exemplos-tv.

Versão 1.0.0-alpha02

9 de novembro de 2022

Lançamento de androidx.tv:tv-foundation:1.0.0-alpha02 e androidx.tv:tv-material:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Correções de bugs

• Melhora no desempenho da rolagem em uma coleção de TvLazyRows/TvLazyColumns, reduzindo o espaço de pesquisa de foco (I723a3).

Versão 1.0.0-alpha01

5 de outubro de 2022

Lançamento de androidx.tv:tv-foundation:1.0.0-alpha01 e androidx.tv:tv-material:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

A primeira versão Alfa contém implementações de pré-lançamento antecipado de componentes para casos de uso de TV, incluindo:

• Foi adicionado o modificador scrollableWithPivot para permitir que contêineres de rolagem não lentos (como Row, Column e Grid) façam com que o contêiner role o conteúdo para que o item em foco permaneça na mesma posição na tela da TV.
• Os elementos de composição TvLazyRow, TvLazyColumn, TvLazyHorizontalGrid e TvLazyVerticalGrid foram adicionados. Dessa forma, o contêiner vai rolar o conteúdo para que o item em foco permaneça na mesma posição na tela da TV.
• Foi adicionado um elemento de composição de carrossel em destaque para TV que permite ao usuário criar um carrossel de banner com rolagem automática.
• Foi adicionado um elemento combinável de lista imersiva para TV que permite ao usuário criar uma linha/coluna/grade imersiva que muda o plano de fundo com base no item da lista em foco.

Problemas conhecidos

• Por padrão, quando o contêiner de rolagem ganha foco, o primeiro elemento não ganha.
• O foco em um TextField nem sempre abre o teclado ou pode inibir a seleção de outros campos.
• A rolagem vertical em uma LazyColumn contendo LazyRows tem um desempenho ruim.