تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اتّبِع الخطوات الواردة في هذا الدليل لاختبار دمج المراجعات داخل التطبيق في
تطبيقك أو لعبتك.
الاختبار باستخدام "متجر Google Play"
تتطلّب المراجعات داخل التطبيق نشر تطبيقك في "متجر Play". ومع ذلك، يمكنك
اختبار الدمج بدون نشر تطبيقك في قناة الإصدار العلني باستخدام
مسارات الاختبار الداخلي أو مشاركة التطبيقات مع الفريق الداخلي. يتم وصف كلتا الطريقتين في هذا
.
الاختبار باستخدام مسار اختبار داخلي
حمِّل تطبيقك إلى مسار الاختبار الداخلي وثبِّته على جهاز يتضمّن
حساب مستخدم لديه إذن الوصول إلى مسار الاختبار الداخلي. عند استخدام وحدة تخزين داخلية
مسار الاختبار، يجب استيفاء الشروط التالية:
حساب المستخدم هو جزء من مسار الاختبار الداخلي.
حساب المستخدم هو الحساب الأساسي ويتم اختياره في "متجر Play".
نزَّل حساب المستخدم التطبيق من متجر Play (يتم تنزيل التطبيق
مدرجة في مكتبة Google Play للمستخدم).
لا يتضمّن حساب المستخدم حاليًا مراجعة للتطبيق.
بعد أن نزَّل الحساب على الجهاز التطبيق مرة واحدة على الأقل من
مسار الاختبار الداخلي وتعد جزءًا من قائمة المختبرين، يمكنك نشر تحديثات
إصدارات التطبيق محليًا على هذا الجهاز (على سبيل المثال، استخدام "استوديو Android").
الاختبار باستخدام ميزة "مشاركة التطبيقات مع الفريق الداخلي"
يمكنك بدلاً من ذلك استخدام ميزة مشاركة التطبيقات مع الفريق الداخلي للتكرار السريع.
لاختبار عملية الدمج تتيح لك هذه الطريقة اختبار التغييرات بسرعة عن طريق تخطي
بعض عمليات التحقّق التي تتم على مسارات الاختبار الأخرى.
الاختبار باستخدام FakeReviewManager
تحتوي عناصر المراجعة داخل التطبيق على آلية تنفيذ FakeReviewManager.
تزييف سلوك واجهة برمجة التطبيقات.
يجب استخدامه فقط لاختبارات الوحدة أو الدمج للتحقّق من السلوك.
التطبيق بمجرد اكتمال المراجعة. لاستخدام FakeReviewManager، استبدِل
المثيل ReviewManager مع مثيل FakeReviewManager، كما هو موضّح
في المثال التالي:
أثناء دمج المراجعات داخل التطبيق واختبارها، قد تواجه بعض المشاكل. تشير رسالة الأشكال البيانية
يوضّح الجدول التالي المشاكل الأكثر شيوعًا التي يمكن أن تمنع حدوث
ظهور مربّع حوار المراجعة في تطبيقك:
المشكلة
الحل
لم يتم نشر تطبيقك في "متجر Play" حتى الآن.
ليس من الضروري نشر تطبيقك لاختباره، ولكن يجب نشر
يجب أن يكون applicationID متاحًا للاستخدام الداخلي على الأقل.
مسار الاختبار.
لا يمكن لحساب المستخدم مراجعة التطبيق.
يجب أن يكون تطبيقك في مكتبة Google Play للمستخدم. لإضافة تطبيقك إلى
مكتبة المستخدم، يمكنك تنزيل تطبيقك من متجر Play باستخدام
حساب المستخدم.
لم يتم اختيار الحساب الأساسي في "متجر Play".
عند توفُّر حسابات متعددة في الجهاز، تأكَّد من
يكون الحساب الأساسي هو الحساب الذي يتم اختياره في "متجر Play".
حساب المستخدم محمي (على سبيل المثال، من خلال حساب Enterprise
الحسابات).
هناك مشكلة في "متجر Google Play" أو "خدمات Google Play" على
الجهاز.
يحدث هذا عادةً عند تثبيت "متجر Play" من مصدر غير معروف على الجهاز.
يجب استخدام جهاز آخر يحتوي على إصدار صالح من "متجر Play"
خدمات Google Play.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Test in-app reviews\n\nFollow the steps in this guide to test your integration of in-app reviews in\nyour app or game.\n\nTest using the Google Play Store\n--------------------------------\n\nIn-app reviews require your app to be published in Play Store. However, you can\ntest your integration without publishing your app to production using either\ninternal test tracks or internal app sharing. Both methods are described in this\nsection.\n\n### Test using an internal test track\n\nUpload your app to the internal test track and install it on a device with a\nuser account that has access to the internal test track. When using an internal\ntest track, the following conditions must be met:\n\n1. The user account is part of the Internal Test Track.\n2. The user account is the primary account and it's selected in the Play Store.\n3. The user account has downloaded the app from the Play Store (the app is listed in the user's Google Play library).\n4. The user account does not currently have a review for the app.\n\nAfter the account on the device has downloaded the app at least once from the\ninternal test track and is part of the testers list, you can deploy new\nversions of the app locally to that device (for example, using Android Studio).\n| **Note:** The quota limits are **not** enforced if the app is downloaded from the internal test track.\n\n### Test using internal app sharing\n\nAlternatively, for rapid iteration you can use [internal app sharing](https://play.google.com/console/internal-app-sharing/)\nto test your integration. This method lets you quickly test changes by skipping\nsome of the verification that happens with other test tracks.\n| **Important:** When using an app installed with internal app sharing, reviews **can't be submitted**. To emphasize this difference, the button is disabled in the UI.\n\nTest using FakeReviewManager\n----------------------------\n\nThe in-app review artifact contains a `FakeReviewManager` implementation that\nallows you to fake the behavior of the API.\n\nThis should only be used for unit or integration tests to verify the behaviour\nof the app once the review is completed. To use the `FakeReviewManager`, replace\nthe `ReviewManager` instance with an instance of `FakeReviewManager`, as shown\nin the following example: \n\n### Kotlin\n\n```kotlin\nval manager = FakeReviewManager(context)\n```\n\n### Java\n\n```java\nReviewManager manager = new FakeReviewManager(context);\n```\n| **Note:** `FakeReviewManager` does not simulate the UI. It only fakes the API method result by always providing a fake `ReviewInfo` object and returning a success status when the in-app review flow is launched.\n\nTroubleshooting\n---------------\n\nAs you integrate and test in-app reviews, you might run into some issues. The\nfollowing table outlines the most common issues that can prevent the in-app\nreview dialog from displaying in your app:\n\n| Issue | Solution |\n|-------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Your app is not published yet in the Play Store. | Your app doesn't have to be published to test, but your app's `applicationID` must be available at least in the internal testing track. |\n| The user account can't review the app. | Your app must be in the user's Google Play library. To add your app to the user's library, download your app from the Play Store using that user's account. |\n| The primary account is not selected in the Play Store. | When multiple accounts are available in the device, ensure that the primary account is the one selected in the Play Store. |\n| The user account is protected (for example, with enterprise accounts). | Use a Gmail account instead. |\n| The user has already reviewed the app. | Delete the review directly from Play Store. |\n| The quota has been reached. | Use an [internal test track](#internal-test-track) or [internal app sharing](#internal-app-sharing). |\n| There is an issue with the Google Play Store or Google Play Services on the device. | This commonly occurs when the Play Store was sideloaded onto the device. Use a different device that has a valid version of the Play Store and Google Play Services. |"]]
