תחילת השימוש ב-Play Games Services בשביל C++ ב-Android

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

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

• Android NDK, גרסה 14 ואילך.
• Android SDK מגרסה 10 ואילך והגרסה העדכנית ביותר של Eclipse ADT.
• במכשיר צריכה לפעול מערכת Android בגרסה 4.0 (רמת API 14) ואילך.
• הגרסה האחרונה של ה-SDK של Google Play Services

במדריך למפתחים נעשה שימוש ב-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. מורידים את C++ SDK של Google Play Games Services. מחלצים את את ה-SDK במכונת הפיתוח. בסביבה שלכם, מגדירים את המשתנה NDK_MODULE_PATH בתור מצביעים על הספרייה מעל הספרייה gpg-cpp-sdk. אתם צריכים שיהיה לכם מבנה הספרייה:

   NDK_MODULE_PATH/
   gpg-cpp-sdk/

4. פותחים את ליקוי חמה. אם עדיין לא עשית זאת, עליך להגיד ל-Eclipse איפה התקנת את ה-NDK באמצעות לוחצים על העדפות > Android > NDK

5. מייבאים את הפרויקט של ספריית השירותים של Google Play לסביבת העבודה של Eclipse.

   1. ב-eclipse, לוחצים על File > (קובץ >) ייבוא > Android > קיים ב-Workspace Code של Android.
   2. בחירה ביחס גובה-רוחב SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib כאשר SDK_ROOT הוא המיקום של Android SDK.
   3. לוחצים על סיום.

6. מייבאים את הפרויקט לדוגמה המינימליסטי לסביבת העבודה של Eclipse.

   1. ב-eclipse, לוחצים על File > (קובץ >) ייבוא > Android > קיים ב-Workspace Code של Android.
   2. יש לבחור באפשרות SAMPLES_DIR/samples-android/minimalist.
   3. לוחצים על סיום.

7. לוחצים לחיצה ימנית על הפרויקט MinimalistActivity ולוחצים על Properties (מאפיינים). בקטע Android, גוללים לקטע ספרייה ומוודאים שהפרויקט google-play-services_lib מוגדר כראוי שיש הפניה אליו. אם לא, מסירים את קובץ העזר ומוסיפים אותו שוב מסביבת העבודה.

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

הפרויקט שלכם אמור לעבור הידור (compile), אבל הוא עדיין לא עובד. קודם צריך להגדיר את המשחק ב-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 כדי להדר את קוד ה-Native.
2. במצב ליקוי חמה, לוחצים על הפעלה > הפעלה בשם > אפליקציית Android ומריצים את הדוגמה במכשיר.
3. כשהדוגמה נפתחת, מקישים במקום כלשהו במסך. אמור להופיע הלוגו של Google Play Games יופיעו. אם האפליקציה הוגדרה בצורה נכונה, תוצג בקשה להיכנס לחשבון.

אופציונלי: יצירה אוטומטית באמצעות Eclipse

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

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

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