قائمة التحقّق من الإطلاق

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

إعداد مشروعك وضبطه

  • تنزيل حزمة تطوير البرامج (SDK) واستيرادها: ادمِج أحدث إصدار من حزمة تطوير البرامج (SDK) لـ "ألعاب Play على الكمبيوتر" مع بيئتك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل Unity أو دليل C++‎.
  • إنشاء ملف بيان التطبيق: أنشئ ملف manifest.xml يربط <PackageName> بحزمة Play Console التي تم إثبات ملكيتها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل البيان.
  • توقيع الملف التنفيذي رقميًا: وقِّع لعبتك باستخدام توقيع رقمي من Authenticode واحتفِظ بالشهادة لجميع التحديثات المستقبلية. على الرغم من أنّه يمكنك تخطّي هذه الخطوة أثناء التطوير المحلي من خلال تفعيل وضع مطور البرامج، عليك توقيع البرنامج الثنائي النهائي باستخدام شهادة إنتاج فعلية من جهة إصدار شهادات معروفة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توقيع لعبتك رقميًا.
  • تنسيق الشهادة وإرسالها: أرسِل معلومات الشهادة إلى ممثل Google. يجب أن يحتوي ملف الشهادة على معلومات ذات صلة بالشهادة فقط، لذا تأكَّد من إزالة جميع الأقسام غير المتعلقة بالشهادة. يمكنك استخدام OpenSSL لتحويل ملفات DER/CER إلى تنسيق PEM المطلوب.

