Collection

Reduza o impacto na memória de coleções novas e existentes.
Atualização mais recente Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
5 de junho de 2019 1.1.0 - - -

Como declarar dependências

Para adicionar uma dependência à Collection, é preciso adicionar o repositório Maven do Google ao projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

    dependencies {
        def collection_version = "1.1.0"

        // Java language implementation
        implementation "androidx.collection:collection:$collection_version"
        // Kotlin
        implementation "androidx.collection:collection-ktx:$collection_version"
    }
    

Para ver mais informações sobre dependências, consulte Adicionar dependências de compilação.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas existentes (link em inglês) nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar novo problema (link em inglês)

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

Versão 1.1.0

Versão 1.1.0

5 de junho de 2019

Lançamento de androidx.collection:collection:1.1.0 e androidx.collection:collection-ktx:1.1.0. As confirmações inclusas na versão 1.1.0 podem ser encontradas neste link.

Veja abaixo um resumo das mudanças da versão 1.0.0 para a 1.1.0:

Novos recursos

  • Uso de uma implementação mais eficiente para as funções contains e isNotEmpty no artefato "collection-ktx". (aosp/866529, link em inglês)

Mudanças na API

  • Adicionar putIfAbsent a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772608, link em inglês)
  • Adicionar getOrDefault a SimpleArrayMap (aosp/772607, link em inglês)
  • Adicionar dois argumentos remove a LongSparseArray, SimpleArrayMap e SparseArrayCompat. Suspender o uso das extensões KTX correspondentes para essa funcionalidade. (aosp/772482, link em inglês)
  • Adicionar dois argumentos replace a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772483, link em inglês)
  • Adicionar três argumentos replace a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772484, link em inglês)
  • Suspender o uso dos métodos delete redundantes. O método remove oferece a mesma API e funcionalidade e corresponde à API usada por mapas não especializados. (aosp/866053, link em inglês)

Correções de bugs

  • Mudança de SimpleArrayMap para sincronizar o cache global interno de matrizes em SimpleArrayMap.class em vez de ArrayMap.class. Isso garante que, se você usar apenas SimpleArrayMap, será possível remover ArrayMap usando ferramentas de redução de código. (aosp/934557, link em inglês)

Versão 1.1.0-rc01

7 de maio de 2019

Lançamento de androidx.collection:collection:1.1.0-rc01 e androidx.collection:collection-ktx:1.1.0-rc01. As confirmações incluídas nessa versão podem ser encontradas neste link (link em inglês).

Novos recursos

  • Uso de uma implementação mais eficiente para as funções contains e isNotEmpty no artefato "collection-ktx". (aosp/866529, link em inglês)

Versão 1.1.0-beta01

3 de abril de 2019

Lançamento de androidx.collection:collection:1.1.0-beta01 e androidx.collection:collection-ktx:1.1.0-beta01. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Mudanças na API

  • O método mencionado em notas de versão alfa03, como tendo o valor @RestrictTo modificado, foi removido. Ele não foi usado por nenhuma biblioteca AndroidX (agora ou historicamente) e não ofereceu nenhuma funcionalidade que estava faltando na API pública.

Correções de bugs

  • Mudança de SimpleArrayMap para sincronizar o cache global interno de matrizes em SimpleArrayMap.class em vez de ArrayMap.class. Isso garante que, se você usar apenas SimpleArrayMap, será possível remover ArrayMap usando ferramentas de redução de código. (aosp/934557, link em inglês)

Versão 1.1.0-alpha03

13 de março de 2019

Lançamento de androidx.collection:collection:1.0.0-alpha03 e androidx.collection:collection-ktx:1.0.0-alpha03. A lista completa de confirmações incluídas nessa versão pode ser encontrada neste link (link em inglês).

Mudanças na API

  • Um método em ArraySet marcado anteriormente como @RestrictTo(LIBRARY_GROUP) foi alterado para @RestrictTo(LIBRARY_GROUP_PREFIX). Essa ação foi realizada para oferecer compatibilidade com o uso histórico de outras bibliotecas do AndroidX que agora pertencem a diferentes IDs de grupo do Maven. Esse método se tornará público ou será removido na versão 1.1.0-alpha04, uma vez que outras bibliotecas do AndroidX não devem receber APIs especiais a que outros desenvolvedores não tenham acesso.

Versão 1.1.0-alpha02

30 de janeiro de 2019

Lançamento de androidx.collection:collection 1.1.0-alpha02 e androidx.collection:collection-ktx 1.1.0-alpha02.

Mudanças na API

  • Suspender o uso dos métodos delete redundantes. Os métodos remove oferecem a mesma API e funcionalidade e correspondem à API usada por mapas não especializados. (aosp/866053, link em inglês)

Versão 1.1.0-alpha01

3 de dezembro de 2018

Mudanças na API

  • Adicionar putIfAbsent a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772608, link em inglês)
  • Adicionar getOrDefault a SimpleArrayMap (aosp/772607, link em inglês)
  • Adicionar dois argumentos remove a LongSparseArray, SimpleArrayMap e SparseArrayCompat. Suspender o uso das extensões KTX correspondentes para essa funcionalidade. (aosp/772482, link em inglês)
  • Adicionar dois argumentos replace a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772483, link em inglês)
  • Adicionar três argumentos replace a LongSparseArray, SimpleArrayMap e SparseArrayCompat (aosp/772484, link em inglês)