בדף הזה מוסבר איך לפתור בעיות שאתם עלולים להיתקל בהן בזמן פיתוח משחקים ל-Android באמצעות Google Play Games Services.
רישום ביומן
כדי לפתור בעיות במשחק, אתם יכולים להפעיל רישום מפורט ביומן במכשיר באמצעות הפקודה adb shell. לאחר מכן תוכלו לראות את הודעות היומן של Google Play Games Services באמצעות logcat.
הפעלת רישום
כדי להפעיל את הרישום ביומן במכשיר הבדיקה:
מחברים את המכשיר למכונה שמותקן בה Android SDK.
פותחים טרמינל ומריצים את הפקודה הבאה:
adb shell setprop log.tag.Games VERBOSEמפעילים את המשחק במכשיר ומשחזרים את הבעיה שמנסים לנפות באגים בה.
צפייה ביומנים:
adb logcat
השבתת רישום ביומן
כדי להשבית את הרישום המפורט ביומן של Play Games Services במכשיר ולחזור להתנהגות הרישום המקורית, מריצים את הפקודה הבאה:
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:בפלט. זו טביעת האצבע של האישור שלכם.
בשלב הבא, בודקים שכלי ה-build משתמש באישור הזה:
- יוצרים את קובץ ה-APK של המשחק מכלי ה-build וחותמים עליו באמצעות האישור הרצוי. מעתיקים את ה-APK שנוצר לספרייה זמנית.
בספרייה הזמנית, מריצים את הפקודה הבאה כדי לחלץ את ה-APK.
unzip YourGame.apkיוצרים מפתח פרטי באמצעות קובץ אישור RSA:
keytool -printcert -file META-INF/CERT.RSAלחלופין, אתם יכולים ליצור את המפתח הפרטי באמצעות קובץ אישור DSA:
keytool -printcert -file META-INF/CERT.DSAשימו לב לרצף הספרות ההקסדצימליות בשורה שמסומנת בתווית
SHA1:.רצף הספרות הזה צריך להתאים לטביעת האצבע לאישור מהשלב הקודם. אם יש חוסר התאמה, כלי ה-build או המערכת לא מוגדרים לחתום על האפליקציה באמצעות האישור. במקרה כזה, עיינו במסמכי התיעוד של סביבת ה-build כדי להבין איך להגדיר אותה בצורה נכונה, ונסו לבצע שוב את האימות.
בשלב הבא, בודקים אם טביעת האצבע של האישור תואמת לטביעת האצבע שהוגדרה במזהה הלקוח. לשם כך:
- פותחים את Play Console ועוברים למשחק.
- בתחתית הדף Game Details, לוחצים על הקישור לפרויקט המקושר ב-Google Cloud.
- בוחרים את הפרויקט הרצוי.
- בסרגל הצד שמימין, לוחצים על APIs & auth (ממשקי API ואימות). מוודאים שהסטטוס של Google Play games services API הוא ON ברשימת ממשקי ה-API שמוצגת.
- בסרגל הצד שמימין, לוחצים על Registered apps (אפליקציות רשומות).
- מרחיבים את הקטע OAuth 2.0 Client ID ורושמים את טביעת האצבע של האישור (SHA1).
אם טביעת האצבע הזו לא תואמת לטביעת אצבע לאישור מהשלבים הקודמים, צריך ליצור מזהה לקוח חדש עם טביעת אצבע לאישור הנכונה. אתם צריכים ליצור את מזהה הלקוח החדש ב-Play Console, ולא בפרויקט בענן ב-Google Cloud.
מוודאים שחשבונות הבדיקה מופעלים
לפני שמפרסמים משחק, צריך להפעיל את החשבון שדרכו נוצר המשחק ב-Play Console גם כבודק. כדי לבדוק שההגדרה הזו נכונה:
- פותחים את Play Console ועוברים למשחק.
- פותחים את הכרטיסייה בדיקה.
- מוודאים שהחשבון שאתם מנסים לאמת נמצא ברשימת הבודקים.
אם החשבון שאתם מנסים לאמת לא מופיע ברשימה, הוסיפו אותו לרשימה, המתינו כמה דקות ונסו לאמת שוב.
בעיות ב-Proguard
אם אתם משתמשים ב-Proguard ומופיעות שגיאות ב-APK המעורפל, בדקו את רמת ה-API המיועדת ב-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...
}
}
מאזינים אנונימיים לא אמינים כי ה-Play Games SDK מתחזק אותם כהפניות חלשות, כלומר יכול להיות שהם יוחזרו על ידי אוסף האשפה לפני שהם יופעלו. במקום זאת, צריך להטמיע את ה-listener באמצעות אובייקט קבוע כמו 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...
}
}