توضّح هذه الصفحة كيفية تحديد المشاكل التي قد تواجهها أثناء تطوير ألعاب Android باستخدام "خدمات ألعاب Google Play" وحلّها.
تسجيل
لتحديد المشاكل وحلّها في لعبتك، يمكنك تفعيل التسجيل المطوَّل على جهازك باستخدام الأمر adb shell. يمكنك بعد ذلك عرض رسائل السجلّ الخاصة بـ "خدمات ألعاب Google Play" باستخدام logcat.
تفعيل التسجيل
لتفعيل التسجيل على الجهاز الاختباري:
وصِّل الجهاز بجهاز كمبيوتر تم تثبيت حزمة تطوير البرامج (SDK) لنظام التشغيل Android عليه.
افتح وحدة طرفية ونفِّذ الأمر التالي:
adb shell setprop log.tag.Games VERBOSEشغِّل لعبتك على الجهاز وأعِد تنفيذ الإجراءات التي أدت إلى المشكلة التي تحاول تصحيح أخطائها.
اعرض السجلّات:
adb logcat
إيقاف التسجيل
لإيقاف التسجيل المطوَّل في "خدمات ألعاب Play" على جهازك والعودة إلى التسجيل الأصلي، نفِّذ الأمر التالي:
adb shell setprop log.tag.Games INFO
تعذرت المصادقة
إذا لم تتمكّن من مصادقة هوية اللاعبين في لعبتك، تأكَّد أولاً من اتّباع التعليمات الخاصة بإنشاء أرقام تعريف العملاء وإعداد خدمات الألعاب. إذا استمرت أخطاء المصادقة، راجِع العناصر التالية للتأكّد من إعداد لعبتك بشكل صحيح.
التحقّق من علامات البيانات الوصفية
يجب أن يحتوي ملف AndroidManifest.xml على علامة بيانات وصفية للألعاب. للتأكّد من إعداد علامات البيانات الوصفية بشكلٍ صحيح:
افتح
AndroidManifest.xmlوتأكَّد من أنّه يحتوي على علامةmeta-dataكما هو موضّح أدناه:<meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id" />ابحث عن تعريف المورد
@string/app_id. يتم عادةً تعريفه في ملف XML موجود في الدليلres/xml، مثلres/xml/strings.xmlأوres/xml/ids.xml.تأكَّد من أنّ قيمة المورد
@string/app_idتتطابق مع رقم تعريف تطبيقك. يجب أن تحتوي قيمة هذا المورد على أرقام فقط. على سبيل المثال:<string name="app_id">123456789012</string>
التحقّق من اسم الحزمة
يجب أن يتطابق اسم حزمة لعبتك مع اسم الحزمة في رقم تعريف العميل. لإثبات صحة اسم الحزمة:
افتح
AndroidManifest.xmlوتأكَّد من صحة اسم حزمة لعبتك. اسم الحزمة هو قيمة السمةpackageفي علامةmanifest.تأكَّد من اسم الحزمة الذي قدّمته عند إنشاء رقم تعريف العميل. لتأكيد اسم الحزمة في Google Play Console، انتقِل إلى Play Console وانقر على الإدخال الذي يتوافق مع لعبتك.
انتقِل إلى علامة التبويب التطبيقات المرتبطة واطّلِع على قائمة أرقام تعريف العملاء. يجب أن يتضمّن هذا التطبيق تطبيقًا مرتبطًا على Android يتطابق اسم الحزمة فيه مع اسم الحزمة في
AndroidManifest.xml. في حال عدم التطابق، أنشئ معرِّف عميل جديد باسم الحزمة الصحيح وحاوِل المصادقة مرة أخرى.
التحقّق من الملف المرجعي للشهادة
يجب أن تتطابق الشهادة التي يتم من خلالها المصادقة على لعبتك مع بصمة الشهادة المرتبطة رقم تعريف العميل. للتأكّد من ذلك، عليك أولاً التحقّق من الملف المرجعي لشهادة SHA-1 على النحو التالي:
ابحث عن ملف الشهادة واحصل على الملف المرجعي لشهادة SHA-1. للحصول على بصمة SHA-1، نفِّذ الأمر التالي:
keytool -exportcert -alias your-key-name -keystore /path/to/your/keystore/file -list -vانسخ تسلسل الأرقام السداسية العشرية التي تحمل التصنيف
SHA1:في ناتج الأمر. هذا هو الملف المرجعي لشهادتك.
بعد ذلك، تأكَّد من أنّ أداة الإنشاء تستخدم هذه الشهادة:
- أنشئ حِزمة APK للعبة من أداة الإصدار ووقِّعها باستخدام الشهادة المطلوبة. انسخ حِزمة APK التي تم إنشاؤها إلى دليل مؤقت.
في الدليل المؤقت، نفِّذ الأمر التالي لاستخراج حزمة APK.
unzip YourGame.apkأنشئ مفتاحًا خاصًا باستخدام ملف شهادة RSA:
keytool -printcert -file META-INF/CERT.RSAبدلاً من ذلك، يمكنك إنشاء المفتاح الخاص باستخدام ملف شهادة DSA:
keytool -printcert -file META-INF/CERT.DSAلاحظ تسلسل الأرقام السداسية العشرية في السطر الذي يحمل التصنيف
SHA1:.يجب أن يتطابق تسلسل الأرقام هذا مع الملف المرجعي للشهادة من الخطوة السابقة. في حال عدم التطابق، يعني ذلك أنّ أداة الإصدار أو النظام غير مضبوطَين لتوقيع تطبيقك باستخدام شهادتك. في هذه الحالة، راجِع مستندات بيئة الإصدار لتحديد كيفية إعدادها بشكل صحيح وحاوِل إثبات الهوية مرة أخرى.
بعد ذلك، تحقَّق مما إذا كان الملف المرجعي للشهادة يتطابق مع البصمة التي تم ضبطها في رقم تعريف العميل. ولإجراء ذلك:
- افتح Play Console وانتقِل إلى لعبتك.
- في صفحة تفاصيل اللعبة، انتقِل إلى أسفل الصفحة وانقر على الرابط المؤدي إلى مشروع Google Cloud المرتبط.
- اختَر مشروعك.
- في الشريط الجانبي الأيمن، انقر على واجهات برمجة التطبيقات والمصادقة. تأكَّد من أنّ حالة واجهة برمجة التطبيقات لخدمات "ألعاب Google Play" هي مفعَّلة في قائمة واجهات برمجة التطبيقات المعروضة.
- في الشريط الجانبي على يمين الصفحة، اختَر التطبيقات المسجّلة.
- وسِّع قسم "رقم تعريف العميل OAuth 2.0" وانسخ رقم الملف المرجعي للشهادة (SHA1).
إذا لم تتطابق هذه البصمة مع الملف المرجعي للشهادة من الخطوات السابقة، عليك إنشاء رقم تعريف عميل جديد باستخدام الملف المرجعي للشهادة الصحيح. يجب إنشاء معرِّف العميل الجديد في Play Console، وليس في مشروع Google Cloud.
التأكّد من تفعيل الحسابات الاختبارية
قبل نشر لعبة، يجب تفعيل الحساب الذي أنشأ اللعبة في Play Console كحساب مختبِر أيضًا. للتأكّد من إعداد هذه الميزة بشكل صحيح:
- افتح Play Console وانتقِل إلى لعبتك.
- افتح علامة التبويب الاختبار.
- تأكَّد من أنّ الحساب الذي تحاول المصادقة باستخدامه مُدرَج في قائمة المختبِرين.
إذا لم يكن الحساب الذي تحاول المصادقة باستخدامه مدرجًا، أضِفه إلى القائمة، وانتظر بضع دقائق وحاول المصادقة مرة أخرى.
مشاكل Proguard
إذا كنت تستخدم Proguard وظهرت لك أخطاء في حزمة APK التي تم تشويشها، تحقَّق من مستوى واجهة برمجة التطبيقات المستهدَف في AndroidManifest.xml. تأكّد من تحديث الأداة إلى الإصدار 17 أو إصدار أحدث.
أسباب أخرى لمشاكل الإعداد
تحقَّق من الأسباب الشائعة الأخرى للأخطاء:
- إذا كانت لعبتك منشورة، تأكَّد من نشر إعدادات اللعبة أيضًا (من الممكن نشر التطبيق بدون نشر إعدادات الألعاب). لإجراء ذلك، انتقِل إلى Google Play Console، ثم إلى تطبيقك، وتأكَّد من أنّ المربّع بجانب اسم اللعبة يشير إلى أنّها منشورة. إذا كانت تشير إلى حالة أخرى، مثل "جاهز للنشر" أو "جاهز للاختبار"، انقر على المربّع واختَر نشر اللعبة.
- إذا تعذّر عليك نشر لعبتك، تأكَّد من تفعيل الخيار يُفضّل استخدام هذا التطبيق في عمليات التثبيت الجديدة لمعرِّف عميل واحد فقط.
متتبِّعات الأحداث المجهولة
يُرجى عدم استخدام هذه المتتبِّعات. متتبِّعات الأحداث المجهولة هي عمليات تنفيذ لواجهة المتتبِّع يتم تعريفها بشكل مضمَّن، كما هو موضَّح أدناه.
ImageManager im = ...;
// Anonymous listener -- dangerous:
im.loadImage(new ImageManager.OnImageLoadedListener() {
@Override
public void onImageLoaded(Uri uri, Drawable drawable) {
// ...code...
}
}
لا يمكن الاعتماد على متتبِّعات الأحداث المجهولة لأنّ حزمة تطوير البرامج (SDK) في "ألعاب Play" تحتفظ بها كمرجع ضعيف، ما يعني أنّ وحدة تجميع البيانات المهملة قد تحذفها من الذاكرة قبل استدعائها. بدلاً من ذلك، يجب تنفيذ متتبِّع باستخدام عنصر ثابت، مثل Activity.
public class MyActivity extends Activity
implements ImageManager.OnImageLoadedListener {
private void loadOurImages() {
ImageManager im = ...;
im.loadImage(this);
}
@Override
public void onImageLoaded(Uri uri, Drawable drawable) {
// ...code...
}
}