תחילת העבודה עם Play Games Services עבור C++ ב-Android

לפני שמתחילים

במדריך למפתחים הזה מוסבר איך מריצים ומפעילים משחק ב-C++ ב-Android שמשתמש ב-Google Play Games Services API. לפני שמתחילים, צריך להוריד ולהגדיר את הדרישות הבאות:

במדריך למפתחים הזה נעשה שימוש ב-Android Native Development Kit (NDK). אם אתם לא מכירים את NDK, קראו את הדוגמאות והמסמכים של NDK לפני שממשיכים.

שלב 1: הגדרת הסביבה

  1. אתם יכולים להוריד את Android SDK ואת Android NDK לחלץ אותם אל המחשב שלכם. בסביבה שלך, מגדירים את SDK_ROOT כמיקום של תיקיית Android SDK, ואת NDK_ROOT את המיקום של תיקיית Android NDK.
  2. מורידים את משחקי C++ לדוגמה. המדריך למפתחים מתייחס למיקום של הדגימות במחשב בתור SAMPLES_DIR.
  3. מורידים את Google+ Games Services C++ SDK. חלץ את ה-SDK למכונה לפיתוח. בסביבה שלכם, מגדירים את המשתנה NDK_MODULE_PATH כך שיצביע על הספרייה מעל הספרייה gpg-cpp-sdk. המבנה של הספריות צריך להיות:
    NDK_MODULE_PATH/
    gpg-cpp-sdk/
  4. פותחים את Eclipse. אם עדיין לא עשיתם זאת, ספרו ל-Eclipse איפה התקנתם את ה-NDK בלחיצה על העדפות > Android > NDK.
  5. ייבוא הפרויקט של הספרייה מ-Google Play Services לסביבת העבודה של Eclipse.

    1. ב-Eclipse, לוחצים על קובץ > ייבוא > Android > קוד Android קיים ב-Workspace.
    2. עליך לבחור את SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib שבו SDK_ROOT הוא המיקום של ה-SDK ל-Android.
    3. לוחצים על סיום.
  6. ייבוא הפרויקט לדוגמה המינימליסטי לסביבת העבודה של Eclipse.

    1. ב-Eclipse, לוחצים על קובץ > ייבוא > Android > קוד Android קיים ב-Workspace.
    2. יש לבחור באפשרות SAMPLES_DIR/samples-android/minimalist.
    3. לוחצים על סיום.
  7. לוחצים לחיצה ימנית על הפרויקט MinimalistActivity ולוחצים על Properties. בקטע Android, גוללים למטה לקטע Library ומוודאים שהפרויקט google-play-services_lib מופיע כראוי. אם לא, יש להסיר את קובץ העזר ולהוסיף אותו שוב מסביבת העבודה.

Eclipse יאסוף באופן אוטומטי את מקורות ה-Java ו-Android של הפרויקט. עם זאת, יש להרכיב בנפרד את הקוד המקורי בתיקייה jni. כדי לעשות זאת באופן ידני, צריך להיכנס לתיקייה jni ולהריץ את ndk-build. חשוב לזכור לעשות את זה אחרי שמבצעים שינויים בתוך התיקייה jni.

הפרויקט צריך להיות מורכב עכשיו, אם כי הוא עדיין לא יפעל. קודם כול צריך להגדיר את המשחק ב-Google Play Console.

שלב 2: הגדרת המשחק ב-Google Play Console

ליצור רשומה עבור המשחק ב-Google Play Console. הפעולה הזו מאפשרת את שירותי המשחקים עבור האפליקציה שלכם, ויוצרת מזהה לקוח OAuth 2.0 אם עדיין אין לכם מזהה כזה.

  1. יוצרים רשומה עבור המשחק לפי השלבים המפורטים במאמר הגדרת Google Play Games Services.
  2. בAndroidManifest.xml, משנים את המאפיין package של התג <manifest> לשם החבילה שבחרתם כשהגדרתם את Google Play Console. יכול להיות שתצטרכו לתקן כמה קובצי עזר לאורך הפרויקט אחרי שתבצעו את השינוי הזה (במיוחד בשיעור R שנוצר).
  3. פותחים את res/values/ids.xml ומציבים את מזהה האפליקציה שם. שימו לב שהמזהה של האפליקציה זהה למזהה הלקוח; זה המספר שמופיע לצד שם המשחק בדף פרטי המשחק ב-Google Play Console.

שלב 3: הרצת הדוגמה

כדי להריץ את הדגימה, נדרש מכשיר פיזי או מכשיר אמולציה של Android עם שירותי Google Play מותקנים:

  1. מריצים את הפקודה ndk-build כדי להדר את הקוד המקורי.
  2. ב-Eclipse, יש ללחוץ על הפעלה > הפעלה בתור > אפליקציית Android ולהריץ את הדוגמה במכשיר.
  3. כשהדגימה נפתחת, מקישים במקום כלשהו על המסך. אמור להופיע הלוגו של Google Play Games. אם הגדרתם את האפליקציה בצורה נכונה, תתבקשו להיכנס לחשבון.

אופציונלי: בנייה אוטומטית עם ליקוי חמה

כדי להגדיר את Eclipse כך שיפעל באופן אוטומטי ב-ndk-build בזמן ביצוע שינויים בקבצים בתיקיית jni:

  1. לוחצים לחיצה ימנית על הפרויקט MinimalistActivity ולוחצים על Properties. בחלון Properties (מאפיינים), בוחרים בחלונית Builders.
  2. לוחצים על חדש כדי להוסיף כלי חדש לבנייה, בוחרים באפשרות תוכנית ואז לוחצים על אישור.
  3. בשדה Name (שם), מזינים 'NDK Builder'.
  4. בקטע Location לוחצים על Browse File System ועוברים לספרייה NDK_ROOT, ובוחרים את הפקודה ndk-build.
  5. בקטע Working Directory, לוחצים על Browse Workspace ובוחרים את תיקיית MinimalistActivity.
  6. לוחצים על הכרטיסייה רענון. מוודאים שהתיבה רענון משאבים בסיום מסומנת.
  7. לוחצים על לחצן הבחירה משאבים ספציפיים ואז על ציון משאבים. בתיבת הדו-שיח שנפתחת, בוחרים את התיקייה jni בקטע MinimalActivity.
  8. לוחצים על אישור ואז על אישור כדי לסיים את יצירת Builder.

עכשיו, בכל פעם שתערכו קובץ בתיקייה jni, Eclipse יריץ את ndk-build וידפיס את הפלט במסוף Eclipse.