دمج واجهات برمجة التطبيقات والميزات

  • إعداد حزمة تطوير البرامج (SDK): نفِّذ منطق إعداد حزمة تطوير البرامج (SDK)، مثل InitializeAsync، أثناء بدء التشغيل قبل استخدام الميزات الأخرى. لمزيد من المعلومات، اطّلِع على دليل الإعداد.
  • تنفيذ عملية تسجيل الدخول السريع: يمكنك مصادقة اللاعبين تلقائيًا باستخدام حساب عميل &quot;ألعاب Play&quot; من خلال Recall API. لمزيد من المعلومات، يمكنك الاطّلاع على دليل "تسجيل الدخول السلس".
  • دمج واجهة برمجة التطبيقات Play Integrity: استخدِم IntegrityClient لطلب الرموز المميزة والتأكّد من شرعية جلسات اللعبة على الخلفية. لمزيد من المعلومات، يُرجى الاطّلاع على دليل Play Integrity.
  • إضافة واجهة برمجة التطبيقات Play Install Referrer: يمكنك دمج واجهة برمجة التطبيقات Install Referrer إذا كنت بحاجة إلى تتبُّع مصادر اكتساب المستخدمين على الكمبيوتر. لمزيد من المعلومات، يُرجى الاطّلاع على دليل Install Referrer.
  • التعامل مع أخطاء التهيئة: لاستخدام حزمة تطوير البرامج (SDK)، عليك طلب GooglePlayInitialize (C++) أو GooglePlayInitialization.InitializeAsync (C#) لتهيئة واجهة برمجة التطبيقات. ويجب طلب هذا الرمز والتحقّق من اكتمال معاودة الاتصال مع InitializeResult::ok() (C++) أو Result.IsOk (C#) مع عرض true قبل أن تتمكّن من استخدام أي واجهة برمجة تطبيقات أخرى.
  • التعامل مع الإيقاف الإجباري: تعامَل مع kActionRequiredShutdownClientProcess من خلال إيقاف عملية العميل في أقرب وقت ممكن.
  • التعامل مع متطلبات تثبيت "ألعاب Google Play": يجب التعامل مع kSdkRuntimeUnavailable من خلال إعلام المستخدمين بأنّه يجب تثبيت "ألعاب Google Play" ووقت تشغيل حزمة SDK لمواصلة اللعب.
  • التعامل مع تحديثات "ألعاب Google Play": تعامَل مع kSdkRuntimeUpdateRequired من خلال إعلام المستخدمين بأنّه يجب تحديث وقت تشغيل "ألعاب Google Play".

تنفيذ "الفوترة في Play"

  • التحقّق من أنواع عمليات الشراء: تأكَّد من أنّ لعبتك تعتمد فقط على عمليات الشراء داخل التطبيق، لأنّ الدفعات المتكرّرة والاشتراكات غير متاحة. لمزيد من المعلومات، اطّلِع على الأسئلة الشائعة حول الفوترة.
  • طلب تفاصيل المنتج: استخدِم QueryProductDetails لاسترداد بيانات المتجر المترجمة. إذا كان لديك أكثر من 50 منتجًا، قسِّم الطلب إلى عدة طلبات. لمزيد من المعلومات، يُرجى الاطّلاع على دليل منتجات طلب البحث.
  • بدء عملية الشراء: استخدِم LaunchPurchaseFlow لمعالجة المعاملات بشكل أصلي. سيحدث خطأ انتهاء المهلة بعد خمس دقائق إذا أغلقت متصفّح الدفع بدون الدفع. لمزيد من المعلومات، راجِع دليل عملية الشراء.
  • استعادة عمليات الشراء الحالية: استدعِ الدالة QueryPurchases عند بدء التشغيل وعند عرض التطبيق في المقدّمة لتسجيل عمليات الشراء التي لم يتم الإقرار بها على أجهزة متعددة. لمزيد من المعلومات، اطّلِع على دليل استعادة عمليات الشراء.
  • المعالجة الآمنة في الخلفية: تحقَّق من صحة purchaseToken في الخلفية قبل منح الأذونات وإكمال العملية باستخدام AcknowledgePurchase أو ConsumePurchase. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المعالجة الآمنة.

الاختبار في وضع مطور البرامج وإجراء عملية تأكيد الجودة قبل الإطلاق

  • الاختبار في وضع مطور البرامج: أضِف <IsDeveloperMode>true</IsDeveloperMode> إلى ملف البيان، واضبط المعرّف الفريد العالمي (GUID) لشريك برنامج الاستخدام قبل الإطلاق لإجراء اختبارات في بيئة التطوير المتكاملة (IDE) المحلية. إذا لم يكن لديك معرّف فريد عالمي (GUID) لشريك برنامج الاستخدام قبل الإطلاق، يُرجى ملء نموذج إبداء الاهتمام.
  • إدارة عمليات الشراء في وضع مطور البرامج: عند اختبار عمليات الشراء في وضع مطور البرامج، استهلك عملية الشراء في غضون ثلاث دقائق لتجنُّب ردّ الأموال تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول الاختبار.
  • إزالة وضع مطور البرامج: يجب إزالة العلامة <IsDeveloperMode> قبل حزمة محتوى التطبيق بنية الإصدار في أقرب وقت ممكن. لمزيد من المعلومات، راجِع دليل وضع مطور البرامج.
  • توجيه وسيطات باستخدام مشغّلات تابعة لجهات خارجية: يتم تمرير جميع وسيطات سطر الأوامر غير المعروفة التي يتلقّاها المشغّل من عميل &quot;ألعاب Google Play&quot; مباشرةً إلى عملية اللعبة التي تم إنشاؤها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل العمليات المتعددة.
  • الاختبار باستخدام شبكة VPN: إذا كنت تختبر من منطقة غير متوافقة، استخدِم شبكة VPN مع تفعيل وضع TUN للحصول على عنوان IP متوافق. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول اختبار شبكة VPN.
  • توافُق اختصارات سطح المكتب: للاطّلاع على معلومات حول التوافق السلس مع الاختصارات، يُرجى الرجوع إلى الأسئلة الشائعة حول الاختصارات بشأن تنفيذ الاختصارات. قد يؤدي تشغيل اللعبة أو مشغّل تابع لجهة خارجية مباشرةً باستخدام اختصار إلى حدوث أخطاء في التهيئة.

تجميع لعبتك واختبارها ونشرها

  • تعبئة حِزمة تطبيق Windows‏ (WAB): استخدِم "أداة النشر على Play" لتعبئة لعبتك في حِزمة تطبيق Windows‏ (WAB). يجب أن يكون حجم ملف WAB أقل من الحد الأقصى المسموح به وهو 10 غيغابايت. لمزيد من المعلومات، اطّلِع على دليل التعبئة.
  • تأكَّد مما إذا كان يجب منح امتيازات إضافية: إذا كان يجب تشغيل أداة التثبيت أو مشغّل التطبيقات أو أداة إلغاء التثبيت كمسؤول في كل مرة يتم تشغيلها، تذكَّر التحقّق مما إذا كنت قد ضبطت INSTALLER_REQUIRES_ELEVATION أو LAUNCHER_REQUIRES_ELEVATION أو UNINSTALLER_REQUIRES_ELEVATION على true. وبخلاف ذلك، لن يتم تشغيلها بامتيازات المشرف، ما سيؤدي إلى تعذُّر بدء التشغيل. لمزيد من التفاصيل، يُرجى الاطّلاع على تنسيق ملف إعداد WAB.
  • إرسال مثبّتات مشغّلات التطبيقات التابعة لجهات خارجية: إذا كنت تستخدم مشغّل تطبيقات تابعًا لجهة خارجية، أرسِل المثبّت الخاص به داخل حزمة التطبيق على Wear OS. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نشر برنامج التثبيت.
  • التعامل مع الرمز المميز لجلسة "اللعب التلقائي": إذا فعّلت ميزة "اللعب التلقائي" من خلال ضبط acceptsCommandLineArguments="true" في play_publishing_config.xml، تأكَّد من أنّ برنامج التثبيت يستخرج وسيطة سطر الأوامر --g_session_token=<token> ويستخدمها لتشغيل اللعبة. تأكَّد من أنّ برنامج التثبيت يتعامل مع حالة الرجوع إلى الإصدار السابق التي لا يتوفّر فيها الرمز المميز. لمزيد من المعلومات، اطّلِع على الأسئلة الشائعة حول مشغّل التطبيق.
  • تحديث اللعبة والمشغّل أو أداة التثبيت: يجب أن يكون محتوى الحزمة قابلاً للتحديث تلقائيًا، بما في ذلك أدوات تثبيت المشغّل. إدارة جميع الموارد التي تحتاج إليها لعبتك، بما في ذلك تحديث مشغّل التطبيق نفسه
  • مشاركة معلومات الإطلاق مع Google: تواصَل مع شريكك في Play وشارِك اسم الحزمة وبلدان الإطلاق (باستخدام رموز ISO المكوّنة من حرفَين، مثل الولايات المتحدة وكندا والمكسيك) وتاريخ الإطلاق ووقته بالتوقيت العالمي المنسَّق (UTC).
  • إعداد إذن الوصول إلى الاختبار: قدِّم مجموعة Google خارجية لإضافتها إلى قائمة السماح الخاصة بالاختبار والوثائق وإمكانية الوصول إلى Google Drive. شارِك قائمة بعناوين البريد الإلكتروني الخاصة بحسابات الاختبار مع شريكك في Play، لأنّ قنوات الاختبار في Play Console غير متاحة على أجهزة الكمبيوتر.
  • إضافة شكل الجهاز المخصّص للكمبيوتر: أضِف بشكل صريح شكل الجهاز المخصّص لبرنامج "ألعاب Google Play على الكمبيوتر" إلى تطبيقك في Google Play Console. إذا لم تتمكّن من الوصول إلى علامة التبويب هذه، تواصَل مع شريكك في Play لإضافة حسابك إلى قائمة السماح.
  • إعداد متطلبات أجهزة الكمبيوتر: أدخِل متطلبات الأجهزة (ذاكرة الوصول العشوائي ووحدة معالجة الرسومات والتخزين) لأجهزة كمبيوتر Windows. لمزيد من المعلومات، اطّلِع على دليل متطلبات أجهزة الكمبيوتر.
  • تحميل مواد عرض المتجر: حمِّل ملف WAB المضغوط إلى مسار الإصدار العلني وأعِدّ مواد العرض المرئية. لمزيد من المعلومات، راجِع دليل تحميل مواد العرض.
  • النشر لاختبار بيئة المستخدم: انقر على نشر في Google Play Console. على عكس إصدار Android، لا يؤدي النقر على نشر في WAB إلى طرح إصدار علني. بدلاً من ذلك، يتيح هذا الخيار البحث عن التطبيق من خلال حسابات الاختبار المشتركة لإجراء الاختبارات في بيئة المستخدم بعد انتهاء عملية المراجعة في Google.
  • الإطلاق الرسمي: تتحكّم Google في عملية الإطلاق استنادًا إلى تاريخ الإطلاق الرسمي الذي شاركته مع شريكك في Play.
  • الاختبار أثناء التسجيل المُسبَق: خلال مرحلة التسجيل المُسبَق، يجب إجراء اختبار داخلي في بلد غير مضمَّن في مناطق التسجيل المُسبَق المحدَّدة.
  • التحقّق من إنهاء عملية المثبّت: تأكَّد من أنّ عملية المثبّت الأساسية تظل نشطة إلى أن يتم إنشاء جميع مفاتيح التسجيل المطلوبة وتسجيلها. إذا خرجت العملية قبل الأوان، لن تنجح عملية التحقّق من التثبيت. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نشر حِزم التثبيت.

نقل البيانات من واجهة برمجة التطبيقات إلى حزمة تطوير البرامج (SDK)

يُعدّ نقل البيانات من واجهة برمجة التطبيقات إلى حزمة تطوير البرامج (SDK) خطوة اختيارية. إذا اخترت نقل البيانات، اتّبِع التوصيات التالية:

  • إزالة واجهات REST API القديمة: يمكنك ربط طلبات واجهة Play Developer API القديمة (مثل purchases.products.get) بوظائف حزمة Native SDK من جهة العميل. لمزيد من المعلومات، اطّلِع على دليل نقل البيانات.
  • التحقّق من وسيطات سطر الأوامر: قد تختلف وسيطات سطر الأوامر في بيئة حزمة تطوير البرامج (SDK) عن تلك الموجودة في بيئة واجهة برمجة التطبيقات. تأكَّد من أنّ الحزمة تعالج جميع الوسيطات وتمرّرها بشكل صحيح. لمزيد من المعلومات، راجِع التحقّق.
  • التحقّق من مسار السجلّ: لضمان نقل البيانات بسلاسة إلى حزمة تطوير البرامج (SDK) الأصلية، يجب أن يظلّ إعداد السجلّ متوافقًا مع الإصدارات السابقة. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ملف WAB.

انظر أيضًا