Pacotes da Biblioteca de Suporte

Observação: com o lançamento do Android 9.0 (API nível 28), há uma nova versão da Biblioteca de Suporte denominada AndroidX, que faz parte do Jetpack. A AndroidX contém a biblioteca de suporte existente e inclui os componentes mais recentes do Jetpack.

Você pode continuar usando a biblioteca de suporte. Os artefatos históricos (da versão 27 e anteriores, empacotados como android.support.*) permanecerão disponíveis no Maven do Google. No entanto, todo o desenvolvimento da nova biblioteca ocorrerá na biblioteca AndroidX.

Recomendamos o uso das bibliotecas AndroidX em todos os novos projetos. Considere também migrar os projetos existentes para a AndroidX.

A Biblioteca de Suporte do Android contém vários pacotes de bibliotecas que podem ser incluídos no seu aplicativo. Cada uma dessas bibliotecas aceita um intervalo específico de versões da plataforma Android e um conjunto de recursos.

Para usar qualquer uma das seguintes bibliotecas, faça o download dos arquivos da biblioteca para a instalação do SDK do Android. Siga as instruções para fazer o download das Bibliotecas de Suporte em Configuração da Biblioteca de Suporte para concluir essa etapa. É preciso seguir outras etapas para incluir uma Biblioteca de Suporte específica no aplicativo. Consulte o final da seção de cada biblioteca abaixo para ver informações importantes sobre como incluir a biblioteca no aplicativo.

Observação: a versão mínima do SDK para todos os pacotes da Biblioteca de Suporte é a API nível 14. Alguns pacotes exigem um nível de API mais alto, conforme observado abaixo.

Bibliotecas de Suporte v4

Essas bibliotecas abrangem o maior conjunto de APIs em comparação com outras bibliotecas, incluindo compatibilidade com componentes de aplicativo, recursos da interface do usuário, acessibilidade, gerenciamento de dados, conectividade de rede e utilitários de programação.

Para ver informações completas e detalhadas sobre as classes e os métodos disponibilizados pelas Bibliotecas de Suporte v4, consulte o pacote android.support.v4 na Referência de API.

Observação: antes da revisão 24.2.0 da Biblioteca de Suporte, havia uma única Biblioteca de Suporte v4. Essa biblioteca foi dividida em vários módulos para melhorar a eficiência. Para compatibilidade com versões anteriores, se você listar o support-v4 no script do Gradle, o APK incluirá todos os módulos v4. No entanto, para reduzir o tamanho do APK, recomendamos que você liste apenas os módulos específicos necessários para o app.

Biblioteca de Compatibilidade v4

Oferece wrappers de compatibilidade para diversas APIs de framework, como Context.obtainDrawable() e View.performAccessibilityAction().

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-compat:28.0.0
    

Biblioteca core-utils v4

Oferece várias classes de utilitários, como AsyncTaskLoader e PermissionChecker.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-core-utils:28.0.0
    

Biblioteca core-ui v4

Implementa diversos componentes relacionados à IU, como ViewPager, NestedScrollView e ExploreByTouchHelper.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-core-ui:28.0.0
    

Biblioteca media-compat v4

Oferece retrocompatibilidade com partes do framework de mídia, incluindo MediaBrowser e MediaSession.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-media-compat:28.0.0
    

Biblioteca fragment v4

Adiciona compatibilidade para encapsulamento da interface do usuário e da funcionalidade com fragmentos, permitindo que os aplicativos ofereçam layouts que se ajustam entre dispositivos de tela pequena e grande. Esse módulo tem dependências em compat, core-utils, core-ui e media-compat.

Observação: a Biblioteca de Suporte v13 oferece uma classe FragmentCompat. A classe Fragment v4 é uma classe autônoma e oferece correções de bugs que foram adicionadas em versões posteriores da plataforma, enquanto a classe FragmentCompat v13 oferece shims de compatibilidade para a implementação de framework da classe Fragment.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-fragment:28.0.0
    

Biblioteca de Suporte Multidex (Multidex Support Library)

Esta biblioteca oferece compatibilidade com a criação de apps com vários arquivos Dalvik Executable (DEX). Os apps que fazem referência a mais de 65.536 métodos precisam usar configurações multidex. Para mais informações sobre o uso de multidex, consulte Métodos para ativar multidex para apps com mais de 64 K.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:multidex:1.0.0
    

Bibliotecas de Suporte v7

Estas bibliotecas oferecem conjuntos de recursos específicos e podem ser incluídas no aplicativo de forma independente umas das outras.

Biblioteca appcompat v7   Parte do Android Jetpack.

Observação: a biblioteca appcompat migrou para a biblioteca AndroidX, que é um componente do Android Jetpack. Veja como ela funciona no app de demonstração Sunflower (em inglês).

Essa biblioteca adiciona compatibilidade com o padrão de design da interface do usuário da barra de ações. Ela também inclui compatibilidade com implementações da interface do usuário do Material Design.

Observação: essa biblioteca depende da Biblioteca de Suporte v4.

