Plug-in do Android para Gradle 8.1.0 (julho de 2023)

O Plug-in do Android para Gradle 8.1.0 é uma versão principal que inclui vários novos recursos e melhorias.

Compatibilidade

A DSL do Kotlin é o padrão para configuração do build

Novos projetos agora usam a DSL do Kotlin (build.gradle.kts) por padrão para configuração do build. Isso oferece uma experiência de edição melhor do que a DSL do Groovy (build.gradle), com destaque de sintaxe, preenchimento de código e navegação para declarações. Se você estiver usando o AGP 8.1 e a DSL do Kotlin para configuração do build, use o Gradle 8.1 para ter a melhor experiência. Para saber mais, consulte o guia de migração de DSL do Kotlin.

Suporte automático ao idioma por app

No Android Studio Giraffe Canary 7 e no AGP 8.1.0-alpha07 e versões mais recentes, é possível configurar seu app para oferecer suporte a seleção de idioma por app automaticamente. Com base nos recursos do projeto, o Plug-in do Android para Gradle gera o arquivo LocaleConfig e adiciona uma referência a ele no arquivo de manifesto final. Assim, não é mais necessário fazer isso manualmente. O AGP usa os recursos nas pastas res dos módulos do app e qualquer dependência de módulos de biblioteca para determinar as localidades que serão incluídas no arquivo LocaleConfig.

O recurso automático de idioma por app tem suporte de apps com o Android 13 (nível 33 da API) ou mais recente. Para usar o recurso, defina compileSdkVersion como 33 ou maior. Para configurar a seleção de idioma por app em versões anteriores do Android, ainda é necessário usar as APIs e os seletores de idioma no app.

Para ativar o suporte automático ao idioma por app, especifique uma localidade padrão:

1. Na pasta res do módulo do app, crie um novo arquivo chamado resources.properties.

2. No arquivo resources.properties, defina a localidade padrão com o rótulo unqualifiedResLocale. Para formar os nomes de localidade, combine o código do idioma com o script opcional e os códigos de região, separando cada um com um traço:

   • Idioma: use o código ISO 639-1 de duas ou três letras.
   • Script (opcional): use o código ISO 15924 (link em inglês).
   • Região (opcional): use o código ISO 3166-1-alpha-2 de duas letras ou o código UN_M.49 (link em inglês) de três dígitos.

   Por exemplo, se a localidade padrão for inglês dos EUA:

       unqualifiedResLocale=en-US
       

O AGP adiciona a localidade padrão e qualquer outra localidade alternativa que você tenha especificado (usando diretórios values-* na pasta res) ao arquivo LocaleConfig gerado automaticamente.

O suporte automático ao idioma por app fica desativado por padrão. Para ativar o recurso, use a configuração generateLocaleConfig no bloco androidResources {} do arquivo build.gradle.kts do módulo (arquivo build.gradle, se você estiver usando Groovy):

android {
  androidResources {
    generateLocaleConfig = true
  }
}

android {
  androidResources {
    generateLocaleConfig true
  }
}

O Android Lint contém bytecode direcionado à JVM 17

A partir do AGP 8.1.0-alpha04, o Android Lint contém bytecode direcionado à JVM 17. Se você escrever verificações de lint personalizadas, precisará compilar com o JDK 17 ou versão mais recente e especificar jvmTarget = '17' nas opções do compilador Kotlin.

Para saber mais sobre a ferramenta lint, consulte Melhorar seu código com verificações de lint.

A configuração de compactação da biblioteca nativa foi movida para DSL

A partir do AGP 8.1.0-alpha10, você vai receber um aviso se não configurar a compactação da biblioteca nativa usando a DSL em vez do manifesto. A orientação a seguir explica como atualizar sua configuração para usar a DSL. Para receber ajuda com essas atualizações, use o Assistente de upgrade do AGP (Tools > AGP Upgrade Assistant).

Para usar bibliotecas nativas descompactadas, remova o atributo android::extractNativeLibs do manifesto e adicione o seguinte código ao arquivo build.gradle.kts no módulo (arquivo build.gradle, se você estiver usando o Groovy):

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging = false
    }
  }
}

android {
  packagingOptions {
    jniLibs {
      useLegacyPackaging false
    }
  }
}

Sinalizações de build experimentais

Estas são flags experimentais para configurar seu build disponível no AGP 8.1.