Recursos da Support Library

O pacote da Android Support Library contém várias bibliotecas que podem ser incluídas no aplicativo. Cada uma dessas bibliotecas aceita um intervalo específico de versões da plataforma Android e um conjunto de recursos.

Este guia explica os recursos importantes e a compatibilidade com a versão fornecida pelas Support Libraries para ajudar você a decidir quais incluir em seu aplicativo. Em geral, recomendamos incluir as bibliotecas v4 support e v7 appcompat porque elas são compatíveis com uma ampla variedade de versões do Android e fornecem as APIs para padrões recomendados de interface do usuário.

Para usar qualquer uma das bibliotecas a seguir, é preciso baixar os arquivos da biblioteca para a instalação do Android SDK. Siga as instruções para baixar as Support Libraries em Configuração da Support Library para completar esta etapa. É preciso realizar etapas adicionais para incluir uma Support Library específica no aplicativo. Consulte o final de cada seção de biblioteca abaixo para obter informações importantes sobre como incluir a biblioteca em seu aplicativo.

v4 Support Libraries

Essas bibliotecas foram projetadas para serem usadas com o Android 2.3 (API de nível 9) e posterior. Elas contêm o maior conjunto de APIs em comparação com as outras bibliotecas, inclusive compatibilidade com componentes do aplicativo, recursos de interface do usuário, acessibilidade, tratamento de dados, conectividade de rede e utilitários de programação.

Para obter informações completas e detalhadas sobre as classes e métodos fornecidos pelas v4 Support Libraries, consulte o pacote android.support.v4 na referência da API.

Observação: Antes da Support Library revisão 24.2.0, havia apenas uma v4 Support Library. Essa biblioteca se dividia 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 APK conterá todos os módulos v4. No entanto, para reduzir o tamanho do APK, recomendamos listar apenas os módulos específicos de que o aplicativo precisa.

Biblioteca v4 compat

Oferece agrupadores de compatibilidade para várias APIs da estrutura, como Context.obtainDrawable() e View.performAccessibilityAction().

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

com.android.support:support-compat:24.2.0

Biblioteca v4 core-utils

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

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

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

Biblioteca v4 core-ui

Implementa uma variedade de componentes relacionados à IU, como ViewPager, NestedScrollView e ExploreByTouchHelper.

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

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

Biblioteca v4 media-compat

Oferece portabilidade para versões anteriores de partes da estrutura de mídia, inclusive MediaBrowser e MediaSession.

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

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

Biblioteca v4 fragment

Adiciona suporte para encapsulamento da interface do usuário e da funcionalidade com fragmentos, possibilitando que os aplicativos forneçam layouts que se ajustem entre dispositivos de telas pequenas e grandes. Este módulo tem dependências nas bibliotecas compat, core-utils, core-ui e media-compat.

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

com.android.support:support-fragment:24.2.0

Multidex Support Library

Esta biblioteca permite criar aplicativos com vários arquivos Dalvik Executable (DEX). Aplicativos que referenciam mais de 65.536 métodos devem usar configurações multidex. Para obter mais informações sobre o uso de multidex, consulte Criação de aplicativos com mais de 64K métodos.

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

com.android.support:multidex:1.0.0

v7 Support Libraries

Há várias bibliotecas projetadas para serem usadas com o Android 2.3 (API de nível 9) e versões posteriores. Essas bibliotecas fornecem conjuntos de recursos específicos e podem ser incluídas em seu aplicativo de forma mutuamente independente.

Biblioteca v7 appcompat

Essa biblioteca adiciona compatibilidade com o padrão de projeto da Barra de ação da interface do usuário. Essa biblioteca contém implementações da interface do usuário do material design.

Observação: Essa biblioteca depende da v4 Support Library.

Eis algumas das principais classes incluídas na biblioteca v7 appcompat:

  • ActionBar - Fornece uma implementação da barra de ação do padrão da interface do usuário. Para obter mais informações sobre o uso da Barra de ação, consulte o guia do desenvolvedor da Barra de ação.
  • AppCompatActivity - Adiciona uma classe de atividade do aplicativo que pode ser usada como uma classe de base para usar a implementação da barra de ação da Support Library.
  • 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 compatibilidade com 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ência do script de compilação do Gradle para essa biblioteca é o seguinte:

com.android.support:appcompat-v7:24.2.0

Biblioteca v7 cardview

Essa biblioteca adiciona compatibilidade com o widget CardView, que permite mostrar informações dentro de cards que tenham uma aparência consistente em qualquer aplicativo. Esses cards são úteis para implementações do material design e são usados extensivamente em layouts para aplicativos de TV.

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

com.android.support:cardview-v7:24.2.0

Biblioteca v7 gridlayout

Depois de baixar as Android Support Libraries, essa biblioteca adiciona suporte para a classe GridLayout, que permite arranjar elementos da interface do usuário usando uma grade de células retangulares. Para obter informações detalhadas sobre as bibliotecas v7 gridlayout library APIs, consulte o pacote android.support.v7.widget na referência da API.

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

com.android.support:gridlayout-v7:24.2.0

Biblioteca v7 mediarouter

Essa biblioteca fornece MediaRouter, MediaRouteProvider e classes de mídia relacionadas que permite a compatibilidade com o Google Cast.

