يوضّح لك هذا المستند كيفية نشر لعبتك على برنامج "ألعاب Google Play على الكمبيوتر" باستخدام أداة تثبيت اللعبة.
في عملية التثبيت من قِبل المطوّر، يجب أن تتولى أداة تثبيت اللعبة التي توفّرها إدارة عمليات تثبيت اللعبة وتحديثها وإلغاء تثبيتها.
قبل البدء
دمج حزمة تطوير البرامج (SDK) الخاصة بـ "ألعاب Google Play" في لعبتك
تجميع لعبتك في ملف WAB
يتطلّب برنامج "ألعاب Google Play على الكمبيوتر" تحميل أداة تثبيت لعبتك إلى Google Play Console كملف Windows App Bundle (WAB). لإنشاء ملف WAB، يُرجى اتّباع الخطوات التالية:
نزِّل أداة النشر على Play. يمكنك تشغيل هذه الأداة في سطر أوامر Windows أو PowerShell.
أنشئ ملف إعدادات النشر على Google 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 acceptsCommandLineArguments=ACCEPTS_COMMAND_LINE_ARGUMENTS> <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": لتشغيل الملف التنفيذي كمستخدم حالي
ACCEPTS_COMMAND_LINE_ARGUMENTS: قيمة منطقية تشير إلى ما إذا كان بإمكان أداة التثبيت قبول وسيطات سطر الأوامر لتفعيل ميزة التشغيل التلقائي. هذا الخيار اختياري والقيمة التلقائية هي "خطأ". لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل ميزة "التشغيل التلقائي".
INSTALLER_PATH: مسار ملف أداة التثبيت ضمن WAB ويمكن أن يكون هذا المسار مطلقًا أو نسبيًا بالنسبة إلى الدليل الرئيسي لإعدادات النشر على Google Play. على سبيل المثال:path\to\test\installer. يُرجى تذكُّر استخدام شهادة Authenticode وتوقيع الرمز للتوقيع على الملف التنفيذي لبرنامج تثبيت اللعبة.
<installation-path-registry-location>: مسار السجلّ الذي يستخدمه تطبيق "ألعاب Google Play" لرصد ما إذا كانت اللعبة مثبّتة أم لا حتى إذا كانت لعبتك تستخدم مشغّل مخصّص، يجب أن يشير هذا المسار إلى مفتاح السجلّ الفريد للعبة، وليس إلى مفتاح السجلّ الخاص بالمشغّل.
UNIQUE_REGISTRY_PATH: مسار مفتاح سجلّ Windows يجب تقديم هذا المسار بالنسبة إلى خلية سجلّ مثلHKEY_LOCAL_MACHINEأوHKEY_CURRENT_USER، ولا تدرِج اسم الخلية في سلسلة المسار. على سبيل المثال، إذا كان برنامج التثبيت يكتب فيHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName، حدِّدSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameفقط. يبحث برنامج "ألعاب Google Play على الكمبيوتر" عن هذا المسار فيHKEY_LOCAL_MACHINEأولاً ثم فيHKEY_CURRENT_USER، باستخدام أول قيمة مطابقة يعثر عليها.يجب أن ينشئ الملف التنفيذي المحدّد في
يجب أن يكون هذا المسار فريدًا على جهاز المستخدم. مثلاً:INSTALLER_PATHمفاتيح السجلّ هذه. قبل اكتمال التثبيت، يجب إنشاء أزواج مفاتيح السجلّ وأسماء القيم المحدّدة ضمنinstallation-path-registry-locationوlaunch-path-registry-locationوuninstall-path-registry-location. على الرغم من أنّ المثال يستخدمInstallLocationوUninstallString، يمكنك تحديد أي اسم في علامات<value-name>هذه، طالما أنّ أداة التثبيت تنشئ إدخالات سجلّ مقابلة لجميع العلامات الثلاث. يستخدم برنامج "ألعاب Google Play على الكمبيوتر" هذه القيم لتشغيل اللعبة وإلغاء تثبيتها. إذا كانت لعبتك تستخدم مشغّل تطبيقات، يجب أن تشير القيمة في إدخال السجلّ المحدّد بواسطةlaunch-path-registry-locationإلى دليل مشغّل التطبيقات (بينما يجب أن يشيرinstallation-path-registry-locationإلى مفتاح السجلّ الفريد للعبة، وليس مفتاح سجلّ مشغّل التطبيقات).SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.إذا كان برنامج تثبيت اللعبة تطبيقًا يعمل بنظام 32 بت على نظام التشغيل Windows 64 بت، يستخدم Windows إعادة توجيه السجلّ لكتابة إدخالات السجلّ ضمن
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. على سبيل المثال، تتم إعادة توجيه عملية الكتابة إلىHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameإلىHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.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": لتشغيل الملف التنفيذي كمستخدم حالي
مثال على ملف إعدادات النشر على Google 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> <!-- The package name for your game. --> <package-name>com.mycompany.mygame</package-name> <!-- The game's version string. --> <version-name>1.0.0</version-name> </application> <!-- If requiresElevation is "true", installer runs as Administrator and a UAC prompt is displayed. This is required for system-wide installs (e.g., to Program Files) or writing to HKLM. --> <!-- If acceptsCommandLineArguments is "true", the installer must be able to accept command-line arguments to enable the auto-play feature. --> <installer requiresElevation="true" acceptsCommandLineArguments="true"> <!-- Path to your installer executable. --> <path>game_installer.exe</path> <!-- The registry location where the installer writes the installation path. --> <installation-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU). game_installer.exe MUST create this key. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe, specified in <path>, creates the registry value called 'InstallLocation' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey by the time it exits. --> <value-name>InstallLocation</value-name> </installation-path-registry-location> </installer> <!-- If requiresElevation is "true", launcher runs as Administrator and a UAC prompt is displayed on every game launch. --> <launcher requiresElevation="true"> <!-- Specifies the registry location where Google Play Games reads the installation path in order to launch the game. --> <launch-path-registry-location > <!-- Registry key path (typically under HKLM or HKCU) where the launch path can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- Google Play Games reads the installation directory from this registry value, for example InstallLocation, to launch the game. --> <value-name>InstallLocation</value-name> </launch-path-registry-location> <executable-invocation> <!-- Game executable or launcher filename, relative to the directory path specified in the InstallLocation registry value. --> <filename>launcher.exe</filename> <!-- Optional arguments to pass to the executable. CDATA is used here to avoid issues with special characters like & or >. --> <arguments><![CDATA[arg1&arg2>arg3]]></arguments> </executable-invocation> </launcher> <!-- If requiresElevation is "true", uninstaller runs as Administrator and a UAC prompt is displayed for uninstall. --> <uninstaller requiresElevation="true"> <!-- Registry key where Google Play Games finds the uninstallation command. --> <uninstall-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU) where uninstall command can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe also creates the registry value, for example, 'UninstallString' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey, containing the command Google Play Games executes to uninstall the game. --> <value-name>UninstallString</value-name> </uninstall-path-registry-location> </uninstaller> </play-publishing-config>-
شغِّل أداة النشر على 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.
كيفية استخدام أداة النشر على Google Play
لنفترض أنّ لديك الملف الثنائي لأداة النشر على Play
playpublishingtool.exe، وملف إعدادات النشر على Playplay_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
تفعيل ميزة "التشغيل التلقائي" عند تثبيت ألعابك المخصَّصة للكمبيوتر (اختياري)
يتيح لك برنامج "ألعاب Google Play على الكمبيوتر" تفعيل ميزة "التشغيل التلقائي" التي تبدأ اللعبة تلقائيًا فور اكتمال عملية التثبيت. توفّر هذه الميزة تجربة سلسة للمستخدم من خلال نقل اللاعب مباشرةً إلى اللعبة، مع مصادقة كاملة ضمن منظومة "ألعاب Google Play على الكمبيوتر" المتكاملة.
طريقة العمل
عند تفعيل هذه الميزة، سيُرسِل برنامج "ألعاب Google Play على الكمبيوتر" رمزًا مميزًا للجلسة إلى عملية التثبيت التابعة لجهة خارجية باستخدام وسيطات سطر الأوامر. بعد ذلك، تكون أداة التثبيت مسؤولة عن استخراج هذا الرمز المميّز واستخدامه لتشغيل الملف التنفيذي للعبة في سياق مصادق عليه.
المتطلّبات الأساسية
لاستخدام هذه الميزة، يجب أن يكون برنامج التثبيت التابع لجهة خارجية قادرًا على معالجة وسيطات سطر الأوامر.
خطوات التنفيذ
تفعيل ميزة "التشغيل التلقائي" في إعدادات النشر على Google Play
للموافقة على هذه الميزة، أضِف السمة
acceptsCommandLineArgumentsإلى العنصر<installer>فيplay_publishing_config.xml.مثال على مقتطف من محتوى
play_publishing_config.xml:<installer requiresElevation="true" acceptsCommandLineArguments="true"> <path>path/to/installer.exe</path> <installation-path-registry-location> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\key</key-name> <value-name>InstallPath</value-name> </installation-path-registry-location> </installer>
- السمة:
acceptsCommandLineArguments - النوع:
Boolean - القيمة التلقائية:
false - السلوك: عند ضبطها على "صحيح"، ستُلحق GPG الرمز المميز للجلسة بوسيطات سطر الأوامر عند تنفيذ أداة التثبيت.
- السمة:
التعامل مع الرمز المميّز للجلسة في أداة التثبيت
عندما يشغّل برنامج GPG برنامج التثبيت، سيتلقّى الرمز المميّز للجلسة كوسيطة سطر أوامر.
- تنسيق الوسيطة:
--g_session_token=<TOKEN>
ما يجب فعله:
- الاستخراج: يجب أن يحلّل برنامج التثبيت وسيطات سطر الأوامر لاسترداد سلسلة الرمز المميّز.
- النشر: إذا كان مسار التثبيت يتضمّن تشغيل مشغّل ثانوي أو عملية لعبة، فإنّ أداة التثبيت تكون مسؤولة عن تمرير الرمز المميز للجلسة بأمان إلى عملية اللعبة النهائية التي تستخدم حزمة SDK.
- التشغيل: استخدِم الرمز المميز للجلسة المقدَّم لبدء تشغيل الملف التنفيذي للعبة. يضمن ذلك تشغيل اللعبة ضمن سياق GPG مصادَق عليه. وإلا، ستتعذّر عملية InitializeSDK وسيحتاج اللاعب إلى إعادة تشغيل اللعبة.
- تنسيق الوسيطة:
معالجة الأخطاء والحلول البديلة
- استرداد الرمز المميّز: إذا لم يتمكّن برنامج GPG لأي سبب من إنشاء رمز مميّز للجلسة أو تمريره (على سبيل المثال، تعذُّر إنشاء الرمز المميّز)، ستستمر عملية التثبيت. ومع ذلك، سيتم تشغيل أداة التثبيت بدون الوسيطة
--g_session_token. - المتانة: يجب تصميم أداة التثبيت للتعامل مع السيناريوهات التي لا يتوفّر فيها الرمز المميّز للجلسة. في هذه الحالات، يجب أن يواصل المثبِّت عملية التثبيت العادية، ولا يجب تشغيل اللعبة تلقائيًا لأنّ InitializeSDK سيتعذّر تشغيله على أي حال.
- أخطاء أداة التثبيت: أنت مسؤول عن قوة أداة التثبيت ومعالجة الأخطاء فيها وتسلسل تشغيل اللعبة الذي تبدأه. لا تتحكّم منصة GPG في العمليات التي تحدث داخل أداة التثبيت بعد تشغيلها.
- استرداد الرمز المميّز: إذا لم يتمكّن برنامج GPG لأي سبب من إنشاء رمز مميّز للجلسة أو تمريره (على سبيل المثال، تعذُّر إنشاء الرمز المميّز)، ستستمر عملية التثبيت. ومع ذلك، سيتم تشغيل أداة التثبيت بدون الوسيطة
-
نشر اللعبة باستخدام Play Console
بعد إنشاء حزمة WAB للعبتك بنجاح، حمِّلها إلى Play Console وأدِر إعداداتها ومتطلباتها. اتّبِع الخطوات التالية لنشر لعبتك:
إضافة شكل الجهاز في برنامج "ألعاب Google Play على الكمبيوتر"
هذه الخطوة مطلوبة فقط عند نشر لعبة لأول مرة.
- في Play Console، اختَر الاختبار والإصدار > الإعداد > الإعدادات المتقدّمة من القائمة اليمنى (رابط مباشر).
انتقِل إلى علامة التبويب أشكال الأجهزة وأضِف
Google Play Games on PCمن القائمة المنسدلة + إضافة شكل جهاز.انقر على زر إدارة المقابل لشكل الجهاز ألعاب Google Play على الكمبيوتر على يسار الصفحة.
حدِّد الخيار استخدام قناة إصدار مخصّصة للعبتك التي تتضمن حِزمة تطبيق Windows.
انقر على حفظ، ثم على حفظ مرة أخرى في مربّع حوار التأكيد.
تفعيل ميزة "النشر المُدار"
لتفعيل ميزة "النشر المُدار"، اتّبِع الخطوات التالية:
- في صفحة نظرة عامة على النشر، ضِمن قسم النشر المُدار، انقر على تفعيل ميزة "النشر المُدار".
- سيظهر مربع حوار. بدِّل إلى تفعيل ميزة "النشر المُدار" للقناة.
- انقر على حفظ.
تحميل ملف WAB
لتحميل ملف WAB، اتّبِع الخطوات التالية:
- في Play Console، اختَر الاختبار والإصدار > الإعدادات المتقدّمة من القائمة اليمنى (رابط مباشر).
- في صفحة الإعدادات المتقدّمة، انقر على علامة التبويب أشكال الأجهزة.
- في علامة التبويب أشكال الأجهزة، انقر على + إضافة شكل جهاز واختَر ألعاب Google Play على الكمبيوتر لإضافته.
- في قسم ألعاب Google Play على الكمبيوتر، انقر على إدارة.
- اختَر استخدام قناة إصدار مخصّصة للعبتك التي تتضمن حِزمة تطبيق Windows.
- انقر على حفظ.
- في القائمة اليمنى من Play Console، اختَر الاختبار والإصدار > الإصدار العلني (رابط مباشر).
- في صفحة الإصدار العلني، اختَر برنامج "ألعاب Google Play على الكمبيوتر" (لنظام Windows) فقط من القائمة المنسدلة الخاصة بشكل الجهاز.
- في علامة التبويب حزمة تطبيق Windows، انقر على تعديل وحمِّل ملف WAB.
ضبط متطلبات أجهزة كمبيوتر Windows
لضبط متطلبات أجهزة كمبيوتر Windows:
- في القائمة اليمنى من Play Console، اختَر زيادة عدد المستخدمين > التوفُّر في المتجر > إعدادات المتجر (رابط مباشر).
- في قسم متطلبات الكمبيوتر الشخصي، انقر على الزر تعديل على الجانب الأيسر.
- عدِّل الحقول وانقر على حفظ.
ضبط صورة عملية الشراء داخل التطبيق
هذه الخطوة اختيارية. لضبط صورة الشراء داخل التطبيق، اتّبِع الخطوات التالية:
- في القائمة اليمنى من Play Console، اختَر زيادة عدد المستخدمين > التوفُّر في المتجر > بطاقات بيانات المتجر (رابط مباشر).
- في قسم بطاقة بيانات المتجر التلقائية ضمن علامة التبويب بطاقات بيانات المتجر، انقر على الزر -> (السهم) على الجانب الأيسر. سيتم توجيهك إلى صفحة بطاقة بيانات المتجر التلقائية.
- انتقِل إلى قسم ألعاب Google Play على الكمبيوتر وحمِّل الصورة في صورة لعمليات الشراء داخل التطبيق في برنامج "ألعاب Google Play على الكمبيوتر" (Windows).
- انقر على حفظ.
إرسال التغييرات للمراجعة
- في القائمة اليمنى ضمن Play Console، انقر على نظرة عامة على النشر.
- في قسم التغييرات التي لم يتم إرسالها للمراجعة بعد، انقر على إرسال التغييرات لمراجعتها.
بعد أن يوافق فريق المراجعة على التغييرات، ستصبح لعبتك قابلة للاكتشاف على Google Play.