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

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

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

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

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

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

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

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

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

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

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

  • تجميع حزمة WAB: استخدِم أداة Play Publishing Tool لتجميع لعبتك في حزمة Windows App Bundle ‏(WAB). يجب أن يكون حجم ملف WAB أقل من 10 غيغابايت للنشر من خلال أداة التثبيت، وأقل من 200 غيغابايت للنشر المُدار على Google Play. لمزيد من المعلومات، يُرجى الاطّلاع على دليل حِزم المحتوى.
  • استخدام أحدث حِزم تطوير البرامج (SDK) والأدوات: يمكنك تجميع إصدارك وحزمه باستخدام أحدث إصدارات حزمة تطوير البرامج (SDK) للكمبيوتر الشخصي في "ألعاب Play"، وحزمة تطوير البرامج (SDK) في Unity للكمبيوتر الشخصي في "ألعاب Play"، وأداة المطوّرين للكمبيوتر الشخصي في Play، وأداة النشر في Play.
  • التأكّد من الحاجة إلى رفع مستوى الأذونات: إذا كان برنامج التثبيت أو مشغّل التطبيقات أو برنامج إلغاء التثبيت يحتاج إلى التشغيل كمسؤول في كل مرة يتم تشغيله فيها، يُرجى التأكّد من ضبط 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.
  • إجراء الاختبارات أثناء التسجيل المُسبَق: خلال مرحلة التسجيل المُسبَق، يجب إجراء اختبار داخلي في بلد غير مُدرَج في المناطق التي اخترتها للتسجيل المُسبَق.
  • التحقّق من إنهاء عملية التثبيت: تأكَّد من أنّ عملية التثبيت الأساسية تظل نشطة إلى أن يتم إنشاء جميع مفاتيح السجلّ المطلوبة وتسجيلها. إذا تم الخروج من العملية قبل الأوان، سيتعذّر التحقّق من التثبيت. لمزيد من المعلومات، يُرجى الاطّلاع على نشر أداة التثبيت.
  • الحفاظ على اتساق خلايا السجلّ وتنظيفها عند إلغاء التثبيت: يتحقّق برنامج "ألعاب Google Play على الكمبيوتر" من HKEY_LOCAL_MACHINE قبل HKEY_CURRENT_USER ويستخدم أول قيمة مطابقة. يجب الحفاظ على اتساق خلية السجلّ في جميع التحديثات وعناوين مشغّلات الألعاب المشتركة، وإزالة مفاتيح السجلّ أثناء إلغاء التثبيت حتى لا تحجب إدخالات HKEY_LOCAL_MACHINE القديمة مسارات HKEY_CURRENT_USER الصالحة. لمزيد من المعلومات، يُرجى الاطّلاع على نشر أداة التثبيت.

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

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

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

انظر أيضًا