نشر اللعبة

يوضّح لك هذا المستند كيفية نشر لعبتك على برنامج "ألعاب Google Play على الكمبيوتر".

قبل البدء

دمج حزمة تطوير البرامج (SDK) الخاصة "بألعاب Google Play" في لعبتك

تجميع لعبتك كملف WAB

يتطلّب برنامج "ألعاب Google Play على الكمبيوتر" تحميل أداة تثبيت اللعبة إلى Google Play Console كملف حِزمة تطبيق Windows (WAB). لإنشاء ملف WAB، اتّبِع الخطوات التالية:

1. نزِّل أداة النشر على Play. يمكنك تشغيل هذه الأداة على سطر أوامر Windows أو Powershell.

2. أنشئ ملف إعداد النشر على Play، مع أي اسم. على سبيل المثال، play_publishing_config.xml بالتنسيق التالي:

   <?xml version="1.0" encoding="UTF-8"?>
   <play-publishing-config version="1.0">
     <application>
       <package-name>PACKAGE_NAME</package-name>
       <version-name>VERSION_NAME</version-name>
     </application>
     <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION>
       <path>INSTALLER_PATH</path>
       <installation-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>InstallLocation</value-name>
       </installation-path-registry-location>
     </installer>
     <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION>
       <launch-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>InstallLocation</value-name>
       </launch-path-registry-location>
       <executable-invocation>
         <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename>
         <arguments>LAUNCHER_ARGS_IF_ANY</arguments>
       </executable-invocation>
     </launcher>
     <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION>
       <uninstall-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>UninstallString</value-name>
       </uninstall-path-registry-location>
     </uninstaller>
   </play-publishing-config>

   استبدِل ما يلي:

   • PACKAGE_NAME: اسم حزمة لعبتك على سبيل المثال، com.yourcompany.yourgame.
   • VERSION_NAME: سلسلة إصدار اللعبة على سبيل المثال، 1.0.0.

   • ‫INSTALLER_REQUIRES_ELEVATION: تشير إلى ما إذا كان يجب تشغيل ملف أداة التثبيت التنفيذي كمسؤول لإكمال عملية التثبيت.

     • "true": لتشغيل الملف التنفيذي كمسؤول

     • "false": تشغيل الملف التنفيذي بصفتك المستخدم الحالي

   • INSTALLER_PATH: مسار ملف المثبِّت داخل WAB يمكن أن يكون هذا المسار مطلقًا أو نسبيًا بالنسبة إلى الدليل الرئيسي لإعدادات النشر على Play. على سبيل المثال، path\to\test\installer. تذكَّر استخدام authenticode وتوقيع الرمز لتوقيع ملف قابل للتنفيذ خاص بمثبِّت اللعبة.

   • UNIQUE_REGISTRY_PATH: المفتاح الجذر الذي سيحتوي على جميع معلومات التسجيل. ويجب أن يكون فريدًا على مستوى جهاز المستخدم. سيكون هذا هو المسار النسبي في أعلى HKLM. على سبيل المثال، SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. سيؤدي هذا الإدخال إلى إنشاء مفتاح رئيسي ضمن HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName على جهاز يعمل بنظام التشغيل Windows 11 إصدار 64 بت.

   • ‫LAUNCHER_REQUIRES_ESCALATION: يشير إلى ما إذا كان يجب تشغيل مشغّل التطبيق أو ملف تشغيل اللعبة كمسؤول في كل مرة يتم تشغيله فيها.

     • "true": لتشغيل الملف التنفيذي كمسؤول

     • "false": تشغيل الملف التنفيذي بصفتك المستخدم الحالي

   • RELATIVE_PATH_TO_LAUNCHER_EXE: مسار مشغّل التطبيق أو ملف اللعبة التنفيذي ضمن دليل التثبيت يجب أن يتضمّن ذلك اسم ملف مشغّل التطبيق أو اللعبة التنفيذي. على سبيل المثال، إذا كان اسم ملف مشغّل التطبيق أو اللعبة هو mygame.exe وكان موجودًا ضمن {INSTALL_DIR}\Resources\mygame.exe، عليك وضع Resources\mygame.exe

   • LAUNCHER_ARGS_IF_ANY: أي وسيطات سطر أوامر يجب تمريرها إلى مشغّل التطبيق أو اللعبة هذا الإدخال اختياري.

   • ‫UNINSTALLER_REQUIRES_ELEVATION: يشير إلى ما إذا كان يجب تشغيل ملف إلغاء التثبيت التنفيذي كمسؤول لإكمال عملية إلغاء التثبيت.

     • "true": لتشغيل الملف التنفيذي كمسؤول

     • "false": تشغيل الملف التنفيذي بصفتك المستخدم الحالي

   مثال على ملف إعداد النشر على Play

   لنفترض أنّ هناك لعبة باسم MyGame، مع مثبّت اللعبة game_installer.exe ومشغّل اللعبة launcher.exe. يوضّح المثال أيضًا كيفية استخدام CDATA. في ما يلي الشكل الذي سيبدو عليه play_publishing_config.xml:

   <?xml version="1.0" encoding="UTF-8"?>
   
   <play-publishing-config version="1.0">
     <application>
       <package-name>com.mycompany.mygame</package-name>
       <version-name>1.0.0</version-name>
     </application>
     <installer requiresElevation="true">
       <path>game_installer.exe</path>
       <installation-path-registry-location>
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>InstallLocation</value-name>
       </installation-path-registry-location>
     </installer>
   
     <launcher requiresElevation="true">
       <launch-path-registry-location >
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>InstallLocation</value-name>
       </launch-path-registry-location>
       <executable-invocation>
         <filename>launcher.exe</filename>
         <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
       </executable-invocation>
     </launcher>
   
     <uninstaller requiresElevation="true">
       <uninstall-path-registry-location>
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>UninstallString</value-name>
       </uninstall-path-registry-location>
     </uninstaller>
   </play-publishing-config>
   

