Para adotar melhorias de latência e estabilidade do Android, use o GMA Next-Gen SDK. Este guia aborda a configuração do Google Mobile Ads Flutter Plugin para usar o GMA Next-Gen SDK no Android.
Pré-requisitos
Antes de continuar, faça o seguinte:
- Instale a versão 9.0.0 ou mais recente do Google Mobile Ads Flutter Plugin.
- Configure o Google Mobile Ads Flutter Plugin.
- Inicie um projeto do Flutter.
Definir as configurações do Android para Gradle
Para usar o GMA Next-Gen SDK no Android, atualize as configurações do Gradle:
- Defina os níveis mínimo e de compilação da API Android.
- Se você usa a mediação, siga as etapas de migração para
excluir módulos
com.google.android.gmse evitar erros de classe duplicada.
Executar com declaração de ambiente
Para usar GMA Next-Gen SDK ao criar e executar o app Android,
forneça a declaração de ambiente USE_NEXT_GEN_SDK definida como o
valor true.
Sempre que você criar ou executar o app, execute o seguinte:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Executar com a configuração do ambiente de desenvolvimento integrado
Se você executar o app usando um ambiente de desenvolvimento integrado (IDE), poderá configurar as declarações de ambiente na configuração de inicialização em vez de transmitir a flag usando a linha de comando.
Por exemplo, é possível definir essas variáveis em um arquivo JSON e adicioná-las à configuração do ambiente de desenvolvimento integrado. Para mais detalhes, consulte Como especificar declarações de ambiente.
Atualizar modelos de anúncios nativos
Se você usa modelos de anúncios nativos, faça as seguintes atualizações para oferecer suporte a GMA Next-Gen SDK:
Atualizar a importação do pacote NativeAdFactory
No Android, atualize a instrução de importação da classe NativeAdFactory:
Java
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;
Kotlin
// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory
// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory
Atualizar as visualizações XML de layout de visualização de anúncios nativos
Nos arquivos XML de layout dos seus anúncios nativos, atualize a classe de visualização de anúncios nativos:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Configurar dependências para as duas configurações
Se o projeto precisar ser compatível com Google Mobile Ads SDK (Legacy) e
GMA Next-Gen SDK, configure o arquivo android/app/build.gradle
para definir dependências condicionalmente com base na declaração de ambiente.
O Google Mobile Ads Flutter Plugin fornece uma configuração de amostra no
arquivo build.gradle do app de exemplo.