Core

Atualização mais recente Versão estável atual Próximo candidato a lançamento Versão Beta Versão Alfa
15 de abril de 2020 1.2.0 1.3.0-rc01 - -

Como declarar dependências

Para adicionar uma dependência ao Core, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

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

dependencies {
    def core_version = "1.3.0"

    // Java language implementation
    implementation "androidx.core:core:$core_version"
    // Kotlin
    implementation "androidx.core:core-ktx:$core_version"

    // To use RoleManagerCompat
    implementation "androidx.core:core-role:1.0.0-rc01"

    // To use the Animator APIs
    implementation "androidx.core:core-animation:1.0.0-alpha01"
    // To test the Animator APIs
    androidTestImplementation "androidx.core:core-animation-testing:1.0.0-alpha01"
}

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 nesta biblioteca antes de criar um novo. Adicione seu voto a um problema existente clicando no botão de estrela.

Criar uma nova edição

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

Core e Core-ktx Versão 1.3.0

Versão 1.3.0-rc01

15 de abril de 2020

Lançamento de androidx.core:core:1.3.0-rc01 e androidx.core:core-ktx:1.3.0-rc01. A versão 1.3.0-rc01 contém essas confirmações (link em inglês).

Correções de bugs

  • WindowInsetsCompat agora implementa corretamente hashCode() e equals() em todos os níveis de API compatíveis.

Versão 1.3.0-beta01

1º de abril de 2020

Lançamento de androidx.core:core:1.3.0-beta01 e androidx.core:core-ktx:1.3.0-beta01. A versão 1.3.0-beta01 contém essas confirmações (link em inglês).

Versão 1.3.0-alpha02

4 de março de 2020

Lançamento de androidx.core:core:1.3.0-alpha02 e androidx.core:core-ktx:1.3.0-alpha02. A versão 1.3.0-alpha02 contém essas confirmações (link em inglês).

Mudanças na API

  • Novas APIs em NestedScrollView para executar rolagens suaves com duração especificada
  • Uma nova API ViewCompat para recuperar as inserções de janela originais que foram enviadas para a hierarquia de visualização

Versão 1.3.0-alpha01

29 de janeiro de 2020

Lançamento de androidx.core:core:1.3.0-alpha01 e androidx.core:core-ktx:1.3.0-alpha01. A versão 1.3.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

  • Adicionado em ContentProviderCompat
  • Adicionado em WindowInsetsCompat.Builder

Mudanças na API

  • Adição de uma API NotificationCompat para silenciar uma instância de notificação
  • Adicionado em ResourcesCompat.NULL_ID
  • CarExtender.UnreadConversationobsoleto em NotificationCompat
  • Adição de uma API DisplayCompat para conseguir o tamanho físico do dispositivo

Correções de bugs

  • Melhoria nas ações de gerenciamento sem ícones em NotificationCompat
  • Correção da tonalidade do drawable no TextView em relação aos drawables compostos na API de nível 23 (aosp/1172194, link em inglês)
  • Garantia de que o contexto base seja sempre um wrapper
  • Correção de um problema em que o RecyclerView não preenche Collection[Item]Info por padrão

Versão 1.2.0

Versão 1.2.0

5 de fevereiro de 2020

Lançamento de androidx.core:core:1.2.0 e androidx.core:core-ktx:1.2.0. A versão 1.2.0 contém essas confirmações (link em inglês).

Principais mudanças desde a versão 1.1.0

  • Adição de novas APIs e correções de bugs em NotificationCompat
  • Adição de novas APIs para trabalhar com BlendMode no AndroidQ de maneira compatível com versões anteriores
  • Adição de novas APIs e correções de bugs na compatibilidade de acessibilidade
  • Adição de novas APIs para trabalhar com ShortcutInfo
  • Adição de novas APIs para trabalhar com WindowInsets
  • Correção da compatibilidade com versões anteriores para strings de chave do pacote entre 28.0 (Biblioteca de Suporte) e 1.1 (AndroidX) em EditorInfoCompat, ShareCompat, WakefulBroadcastReceiver e InputConnectionCompat

Versão 1.2.0-rc01

20 de novembro de 2019

Lançamento de androidx.core:core:1.2.0-rc01 e androidx.core:core-ktx:1.2.0-rc01, sem alterações desde 1.2.0-beta02. A versão 1.2.0-rc01 contém essas confirmações (link em inglês).

Versão 1.2.0-beta02

7 de novembro de 2019

