Configuração da Biblioteca de Suporte

Observação: com o lançamento do Android 9.0 (API de nível 28), há uma nova versão da Biblioteca de Suporte denominada AndroidX, que faz parte do Jetpack. O 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 com versões 27 e anteriores, e empacotados como android.support.*, permanecerão disponíveis no Google Maven. 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 o AndroidX.

A forma como você configura as Bibliotecas de Suporte do Android no seu projeto de desenvolvimento depende de quais recursos que quer usar e a qual variedade de versões da plataforma Android você pretende oferecer suporte com o para o aplicativo.

Este documento orienta você no download do pacote Biblioteca de Suporte e na adição de bibliotecas ao seu ambiente de desenvolvimento.

As Bibliotecas de Suporte agora estão disponíveis no Maven do Google repositório de dados. Não é mais possível fazer o download de bibliotecas pelo SDK Manager, e essa funcionalidade será removida em breve.

Escolher Bibliotecas de Suporte

Antes de adicionar uma Biblioteca de Suporte ao aplicativo, decida quais recursos você quer incluir e as versões mais antigas do Android às quais você quer oferecer suporte. Para mais informações sobre os recursos, fornecidas pelas diferentes bibliotecas, consulte Recursos da Biblioteca de Suporte.

Adicionar Biblioteca de Suporte

Para usar uma Biblioteca de Suporte, é necessário modificar o arquivo dependências de caminho de classe no seu ambiente de desenvolvimento. Você deve executar este procedimento para cada Biblioteca de Suporte que você quer usar.

Para adicionar uma Biblioteca de Suporte ao projeto do aplicativo:

1. Inclua o repositório Maven do Google no arquivo settings.gradle.

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }
   

2. Para cada módulo em que você quer usar uma Biblioteca de Suporte, adicione a biblioteca no Bloco dependencies do arquivo build.gradle do módulo. Para exemplo, para adicionar a biblioteca v4 core-utils, adicione o seguinte:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }
   

Cuidado: o uso de dependências dinâmicas (por exemplo, palette-v7:23.0.+) podem causar atualizações inesperadas de versão e ou incompatibilidades de regressão. Recomendamos que você especifique explicitamente versão da biblioteca (por exemplo, palette-v7:28.0.0).

Usar APIs de Biblioteca de Suporte

As classes de Biblioteca de Suporte que fornecem suporte para as Framework APIs existentes normalmente têm a mesmo nome da classe de framework, mas estão localizados nos pacotes de classe android.support; ou têm um sufixo *Compat.

Observação:depois de incluir a Biblioteca de Suporte no projeto do seu app, nós é altamente recomendável reduzir, ofuscar e otimizar seu app para lançamento. Além de proteger seu código-fonte com ofuscação, a redução remove classes não usadas de todas as bibliotecas incluídas no aplicativo, mantendo a o menor tamanho possível de download do seu aplicativo.

Mais orientações para o uso de alguns recursos da Biblioteca de Suporte são fornecidas na documentação do desenvolvedor Android aulas de treinamento, guias e amostras. Para mais informações sobre as classes e os métodos individuais da Biblioteca de Suporte, consulte pacotes android.support na referência da API.

Mudanças na declaração do manifesto

Se você estiver aumentando a compatibilidade com versões anteriores de seu aplicativo atual para uma versão mais recente da API do Android com a Biblioteca de Suporte, não se esqueça de atualizar a versão manifesto do aplicativo. Mais especificamente, você precisa atualizar android:minSdkVersion. do elemento <uses-sdk> no manifesto para o novo número da versão anterior, conforme mostrados abaixo:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

A configuração do manifesto informa ao Google Play que seu aplicativo pode ser instalado em dispositivos com Android 4.0 (nível 14 da API) e versões mais recentes.

Caso você esteja usando arquivos de build do Gradle, a configuração minSdkVersion no arquivo de build modifica as configurações do manifesto.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

Nesse caso, a configuração do arquivo de build informa ao Google Play que a variante de build padrão do aplicativo pode ser instalado em dispositivos com Android 4.1 (API de nível 16) e superior. Para mais informações sobre variantes de build, consulte Visão geral do sistema de build.

Observação: se você estiver incluindo várias Bibliotecas de Suporte, os A versão mínima do SDK precisa ser a versão mais recente exigida por qualquer um dos as bibliotecas especificadas. Por exemplo, se o app incluir a Biblioteca de Suporte de preferências v14 e as A biblioteca do YouTube v17, a versão mínima A versão do SDK precisa ser 17 ou mais recente.