Ten przewodnik jest przeznaczony dla wydawców integrujących w swoich aplikacjach na Androida kompilację w ramach wcześniejszego dostępu do pakietu SDK do reklam mobilnych Google na Androida. Takie kompilacje umożliwiają korzystanie z nowych funkcji pakietu SDK do reklam mobilnych Google bez konieczności czekania na następną wersję Usług Google Play oraz zapewniają te korzyści:
Zaczynają automatycznie korzystać z nowszej implementacji pakietu SDK do reklam mobilnych Google z pakietu APK Usług Google Play, gdy tylko w pakiecie APK pojawi się funkcja wcześniejszego dostępu.
Są one w pełni przetestowane i spełniają te same kryteria wydania co kompilacje publiczne dostępne w repozytorium Google Maven lub w SDK Manager.
Są to pełne wersje pakietu SDK do reklam mobilnych Google, które są większe niż pakiet SDK Lite, ale nie podlegają ograniczeniom pakietu SDK Lite.
Można ich używać na całym świecie, a nie tylko w aplikacjach rozpowszechnianych w Google Play.
Wykonaj czynności opisane na tej stronie, aby skonfigurować lokalne repozytorium Maven z pakietem SDK do reklam mobilnych Google z wcześniejszym dostępem i wskazać je jako zależność w aplikacji na Androida.
Wymagania wstępne
- Korzystanie z Androida Studio w wersji 3.0 lub nowszej
- Docelowy poziom interfejsu API Androida na poziomie 16 lub wyższym
- Plik ZIP z pakietem SDK do reklam mobilnych Google z wcześniejszym dostępem udostępniony przez menedżera konta
Skonfiguruj niestandardowe repozytorium Maven
Pobierz plik ZIP pakietu SDK do reklam mobilnych Google z wcześniejszym dostępem. Utwórz folder gma_sdk_repo w katalogu głównym projektu i umieść w nim całą zawartość pliku ZIP. Struktura katalogów powinna wyglądać mniej więcej tak: <project_root_dir>/gma_sdk_repo/com/google/....
Otwórz plik build.gradle na poziomie projektu aplikacji.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
Dodaj pogrubioną linię do sekcji allprojects/repositories. Powoduje to, że podczas rozwiązywania problemów z zależnościami Gradle szuka repozytorium Maven w utworzonym właśnie folderze gma_sdk_repo.
Dodaj zależność kompilacji
Aby korzystać w projekcie z kompilacji pakietu SDK do reklam mobilnych Google z wcześniejszym dostępem, musisz też określić ją jako zależność w pliku build.gradle na poziomie aplikacji. Otwórz plik build.gradle na poziomie aplikacji i dodaj pogrubiony wiersz we fragmencie kodu do sekcji dependencies.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
Wersję zależności (wyświetlaną przez funkcję x.y.z w poprzednim fragmencie kodu) można sprawdzić, znajdując najnowszą wersję znajdującą się w katalogu com/google/android/gms/play-services-ads/ w niezarchiwizowanej zawartości pliku ZIP pakietu SDK do reklam mobilnych Google na Androida z wcześniejszym dostępem.
Rozwiązywanie konfliktów Firebase
Jeśli używasz biblioteki Firebase razem z pakietem SDK do reklam mobilnych, możesz uwzględnić w projekcie zarówno zależności com.google.android.gms:play-services-measurement-api, jak i com.google.android.gms:play-services-measurement-sdk-api. Wersje tych 2 zależności muszą być takie same, ale może się okazać, że kompilacja wcześniejszego dostępu do pakietu SDK do reklam mobilnych oraz obecna wersja Firebase zostały pobrane w różnych wersjach związanych z tymi 2 zależnościami.
Aby obejść problem, możesz wymusić rozwiązanie zależności od konkretnej wersji biblioteki play-services-measurement-sdk-api w pliku build.gradle aplikacji w ten sposób:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
Wersja x.y.z zależy od wersji Firebase. Oto prawidłowe wersje najnowszych wersji Firebase:
Wersja firebase-core
|
Wersja play-services-measurement-sdk-api
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
Aby znaleźć prawidłową wersję dla innych wersji Firebase, uruchom gradle androidDependencies dla swojej aplikacji i użyj wersji wydrukowanej dla zależności com.google.android.gms:play-services-measurement-api.
Możesz już używać swojej aplikacji na Androida z pakietem SDK do reklam mobilnych Google na Androida w ramach wcześniejszego dostępu.