מדריך למתחילים

מגדירים את Android Game Development Extension במחשב Windows ומריצים פרויקט לדוגמה של Visual Studio C++‎ במכשיר Android או באמולטור.

דרישות מוקדמות

כדי להכין את מחשב Windows להתקנת התוסף, פועלים לפי השלבים שבקטע הזה:

1. מורידים ומתקינים אחת מהגרסאות הנתמכות של Visual Studio:

   • ‫Visual Studio 2017 בגרסה 15.4.0 (9 באוקטובר 2017) ואילך.
   • ‫Visual Studio 2019 בגרסה 16.0.0 ואילך.
   • ‫Visual Studio 2022 בגרסה 17.0.0 ואילך.

2. הורדה והתקנה של .NET Core SDK 2.2.

3. ‫Android Studio 3.5 ואילך הוא אופציונלי, אבל אפשר להשתמש בו במקום ב-Android Game Development Extension כדי להתקין את Android SDK ו-NDK.

4. מורידים ומתקינים את JDK 17 ל-AGDE 23.1.82 ואילך, או את JDK 11 לגרסאות עד AGDE 22.2.71, ומגדירים את משתנה הסביבה JAVA_HOME.

התקנת התוסף

כדי להוריד ולהתקין את Android Game Development Extension, פועלים לפי השלבים שמפורטים בקטע הזה:

1. סוגרים את כל המופעים של Visual Studio.

2. מורידים את הגרסה האחרונה של קובץ ההתקנה של התוסף ואת הדוגמאות מהדף הורדות.

3. במיקום ההורדה, לוחצים לחיצה כפולה על קובץ ההתקנה. השלמת ההתקנה נמשכת כמה דקות.

4. אם מותקנות כמה גרסאות של Visual Studio, בוחרים את הגרסאות שרוצים להתקין עבורן את התוסף.

5. לוחצים על סיום כדי להשלים את ההתקנה.

התקנה של Android SDK ו-NDK

אפשר להתקין את Android SDK ואת Android Native Development Kit (NDK) באמצעות Android Studio או Android Game Development Extension. כדי להתקין את ה-SDK ואת ה-NDK מהתוסף, משתמשים בSDK Manager, שנמצא בסרגל הכלים של התוסף ב-Visual Studio.

כשמתקינים את NDK, חשוב לסמן את התיבה NDK (Side by side) כדי שהתוסף יוכל לאתר אותו. צריך להתקין גרסת NDK שנתמכת על ידי התוסף (ראו היסטוריית הגרסאות של NDK).

כדי להתקין את ה-SDK במיקום שונה מברירת המחדל, מגדירים את משתנה הסביבה ANDROID_SDK_ROOT במחשב:

1. מוודאים ש-Visual Studio סגור.
2. בחיפוש של Windows, מחפשים את Environment Variables.
3. בוחרים באפשרות עריכת משתני הסביבה של המערכת.
4. לוחצים על משתני סביבה.
5. בקטע משתני משתמש, לוחצים על חדש.
6. בתיבה שם המשתנה, מקלידים ANDROID_SDK_ROOT.
7. בתיבה ערך משתנה, מזינים את הנתיב אל Android SDK.
8. מפעילים מחדש את המחשב.

אי אפשר לשנות את המיקום של ה-SDK באמצעות חלון SDK Manager, כי משתנה הסביבה הזה הוא המקור היחיד של האמת לגבי המיקום של ה-SDK.

הרצת הדוגמה

כדי להריץ דוגמה שסופקה באמולטור ולאחר מכן במכשיר Android פיזי, פועלים לפי השלבים בקטע הזה.

הגדרת הפלטפורמה

1. מבטלים את הדחיסה של קובץ ה-ZIP של הדוגמאות לתוך ספרייה לבחירתכם. הדוגמאות הבאות כלולות:

   • endless-tunnel
   • HelloJNI
   • Teapot

2. מפעילים את Visual Studio אם הוא עדיין לא פועל.

3. פותחים את ספריית הדוגמאות. בוחרים באפשרות File > Open > Project/Solution (קובץ > פתיחה > פרויקט/פתרון) ועוברים לקובץ .sln.

4. בוחרים פלטפורמת Android:

   1. בוחרים באפשרות Build > Configuration Manager (בנייה > Configuration Manager).
   2. בקטע פלטפורמת פתרון פעילה, בוחרים באפשרות Android-x86_64.

   פלטפורמות Android כבר מוגדרות בדוגמאות (במאמר הוספת פלטפורמות Android נוספות מוסבר איך להוסיף פלטפורמות).

5. מוודאים שהמאפיינים של Android SDK ו-NDK מוגדרים בפרויקט לדוגמה:

   

   • ב-Solution Explorer, לוחצים לחיצה ימנית על הפרויקט ובוחרים באפשרות Properties.

   • בוחרים בכרטיסיית המאפיינים כללי ומחפשים את מאפייני הפלטפורמה ל-Android.