Em geral, as APIs na biblioteca v7 mediarouter fornece um meio de controlar o roteamento de canais e transmissões de mídia do dispositivo atual para telas, alto-falantes e outros dispositivos de destino externos. A biblioteca contém APIs para publicar provedores de rotas de mídia específicos do aplicativo para descobrir e selecionar dispositivos de destino, verificar status de mídias e muito mais. Para obter informações detalhadas sobre as APIs da biblioteca v7 mediarouter, consulte o pacote android.support.v7.media na referência da API.

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

com.android.support:mediarouter-v7:24.2.0

As APIs da biblioteca v7 mediarouter introduzidas na Support Library r18 estão sujeitas a alterações em revisões posteriores da Support Library. No momento, recomendamos usar a biblioteca apenas em conexão com Google Cast.

Biblioteca v7 palette

A biblioteca de suporte v7 palette contém a classe Palette, que permite extrair cores proeminentes de uma imagem. Por exemplo, um aplicativo de música poderia usar um objeto 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 com as cores.

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

com.android.support:palette-v7:24.2.0

Biblioteca v7 recyclerview

A biblioteca recyclerview adiciona a classe RecyclerView. Essa classe fornece suporte para o widget RecyclerView, uma visualização para exibir eficientemente conjuntos de dados grandes ao oferecer uma janela limitada para itens de dados.

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

com.android.support:recyclerview-v7:24.2.0

v7 Preference Support Library

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

A biblioteca v7 Preference adiciona suporte para interfaces, como Preference.OnPreferenceChangeListener e Preference.OnPreferenceClickListener, e classes, como CheckBoxPreference e ListPreference.

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

com.android.support:preference-v7:24.2.0

v8 Support Library

Essa biblioteca foi projetada para ser usada com o Android 2.3 (API de nível 9) e versões posteriores. Essa biblioteca fornece conjuntos de recursos específicos e pode ser incluída em seu aplicativo de forma independente de outras bibliotecas.

Biblioteca v8 renderscript

Essa biblioteca foi projetada para ser usada com o Android 2.3 (API de nível 9) e versões posteriores. Ela adiciona suporte para a estrutura de computação RenderScript. Essas APIs estão incluídas no pacote android.support.v8.renderscript. Você deve estar ciente de que os passos para incluir essas APIs em seu aplicativo são muito diferentes de outras APIs de bibliotecas de suporte. Para obter mais informações sobre o uso dessas APIs em seu aplicativo, consulte o guia do desenvolvedor de RenderScript.

Observação: O uso de RenderScript com a biblioteca de suporte é compatível com compilações baseadas em Android Studio e Gradle. A biblioteca renderscript se localiza na pasta build-tools/$VERSION/renderscript/.

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

v13 Support Library

Essa biblioteca foi projetada para o uso com o Android 3.2 (API de nível 13) e versões posteriores. Ela adiciona compatibilidade com o padrão de interface do usuário Fragment com a classe (FragmentCompat) e classes adicionais de compatibilidade com fragmentos. Para obter mais informações sobre fragmentos, consulte o guia do desenvolvedor de Fragmentos. Para obter informações detalhadas sobre as v13 Support Library APIs, consulte o pacote android.support.v13 na referência da API.

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

com.android.support:support-v13:24.2.0

v14 Preference Support Library

O pacote android.support.v14.preference fornece APIs para adicionar compatibilidade com interfaces de preferência, como PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, além de classes como MultiSelectListPreference e PreferenceFragment. Para obter informações detalhadas sobre as v14 Preference Support Library APIs, consulte o pacote preference na referência da API.

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

com.android.support:preference-v14:24.2.0

v17 Preference Support Library for TV

O pacote android.support.v17.preference fornece APIs para fornecer interfaces de preferência em dispositivos de TV, inclusive a compatibilidade com a interface LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener e classes, como BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Para obter informações detalhadas sobre as v17 Preference Support Library APIs, consulte o pacote preference na referência da API.

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

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

v17 Leanback Library

O pacote android.support.v17.leanback fornece APIs para dar suporte à criação de interfaces de usuário em dispositivos de TV. Ele fornece vários widgets importantes para aplicativos de TV. Algumas das classes notáveis:

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

com.android.support:leanback-v17:24.2.0

Annotations Support Library

O pacote Annotation fornece APIs para dar suporte à adição de metadados de anotação aos seus aplicativos.

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

com.android.support:support-annotations:24.2.0

Design Support Library

O pacote Design fornece APIs para compatibilidade com a adição de componentes e padrões do Material Design aos seus aplicativos.

A Design Support Library adiciona suporte para vários componentes e padrões do material design para uso pelos desenvolvedores de aplicativos, como gavetas de navegação, botões de ação flutuantes (FAB), barrinhas e guias.

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

com.android.support:design:24.2.0

Custom Tabs Support Library

O pacote Custom Tabs fornece APIs para dar suporte à adição e ao gerenciamento de guias personalizadas em seus aplicativos.

A Custom Tabs Support Library adiciona compatibilidade com várias classes, como Custom Tabs Service e Custom Tabs Callback.

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

com.android.support:customtabs:24.2.0

Percent Support Library

O pacote Percent fornece APIs para compatibilidade com a adição e o gerenciamento de dimensões com base em porcentagem em seu aplicativo.

A Percent Support Library adiciona suporte para a interface PercentLayoutHelper.PercentLayoutParams e várias classes, como PercentFrameLayout e PercentRelativeLayout.

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

com.android.support:percent:24.2.0

App Recommendation Support Library for TV

O pacote App Recommendation fornece APIs para compatibilidade com a adição de recomendações de conteúdo em seu aplicativo em execução em dispositivos de TV.

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

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

com.android.support:recommendation:24.2.0