W tym przewodniku znajdziesz szczegółowe instrukcje integracji pakietu SDK Engage z aplikacją.
Udostępnione zasoby
Aby ułatwić Ci integrację, udostępniamy te materiały:
Aplikacja weryfikacyjna
Aplikacja weryfikacyjna używana do weryfikacji publikowania treści w interfejsie.
Wskazówki dotyczące publikowania treści
Dokumentacja zawierająca wskazówki dotyczące skutecznego publikowania treści za pomocą interfejsów API.
Krok 1. Tworzenie w trybie debugowania pakietu SDK
Dodaj pakiet SDK Engage do pliku build.gradle i postępuj zgodnie z odpowiednim przewodnikiem integracji dla danej branży, aby dokończyć integrację.
dependencies {
// Make sure you also include the repository in your project's
// build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.7'
}
Krok 2. Zainstalowanie aplikacji weryfikacyjnej
Aplikacja weryfikacyjna to aplikacja na Androida, której możesz używać do sprawdzania, czy integracja działa. Aplikacja zawiera funkcje, które pomagają programistom weryfikować dane i nadawać intencje.
Krok 3. Sprawdzenie, czy dane są widoczne w aplikacji weryfikacyjnej
Aplikacja weryfikacyjna powinna wyświetlać każdy klaster w osobnym wierszu.
- Wpisz nazwę pakietu dewelopera, który publikuje dane.
- Sprawdź, czy wszystkie encje w klastrze są opublikowane.
- Sprawdź, czy wszystkie pola w encji są opublikowane. W przypadku każdego elementu w wierszu możesz kliknąć obraz plakatu, aby sprawdzić intencję.
- Sprawdź podsumowania na poziomie aplikacji, klastra i elementu, które wskazują liczbę błędów weryfikacji. Sprawdź komunikaty o błędach weryfikacji, które pojawiają się na czerwono pod każdym odpowiednim polem. Błędy weryfikacji występują, gdy brakuje wymaganych pól lub mają one nieprawidłowe wartości.
- Sprawdź, czy wszystkie błędy weryfikacji zostały usunięte. Stan próbki:
Krok 4. Weryfikacja przepływu intencji transmisji
Aby zweryfikować intencję transmisji, kliknij przycisk u góry interfejsu, aby wywołać logikę wysyłania transmisji.
Po wykonaniu kroków 1–4 testowanie integracji po Twojej stronie zostanie zakończone.
Krok 5. Samodzielne potwierdzenie zgodności integracji
Przed rozpoczęciem sprawdzania musisz przejść samodzielną certyfikację. Jest to kluczowy krok, który pozwala sprawdzić, czy integracja jest gotowa, i ułatwia proces weryfikacji.
Wpisz nazwę pakietu i kliknij przycisk „Rozpocznij samodzielną certyfikację” na stronie głównej aplikacji weryfikacyjnej.
Rysunek 7. Rozpoczynanie samodzielnej certyfikacji Na następnej stronie wybierz branżę z listy. Wyświetli się lista testów w danej branży:
Użyj aplikacji Verify, aby przetestować integrację w każdym przypadku testowym wyświetlanym w tej aplikacji.
- Pasek postępu wskazuje liczbę przeprowadzonych do tej pory testów.
- Kliknij przycisk Wyświetl szczegóły, aby zobaczyć czynności, które należy wykonać w ramach testu, oraz oczekiwane działanie i wymagane weryfikacje ręczne.
- W środkowej części strony samodzielnej certyfikacji wyświetlają się opublikowane klastry.
- Aby zapisać wynik testu, kliknij przycisk Zapisz wynik testu. Jeśli oznaczysz test jako nieudany lub pominięty, podaj uzasadnienie.
- Aby przejść do poprzedniego lub następnego testu, użyj przycisków Wstecz i Dalej.
- Aby zakończyć testowanie, w dowolnym momencie kliknij przycisk Zakończ testowanie lub zamknij aplikację Weryfikacja. Bieżąca sesja testowa jest zapisywana automatycznie i można ją w każdej chwili wznowić lub ponownie uruchomić (nawet jeśli aplikacja Verify jest zamknięta lub urządzenie zostało ponownie uruchomione). Jeśli na początku samodzielnej certyfikacji wpiszesz tę samą nazwę pakietu i wybierzesz tę samą branżę, aplikacja Weryfikacja wyświetli prośbę o potwierdzenie, czy chcesz kontynuować bieżącą sesję testową.
- Kliknij przycisk Pobierz sesję, aby pobrać bieżącą sesję testową jako plik CSV. Ten plik CSV można udostępniać, a sesję można wczytać do aplikacji Weryfikacja, klikając przycisk „Wczytaj udostępnioną sesję” na stronie głównej aplikacji Weryfikacja. Pamiętaj, że w pobranej sesji zapisywane są tylko przypadki testowe i wyniki testów.
Po zakończeniu testowania kliknij przycisk Zakończ testowanie, aby wygenerować podsumowanie testu samodzielnej certyfikacji, które można pobrać.
Po wykonaniu kroków 1–5 testowanie integracji zostanie zakończone.
Krok 6. Ponowne sprawdzenie: przejście na produkcyjną wersję pakietu SDK
Po zakończeniu debugowania musisz zaktualizować metadane w pliku manifestu:
<application>
...
<meta-data
android:name="com.google.android.engage.service.ENV"
android:value="PRODUCTION"></meta-data>
</application>
Krok 7. Przesłanie do Google pliku APK gotowego do opublikowania
Wyślij kopię pliku APK gotowego do opublikowania jako załącznik e-maila na adres engage-developers@google.com. Dołącz też wygenerowane przez aplikację Verify podsumowanie samodzielnej certyfikacji. Google sprawdzi, czy integracja działa zgodnie z założeniami. Gdy Google zweryfikuje integrację, możesz przesłać aplikację do wersji produkcyjnej, aby ją opublikować.
Krok 8. Opublikowanie pliku APK w Sklepie Play
Po uzyskaniu zatwierdzeń opublikuj plik APK w Sklepie Play. Po opublikowaniu pliku APK wyślij e-maila na adres engage-developers@google.com z numerem opublikowanej wersji. Google odpowie, podając kolejne kroki.
Pobierz
Przed pobraniem musisz zaakceptować poniższe warunki.