Estas são algumas das principais classes incluídas na Biblioteca appcompat v7:

  • ActionBar: disponibiliza uma implementação do padrão da interface do usuário da barra de ações. Para mais informações sobre como usar a barra de ações, consulte o guia do desenvolvedor Barra de ações.
  • AppCompatActivity: adiciona uma classe de atividade de aplicativo que pode ser usada como classe básica para atividades que usam a implementação da barra de ações da Biblioteca de Suporte.
  • AppCompatDialog: adiciona uma classe de caixa de diálogo que pode ser usada como classe básica para caixas de diálogo temáticas do AppCompat.
  • ShareActionProvider: adiciona compatibilidade com uma ação de compartilhamento padronizada (como e-mail ou postagem em aplicativos sociais) que pode ser incluída em uma barra de ações.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:appcompat-v7:28.0.0
    

Biblioteca cardview v7

Esta biblioteca adiciona compatibilidade com o widget CardView, que permite exibir informações dentro de cards com aparência consistente em qualquer app. Esses cards são úteis para implementações do Material Design e são amplamente usados em layouts de apps para TV.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:cardview-v7:28.0.0
    

Biblioteca gridlayout v7

Depois de fazer o download das Bibliotecas de Suporte do Android, essa biblioteca adiciona compatibilidade com a classe GridLayout, que permite organizar elementos da interface do usuário por meio de uma grade de células retangulares. Para ver informações detalhadas sobre as APIs da biblioteca gridlayout v7, consulte o pacote android.support.v7.widget na Referência de API.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:gridlayout-v7:28.0.0
    

Biblioteca mediarouter v7

Esta biblioteca oferece MediaRouter, MediaRouteProvider e classes de mídia relacionadas compatíveis com o Google Cast.

Em geral, as APIs na biblioteca mediarouter v7 oferecem um meio de controlar o roteamento de canais de mídia e streaming do dispositivo atual para telas externas, alto-falantes e outros dispositivos de destino. A biblioteca inclui APIs para publicar provedores de rotas de mídia específicas do app, descobrir e selecionar dispositivos de destino, verificar status de mídia e muito mais. Para ver informações detalhadas sobre as APIs da biblioteca mediarouter v7, consulte o pacote android.support.v7.media na Referência de API.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:mediarouter-v7:28.0.0
    

As APIs da biblioteca mediarouter v7, introduzidas na Biblioteca de Suporte r18, estão sujeitas a mudanças em revisões posteriores. No momento, recomendamos o uso da biblioteca somente em conjunto com o Google Cast.

Biblioteca palette v7

A Biblioteca de Suporte palette v7 inclui a classe Palette, que permite extrair cores proeminentes de uma imagem. Por exemplo, um app de música pode usar um objeto de Palette para extrair as cores principais da capa de um álbum e usá-las para criar um cartão de título de música coordenado por cores.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:palette-v7:28.0.0
    

Biblioteca recyclerview v7

A biblioteca recyclerview adiciona a classe RecyclerView. Essa classe oferece compatibilidade com o widget RecyclerView, uma visualização para exibir grandes conjuntos de dados de maneira eficiente, disponibilizando uma janela limitada de itens de dados.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:recyclerview-v7:28.0.0
    

Biblioteca de Suporte de Preferências (Preference Support Library) v7

O pacote preference oferece APIs para a adição de objetos de preferência, como CheckBoxPreference e ListPreference, para que os usuários modifiquem as configurações da IU.

A Biblioteca de Preferências v7 adiciona compatibilidade com interfaces, como Preference.OnPreferenceChangeListener e Preference.,OnPreferenceClickListener e com classes, como CheckBoxPreference e ListPreference.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:preference-v7:28.0.0
    

Biblioteca de Suporte v8

Esta biblioteca oferece conjuntos de recursos específicos e pode ser incluída no aplicativo de forma independente de outras bibliotecas.

Biblioteca renderscript v8

Esta biblioteca adiciona compatibilidade com o framework de computação RenderScript. Essas APIs estão incluídas no pacote android.support.v8.renderscript. Lembre-se de que as etapas para a inclusão dessas APIs no aplicativo são muito diferentes das de outras APIs da Biblioteca de Suporte. Para mais informações sobre como usar essas APIs no aplicativo, consulte o guia do desenvolvedor RenderScript.

Observação: o uso de RenderScript com a Biblioteca de Suporte é compatível com compilações no Android Studio e no Gradle. A biblioteca renderscript é armazenada na pasta build-tools/$VERSION/renderscript/.

O exemplo a seguir mostra as propriedades do script de compilação do Gradle para essa biblioteca:

    defaultConfig {
        renderscriptTargetApi 18
        renderscriptSupportModeEnabled true
    }
    

Biblioteca de Suporte v13

Esta biblioteca adiciona compatibilidade para o padrão de interface do usuário Fragment com a classe FragmentCompat e outras classes de compatibilidade com fragmentos. Para mais informações sobre fragmentos, consulte o guia do desenvolvedor Fragments. Para ver informações detalhadas sobre as APIs da Biblioteca de Suporte v13, consulte o pacote android.support.v13 na Referência de API.