Lançamento de androidx.core:core:1.2.0-beta02 e androidx.core:core:1.2.0-beta02. A versão 1.2.0-beta02 contém essas confirmações (link em inglês).

Correções de bugs

  • Traduções atualizadas para localidades en-rCA e en-rXC.

Versão 1.2.0-beta01

9 de outubro de 2019

Lançamento de androidx.core:core:1.2.0-beta01 e androidx.core:core-ktx:1.2.0-beta01. A versão 1.2.0-beta01 contém essas confirmações (link em inglês).

Mudanças na API

  • Adicionada compatibilidade com a criação de Ações do NotificationCompat usando IconCompat e suspensão do uso de um campo público (e seu getter) usando IDs de recurso para representar ícones de Ações. (aosp/1119192, link em inglês)
  • Adicione MathUtils.clamp para longs (aosp/1117300, link em inglês)
  • Adicionada setChronometerCountDown a NotificationCompat (b/138601213, link em inglês)

Correções de bugs

  • Corrigido um problema com o processamento de dígitos unicode na detecção de endereços. (aosp/1129852, link em inglês)

Contribuição externa

  • Agradecemos a Sergey Zakharov por liberar a API de verificação de lint para o MissingBuild e ListenerLast no AndroidX. (aosp/1119191, aosp/1126768, links em inglês)

Versão 1.2.0-alpha04

5 de setembro de 2019

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

Mudanças na API

  • O uso de ShortcutInfoCompat.Builder#setLongLived() foi suspenso, e ela foi substituída por uma nova API com o mesmo nome, que aceita um valor booleano como parâmetro, para corresponder à API semelhante em ShortcutInfo.Builder no framework do Android.
  • Adição de ShortcutInfoCompat.Builder#setRank() e ShortcutInfoCompat#getRank() para corresponder a ShortcutInfo no framework do Android.

Correções de bugs

  • A rolagem prévia aninhada não é mais executada antes que o gesto exceda a tolerância de toque (b/139530818, aosp/1105373, links em inglês). Isso beneficia o ViewPager2 e outras bibliotecas.

Versão 1.2.0-alpha03

7 de agosto de 2019

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

Novos recursos

  • Adicionado UriCompat.toSafeString(Uri) para fornecer escape de URI atualizável separadamente da plataforma. (b/130878326, link em inglês)
  • Adicionada interface Predicate<T> para fornecer predicados em estilo Java 8 sem exigir recursos da linguagem Java 8.

Mudanças na API

  • removeDynamicShortuct() se tornou estático (b/134993204, link em inglês)
  • Criado método de fábrica para o filtro de cores BlendMode. (b/135943149)
  • Adição de async, counter e isEnabled a TraceCompat (aosp/987332, link em inglês)
  • APIs do Unhid em WindowInsetsCompat e ViewDragHelper (aosp/979408, link em inglês)

Correções de bugs

  • Corrigido bug da rolagem de NestedScrollView em resposta a chamadas de rolagem a11y. (aosp/971000, link em inglês)
  • Início do uso da implementação de SimpleArrayMap em ViewCompat (aosp/1012534, link em inglês)
  • Corrigido bug em que o FingerprintManager verificava incorretamente o PackageManager na API de nível 23. (b/124066957)

Versão 1.2.0-alpha02

13 de junho de 2019

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

Mudanças na API

  • Adição de WindowInsetsCompat.wrap() e unwrap(), para poder unir e separar instâncias de WindowInsets.

Versão 1.2.0-alpha01

7 de maio de 2019 Lançamento de androidx.core:core:1.2.0-alpha01 e androidx.core:core-ktx:1.2.0-alpha01.

Novos recursos

  • Adicionar ações de acessibilidade ACTION_PAGE_UP/DOWN/NEXT/PREVIOUS
  • Adição de CATEGORY_NOTIFICATION a NotificationCompat
  • Adicionada compatibilidade para ações de notificação contextuais
  • Adicionada compatibilidade para bubbles em NotificationCompat
  • Adicionadas APIs BlendModeCompat para usar as APIs BlendMode no Android 10 e voltar para os equivalentes de PorterDuff.Mode sempre que possível
  • Adição de novos getters ao WindowInsetsCompat e ViewCompat
  • Adição de compatibilidade com a função "toque para editar" em notificações
  • Exclusão de gestos do sistema rects do DrawerLayout
  • Adicionada API NotificationCompat para permitir ações contextuais geradas pelo sistema
  • Processamento de componentes <activity-alias> desativados no NavUtils
  • Adicionar AccessibilityNodeInfoCompat.setEntryKey