6. בוחרים בכרטיסייה 'מאפיינים' של Android Packaging.

   

   בכרטיסייה הזו אפשר לשנות את שם ה-APK של הפלט ואת הספרייה. שימו לב: חלק מהמאפיינים של הגדרות Android מוגדרים בדפי המאפיינים ומועברים אל Gradle. לדוגמה, מאפיין שם ה-APK‏ MSBUILD_ANDROID_OUTPUT_APK_NAME מעביר את השם הזה לקובץ האפליקציה build.gradle.

הגדרת האמולטור

1. מפעילים את AVD Manager מסרגל הכלים של התוסף ב-Visual Studio. מגדירים מכשיר וירטואלי ואז מריצים אותו באמולטור של Android.

   1. ב-Android Virtual Device Manager, לוחצים על Create Virtual Device (יצירת מכשיר וירטואלי).
   2. בוחרים הגדרת מכשיר (לדוגמה, Pixel 2).
   3. בוחרים תמונת מערכת. מומלץ לבחור x86_64 ABI כי הארכיטקטורה הזו פועלת מהר יותר באמולטור.
   4. בודקים את ההגדרה ולוחצים על סיום.

2. מפעילים את המכשיר הווירטואלי על ידי לחיצה על הלחצן Run ב-Android Virtual Device Manager.

3. ב-Visual Studio, המכשיר הווירטואלי אמור להופיע לצד לחצן סרגל הכלים התחלת ניפוי באגים. לוחצים על Start Debugging (התחלת ניפוי הבאגים) כדי להפעיל את אפליקציית הדוגמה במכשיר. יכול להיות שיידרשו כמה רגעים עד שהבאגים יצורפו לאפליקציה. אם מריצים את הדוגמה של קומקום התה, אפשר לסובב את קומקום התה על ידי גרירת סמן העכבר מעליו.

   
   איור 3. דוגמה של קומקום שפועל באמולטור Android

הגדרת המכשיר

1. כדי להריץ את הדוגמה במכשיר Android פיזי, יכול להיות שתצטרכו ליצור פלטפורמת Android חדשה בפרויקט. הפלטפורמה הזו צריכה להתאים לארכיטקטורה של המכשיר. כדי ליצור פלטפורמה חדשה, מבצעים את הפעולות הבאות ב-Visual Studio:

   1. בוחרים באפשרות Build > Configuration Manager (בנייה > Configuration Manager).
   2. בקטע פלטפורמת פתרונות פעילה, בוחרים באפשרות <חדש>.

   3. מקלידים אחת מהאפשרויות הבאות עבור הפלטפורמה החדשה:

      • Android-armeabi-v7a
      • ‫Android-arm64-v8a
      • ‫Android-x86
      • ‫Android-x86_64

   4. בתיבה Copy settings from (העתקת הגדרות מ), בוחרים פלטפורמת Android קיימת אחרת (או None (ללא) אם עדיין אין לכם פלטפורמות Android). מוודאים שהפעלתם את האפשרות יצירת פלטפורמות חדשות לפרויקט.

2. מחברים מכשיר Android למחשב באמצעות כבל USB. סוג המכשיר צריך להופיע לצד לחצן סרגל הכלים התחלת ניפוי באגים.

   
   איור 4. מכשיר Android מחובר מוצג לצד לחצן סרגל הכלים התחלת ניפוי הבאגים

   אם המכשיר לא מופיע, כדאי לבדוק את הדברים הבאים:

   • הפלטפורמה שנבחרה תואמת ל-ABI של המכשיר.
   • האפשרויות למפתחים וניפוי באגים ב-USB מופעלות במכשיר.
   • כבל ה-USB מחובר מהמכשיר למחשב.
   • כבל ה-USB תומך בחיבור נתונים (ולא רק בהעברת חשמל).

3. לוחצים על לחצן התחלת ניפוי הבאגים בסרגל הכלים כדי להפעיל את אפליקציית הדוגמה במכשיר. יכול להיות שיחלפו כמה רגעים עד שהבאג יצורף לאפליקציה. אחרי שהוא יצורף, תוכלו לבצע פעולות באפליקציה במכשיר.

שאלות נפוצות

ריכזנו כאן כמה שאלות נפוצות בנושא Android Game Development Extension.

איפה נמצאים היומנים של הפלאגין?

אפשר לפתוח את קובץ היומן של הפלאגין באמצעות הסמל Open Logs בסרגל הכלים של Android Game Development Extension.

באילו משתני סביבה הפלאגין משתמש?

התוסף משתמש במשתני הסביבה הבאים:

• ANDROID_SDK_ROOT
• ANDROID_SDK_HOME
• TEMP
• GOOGLE_ANDROID_LOG_DIR

השלבים הבאים

כדי להשתמש בפרויקט שלכם עם התוסף, אתם צריכים להגדיר אותו בהתאם למדריך הגדרת הפרויקט.