اختبار تسليم مواد العرض
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استخدِم الخطوات الواردة في هذا الدليل لاختبار طريقة دمج تطبيقك لميزة "عرض المواد في Play"
لاسترداد حِزم مواد العرض.
الاختبار المحلي
تتيح ميزة "عرض المواد في Play" إجراء الاختبارات المحلية من خلال تثبيت إصدار جديد من
اللعبة باستخدام bundletool. استخدام الاختبار المحلي
للحصول على دورات متكررة وسريعة لأنّها تتجنّب الحاجة إلى تحميل اللعبة إلى Google
خوادم Play تعتمد الخطوات التي ينبغي عليك اتخاذها على ما إذا كنت
تُطور بلغة Java أو بلغة البرمجة Unity أو Unity.
Java أو مدمج مع المحتوى
يُرجى اتّباع الخطوات التالية لاختبار تطبيقك محليًا:
إنشاء حِزمة تطبيقك:
إنشاء حِزم APK باستخدام علامة --local-testing:
java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \
--output=output.apks --local-testing
يمكنك ربط جهاز وتشغيل bundletool لتثبيت حِزم APK من مصدر غير معروف:
java -jar bundletool.jar install-apks --apks=output.apks
الانسجام
في Unity Editor، اختَر Google > الإنشاء والتشغيل:
السُلوك
سيتم تثبيت install-time حِزم أثناء عملية تثبيت التطبيق.
تعمل fast-follow حِزم كحزم on-demand. أي، لن يكون
يتم استرجاعها تلقائيًا عند تثبيت اللعبة من مصدر غير معروف. على المطوّرين إرسال طلب
يدويًا عند بدء اللعبة ولا يتطلب ذلك أي تغييرات على الرمز في
تطبيقك.
القيود
في ما يلي قيود الاختبار المحلي:
- يتم جلب الحزم من وحدة التخزين الخارجية بدلاً من Play، لذلك لا يمكنك الاختبار
طريقة تصرف الرمز في حالة حدوث أخطاء في الشبكة.
- لا يشمل الاختبار المحلي سيناريو "انتظار الاتصال بشبكة Wi-Fi".
- لا يمكن إجراء تحديثات. قبل تثبيت إصدار جديد من
إصدارًا، فقم بإلغاء تثبيت الإصدار السابق يدويًا.
الاختبار من خلال ميزة "مشاركة التطبيقات مع الفريق الداخلي"
كلما اقتربت من الحصول على مرشح، اختبار
لعبتك باستخدام إعدادات واقعية قدر الإمكان لضمان أداء لعبتك
بشكل جيد للمستخدمين في الإنتاج. للتحقق من ذلك، يمكنك استخدام
مشاركة التطبيقات مع الفريق الداخلي
للحصول على رابط قابل للمشاركة يمكنك استخدامه لتنزيل اللعبة من Play أثناء
الحصول على نفس سلوك المستخدمين بمجرد بدء
على "متجر Play".
لاختبار "عرض مواد العرض" باستخدام ميزة "مشاركة التطبيقات مع الفريق الداخلي"، عليك اتّباع الخطوات التالية:
- أنشئ حِزمة تطبيقك.
- اتّبِع تعليمات Play Console حول كيفية
مشاركة التطبيق مع الفريق الداخلي
- على الجهاز الاختباري، انقر على رابط "مشاركة التطبيقات مع الفريق الداخلي" لإصدار
تطبيقك الذي حمّلته للتو.
- ثبِّت التطبيق من صفحة "متجر 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 asset delivery\n\nUse the steps in this guide to test how your app integrates Play Asset Delivery\nto retrieve asset packs.\n\nLocal testing\n-------------\n\nPlay Asset Delivery supports local testing by installing a new version of the\ngame using [`bundletool`](/studio/command-line/bundletool). Use local testing\nfor quick, iterative cycles as it avoids the need to upload the game to Google\nPlay servers. The steps you need to take depend on whether you're\ndeveloping in Java, native, or Unity.\n\n- [Java](#steps-native-java)\n- [Native](#steps-native-java)\n- [Unity](#steps-unity)\n\n### Java or native\n\nFollow these steps to test your app locally:\n\n1. [Build your app bundle](/guide/playcore/asset-delivery#next-step-instructions).\n\n2. Generate APKs with the `--local-testing` flag:\n\n ```\n java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \\\n --output=output.apks --local-testing\n ```\n3. Connect a device and run `bundletool` to sideload the APKs:\n\n ```\n java -jar bundletool.jar install-apks --apks=output.apks\n ```\n\n### Unity\n\nIn the Unity Editor, select **Google \\\u003e Build and Run**.\n\n### Behavior\n\n`install-time` packs will be installed during the app installation process.\n\n`fast-follow` packs behave as `on-demand` packs. That is, they won't be\nautomatically fetched when the game is sideloaded. Developers need to request\nthem manually when the game starts; this does not require any code changes in\nyour app.\n\n### Limitations\n\nThe following are limitations of local testing:\n\n- Packs fetch from external storage instead of Play, so you cannot test how your code behaves in the case of network errors.\n- Local testing does not cover the wait-for-Wi-Fi scenario.\n- Updates are not supported. Before installing a new version of your build, manually uninstall the previous version.\n\nTesting with internal app sharing\n---------------------------------\n\nAs you get closer to having a release candidate, test\nyour game using as realistic a configuration as possible to make sure that your game will perform\nwell for your users in production. To validate this, you can use\n[internal app sharing](https://support.google.com/googleplay/android-developer/answer/9303479)\nto get a sharable link that you can use to download the game from Play while\ngetting the exact same behaviour as your users will once the game is\npublished to the Play Store.\n\nTo test Asset Delivery using internal app sharing, do the following:\n\n1. Build your app bundle.\n2. Follow the Play Console instructions on how to [share your app internally](https://support.google.com/googleplay/android-developer/answer/9303479).\n3. On the test device, click the internal app-sharing link for the version of your app you just uploaded.\n4. Install the app from the Google Play Store page you see after clicking the link."]]
