לפני שמתחילים
במדריך הזה למפתחים נסביר איך להדר ולהפעיל משחק 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: מגדירים את הסביבה
- מורידים את Android SDK ואת Android NDK ומחלצים אותם למחשב. ב
מגדירים את
SDK_ROOT
למיקום של תיקיית Android SDK ו-NDK_ROOT
המיקום של תיקיית Android NDK. - מורידים משחקים לדוגמה C++. הזה
המדריך למפתחים מתייחס למיקום הדגימות במחשב בתור
SAMPLES_DIR
. - מורידים את C++ SDK של Google Play Games Services. מחלצים את
את ה-SDK במכונת הפיתוח. בסביבה שלכם, מגדירים את המשתנה
NDK_MODULE_PATH
בתור מצביעים על הספרייה מעל הספרייהgpg-cpp-sdk
. אתם צריכים שיהיה לכם מבנה הספרייה:NDK_MODULE_PATH/ gpg-cpp-sdk/
- פותחים את ליקוי חמה. אם עדיין לא עשית זאת, עליך להגיד ל-Eclipse איפה התקנת את ה-NDK באמצעות לוחצים על העדפות > Android > NDK
מייבאים את הפרויקט של ספריית שירותי Google Play לסביבת העבודה ב-Eclipse.
- ב-eclipse, לוחצים על File > (קובץ >) ייבוא > Android > קיים ב-Workspace Code של Android.
- בחירה ביחס גובה-רוחב
SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib
כאשרSDK_ROOT
הוא המיקום של Android SDK. - לוחצים על סיום.
מייבאים את הפרויקט לדוגמה המינימליסטי לסביבת העבודה של Eclipse.
- ב-eclipse, לוחצים על File > (קובץ >) ייבוא > Android > קיים ב-Workspace Code של Android.
- יש לבחור באפשרות
SAMPLES_DIR/samples-android/minimalist
. - לוחצים על סיום.
לוחצים לחיצה ימנית על הפרויקט 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, אם עדיין אין לכם.
- כדי ליצור רשומה למשחק, צריך לבצע את השלבים שמפורטים בקטע מגדירים את 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
כדי להדר את קוד ה-Native. - במצב ליקוי חמה, לוחצים על הפעלה > הפעלה בשם > אפליקציית Android ומריצים את הדוגמה במכשיר.
- כשהדוגמה נפתחת, מקישים במקום כלשהו במסך. אמור להופיע הלוגו של Google Play Games יופיעו. אם האפליקציה הוגדרה בצורה נכונה, תוצג בקשה להיכנס לחשבון.
אופציונלי: יצירה אוטומטית באמצעות Eclipse
בשלבים הבאים מוסבר איך להגדיר את Eclipse כך שיריץ את ndk-build
באופן אוטומטי
לבצע שינויים בקבצים שבתיקייה jni
.
- לוחצים לחיצה ימנית על הפרויקט MinimalistActivity ולוחצים על Properties (מאפיינים). בחלון Properties (מאפיינים), לוחצים על החלונית Builders.
- כדי להוסיף Builder חדש, לוחצים על New (חדש) ובוחרים באפשרות Program (תוכנית) ולאחר מכן לוחצים על OK (אישור).
- בשדה Name, מזינים 'NDK Builder'.
- בקטע מיקום, לוחצים על Browse File System, ועוברים לספרייה
NDK_ROOT
. בוחרים את הפקודהndk-build
. - בקטע ספריית עבודה, לוחצים על עיון בסביבת העבודה ובוחרים באפשרות MinimalistActivity. בתיקיית הפרויקט.
- לוחצים על הכרטיסייה רענון. מוודאים שהתיבה רענון המשאבים לאחר ההשלמה מסומנת.
- לוחצים על לחצן הבחירה specific resources ולאחר מכן לוחצים על specified Resources. ב
בתיבת הדו-שיח שמופיעה, בוחרים בתיקייה
jni
בקטע MinimalActivity. - כדי לסיים את יצירת ה-builder, לוחצים על אישור ואז על אישור.
בכל פעם שעורכים קובץ בתיקייה jni
, אפליקציית Eclipse תריץ את הפקודה ndk-build
ותדפיס את
אל קונסולת Eclipse Console.