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

استخدِم قائمة التحقّق هذه للتأكّد من أنّ لعبتك تستوفي جميع المتطلبات وأفضل الممارسات قبل إرسالها للمراجعة في برنامج "ألعاب 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 إذا كنت بحاجة إلى تتبُّع مصادر اكتساب المستخدمين على الكمبيوتر. لمزيد من المعلومات، يُرجى الاطّلاع على دليل "المُحيل إلى التثبيت".
  • التعامل مع أخطاء الإعداد: لاستخدام حزمة 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. لمزيد من المعلومات، يُرجى الاطّلاع على دليل المعالجة الآمنة.
  • احتساب تأخير نشر مفتاح الترخيص: عند إعداد مفاتيح جديدة للفوترة أو الترخيص في Play Console، يجب الانتظار لعدّة ساعات حتى تتم مزامنة ذاكرة التخزين المؤقت للخادم الخلفي في جميع بيئات عرض التجارة قبل إجراء اختبارات الشراء المباشر. ستعرض عمليات الشراء التي تتم قبل اكتمال المزامنة الرمز 6 للخطأ.

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

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

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

  • تعبئة حِزمة تطبيق Windows: استخدِم "أداة النشر على Play" لتعبئة لعبتك في حِزمة تطبيق Windows. يجب أن يكون حجم ملف WAB أقل من الحد الأقصى المسموح به وهو 10 غيغابايت عند استخدام ميزة "النشر من خلال أداة التثبيت"، و200 غيغابايت عند استخدام ميزة "النشر المُدار في Play". لمزيد من المعلومات، يُرجى الاطّلاع على دليل التغليف.
  • استخدام أحدث حِزم SDK والأدوات: يمكنك تجميع إصدارك وحزمه باستخدام أحدث الإصدارات من حزمة SDK الخاصة بـ &quot;ألعاب Play على الكمبيوتر&quot; وحزمة Unity SDK الخاصة بـ &quot;ألعاب Play على الكمبيوتر&quot; وأداة المطوّرين الخاصة بـ &quot;ألعاب Play على الكمبيوتر&quot; وأداة النشر على Play.
  • تأكيد ما إذا كان يجب منح امتيازات إضافية: إذا كان يجب تشغيل أداة التثبيت أو المشغّل أو أداة إلغاء التثبيت بصفتك مشرفًا في كل مرة يتم تشغيلها، تذكَّر التحقّق مما إذا كنت قد ضبطت INSTALLER_REQUIRES_ELEVATION أو LAUNCHER_REQUIRES_ELEVATION أو UNINSTALLER_REQUIRES_ELEVATION على true. وبخلاف ذلك، لن يتم تشغيلها بامتيازات المشرف، ما سيؤدي إلى تعذُّر بدء التشغيل. لمزيد من التفاصيل، يُرجى الاطّلاع على تنسيق ملف إعداد WAB.
  • إرسال مثبّتات مشغّلات التطبيقات التابعة لجهات خارجية: إذا كنت تستخدم مشغّل تطبيقات تابعًا لجهة خارجية، أرسِل المثبّت الخاص به داخل حزمة التطبيق على Android. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نشر برنامج التثبيت.
  • التعامل مع الرمز المميز لجلسة "التشغيل التلقائي": إذا فعّلت ميزة "التشغيل التلقائي" من خلال ضبط 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 API القديمة: يمكنك ربط طلبات Play Developer API القديمة (مثل purchases.products.get) بوظائف حزمة Native SDK من جهة العميل. لمزيد من المعلومات، اطّلِع على دليل نقل البيانات.
  • التحقّق من وسيطات سطر الأوامر: قد تختلف وسيطات سطر الأوامر في بيئة حزمة تطوير البرامج (SDK) عن تلك الموجودة في بيئة واجهة برمجة التطبيقات. تأكَّد من أنّ الحزمة تعالج جميع الوسيطات وتمرّرها بشكل صحيح. لمزيد من المعلومات، راجِع إثبات صحة المعلومات.
  • التحقّق من مسار السجلّ: لضمان عملية نقل سلسة إلى حزمة SDK الأصلية، يجب أن يظلّ إعداد السجلّ متوافقًا مع الإصدارات السابقة. لمزيد من المعلومات، يُرجى الاطّلاع على دليل ملف WAB.

انظر أيضًا