Observação: a biblioteca fragment v4 oferece uma classe Fragment. A classe Fragment v4 é autônoma e disponibiliza correções de bugs que foram adicionadas em versões posteriores da plataforma, enquanto a classe FragmentCompat v13 oferece shims de compatibilidade para a implementação de framework da classe Fragment.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-v13:28.0.0
    

Biblioteca de Suporte de Preferências (Preference Support Library) v14

O pacote android.support.v14.preference disponibiliza APIs para a adição de compatibilidade com interfaces de preferência, como PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, e com algumas classes, como MultiSelectListPreference e PreferenceFragment. Para ver informações detalhadas sobre as APIs da Biblioteca de Suporte de Preferências v14, consulte o pacote preference na Referência de API.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:preference-v14:28.0.0
    

Biblioteca de Suporte de Preferências (Preference Support Library) v17 para TV

O pacote android.support.v17.preference disponibiliza APIs para oferecer interfaces de preferência em dispositivos de TV, incluindo compatibilidade com a interface LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener e com algumas classes, como BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Para ver informações detalhadas sobre as APIs da Biblioteca de Suporte de Preferências v17, consulte o pacote de preference na Referência de API.

Esse pacote requer a API nível 17 ou posterior. O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

 com.android.support:preference-leanback-v17:28.0.0 

Biblioteca Leanback v17

O pacote android.support.v17.leanback oferece APIs para a criação de interfaces do usuário em dispositivos de TV. Ele disponibiliza uma série de widgets importantes para apps de TV. Entre as principais classes estão:

Esse pacote requer a API nível 17 ou posterior. O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:leanback-v17:28.0.0
    

Biblioteca de Drawables Vetoriais (Vector Drawable Library)

Oferece compatibilidade com gráficos vetoriais estáticos.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-vector-drawable:28.0.0
    

Biblioteca de Drawables Vetoriais Animados (Animated Vector Drawable Library)

Oferece compatibilidade com gráficos vetoriais animados.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:animated-vector-drawable:28.0.0
    

Biblioteca de Suporte a Anotações (Annotations Support Library)

O pacote Annotation oferece APIs para a adição de metadados de anotação aos seus apps.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:support-annotations:28.0.0
    

Biblioteca de Suporte ao Design (Design Support Library)

O pacote Design oferece APIs para a adição de componentes e padrões do Material Design aos seus apps.

A Biblioteca de Suporte de Design adiciona compatibilidade para vários componentes e padrões do Material Design que os desenvolvedores de apps podem usar durante a compilação, como gavetas de navegação, botões de ações flutuantes (FAB, na sigla em inglês), snackbars e guias.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:design:28.0.0
    

Biblioteca de Suporte a Guias Personalizadas (Custom Tabs Support Library)

O pacote Custom Tabs oferece APIs para a adição e o gerenciamento de guias personalizadas nos seus apps.

A Biblioteca de Suporte a Guias Personalizadas adiciona compatibilidade com várias classes, como Custom Tabs Service e Custom Tabs Callback.

Esse pacote requer a API nível 15 ou posterior. O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:customtabs:28.0.0
    

Biblioteca de Suporte Percentual (Percent Support Library)

O pacote Percent oferece APIs para a adição e o gerenciamento de dimensões baseadas em porcentagem no seu app.

Observação: a partir da versão 26.0.0, o uso Biblioteca de Suporte Percentual será suspenso. Os clientes desse módulo devem migrar para o novo widget ConstraintLayout, que é disponibilizado como um artefato diferente no SDK Manager.

A Biblioteca de Suporte Percentual adiciona compatibilidade com a interface PercentLayoutHelper.PercentLayoutParams e com várias classes, como PercentFrameLayout e PercentRelativeLayout.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:percent:28.0.0
    

Biblioteca de Suporte a ExifInterface (ExifInterface Support Library)

As tags Exif armazenam informações como orientação, data e hora, dados da câmera e local diretamente em um arquivo JPEG ou RAW. A classe ExifInterface desagrupa a compatibilidade para leitura de informações Exif de arquivos JPEG e RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW e RAF) e para definição de informações Exif em arquivos de imagem JPEG.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:exifinterface:28.0.0
    

Biblioteca de Suporte a Recomendações de App para TV (App Recommendation Support Library for TV)

O pacote App Recommendation oferece APIs para a adição de recomendações de conteúdo no app executado em dispositivos de TV.

A biblioteca de apps adiciona compatibilidade com anotações, como ContentRecommendation.ContentMaturity, e com várias classes, como ContentRecommendation e RecommendationExtender.

Este pacote requer a API nível 21 ou posterior. O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:recommendation:28.0.0
    

Biblioteca de IU do Wear (Wear UI Library)

Esta biblioteca conta com APIs para a criação de interfaces de usuário para apps do Wear. As APIs, disponíveis no pacote android.support.wear.widget, substituem as APIs correspondentes na Biblioteca de Suporte de Wearables (Wearable Support Library).

Para mais informações, consulte Usar a Biblioteca de IU do Wear.

O identificador de dependências de script de compilação do Gradle para essa biblioteca é:

    com.android.support:wear:28.0.0