Pacotes da Biblioteca de Suporte

Observação:com o lançamento da Biblioteca de Suporte 28.0.0, o pacote android.support As bibliotecas foram descontinuadas e substituídas pelo Jetpack com controle de versão individual bibliotecas empacotadas como androidx. A versão inicial 1.0.0 das bibliotecas do Jetpack oferece paridade com a Biblioteca de Suporte 28.0.0 e um ponto de partida para migrar para o novo pacote androidx.

As bibliotecas em pacote android.support atuais vão continuar funcionando. No entanto, eles não receberá atualizações além da 28.0.0 e não será compatível com as novas bibliotecas do Jetpack. Artefatos históricos (versões 27 e anteriores e empacotados como android.support) vão continuar disponíveis no Maven do Google. Todos os novos artefatos serão empacotados como androidx e vão exigir a migração de android.support para androidx.

Recomendamos usar as bibliotecas androidx em todos os novos projetos. Também é recomendável migrar os projetos existentes para garantir que eles continuem recebendo correções de bugs e outras melhorias de biblioteca.

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, você deve baixar os arquivos da biblioteca para o seu 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 esta etapa. É preciso realizar etapas adicionais para incluir uma Biblioteca de Suporte específica no aplicativo. Consulte o final de cada seção de biblioteca abaixo para conferir 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 de nível 14. Alguns pacotes exigem uma API mais recente de serviço, 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, tratamento de dados, conectividade de rede e utilitários de programação.

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

Observação:antes da revisão 24.2.0 da Biblioteca de Suporte, havia uma 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 support-v4 no script do Gradle, o app vai incluir todos os módulos v4. No entanto, para reduzir o tamanho do app, recomendamos que você apenas liste os módulos específicos que seu aplicativo precisa.

Biblioteca de Compatibilidade v4

Oferece wrappers de compatibilidade para várias APIs do 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 suporte para encapsulamento da interface do usuário e da funcionalidade com fragmentos, permitindo que os aplicativos forneçam layouts que se ajustem entre pequeno e em dispositivos de tela grande. Esse módulo tem dependências em compat, core-utils, core-ui, e media-compat.

Observação: a Biblioteca de Suporte v13 fornece uma classe FragmentCompat. A v4 Fragment é uma classe autônoma que fornece correções de bugs que foram adicionadas em versões posteriores da plataforma, enquanto a A classe FragmentCompat v13 oferece paliativos de compatibilidade para a implementação do framework 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 Como criar apps com mais de 64 mil métodos.

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

Essas bibliotecas fornecem 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 appcompatibilidade foi migrada para a A biblioteca do AndroidX, que é uma biblioteca do Android Componente Jetpack. Confira como ele está em uso App de demonstração Sunflower (em inglês).

Essa biblioteca adiciona suporte ao padrão de design da interface do usuário da barra de ações. Essa biblioteca inclui suporte para interface do usuário do Material Design e implementações.

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

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

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

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 suporte ao CardView , que permite mostrar informações dentro de cards que têm uma aparência consistente. em qualquer app. Esses cards são úteis para o material design implementações 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 suporte à classe GridLayout, que permite organizar elementos da interface do usuário usando uma grade de células retangulares. Para obter informações detalhadas sobre as APIs da biblioteca gridlayout v7, consulte a android.support.v7.widget na Referência da 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

Essa biblioteca fornece MediaRouter, MediaRouteProvider e classes de mídia relacionadas que são compatíveis com o Google Cast (link em inglês).

Em geral, as APIs na biblioteca mediarouter v7 oferecem um meio de controlar o roteamento de canais e transmissões de mídia 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, para descobrir e selecionar dispositivos de destino, verificar o status da mídia e muito mais. Para obter informações sobre as APIs da biblioteca mediarouter v7, consulte a Pacote android.support.v7.media na API de referência.

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 da Biblioteca de Suporte. Neste recomendamos o uso da biblioteca somente em conexão com o Google Cast.

