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

استخدِم قائمة التحقّق هذه للتأكّد من أنّ لعبتك تستوفي جميع المتطلبات وأفضل الممارسات قبل إرسالها للمراجعة في برنامج "ألعاب 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 API إذا كنت بحاجة إلى تتبُّع مصادر اكتساب المستخدمين على الكمبيوتر. لمزيد من المعلومات، يُرجى الاطّلاع على دليل 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: استخدِم "أداة النشر على Play" لتعبئة لعبتك في حِزمة تطبيق Windows. يجب أن يكون حجم ملف WAB أقل من الحد الأقصى المسموح به وهو 10 غيغابايت. لمزيد من المعلومات، اطّلِع على دليل التغليف.
  • إرسال مثبّتات مشغّلات التطبيقات التابعة لجهات خارجية: إذا كنت تستخدم مشغّل تطبيقات تابعًا لجهة خارجية، أرسِل المثبّت الخاص به داخل حزمة التطبيق على Wear OS. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نشر برنامج التثبيت.
  • تحديث اللعبة والمشغّل أو أداة التثبيت: يجب أن يكون محتوى الحزمة قابلاً للتحديث الذاتي، بما في ذلك أدوات تثبيت المشغّل. إدارة جميع الموارد التي تحتاجها لعبتك، بما في ذلك تحديث مشغّل التطبيق نفسه
  • مشاركة معلومات الإطلاق مع 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.

انظر أيضًا