يوضّح هذا الدليل كيفية دمج المراجعات داخل التطبيق باستخدام إما Kotlin أو Java. تتوفّر أدلة دمج منفصلة إذا كنت تستخدم رمزًا برمجيًا أصليًا أو Unity.
إعداد بيئة التطوير
تشكّل "مكتبة المراجعات داخل التطبيقات" في Play جزءًا من مكتبات Google Play الأساسية. يُرجى تضمين التبعية التالية لـ Gradle لدمج مكتبة "مراجعات التطبيقات داخل Play".
رائع
// 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
لإنشاء مهمة طلب. في حال نجاح العملية، تعرض واجهة برمجة التطبيقات العنصر
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. });
الخطوات التالية
اختبِر مسار المراجعة داخل تطبيقك للتأكّد من أنّ عملية الدمج تعمل بشكلٍ صحيح.