3. تشغيل أداة النشر على Play من سطر الأوامر في Windows أو Powershell

   playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH
   

   للكتابة فوق ملف WAB حالي يحمل الاسم نفسه، استخدِم الوسيطة --force.

   playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
   

   استبدِل ما يلي:

   • ‫PLAY_PUBLISHING_CONFIG_PATH: مسار ملف إعدادات النشر على Play على سبيل المثال، path\to\play_publishing_config.xml.
   • WAB_OUTPUT_PATH: مسار ملف WAB. على سبيل المثال، path\to\output_bundle.wab.

   كيفية استخدام أداة النشر على Play

   لنفترض أنّ لديك ملفًا ثنائيًا لأداة النشر على Play playpublishingtool.exe وملف إعدادات النشر على Play play_publishing_config.xml وبرنامج تثبيت اللعبة game_installer.exe في دليل العمل الحالي.

   يجب أن يبدو دليل العمل الحالي على النحو التالي:

   .\
   ├── game_installer.exe
   ├── play_publishing_config.xml
   ├── playpublishingtool.exe
   

   لإنشاء WAB بالاسم installer_bundle.wab في الدليل نفسه، سيبدو الأمر على النحو التالي:

   playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
   

   باستخدام الوسيطة --force، سيبدو الأمر على النحو التالي:

   playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
   

   عند النجاح، من المفترض أن تظهر لك نتيجة مشابهة لما يلي:

   Successfully built the installer bundle at installer_bundle.wab
   

   ابحث عن ملف WAB في المجلد:

     .\
     ├── game_installer.exe
     ├── installer_bundle.wab
     ├── play_publishing_config.xml
     ├── playpublishingtool.exe
   

نشر اللعبة باستخدام Play Console

بعد إنشاء حزمة تطبيق Android بنجاح للعبتك، حمِّلها إلى Play Console وأدِر إعداداتها ومتطلباتها. اتّبِع الخطوات التالية لنشر لعبتك:

إضافة شكل الجهاز المخصّص لبرنامج "ألعاب Google Play على الكمبيوتر"

يجب تنفيذ هذه الخطوة مرة واحدة فقط عند نشر لعبة للمرة الأولى.

1. في Play Console، اختَر الاختبار والإصدار > الإعداد > الإعدادات المتقدّمة من القائمة اليمنى (رابط مباشر).

2. انتقِل إلى علامة التبويب أشكال الأجهزة وأضِف Google Play Games on PC(Windows) من القائمة المنسدلة + إضافة شكل جهاز.

3. انقر على الزر إدارة بجانب شكل الجهاز ألعاب Google Play على الكمبيوتر على يسار الشاشة.

4. اختَر الخيار استخدام قناة إصدار مخصّصة للعبتك التي تتضمّن حِزمة تطبيق Windows.

5. انقر على حفظ، ثم انقر على حفظ مرة أخرى في مربّع حوار التأكيد.

تحميل ملف WAB

لتحميل ملف WAB، اتّبِع الخطوات التالية:

1. في Play Console، انقر على الاختبار والإصدار > الإصدار العلني (رابط مباشر) في القائمة اليمنى.
2. في صفحة الإنتاج، اختَر ألعاب Google Play على الكمبيوتر (لنظام التشغيل Windows) فقط من القائمة المنسدلة الخاصة بشكل الجهاز على الجانب الأيسر.
3. في علامة التبويب حِزمة تطبيق Windows، انقر على الزر تحميل حِزمة تطبيق Windows وحمِّل ملف WAB. بدلاً من ذلك، يمكنك أيضًا النقر على الزر تحميل حِزمة تطبيق Windows على يسار القائمة المنسدلة "عامل الشكل".
4. انقر على حفظ.

ضبط متطلبات أجهزة الكمبيوتر التي تعمل بنظام التشغيل Windows

لضبط متطلبات أجهزة الكمبيوتر التي تعمل بنظام التشغيل Windows، اتّبِع الخطوات التالية:

1. في Play Console، انقر على زيادة عدد المستخدمين > التوفُّر في المتجر > إعدادات المتجر (رابط مباشر) في القائمة اليمنى.
2. في قسم متطلبات الكمبيوتر، انقر على الزر تعديل على يسار الصفحة.
3. عدِّل الحقول وانقر على حفظ.

ضبط صورة عملية الشراء داخل التطبيق

هذه الخطوة اختيارية. لضبط صورة عملية الشراء داخل التطبيق، اتّبِع الخطوات التالية:

1. في Play Console، انقر على زيادة عدد المستخدمين > التوفّر في المتجر > بطاقات بيانات المتجر(رابط مباشر) في القائمة اليمنى.
2. في قسم بطاقة بيانات المتجر التلقائية ضمن علامة التبويب بطاقات بيانات المتجر، انقر على الزر -> (السهم) على الجانب الأيسر. سينقلك هذا الإجراء إلى صفحة بطاقة بيانات المتجر التلقائية.
3. انتقِل إلى قسم ألعاب Google Play على الكمبيوتر وحمِّل الصورة في صورة لعمليات الشراء داخل التطبيق في برنامج "ألعاب Google Play على الكمبيوتر" (Windows).
4. انقر على حفظ.

إرسال التغييرات للمراجعة

1. في Play Console، انقر على نظرة عامة على النشر في القائمة اليمنى.
2. في قسم التغييرات التي لم يتم إرسالها للمراجعة بعد، انقر على إرسال التغييرات للمراجعة.

بعد موافقة فريق المراجعة على التغييرات، سيصبح بإمكان المستخدمين العثور على لعبتك على Google Play.