Pakiet SDK do reklam mobilnych Google Lite

Od stycznia 2026 r. pakiet Lite SDK do reklam mobilnych Google jest wycofany. Aby nadal korzystać z pomocy, przejdź na GMA Next-Gen SDK. GMA Next-Gen SDK zajmuje na urządzeniu mniej miejsca niż pełna wersja Google Mobile Ads SDK (Legacy). Więcej informacji znajdziesz w artykule Korzyści z GMA Next-Gen SDK.

Podobnie jak każda biblioteka Androida, pakiet SDK usług Google Play zwiększa rozmiar aplikacji, które go zawierają. Pakiet Lite SDK do reklam mobilnych Google to uproszczona wersja Google Mobile Ads SDK (Legacy), która została opracowana z myślą o zmniejszeniu tego wpływu. Jest on znacznie mniejszy niż zwykły pakiet SDK.

Oprócz mniejszego rozmiaru korzystanie z pakietu Lite SDK zmniejsza łączną liczbę metod, do których odwołuje się aplikacja. Jest to szczególnie przydatne w przypadku wdrażania w starszych wersjach Androida, gdzie deweloperzy mogą napotkać limit 64 tys. odwołań.

Oto jak skonfigurować Gradle tak, aby uwzględniał pakiet SDK w wersji Lite w aplikacji:

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

Ograniczenia pakietu SDK Lite

Pakietu SDK Lite należy używać tylko w aplikacjach rozpowszechnianych w Sklepie Google Play.

W odróżnieniu od innych usług Google Play standardowa implementacja Google Mobile Ads SDK (Legacy) w pakiecie APK usług Google Play jest też uwzględniona w bibliotece klienta usług Google Play. Dzięki temu można go używać na urządzeniach bez pliku APK usług Google Play. W czasie działania pakiet SDK porówna wersje biblioteki klienta i pliku APK usług Google Play i użyje nowszej wersji.

Pakiet SDK w wersji Lite usuwa implementację Google Mobile Ads SDK (Legacy) z biblioteki klienta, pozostawiając tylko interfejs do pakietu APK usług Google Play. Pakiet SDK w wersji Lite opiera się na implementacji pakietu APK. Jeśli wdrażasz aplikację poza Sklepem Google Play, nie ma gwarancji, że na urządzeniach użytkowników będzie zainstalowany pakiet APK Usług Google Play.

Na urządzeniach z aktualną wersją usług Google Play pakiet SDK w wersji Lite działa tak samo jak standardowy pakiet SDK. Na urządzeniach, na których usługi Google Play są nieaktualne lub nie są dostępne, pakiet SDK w wersji Lite może odwoływać się do interfejsów API, które są niedostępne lub zostały zmienione w porównaniu z tymi w pliku APK usług Google Play. Spowoduje to brak działania i zarejestrowanie błędu, co może uniemożliwić wyświetlanie reklam na tych urządzeniach.

Częstotliwość publikowania wersji pakietu Lite SDK

Począwszy od wersji 24.1.0, artefakt play-services-ads-lite nie będzie już publikowany z tą samą częstotliwością co play-services-ads. Ta zmiana umożliwia bardziej stopniowe i stabilne wdrażanie implementacji pakietu SDK. Pakiet SDK Lite jest udostępniany mniej więcej co trzecią wersję pakietu SDK.

W projektach, które zależą zarówno od play-services-ads-lite w wersji 24.0.0 lub starszej, jak i od play-services-ads w wersji 24.1.0 lub nowszej, podczas kompilacji aplikacji występuje błąd Duplicate class. Aby rozwiązać ten błąd, użyj tylko jednego z artefaktów play-services-ads lub play-services-ads-lite.