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
da biblioteca Jetpack oferece paridade com a Biblioteca de Suporte 28.0.0 e oferece uma
ponto de partida para migrar para o novo androidx
na embalagem.
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 vai exigir a migração de android.support
para androidx
.
Recomendamos usar as bibliotecas androidx
em todos os novos projetos. Você também deve
considere migrar os projetos atuais para garantir que eles
continuam a receber correções de bugs e outras melhorias na 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 oferece suporte a uma variedade específica de bibliotecas de várias versões 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 para concluir essa etapa. Você deve tomar medidas adicionais para incluir uma Biblioteca de Suporte específica em seu aplicativo. Consulte o final de cada seção da biblioteca abaixo para conferir informações importantes sobre como incluem a biblioteca no seu aplicativo.
Observação:a versão mínima do SDK para todo o suporte os pacotes de biblioteca são pelo menos o nível 14 da API. Alguns pacotes exigem uma API mais recente de serviço, conforme observado abaixo.
Bibliotecas de Suporte v4
Essas bibliotecas incluem o maior conjunto de APIs em comparação a outras bibliotecas, incluindo suporte para componentes de aplicativo, recursos de interface do usuário, acessibilidade, gerenciamento de dados, conectividade de rede e programação de serviços públicos.
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
e melhorar a eficiência. Para compatibilidade com versões anteriores, se você listar
support-v4
no script do Gradle, o app 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 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
Fornece 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 vários componentes relacionados à interface, 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
Faz backport de 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 seu aplicativo de forma independente uns dos outros.
Biblioteca v7 appcompatibilidade 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 Usuário da barra de ações design da interface padrão. 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 da barra de ações. padrão da interface do usuário. Para mais informações sobre como usar a barra de ações, consulte a Guia do desenvolvedor da barra de ações.AppCompatActivity
: adiciona uma classe de atividade de aplicativo que pode ser usada como classe de base para atividades que usam a barra de ações da Biblioteca de Suporte. implementação.AppCompatDialog
: adiciona uma classe de caixa de diálogo que pode ser usada como base. classe para caixas de diálogo com temas do AppCompat.ShareActionProvider
: adiciona suporte a um modelo ações de compartilhamento (como e-mail ou postagem em aplicativos sociais) que podem ser incluídas em um 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 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 baixar as Bibliotecas de Suporte do Android, essa biblioteca adiciona suporte para o
a 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.
Em geral, as APIs na biblioteca mediarouter v7 oferecem um meio de
controlando o roteamento de canais de mídia e streams 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 sujeitos a alterações 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 fornece suporte para
RecyclerView (em inglês)
uma visualização para exibir de forma eficiente grandes conjuntos de dados, fornecendo uma
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
A
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 seu aplicativo de forma independente de outras bibliotecas.
Biblioteca renderscript v8
Essa biblioteca adiciona suporte a
a computação do RenderScript
de análise de dados em nuvem. 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 como usar essas APIs
no seu aplicativo, consulte a
RenderScript
guia para desenvolvedores.
Observação:o uso do RenderScript com a Biblioteca de Suporte é compatível com o Android.
Versões baseadas no Studio e no Gradle. A
renderscript está 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 a
Fragmentos. Para obter
mais informações 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 obter
informações sobre as APIs da Biblioteca de Suporte de Preferências v14, consulte a
preferência
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 dar preferência
em dispositivos de TV, incluindo suporte para o
LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener
interface 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:
BrowseFragment
: um fragmento para criar um layout principal para navegar por categorias e linhas de mídia itens.DetailsFragment
: um wrapper para telas de detalhes do YouTube TV.PlaybackOverlayFragment
– 1 subclasse deDetailsFragment
para exibindo controles de mídia e conteúdos relacionados.SearchFragment
: um fragmento para lidar com pesquisas. O fragmento recebe a solicitação de pesquisa do usuário e transmite para oSearchResultProvider
fornecido pelo aplicativo. OSearchResultProvider
retorna os resultados da pesquisa paraSearchFragment
, que os renderiza em umRowsFragment
.
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: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 é da seguinte forma:
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 é da seguinte forma:
com.android.support:animated-vector-drawable:28.0.0
Biblioteca de Suporte a Anotações (Annotations Support Library)
A Anotação oferece APIs para oferecer suporte à 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)
A pacote Design fornece APIs para dar suporte à adição de componentes e padrões do Material Design aos seus aplicativos.
A Biblioteca de Suporte de Design adiciona suporte a vários componentes e padrões do Material Design para desenvolvedores de apps a serem usados como base, como gavetas de navegação e botões de ação flutuantes (FAB, link 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)
A Guias personalizadas fornece APIs para dar suporte à adição e ao gerenciamento de guias personalizadas em seus aplicativos.
A Biblioteca de Suporte de Guias Personalizadas adiciona suporte para várias classes, como Guias personalizadas Serviço e Guias personalizadas Chamada de retorno.
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)
A Percentual oferece APIs para adicionar e gerenciar a adição e o gerenciamento dimensões no seu app.
Observação: a partir da versão 26.0.0, o uso Biblioteca de Suporte Percentual será suspenso.
Os clientes deste módulo precisam migrar para o novo ConstraintLayout
fornecido como um artefato separado no SDK Manager.
A Percent Support Library adiciona suporte para o Interface PercentLayoutHelper.PercentLayoutParams e várias classes, como PercentFrameLayout (em inglês) e PercentParentLayout da tabela.
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)
A 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