تطوير التطبيق باستخدام محاكي مطوّر برامج "ألعاب Google Play على الكمبيوتر"

محاكي المطوّرين لبرنامج "ألعاب Google Play على الكمبيوتر" هو محاكي يركّز على المطوّرين "ألعاب Google Play على الكمبيوتر" على عكس تجربة المشغّل، يمكنك تثبيت وتصحيح أخطاء الحزم الخاصة بك. يمكنك أيضًا محاكاة إعدادات مشغّلات مختلفة مثل نسبة العرض إلى الارتفاع ومحاكاة الماوس والواجهة الخلفية للرسومات لمساعدتك التأكّد من أنّ لعبتك تعمل على النحو المتوقَّع على مجموعة متنوّعة من أجهزة الكمبيوتر الإعدادات.

بدء المحاكي

بعد تثبيت التطبيق، سيصبح لديك "محاكي مطوّري برامج "ألعاب Google Play" بدء عنصر قائمة واختصار على سطح المكتب لتشغيل المحاكي. سيبدأ المحاكي يبقى في لوحة النظام عند إغلاق النافذة.

تسجيل الدخول

يُطلب منك تسجيل الدخول إلى حسابك على Google في المرة الأولى التي تشغّل فيها المحاكي. استخدِم بيانات اعتماد تسجيل الدخول نفسها التي تخطِّط لاستخدامها في عملية التطوير.

يمكنك تسجيل الخروج من خلال النقر بزر الماوس الأيمن على رمز لوحة النظام واختيار المطوّر. الخيارات، ثم النقر على فرض تسجيل الخروج. عند إجراء ذلك، سيقوم المحاكي تتم إعادة تشغيله على الفور ويطلب منك تسجيل الدخول مرة أخرى.

التنقّل

بعد تشغيل التطبيق، ستظهر لك شاشة رئيسية عادية في نظام التشغيل Android. الماوس الأيسر تتم ترجمة النقرات مباشرةً إلى نقرات بالأصابع، كما هو الحال في وضع محاكاة الماوس. تظهر الألعاب التي تم تثبيتها من مصدر غير معروف للتطوير في قائمة التطبيقات، التي يمكنك يمكنك الوصول إليها من خلال النقر على سطح المكتب والسحب لأعلى (محاكاة التمرير السريع للأعلى على هاتف أو جهاز لوحي).

بالإضافة إلى الترجمة باستخدام الماوس، يوفّر محاكي المطوّرين في "ألعاب Google Play على الكمبيوتر" اختصارات لوحة المفاتيح لتحسين التنقل:

• ctrl + h: اضغط على زر الشاشة الرئيسية
• ctrl + b: اضغط على زر الرجوع
• F11 أو alt + enter: للتبديل بين وضع ملء الشاشة وضع عرض المحتوى في نافذته
• shift + tab: لفتح صفحة "ألعاب Google Play على الكمبيوتر"، بما في ذلك تعيينات المفاتيح الحالية لحزمة تطوير البرامج (SDK) للإدخال

تثبيت لعبة

يستخدم محاكي المطوّرين لبرنامج "ألعاب Google Play على الكمبيوتر" Android Debug Bridge (adb) من أجل حزم التثبيت.

توافق مع Adb

تتوافق الإصدارات الحالية من adb مع محاكي المطوّرين في برنامج "ألعاب Google Play على الكمبيوتر". بالإضافة إلى ذلك، يتم تثبيت إصدار متوافق على C:\Program Files\Google\Play Games Developer Emulator\current\emulator عند التثبيت. المحاكي.

لاتّباع هذه التعليمات، يجب أن يتوفّر Adb في $PATH. يمكنك تأكَّد من ضبط adb بشكل صحيح باستخدام الأمر adb devices.

adb devices
List of devices attached
localhost:6520  device

تثبيت اللعبة

• تشغيل Google Play Games for PC Emulator

• اكتب adb devices في موجّه الأوامر. من المفترض أن يظهر لك ما يلي:

  adb devices
  List of devices attached
  localhost:6520 device
  

