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

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

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

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

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

  • تهيئة حزمة تطوير البرامج (SDK): يمكنك تنفيذ منطق تهيئة حزمة تطوير البرامج (SDK)، مثل InitializeAsync، أثناء بدء التشغيل قبل استخدام ميزات أخرى. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التهيئة.
  • تنفيذ ميزة تسجيل الدخول السلس: يمكنك مصادقة اللاعبين تلقائيًا باستخدام حساب عميل "ألعاب Play" من خلال واجهة 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> قبل تجميع إصدارك في أقرب وقت ممكن. لمزيد من المعلومات، يُرجى الاطّلاع على دليل وضع المطوّر.
  • إعادة توجيه الوسيطات باستخدام مشغّلات خارجية: يمكنك تمرير جميع وسيطات سطر الأوامر غير المعروفة التي يتلقّاها المشغّل من عميل "ألعاب Google Play" مباشرةً إلى عملية اللعبة التي تم إنشاؤها. لمزيد من المعلومات، يُرجى الاطّلاع على دليل العمليات المتعدّدة.
  • الاختبار باستخدام شبكة VPN: إذا كنت تختبر من منطقة غير متاحة، يمكنك استخدام شبكة VPN مع تفعيل وضع TUN للحصول على عنوان IP متاح. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول اختبار شبكة VPN.
  • توفير دعم لاختصارات سطح المكتب: لتوفير دعم سلس للاختصارات، يُرجى الاطّلاع على الأسئلة الشائعة حول الاختصارات لمعرفة معلومات عن تنفيذ الاختصارات. قد يؤدي تشغيل اللعبة أو مشغّل خارجي مباشرةً باستخدام اختصار إلى حدوث أخطاء في التهيئة.

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

  • تجميع حزمة تطبيق Windows‏ (WAB): يمكنك استخدام أداة Play Publishing Tool لتجميع لعبتك في حزمة تطبيق Windows‏ (WAB). يجب أن يكون حجم ملف WAB أقل من الحد الأقصى لحجم الملف البالغ 10 غيغابايت. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التجميع.
  • التأكّد مما إذا كان يجب التشغيل كمسؤول: إذا كان يجب تشغيل أداة التثبيت أو المشغّل أو أداة إلغاء التثبيت كمسؤول في كل مرة يتم تشغيلها، يُرجى التأكّد مما إذا تم ضبط INSTALLER_REQUIRES_ELEVATION أو LAUNCHER_REQUIRES_ELEVATION أو UNINSTALLER_REQUIRES_ELEVATION على true. بخلاف ذلك، لن يتم تشغيلها بامتيازات المشرف، ما سيؤدي إلى تعذُّر بدء التشغيل. لمزيد من التفاصيل، يُرجى الاطّلاع على تنسيق ملف إعدادات WAB.
  • إرسال أدوات تثبيت المشغّلات الخارجية: إذا كنت تستخدم مشغّلًا خارجيًا، عليك إرسال أداة التثبيت الخاصة به داخل حزمة WAB. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نشر أداة التثبيت.
  • التعامل مع رمز جلسة "التشغيل التلقائي": إذا فعّلت ميزة "التشغيل التلقائي" من خلال ضبط acceptsCommandLineArguments="true" في play_publishing_config.xml، يُرجى التأكّد من أنّ أداة التثبيت تستخرج وسيطة سطر الأوامر --g_session_token=<token> وتستخدمها لتشغيل اللعبة. يُرجى التأكّد من أنّ أداة التثبيت تتعامل مع الحالة الاحتياطية التي لا يكون فيها الرمز متاحًا. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة حول المشغّل.
  • تحديث اللعبة والمشغّل أو أداة التثبيت: يجب أن يكون محتوى الحزمة، بما في ذلك أدوات تثبيت المشغّل، قابلاً للتحديث الذاتي. يمكنك إدارة جميع الموارد التي تحتاجها لعبتك، بما في ذلك تحديث المشغّل نفسه.
  • مشاركة معلومات الإطلاق مع Google: يُرجى التواصل مع شريكك في Play ومشاركة اسم الحزمة وبلدان الإطلاق (باستخدام رموز مكوّنة من حرفَين وفقًا للمعيار ISO، مثل US وCA وMX) وتاريخ الإطلاق ووقته بالتوقيت العالمي المنسَّق (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 القديمة: يمكنك ربط استدعاءات واجهة برمجة التطبيقات القديمة لـ Play Developer API (مثل purchases.products.get) بوظائف حزمة تطوير البرامج (SDK) الأصلية من جهة العميل. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نقل البيانات.
  • التحقّق من وسيطات سطر الأوامر: قد تختلف وسيطات سطر الأوامر في بيئة حزمة تطوير البرامج (SDK) عن تلك الموجودة في بيئة واجهة برمجة التطبيقات. يُرجى التأكّد من أنّ الحزمة تتعامل مع جميع الوسيطات وتمرّرها بشكلٍ صحيح. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحقّق.
  • التحقّق من مسار التسجيل: لإجراء عملية نقل سلسة إلى حزمة تطوير البرامج (SDK) الأصلية، يجب أن يظل إعداد التسجيل متوافقًا مع الإصدارات السابقة. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ملف WAB.

انظر أيضًا