Biblioteca palette v7

A Biblioteca de Suporte Paleta v7 inclui a Palette, que permite extrair cores proeminentes em uma imagem. Por exemplo, um app de música pode usar Objeto Palette para extrair as cores principais na capa de um álbum e usar essas cores para criar uma música com as cores certas cartão de título.

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 suporte ao 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 preferência fornece APIs para dar suporte à adição de objetos de preferência, como CheckBoxPreference e ListPreference para que os usuários modifiquem as configurações da interface.

A Biblioteca de Preferências v7 adiciona suporte a interfaces, como Preference.OnPreferenceChangeListener e Preference.OnPreferenceClickListener e 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

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

Biblioteca renderscript v8

Essa biblioteca adiciona suporte ao framework de computação RenderScript. Essas APIs estão incluídas no pacote android.support.v8.renderscript. Você você deve estar ciente de que os passos para incluir essas APIs em seu aplicativo são muito diferente de outras APIs da Biblioteca de Suporte. Para mais informações sobre o uso dessas APIs no seu aplicativo, consulte o guia do desenvolvedor do RenderScript.

Observação: o uso de RenderScript com a biblioteca de suporte é compatível com o Android Studio e compilações baseadas no Gradle. A biblioteca renderscript está localizada 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 suporte para o padrão de interface do usuário Fragment com a classe (FragmentCompat) e suporte extra a fragmentos classes. Para mais informações sobre fragmentos, consulte o guia do desenvolvedor Fragmentos. Para informações detalhadas sobre as APIs da Biblioteca de Suporte v13, consulte o pacote android.support.v13 na referência da API.

Observação:a biblioteca de fragmentos v4 fornece uma classe Fragment. A v4 Fragment é uma classe autônoma que fornece correções de bugs que foram adicionadas em versões posteriores da plataforma, enquanto a A classe FragmentCompat v13 oferece paliativos de compatibilidade para a implementação do framework 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 fornece APIs para adicionar suporte para interfaces de preferência, como PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, além de classes, como MultiSelectListPreference e PreferenceFragment. Para informações detalhadas sobre as APIs da Biblioteca de Suporte de Preferências v14, consulte o pacote preference na referência da 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 fornece APIs para adicionar interfaces de preferência em dispositivos de TV, incluindo a compatibilidade com a interface LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener e classes como BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Para obter informações sobre as APIs da Biblioteca de Suporte de Preferências v17, consulte a preferência na referência da API.

Esse pacote requer a API nível 17 ou posterior. O script de build do Gradle identificador de dependência dessa biblioteca é o seguinte:

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

Biblioteca Leanback v17

O pacote android.support.v17.leanback fornece APIs para dar suporte 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 build 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 build do Gradle para essa biblioteca é este:

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 build do Gradle para essa biblioteca é segue:

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 adição de componentes e padrões do Material Design aos seus apps.

A Biblioteca de Suporte de Design adiciona suporte 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 adição e gerenciamento de guias personalizadas nos seus apps.

A Biblioteca de Suporte a Guias Personalizadas adiciona suporte a 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 adição e 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 precisam migrar para o novo widget ConstraintLayout, que é fornecido como um artefato separado no SDK Manager.

A Biblioteca de Suporte Percentual adiciona suporte à interface PercentLayoutHelper.PercentLayoutParams e a 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, câmera informações e o local diretamente em um arquivo JPEG ou RAW. O ExifInterface desagrupa o suporte à leitura de informações Exif de arquivos JPEG e brutos (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW e RAF) formatados e definir as 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 Aplicativo Recomendação oferece APIs para oferecer suporte à adição de recomendações de conteúdo no app em execução em dispositivos de TV.

A biblioteca de apps adiciona suporte a anotações, como: ContentRecommendation.ContentMaturity e várias classes, como Recomendação de conteúdo 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 android.support.wear.widget, substituir as APIs correspondentes na Biblioteca de Suporte de Wearables.

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

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

com.android.support:wear:28.0.0