• استكشاف المشاكل وإصلاحها:

  • إذا ظهرت لك رسالة خطأ، تأكَّد من اتّباع التعليمات الواردة في Adb. .
  • إذا لم يظهر لك أي جهاز، حاوِل إعادة الاتصال عبر المنفذ 6520:

  adb connect localhost:6520
  

• اكتب adb install path\to\your\game.apk لتثبيت لعبتك. إذا كنت تمّ إنشاء تنسيق Android App Bundle (aab)، يُرجى الاطّلاع على التعليمات بشأن bundletool واستخدِم bundletool install-apks بدلاً منها.

• يمكنك تشغيل لعبتك من خلال أحد الإجراءَين التاليَين:

  • اكتب adb shell monkey -p your.package.name 1 لتشغيل لعبتك، مع استبدال your.package.name باسم حزمة لعبتك.
  • في مُحاكي مطوّري برامج "ألعاب Google Play على الكمبيوتر"، انقر على الرمز لتشغيل لعبتك. كما هو الحال في هاتف Android، يجب عليك "التمرير السريع لأعلى" في المنزل للاطّلاع على قائمة الألعاب المثبَّتة.

تصحيح أخطاء لعبة

استخدِم Android Debug Bridge (adb) لتصحيح الأخطاء كما تفعل مع أي لعبة أخرى. يظهر المحاكي كجهاز متصل من خلال localhost:6520.

تعمل adb logcat على النحو المتوقع، وكذلك الأدوات التي تساعد في تحسين أو تصفية Logcat، بما في ذلك Android Studio.

بالإضافة إلى adb، يمكن الوصول إلى السجلّات في دليل %LOCALAPPDATA%\Google\Play Games Developer Emulator\Logs. معظم الأقسام مفيدة هنا هي AndroidSerial.log التي تمثل كل شيء adb logcat من لحظة بدء المحاكي.

إعدادات مطوّر البرامج

يركّز محاكي المطوّرين في "ألعاب Google Play على الكمبيوتر" على كفاءة المطوّرين من تجربة المستخدم النهائي. وهذا يعني أنه يمكنك الوصول بشكل واضح إلى لنظام Android، بما في ذلك استخدام مشغّل Android القياسي بدلاً من تجربة برنامج "ألعاب Google Play على الكمبيوتر" وعناصر التحكّم في الميزات إذا تم تفعيلها أو إيقافها تلقائيًا للّاعبين

اختبار إدخالات الماوس

أثناء تطوير "ألعاب Google Play على الكمبيوتر"، يتم تلقائيًا استخدام اللمسات التالية: بدلاً من منحك مدخلات مباشرة بالماوس. يمكنك تفعيل خيار الماوس المباشر بالنقر بزر الماوس الأيمن على رمز لوحة النظام واختيار خيارات المطوّرين ثم وضع الكمبيوتر الشخصي (KiwiMouse).

يتضمّن برنامج "ألعاب Google Play على الكمبيوتر" وضعَين للماوس: وضع المحاكاة الذي يترجم نقرات الماوس على نقرات واحدة وتمرير "وضع الكمبيوتر الشخصي" (PC mode) تتيح للألعاب إجراءات الماوس بشكل محلي وتنفيذ التقاط المؤشر. للحصول على تفاصيل حول إدخالات الماوس في برنامج "ألعاب Google Play على الكمبيوتر"، راجِع إعداد إدخال الماوس.

في برنامج المشغّل، يتم إيقاف المحاكاة من خلال إضافة هذا الرمز إلى ملف البيان:

<manifest ...>
  <uses-feature
      android:name="android.hardware.type.pc"
      android:required="false" />
  ...
</manifest>

ليس لعلامة الميزة هذه أي تأثير في بيئة التطوير.

اختبار نِسب العرض إلى الارتفاع

يتم تشغيل المحاكي بنسبة عرض إلى ارتفاع تبلغ 16:9 على عكس المشغّل الذي يستنتج نسبة العرض إلى الارتفاع من الشاشة الأساسية. على اليمين والنقر على رمز لوحة النظام، وتحديد خيارات المطوّرين، ثم تحديد أي الخيار في قسم نسبة العرض، يمكنك اختبار طريقة ظهور اللعبة على لشاشات اللاعبين المختلفة.

