במדריך הזה מוסבר איך לשלב ביקורות מתוך האפליקציה באפליקציה שלכם באמצעות Kotlin או Java. אם משתמשים בקוד נייטיב או ב-Unity, יש מדריכי שילוב נפרדים.
הגדרת סביבת הפיתוח
ספריית הביקורות בתוך האפליקציה של Play היא חלק מספריות הליבה של Google Play. כדי לשלב את ספריית Play In-App Review, צריך לכלול את יחסי התלות הבאים ב-Gradle.
מגניב
// 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.2' // For Kotlin users also add the Kotlin extensions library for Play In-App Review: implementation 'com.google.android.play:review-ktx:2.0.2' ... }
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.2") // For Kotlin users also import the Kotlin extensions library for Play In-App Review: implementation("com.google.android.play:review-ktx:2.0.2") ... }
יצירת ReviewManager
ReviewManager
הוא הממשק שמאפשר לאפליקציה להתחיל תהליך בדיקה בתוך האפליקציה. כדי לקבל אותו, יוצרים מכונה באמצעות ReviewManagerFactory
.
Kotlin
val manager = ReviewManagerFactory.create(context)
Java
ReviewManager manager = ReviewManagerFactory.create(context)
שליחת בקשה לאובייקט ReviewInfo
כדי לזהות נקודות טובות בתהליך שעובר המשתמש באפליקציה, צריך לפעול לפי מתי כדאי לשלוח בקשה לבדיקה בתוך האפליקציה, כדי לבקש בדיקה למשתמש (למשל, כשהמשתמש משלים שלב במשחק). כשהאפליקציה מגיעה לאחד מהשלבים האלה, צריך להשתמש במכונה ReviewManager
כדי ליצור משימה של בקשה. אם הפעולה תצליח, ה-API יחזיר את האובייקט ReviewInfo
שנחוץ כדי להתחיל את תהליך הבדיקה באפליקציה.
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(); } });
הפעלת תהליך הבדיקה באפליקציה
משתמשים במכונה ReviewInfo
כדי להפעיל את תהליך הבדיקה בתוך האפליקציה. ממתינים עד שהמשתמש ישלים את תהליך הבדיקה בתוך האפליקציה לפני שהאפליקציה תמשיך לפעול כרגיל (למשל, להתקדם לרמה הבאה).
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. });
השלבים הבאים
בודקים את תהליך הבדיקה באפליקציה כדי לוודא שהשילוב פועל כמו שצריך.