Correções de bugs

  • Correção de exceção ao carregar fontes no TypefaceCompat
  • Várias correções de DayNight
  • Corrigida compatibilidade com versões anteriores para strings de chaves do pacote entre 28.0 (Biblioteca de Suporte) e 1.1 (AndroidX) no EditorInfoCompat, ShareCompat, WakefulBroadcastReceiver e InputConnectionCompat.

Versão 1.1.0

Versão 1.1.0

5 de setembro de 2019

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

Mudanças importantes desde a versão 1.0.0

  • Atualizadas APIs de acessibilidade para corresponder às APIs de acessibilidade da plataforma Android 10
  • Adicionadas melhorias à Nested Scrolling; consulteNestedScrollingChild3 e NestedScrollingParent3.
  • Essa biblioteca não expõe mais a dependência androidx.collection como parte da sua API. Se você depende dos tipos androidx.collection implicitamente por meio de uma dependência do Core, é necessário adicionar uma dependência androidx.collection explícita à sua biblioteca ou app. Essa alteração é incompatível com a fonte, mas mantém a compatibilidade binária. A dependência Collection ainda é uma dependência transitiva do Core, mas como um detalhe de implementação, não como parte da própria API.
  • Resolvido problema de compatibilidade de IPC causado pelo refactor para androidx (aosp/948725, aosp/938269, link em inglês)
  • Adicionadas várias correções para o AppCompat DayNight (aosp/942956, link em inglês)

Versão 1.1.0-rc03

7 de agosto de 2019

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

Correções de bugs

  • A androidx.core.app.ComponentActivity oculta implementa LifecycleOwner para manter a compatibilidade binária com androidx.fragment:fragment:1.0.0 (osp/1094409, link em inglês)

Versão 1.1.0-rc02

2 de julho de 2019

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

Correções de bugs

  • FingerprintManagerCompat#getFingerprintManagerOrNull na API de nível 23 não precisa verificar PackageManager (b/124066957, link em inglês) (aosp/987433, link em inglês)
  • Corrigida comparação de igualdade em AccessibilityNodeInfoCompat. (aosp/985736)

Versão 1.1.0-rc01

5 de junho de 2019

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

Correções de bugs

  • Ativada retrocompatibilidade da API do teclado de imagens com todas as implementações anteriores. (aosp/968220)
  • Remoção do ListenableFuture Guava das dependências da biblioteca androidx.core:core. (b/133171974, aosp/965393, link em inglês)
  • Correção da velocidade incorreta ao lançar com rolagem aninhada. (aosp/961642)
  • Adição de teste para modificar TransitionDrawable (b/37033322, link em inglês)

Versão 1.1.0-beta01

7 de maio de 2019

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

A versão inicial do AndroidX deixou de ser compatível com versões anteriores para APIs compat da Biblioteca de Suporte que são usadas para comunicação entre processos, enviando dados com chave em pacotes. Essa versão corrige essa compatibilidade, restaurando a comunicação entre o código criado com a Biblioteca de Suporte 28.0 (ou anterior) e o AndroidX 1.1 (ou posterior).

