לפני שמתחילים
במדריך למפתחים הזה מוסבר איך מריצים ומפעילים משחק ב-C++ ב-Android שמשתמש ב-Google Play Games Services API. לפני שמתחילים, צריך להוריד ולהגדיר את הדרישות הבאות:
- Android NDK, גרסה 14 ואילך.
- Android SDK גרסה 10 ואילך והגרסה העדכנית ביותר של Eclipse ADT.
- במכשיר חייבת לפעול גרסת Android 4.0 (רמת API 14) ומעלה.
- גרסה עדכנית של Google Play Services SDK.
במדריך למפתחים הזה נעשה שימוש ב-Android Native Development Kit (NDK). אם אתם לא מכירים את NDK, קראו את הדוגמאות והמסמכים של NDK לפני שממשיכים.
שלב 1: הגדרת הסביבה
- אתם יכולים להוריד את Android SDK ואת Android NDK לחלץ אותם אל המחשב שלכם. בסביבה שלך, מגדירים את
SDK_ROOT
כמיקום של תיקיית Android SDK, ואתNDK_ROOT
את המיקום של תיקיית Android NDK. - מורידים את משחקי C++ לדוגמה. המדריך למפתחים מתייחס למיקום של הדגימות במחשב בתור
SAMPLES_DIR
. - מורידים את Google+ Games Services C++ SDK. חלץ את ה-SDK למכונה לפיתוח. בסביבה שלכם, מגדירים את המשתנה
NDK_MODULE_PATH
כך שיצביע על הספרייה מעל הספרייהgpg-cpp-sdk
. המבנה של הספריות צריך להיות:NDK_MODULE_PATH/ gpg-cpp-sdk/
- פותחים את Eclipse. אם עדיין לא עשיתם זאת, ספרו ל-Eclipse איפה התקנתם את ה-NDK בלחיצה על העדפות > Android > NDK.
ייבוא הפרויקט של הספרייה מ-Google Play Services לסביבת העבודה של Eclipse.
- ב-Eclipse, לוחצים על קובץ > ייבוא > Android > קוד Android קיים ב-Workspace.
- עליך לבחור את
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
שבוSDK_ROOT
הוא המיקום של ה-SDK ל-Android. - לוחצים על סיום.
ייבוא הפרויקט לדוגמה המינימליסטי לסביבת העבודה של Eclipse.
- ב-Eclipse, לוחצים על קובץ > ייבוא > Android > קוד Android קיים ב-Workspace.
- יש לבחור באפשרות
SAMPLES_DIR/samples-android/minimalist
. - לוחצים על סיום.
לוחצים לחיצה ימנית על הפרויקט 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 אם עדיין אין לכם מזהה כזה.
- יוצרים רשומה עבור המשחק לפי השלבים המפורטים במאמר הגדרת Google Play Games Services.
- ב
AndroidManifest.xml
, משנים את המאפייןpackage
של התג<manifest>
לשם החבילה שבחרתם כשהגדרתם את Google Play Console. יכול להיות שתצטרכו לתקן כמה קובצי עזר לאורך הפרויקט אחרי שתבצעו את השינוי הזה (במיוחד בשיעורR
שנוצר). - פותחים את
res/values/ids.xml
ומציבים את מזהה האפליקציה שם. שימו לב שהמזהה של האפליקציה זהה למזהה הלקוח; זה המספר שמופיע לצד שם המשחק בדף פרטי המשחק ב-Google Play Console.
שלב 3: הרצת הדוגמה
כדי להריץ את הדגימה, נדרש מכשיר פיזי או מכשיר אמולציה של Android עם שירותי Google Play מותקנים:
- מריצים את הפקודה
ndk-build
כדי להדר את הקוד המקורי. - ב-Eclipse, יש ללחוץ על הפעלה > הפעלה בתור > אפליקציית Android ולהריץ את הדוגמה במכשיר.
- כשהדגימה נפתחת, מקישים במקום כלשהו על המסך. אמור להופיע הלוגו של Google Play Games. אם הגדרתם את האפליקציה בצורה נכונה, תתבקשו להיכנס לחשבון.
אופציונלי: בנייה אוטומטית עם ליקוי חמה
כדי להגדיר את Eclipse כך שיפעל באופן אוטומטי ב-ndk-build
בזמן ביצוע שינויים בקבצים בתיקיית jni
:
- לוחצים לחיצה ימנית על הפרויקט MinimalistActivity ולוחצים על Properties. בחלון Properties (מאפיינים), בוחרים בחלונית Builders.
- לוחצים על חדש כדי להוסיף כלי חדש לבנייה, בוחרים באפשרות תוכנית ואז לוחצים על אישור.
- בשדה Name (שם), מזינים 'NDK Builder'.
- בקטע Location לוחצים על Browse File System ועוברים לספרייה
NDK_ROOT
, ובוחרים את הפקודהndk-build
. - בקטע Working Directory, לוחצים על Browse Workspace ובוחרים את תיקיית MinimalistActivity.
- לוחצים על הכרטיסייה רענון. מוודאים שהתיבה רענון משאבים בסיום מסומנת.
- לוחצים על לחצן הבחירה משאבים ספציפיים ואז על ציון משאבים. בתיבת הדו-שיח שנפתחת, בוחרים את התיקייה
jni
בקטע MinimalActivity. - לוחצים על אישור ואז על אישור כדי לסיים את יצירת Builder.
עכשיו, בכל פעם שתערכו קובץ בתיקייה jni
, Eclipse יריץ את ndk-build
וידפיס את הפלט במסוף Eclipse.