النشر باستخدام أداة التثبيت

يوضّح لك هذا المستند كيفية نشر لعبتك على برنامج "ألعاب 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: اسم حزمة لعبتك هذا هو المعرّف الفريد الذي سيتم ربطه بلعبتك على Google Play. على سبيل المثال، com.yourcompany.yourgame. يجب أن يتوافق اسم الحزمة مع القواعد التالية:
     • يجب أن يحتوي على قسمَين على الأقل (نقطة واحدة أو أكثر).
     • يجب أن يبدأ كل جزء بحرف.
     • يجب أن تكون جميع الأحرف أبجدية رقمية أو شرطة سفلية ([a-zA-Z0-9_]).

   • VERSION_NAME: سلسلة إصدار اللعبة يمكن أن تكون هذه السلسلة عشوائية، ولكن يجب أن تكون فريدة بين جميع حِزم WAB التي تم تحميلها للعبتك. على سبيل المثال: 1.0 و1.0.1-beta و2025.11.24 وv1.rc1.

     • ‫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_ELEVATION: تشير إلى ما إذا كان يجب تشغيل مشغّل التطبيق أو ملف تنفيذ اللعبة كمسؤول في كل مرة يتم تشغيلهما.

       • "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 من القائمة المنسدلة + إضافة شكل جهاز.

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

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

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

تفعيل ميزة "النشر المُدار"

لتفعيل ميزة "النشر المُدار"، اتّبِع الخطوات التالية.

1. في صفحة نظرة عامة على النشر، ضِمن قسم النشر المُدار، انقر على تفعيل ميزة "النشر المُدار".
2. سيظهر مربّع حوار. بدِّل إلى تفعيل ميزة "النشر المُدار" للقناة.
3. انقر على حفظ.

تحميل ملف WAB

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

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

ضبط متطلبات أجهزة كمبيوتر Windows

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

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

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

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

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

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

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

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