SDK Google Mobile Ads Lite

A partire da gennaio 2026, l'SDK Google Mobile Ads Lite è ritirato. Per un'assistenza continua, esegui la migrazione a GMA Next-Gen SDK. GMA Next-Gen SDK ha dimensioni inferiori sul dispositivo rispetto alla versione completa di Google Mobile Ads SDK (Legacy). Per maggiori dettagli, consulta Scopri i vantaggi di GMA Next-Gen SDK.

Come qualsiasi libreria Android, l'SDK Google Play Services aumenta le dimensioni delle app che lo includono. L'SDK Google Mobile Ads Lite è una versione leggera di Google Mobile Ads SDK (Legacy) creata per ridurre questo impatto. È una frazione delle dimensioni dell'SDK normale.

Oltre alle dimensioni ridotte, l'utilizzo dell'SDK Lite riduce il numero totale di metodi a cui viene fatto riferimento in un'app. Ciò è particolarmente utile quando si esegue il deployment su versioni precedenti di Android, in cui gli sviluppatori possono imbattersi nel limite di riferimento di 64.000.

Ecco come configurare Gradle per incorporare l'SDK Lite nella tua app:

dependencies {
    implementation 'com.google.android.gms:play-services-ads-lite:25.0.0'
}

Limitazioni dell'SDK Lite

L'SDK Lite deve essere utilizzato solo nelle app distribuite tramite il Google Play Store.

A differenza di altri Google Play Services, l'implementazione standard di Google Mobile Ads SDK (Legacy) nell'APK di Google Play Services è inclusa anche nella libreria client di Google Play Services. In questo modo, è possibile supportare i dispositivi senza l'APK di Google Play Services. In fase di runtime, l'SDK confronterà le versioni della libreria client e dell'APK di Google Play Services e utilizzerà la versione più recente.

L'SDK Lite rimuove l'implementazione di Google Mobile Ads SDK (Legacy) dalla libreria client, lasciando solo un'interfaccia per l'APK di Google Play Services. L'SDK Lite si basa sull'implementazione dell'APK. Se esegui il deployment della tua app al di fuori del Google Play Store, non è garantito che sui dispositivi degli utenti sia installato l'APK di Google Play Services.

Sui dispositivi con una versione aggiornata di Google Play Services, il comportamento dell'SDK Lite è identico a quello dell'SDK standard. Tuttavia, sui dispositivi in cui Google Play Services non è aggiornato o non è presente, l'SDK Lite potrebbe fare riferimento ad API non disponibili o modificate rispetto a quelle presenti nell'APK di Google Play Services. In questo modo, verrà registrata un'operazione senza effetto e un errore, il che potrebbe impedire la pubblicazione degli annunci su questi dispositivi.

Cadenza di rilascio dell'SDK Lite

A partire dalla versione 24.1.0, l'artefatto play-services-ads-lite non viene più rilasciato con la stessa cadenza di play-services-ads. Questa modifica consente un'implementazione dell'SDK più graduale e stabile. L'SDK Lite viene rilasciato circa ogni tre release dell'SDK.

I progetti che dipendono sia dalla versione 24.0.0 o precedente di play-services-ads-lite sia dalla versione 24.1.0 o successiva di play-services-ads riscontrano un errore Duplicate class durante la compilazione dell'app. Risolvi questo errore utilizzando solo uno degli artefatti play-services-ads o play-services-ads-lite.