‫GameActivity   חלק מ-Android Game Development Kit.

GameActivity היא ספריית Jetpack שנועדה לעזור למשחקי Android לעבד פקודות של מחזור החיים של האפליקציה, אירועי קלט וקלט טקסט בקוד C/C++‎ של האפליקציה. ‫GameActivity הוא צאצא ישיר של NativeActivity, והארכיטקטורה שלהם דומה:

alt_text

כפי שמוצג בתרשים שלמעלה, GameActivity מבצע את הפונקציות הבאות:

  • אינטראקציה עם מסגרת Android דרך הרכיב בצד של Java.
  • העברת פקודות של מחזור האפליקציה, אירועי קלט וטקסט קלט לצד המקורי.
  • מידול של קוד מקור ב-C/C++‎ לשלושה רכיבים לוגיים:
    • פונקציות JNI של GameActivity, שתומכות ישירות בפונקציונליות של GameActivity ב-Java ומכניסות את האירועים לתור של native_app_glue.
    • ‫native_app_glue, שפועל בעיקר בשרשור המקורי שלו (שונה מהשרשור הראשי של האפליקציה), ומבצע משימות באמצעות ה-looper שלו.
    • קוד המשחק של האפליקציה, שדוגם ומעבד את האירועים בתור בתוך native_app_glue ומריץ את קוד המשחק בשרשור native_app_glue.

בעזרת GameActivity, אתם יכולים להתמקד בפיתוח המשחק עצמו ולא לבזבז זמן מיותר על קוד JNI.

אם אתם כבר מכירים את NativeActivity, אלה ההבדלים העיקריים בין GameActivity לבין NativeActivity:

  • ‫GameActivity מעובד ל-SurfaceView, מה שמקל מאוד על משחקים לקיים אינטראקציה עם רכיבים אחרים של ממשק המשתמש.
  • באירועים של קלט מגע ומקשים, ב-GameActivity יש הטמעה חדשה לגמרי עם הממשק android_input_buffer, בנפרד מהממשק InputQueue שמשמש את NativeActivity.
  • ‫GameActivity היא מחלקה נגזרת של AppCompatActivity, שמאפשרת להשתמש בצורה חלקה ברכיבים אחרים של Jetpack. ‫ActionBar, Fragment ועוד.
  • GameActivity מוסיף פונקציונליות של קלט טקסט על ידי שילוב ספריית GameTextInput.
  • באפליקציות שמבוססות על GameActivity, צריך ליצור את כל שלושת החלקים של קוד C/C++‎ בספרייה אחת. מצד שני, פונקציות ה-JNI של NativeActivity הן חלק מה-framework (תמיד נטענות על ידי מערכת ההפעלה). לכן, רק native_app_glue וקוד C/C++‎ של האפליקציה אמורים להיות מובנים בספרייה אחת.
  • ‫NativeActivity הוא חלק ממסגרת Android ופועל לפי מחזור ההפצה שלה (בדרך כלל פעם בשנה). ‫GameActivity היא חלק מספריית Jetpack, שבה מחזור ההשקה תדיר יותר (בדרך כלל פעם בשבועיים). כך אפשר להוסיף תכונות חדשות ולתקן באגים הרבה יותר מהר.

מיקומי השקה

הספרייה GameActivity זמינה בערוצים הבאים:

קוד C/C++‎ מסופק כקוד מקור בכל ערוצי ההפצה, בפורמט Prefab. בגרסה 1.2.2 של GameActivity נוספה ספרייה סטטית להפצה. החל מהגרסה הזו, מומלץ להשתמש בספרייה הסטטית במקום בקוד המקור.

התוכן של ספריית Jetpack

עם ספריית Jetpack, ‏ GameActivity מופץ עם AAR. ה-AAR הזה מכיל את הרכיבים העיקריים הבאים:

  • קובץ JAR לקוד Java
  • הספרייה הסטטית game-activity_static של C/C++‎ כלולה ב-GameActivity מגרסה 1.2.2 ואילך.
  • קוד מקור ב-C/C++‎ (בתיקייה /prefab)

הוראות השילוב שמקושרות לדף הזה מבוססות על ההנחה שאתם יכולים להשתמש ב-Prefab במערכת ה-build שלכם. אם לא, אתם יכולים להעתיק את קוד המקור שנארז בתיקייה prefab/modules/game-activity/include למערכת ה-build ולבצע את שלבי השילוב הנדרשים. מבנה קבצים דומה קיים לגרסאות ב-androidx לספריית Android Jetpack. כברירת מחדל, gradle פורק קובצי AAR בספריית המטמון שלו (‎~/.gradle/caches/...‎). כדי למצוא את קוד המקור ב-C/C++, מחפשים את prefab/modules/game-activity/include ובוחרים את המיקום בגרסת ההפצה הרצויה.

במאמר תחילת העבודה עם GameActivity מוסבר איך לשלב את GameActivity באמצעות ספריית Jetpack.

תוכן של קוד מקור ב-AOSP

‫AOSP תמיד מכיל את קוד המקור העדכני ביותר. פועלים לפי הוראות ה-build כדי ליצור גרסאות משלכם או לשלב ישירות את המקור בסביבת ה-build. קוד המקור ב-C/C++‎ נשמר במבנה קבצים שדומה לספריית Jetpack.

מדריכי שילוב

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

מקורות מידע נוספים

מידע נוסף על GameActivity זמין במאמרים הבאים:

משוב

כדי לדווח על באגים או לבקש תכונות חדשות ב-GameActivity, השתמשו בכלי למעקב אחר בעיות ב-GameActivity.