Mudanças na API

  • Cancelada suspensão de setters de capacidade. (aosp/937281)
  • RemoteActionCompat agora é um 1VersionedParcelable` (aosp/928534, link em inglês)

Correções de bugs

  • AppCompatTextView nos testes principais precisa ser criado com um tema appcompat. (aosp/951636)
  • Uso de valores de string anteriores a 1.0 para InputConnectionCompat. (aosp/948725)
  • Uso de strings anteriores ao AndroidX como interoperabilidade de fallback para chaves do pacote. (aosp/938269)
  • Corrigido bug nas atualizações do DayNight quando em segundo plano. (aosp/942956)
  • Implementada API de chave de entrada de texto para serviços de acessibilidade no teclado do AOSP. (aosp/943897)
  • Corrigida exceção ao carregar a fonte em dispositivos com API nível 20 e anterior.
  • Processamento de componentes <activity-alias> desativados no NavUtils (aosp/940788, link em inglês)

Versão 1.1.0-alpha05

13 de março de 2019

Lançamento de androidx.core:core:1.1.0-alpha05 e androidx.core:core-ktx:1.1.0-alpha05. A lista completa de confirmações incluídas nessa versão pode ser encontrada neste link.

Novos recursos

  • Nova API ActivityCompat.recreate() para solução de bugs da plataforma anteriores à versão 28 (aosp/898940, link em inglês)
  • Nova classe LocationManagerCompat (aosp/894736, link em inglês)

Mudanças na API

  • Essa biblioteca não expõe mais a dependência "collection" como parte da API. Se você depende dos tipos "collection" implicitamente por meio de uma dependência de "core", é necessário adicionar uma dependência "collection" explícita à sua biblioteca ou app. Essa mudança é incompatível com a fonte, mas mantém a compatibilidade binária. A dependência "collection" ainda é uma dependência transitiva de "core", mas como um detalhe de implementação, não como parte da própria API.

Correções de bugs

  • Corrigido bug com o modo de tonalidade padrão para ImageView em dispositivos com a API de nível 21.

Versão 1.1.0-alpha04

30 de janeiro de 2019

Lançamento de androidx.core:core 1.1.0-alpha04 e androidx.core:core-ktx 1.1.0-alpha04.

Mudanças na API

  • Alterado valor de EXTRA_SHORTCUT_ID para ser consistente com a plataforma. (aosp/877712, link em inglês)
  • Adição de CATEGORY_NOTIFICATION a NotificationCompat (aosp/861067, link em inglês)

Correções de bugs

  • Correção em fontFamily, que não estava funcionando em dispositivos com a API de nível 24 e anterior. (aosp/807054)
  • Corrigido bug em que a substituição de ações de acessibilidade e a adição de ações de acessibilidade não removia ações antigas de acessibilidade. (aosp/848314)

Versão 1.1.0-alpha03

17 de dezembro de 2018

Lançamento de androidx.core 1.1.0-alpha03 e androidx.core-ktx 1.1.0-alpha03 com as seguintes mudanças. androidx.core-ktx 1.1.0-alpha02 foi lançado para fornecer uma correspondência de ktx para androidx.core 1.1.0-alpha02.

Novos recursos

  • Adição de métodos de canais de notificação a NotificationManagerCompat para que os desenvolvedores possam usar somente NotificationManagerCompat ao trabalhar com notificações. Agradecimentos especiais a Zdeněk Kořán por esse novo recurso.

Mudanças na API

  • Adicionadas novas APIs a ShortcutManagerCompat para publicar e atualizar atalhos dinâmicos.

Versão 1.1.0-alpha01

5 de novembro de 2018

Lançamento de androidx.core 1.1.0-alpha01 com as seguintes mudanças de API e correções de bugs.

Novos recursos e mudanças na API

  • NestedScrollingChild3 e NestedScrollingParent3 adicionam o parâmetro "consumed" aos métodos dispatchNestedScroll e * onNestedScroll sobrecarregados. Assim, a visualização que conduz a rolagem aninhada pode ser melhor informada sobre a distância de rolagem * consumida pelos pais em cada transmissão de rolagem aninhada.
  • NestedScrollView agora implementa NestedScrollingChild3 e NestedScrollingParent3. Por isso, as implementações NestedScrollingChild2 e * NestedScrollingParent2 de dispatchNestedScroll e onNestedScroll não têm garantia de serem chamadas. Os desenvolvedores * que estiverem contando com a chamada de qualquer uma das opções também precisam modificar a nova versão de rolagem aninhada 3 de dispatchNestedScroll e onNestedScroll.
  • ShortcutInfoCompat tem os seguintes campos novos: "Persons", "Categories" e "isLongLived". Com a finalidade de anunciar, ele pode aceitar vários tipos * de conteúdo.
  • Renomeação de SupportActivity para ComponentActivity. Para ver mais informações, consulte androidx.activity.
  • Adição do método getMainExecutor(), que retorna um link do Executor que executará tarefas enfileiradas na linha de execução principal associada a esse * contexto.
  • Adição de implementação de compatibilidade de Resources.getFloat.
  • Adição de fonte de resultados ao RemoteInput compat. Isso permite que os apps diferenciem respostas diretas e inteligentes para fins de registro.
  • Adição de funções de extensão Kotlin para ações TextView TextWatcher.
  • Suspensão do uso da capacidade AccessibilityNodeInfo e de setters de sinalização. Em vez disso, use ações.
  • Adição de AccessibilityPane a ViewCompat.
  • Exposição de ClickableSpans em dispositivos anteriores ao O por meio da adição de AccessibilityClickableSpanCompat.
  • Suspensão do uso de AccessibilityNodeInfoCompat.setFocusable(), setClickable(), setLongClickable(), setScrollable() e setContextClickable(). Adição de AccessibilityActions no lugar.
  • Adição de ViewCompat.setAccessibilityPaneTitle(), getAccessibilityPaneTitle(), setScreenReaderFocusable(), isScreenReaderFocusable(), setAccessibilityHeading() e isAccessibilityHeading(), para oferecer backport com essa funcionalidade de acessibilidade View por meio da API 19.
  • Adição de ViewCompat.enableAccessibleClickableSpanSupport() para permitir que desenvolvedores tornem ClickableSpans que não são URL acessíveis novamente por meio da API 19.

Correções de bugs

  • Corrigido bug que causava falha de ResourcesCompat.getFont() quando a rede falhava ao usar fontes disponíveis para download.
  • Corrigida uma exceção de ponteiro nulo em TypefaceCompatApi21, que ocorria quando ContentResolver retornava nulo.
  • Corrigido erro de tipo em Array Utils, em que ColorStateList era esperado, mas cores brutas eram exibidas.

Core-Animation e Core-Animation-Testing 1.0.0

Core-Animation Versão 1.0.0-alpha01

15 de abril de 2020

Lançamento de androidx.core:core-animation:1.0.0-alpha01 e androidx.core:core-animation-testing:1.0.0-alpha01. A versão 1.0.0-alpha01 contém essas confirmações (link em inglês).

Novos recursos

androidx.core:core-animation é uma retrocompatibilidade da API Animator, incluindo todos os recursos adicionados à plataforma desde a API de nível 14. Alguns dos principais recursos são:

  • ValueAnimator#pause, ValueAnimator#resume (API de nível 19)
  • ObjectAnimator.ofMultiInt, ObjectAnimator.ofMultiFloat (API de nível 21)
  • ValueAnimator#setCurrentFraction (API de nível 22)
  • AnimatorSet#setCurrentPlayTime (API de nível 26)
  • androidx.core:core-animation-testing permite que os desenvolvedores testem os animadores de maneira determinista. Consulte AnimatorTestRule para saber mais.

Core-Role Versão 1.1.0

Core-Role Versão 1.1.0-alpha01

15 de abril de 2020

androidx.core:core-role:1.1.0-alpha01 é lançado. A versão 1.1.0-alpha01 contém essas confirmações (link em inglês).

Mudanças na API

  • Adição de nome da função à galeria do sistema.

Core-Role Versão 1.0.0

Core-Role Versão 1.0.0-rc01

15 de abril de 2020

androidx.core:core-role:1.0.0-rc01 é lançado sem mudanças desde 1.0.0-beta01. A versão 1.0.0-rc01 contém essas confirmações (link em inglês).

Core-Role Versão 1.0.0-beta01

20 de novembro de 2019

androidx.core:core:1.0.0-beta01 é lançado sem mudanças desde a versão 1.0.0-alpha01. A versão 1.0.0-beta01 contém essas confirmações (link em inglês).

Core-Role Versão 1.0.0-alpha01

2 de julho de 2019

Lançamento de androidx.core:core-role:1.0.0-alpha01. Essa é a primeira versão do androidx.core:core-role. As confirmações incluídas nessa versão inicial podem ser encontradas neste link (link em inglês).

Novos recursos

  • Adição de RoleManagerCompat contendo o nome e a documentação das funções que podem estar disponíveis no sistema.

Versão 1.0.2

Versão 1.0.2

7 de maio de 2019

Lançamento de androidx.core:core:1.0.2 e androidx.core:core-ktx:1.0.2. Essa versão inclui duas confirmações.

A versão inicial do AndroidX deixou de ser compatível com versões anteriores para APIs compat da Biblioteca de Suporte que são usadas para comunicação entre processos, enviando dados com chave em pacotes. Essa versão corrige essa compatibilidade, restaurando a comunicação entre o código criado com a Biblioteca de Suporte 28.0 (ou anterior) e o AndroidX 1.1 (ou posterior).

Correções de bugs

  • Uso de valores de string anteriores a 1.0 para InputConnectionCompat. (aosp/948725)
  • Uso de strings anteriores ao AndroidX como interoperabilidade de fallback para chaves do pacote. (aosp/938269)

Versão 1.0.1

Versão 1.0.1

7 de novembro de 2018

Versão de correção de bugs de core-1.0.1 e appcompat-1.0.2.

Correções de bugs

  • Corrigido bug em que PrecomputedTextCompat falhava quando usado com RTL AppCompatTextView. b/113070424 (link em inglês)

Core-Ktx Versão 1.0.1

5 de novembro de 2018

Lançamento de androidx.core-ktx 1.0.1 com as seguintes correções de bugs:

  • Corrigido bug em que a implementação de união e interseção estava trocada.