Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji za pomocą języka Kotlin lub Javy. W przypadku korzystania z kodu natywnego lub Unity dostępne są osobne przewodniki po integracji.
Konfigurowanie środowiska programistycznego
Biblioteka opinii w aplikacji Google Play jest częścią podstawowych bibliotek Google Play. Uwzględnij tę zależność Gradle, aby zintegrować bibliotekę opinii z Google Play w aplikacji.
Odlotowe
// In your app’s build.gradle file: ... dependencies { // This dependency is downloaded from the Google’s Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation 'com.google.android.play:review:2.0.1' // For Kotlin users also add the Kotlin extensions library for Play In-App Review: implementation 'com.google.android.play:review-ktx:2.0.1' ... }
Kotlin
// In your app’s build.gradle.kts file: ... dependencies { // This dependency is downloaded from the Google’s Maven repository. // So, make sure you also include that repository in your project's build.gradle file. implementation("com.google.android.play:review:2.0.1") // For Kotlin users also import the Kotlin extensions library for Play In-App Review: implementation("com.google.android.play:review-ktx:2.0.1") ... }
Tworzenie menedżera opinii
ReviewManager
to interfejs, który pozwala rozpocząć proces sprawdzania aplikacji. Aby go uzyskać, utwórz instancję za pomocą interfejsu ReviewManagerFactory
.
Kotlin
val manager = ReviewManagerFactory.create(context)
Java
ReviewManager manager = ReviewManagerFactory.create(context)
Poproś o obiekt ReviewInfo
Postępuj zgodnie ze wskazówkami dotyczącymi tego, kiedy poprosić o sprawdzenie aplikacji, aby określić, w których momentach w aplikacji użytkownik powinien poprosić o sprawdzenie aplikacji (np. gdy ukończy poziom w grze). Gdy aplikacja dotrze do jednego z tych punktów, użyj instancji ReviewManager
, aby utworzyć zadanie żądania. Jeśli operacja się uda, interfejs API zwróci obiekt ReviewInfo
potrzebny do rozpoczęcia procesu sprawdzania aplikacji.
Kotlin
val request = manager.requestReviewFlow() request.addOnCompleteListener { task -> if (task.isSuccessful) { // We got the ReviewInfo object val reviewInfo = task.result } else { // There was some problem, log or handle the error code. @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode } }
Java
ReviewManager manager = ReviewManagerFactory.create(this); Task<ReviewInfo> request = manager.requestReviewFlow(); request.addOnCompleteListener(task -> { if (task.isSuccessful()) { // We can get the ReviewInfo object ReviewInfo reviewInfo = task.getResult(); } else { // There was some problem, log or handle the error code. @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode(); } });
Uruchom proces sprawdzania aplikacji
Aby uruchomić proces sprawdzania w aplikacji, użyj instancji ReviewInfo
. Poczekaj, aż użytkownik zakończy proces sprawdzania aplikacji, zanim będzie można dalej z niej korzystać (np. przejść na wyższy poziom).
Kotlin
val flow = manager.launchReviewFlow(activity, reviewInfo) flow.addOnCompleteListener { _ -> // The flow has finished. The API does not indicate whether the user // reviewed or not, or even whether the review dialog was shown. Thus, no // matter the result, we continue our app flow. }
Java
Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo); flow.addOnCompleteListener(task -> { // The flow has finished. The API does not indicate whether the user // reviewed or not, or even whether the review dialog was shown. Thus, no // matter the result, we continue our app flow. });
Dalsze kroki
Przetestuj proces sprawdzania aplikacji w aplikacji, aby sprawdzić, czy integracja działa prawidłowo.