الطريقة المفضلة لضبط نسبة العرض إلى الارتفاع هي استخدام android:minAspectRatio وandroid:maxAspectRatio.

على سبيل المثال: للألعاب التي تعمل بالاتجاه العمودي نسبة عرض إلى ارتفاع 9/16 أو 0.5625، لذا قد تحتاج إلى عليك ضبط نسبة عرض إلى ارتفاع قصوى تبلغ 1 لمنع لعبتك من الظهور بشكل أوسع من المربّع:

<activity android:maxAspectRatio="1">
 ...
</activity>

وبالمثل، قد تكون لعبة المناظر الطبيعية 16/9 أو 1.778 تقريبًا، لذا قد تحتاج لضبط الحد الأدنى لنسبة العرض إلى الارتفاع على 1 لمنع أن تبدو أقل من الصورة المربّعة:

<activity android:minAspectRatio="1">
 ...
</activity>

ما يمكن اختباره

إذا كانت لعبتك تتيح الأوضاع العمودية فقط في ملف البيان، يمكنك اختيار 9:16. (عمودي) في القائمة المنسدلة للاطّلاع على شكل ظهورها في نتائج اللاعبين أجهزة الكمبيوتر الشخصية. أو التأكّد من أنّ لعبتك تعمل على أوسع وأضيق نسب أفقيّة في ملف البيان، مع تذكُّر أنّ 16:9 (القيمة التلقائية) (أو 9:16 (عمودي) إذا كانت لعبتك بالاتجاه العمودي فقط مطلوبة من أجل الشهادة الكاملة.

اختبار الخلفيات الخاصة بعرض المحتوى

يستخدم برنامج "ألعاب Google Play على الكمبيوتر" محرِّك ANGLE كطبقة توافق التأكّد من معالجة طلبات OpenGL ES بشكل صحيح من خلال الكمبيوتر الشخصي المضيف باستخدام الخلفية لـDirect أو Vulkan. ويدعم المحاكي أيضًا Vulkan بشكل مباشر، على الرغم من وليس في برنامج Direct. تعمل هذه الطبقة أيضًا على تحويل تنسيقات الزخرفة المضغوطة على الجوّال فقط إلى أجهزة الكمبيوتر الشخصي المتوافقة. بالنقر بزر الماوس الأيمن على رمز لوحة النظام وتحديد تجاوز حزمة الرسومات، يمكنك إما ضبطه على الإعداد التلقائي للنظام أو فرض تفعيل vulkan أو إيقافه لاختبار التوافق.

ما يمكن اختباره

هناك اختلافات طفيفة في تنسيقات الزخرفة المتوافقة والخطوات المطلوبة يمكنك محاكاة ميزات مختلفة للجوّال على سطح المكتب. عند تحديد المواصفات الشخصية فقد يكون من المفيد التحقق من كل خلفية.

تحليل ألعاب الكمبيوتر الشخصي

نظرًا لأن المحاكي يستخدم نفس التقنية التي يستخدمها العميل، فهو البيئة المناسبة لتحليل بيانات الأداء.

Perfetto هي أداة لتحليل الأداء على Android. يمكنك جمع يمكنك عرض تتبُّع Perfetto باتّباع الخطوات التالية:

1. في طلب PowerShell، ابدأ التتبع باستخدام adb.

   adb shell perfetto --time 10s gfx wm sched --out /data/misc/perfetto-traces/example.trace
   

   1. تحدّد العلامة --time مدة بيانات آثار الأنشطة التي سيتم جمعها.في هذه الدورة، على سبيل المثال، يبلغ التتبع 10 ثوانٍ.
   2. تشير الوسيطات بعد علامة --time إلى الأحداث التي يجب اتّخاذها. وتتبعها. في هذا المثال، تشير السمة gfx إلى الرسومات وwm إدارة النوافذ معلومات جدولة عملية sched هذه علامات شائعة لتحديد المواصفات الشخصية الألعاب والمرجع الكامل.
   3. تحدّد العلامة --out ملف الإخراج الذي يتم سحبه من المحاكي على الجهاز المضيف في الخطوة التالية.

2. يُرجى سحب آثار الأنشطة من المضيف.

   adb pull /data/misc/perfetto-traces/example.trace $HOME/Downloads/example.trace
   

3. فتح سجلّ التتبُّع في واجهة مستخدم Perfetto

   1. افتح ui.perfetto.dev.
   2. اختَر فتح ملف التتبُّع من أعلى يمين الصفحة ضمن التنقل.
   3. افتح ملف example.trace الذي نزّلته في الخطوة السابقة على دليل Downloads/.

4. افحص عملية التتبّع في واجهة مستخدم Perfetto. في ما يلي بعض الملاحظات المفيدة:

   1. لكل عملية صفها الخاص، والذي يمكن توسيعه لعرض جميع سلاسل المحادثات. في هذه العملية. إذا كنت تنشئ ملفًا شخصيًا للعبة، فمن المحتمل أن تكون هذه العملية هي أول الصف.
   2. يمكنك التكبير والتصغير من خلال الضغط مع الاستمرار على Control واستخدام الانتقال عجلة.
   3. عند استخدام حدث "sched"، يظهر صف لكل سلسلة محادثات يعرض الوقت حالة سلسلة المحادثات هذه "قيد التشغيل" أو "قابلة للتشغيل" أو "ساكنة" أو "محظورة".
   4. عند تفعيل حدث مثل gfx، يمكنك مشاهدة الخيارات المختلفة. رسومات يتم إجراؤها بواسطة سلاسل محادثات متنوعة. يمكنك اختيار "شرائح" فردية. إلى معرفة المدة التي استغرقتها، أو يمكنك سحب أحد الصفوف مما يؤدي إلى ظهور "شرائح" قسم لفتحها في الجزء السفلي وتوضيح المدة التي استغرقتها كل الشرائح في الفترة الزمنية المحددة.

تحليل مواصفات الرسومات

يمكن إجراء بعض تحليل الرسومات باستخدام RenderDoc:

1. ضبط متغيّر البيئة ANDROID_EMU_RENDERDOC إلى سلسلة غير فارغة (مثل "1").

2. ضبط متغيّر البيئة TMP على %USERPROFILE%\AppData\LocalLow يؤدي هذا الإجراء إلى إعلام Renderdoc بوضع ملفات السجلّ في مكان يمكن الوصول إليه داخل وضع الحماية المحاكي.

3. إذا كنت تستخدم الواجهة الخلفية Vulkan اختيار إعدادات الرسومات > الطبقات الضمنية لمثيل Vulkan والتأكد من يتم وضع علامة في المربّع VKLAYER_RENDERDOC_Capture.

4. شغِّل محاكي المطوّرين لبرنامج "ألعاب Google Play على الكمبيوتر". يتم رسم تراكب RenderDoc عند ما دام الدعم مفعَّلاً.

5. تشغيل RenderDoc في أي وقت قبل محاكي المطوّرين في "ألعاب Google Play على الكمبيوتر" أو بعده عمليات الإطلاق.

6. انقر على ملف >. الإرفاق بمثيل التشغيل واختَر crosvm

تحديد متغيّرات البيئة

لكي يعمل Renderdoc، يجب إضافة متغيرات بيئة أو تغييرها. في نظام التشغيل Windows يمكنك تغيير متغيرات البيئة باستخدام واجهة المستخدم أو PowerShell أو cmd.exe.

استخدام واجهة المستخدم

• اضغط على Win+R لفتح مربّع حوار التشغيل.
• اكتب sysdm.cpl لفتح نافذة خصائص النظام.
• اختَر علامة التبويب إعدادات متقدّمة إذا لم تكن نشطة حاليًا.
• انقر على زر متغيّرات البيئة.

من هنا، يمكنك النقر على الزر جديد لإنشاء بيئة جديدة. متغيّر أو اختَر متغيّرًا وانقر على الزرّ تعديل لتعديله.

استخدام PowerShell

في نافذة PowerShell، اكتب:

$Env:VARIABLE_NAME=VALUE

استبدِل VARIABLE_NAME وVALUE بالقيم التي تريد ضبطها. بالنسبة على سبيل المثال، لضبط ANDROID_EMU_RENDERDOC على النوع "1":

$Env:ANDROID_EMU_RENDERDOC="1"

استخدام cmd.exe

في نافذة cmd.exe، اكتب:

set VARIABLE_NAME=VALUE

استبدِل VARIABLE_NAME وVALUE بالقيم التي تريد ضبطها. بالنسبة على سبيل المثال، لضبط ANDROID_EMU_RENDERDOC على النوع "1":

set ANDROID_EMU_RENDERDOC="1"

نصائح لنظام Android 11 (المستوى 30 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث

تم تحديث برنامج "ألعاب Google Play على الكمبيوتر" بأحدث إصدارات Android. إليك بعض النصائح للعمل باستخدام أحدث إصدار من Android.

تحديث الأدوات باستمرار

يثبّت "استوديو Android" إصدارًا من adb يتوافق مع المطوّر. المحاكي مع ذلك، تتضمّن بعض محرّكات الألعاب إصدارًا قديمًا من adb. في ذلك، بعد تثبيت محاكي المطور، يمكنك العثور على تطبيق متوافق إصدار adb في C:\Program Files\Google\Play Games Developer Emulator\current\emulator.

في حال إطلاق أحد إصدارات adb، سيتم إنهاء الإصدار الآخر. هذا يعني أنّ إذا شغّل محرّك لعبتك مثيل adb الخاص به تلقائيًا، قد تكون لديك لإعادة إطلاق إصدار adb المتوفّر مع مطوّر البرامج وإعادة ربطه. كلما قمت بالنشر.

إذا كنت تستخدم حِزمة تطبيق Android، يجب تثبيت أحدث إصدار من Bundletool من مستودع GitHub.

التخزين الفرعي

يتضمّن Android 11 (المستوى 30 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث مساحة تخزين ذات نطاق، والتي توفّر حماية أفضل لبيانات التطبيقات والمستخدمين على وحدة التخزين الخارجية. بالإضافة إلى جعل لعبة متوافقة مع متطلبات مساحة التخزين ضمن النطاق، عليك تنفيذها خطوات إضافية لتحميل ملفات توسيع حِزم APK (obb) أو بيانات مواد العرض في محاكي المطوّرين لبرنامج "ألعاب Google Play على الكمبيوتر" اتّبِع هذه الخطوات إذا واجهت مشاكل. بالوصول إلى هذه الملفات من اللعبة:

1. أنشئ دليلاً يمكن لتطبيقك قراءته.
2. ويمكنك إرسال ملفات البيانات الموسّعة إلى المحاكي.

adb shell mkdir /sdcard/Android/obb/com.example.game
adb push main.com.example.game.obb /sdcard/Android/obb/com.example.game

مستوى رؤية الحزمة

بسبب قواعد إذن الوصول إلى الحِزم الجديدة، فإنّ التطبيقات التي تستهدف الإصدار 11 من Android (مستوى واجهة برمجة التطبيقات 30) أو المستويات الأحدث من الاستعلام عن معلومات حول التطبيقات الأخرى المثبَّتة على الجهاز يعني هذا أنّ لعبتك محظورة. من الوصول إلى "خدمات Play" عند التحميل من مصدر غير معروف باستخدام adb بدلاً من الذي تم تثبيته عبر "متجر Play". لاختبار الشراء داخل التطبيق باستخدام لعبة من مصدر غير معروف، يجب إضافة استعلام إلى الحزمة "com.android.vending" في ملف AndroidManifest.xml على النحو التالي:

<manifest>
    <queries>
        <package android:name="com.android.vending" />
    </queries>
</manifest>

تثبيت لعبتك في برنامج العميل للمستهلكين

لا يمكنك تثبيت لعبة على برنامج العميل حتى يتم إدراجها في كتالوج "خدمات ألعاب Play" بعد طرح إصدار واحد للعبتك، عليك إنشاء مسار اختبار داخلي للتحقّق من التعديلات المستقبلية قبل إصداره.

لا يتوافق برنامج المشغّل مع الميزات التي يركّز عليها المطوّر محاكي المطوّرين لبرنامج "ألعاب Google Play على الكمبيوتر" يُستخدم هذا الأسلوب بشكل أفضل لضمان جودة اللعبة قبل إصدارها. لاختبار تجربة اللاعب من البداية إلى النهاية بعد الإصدار الأولي