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

כפי שמוצג בתרשים שלמעלה, GameActivity מבצע את הפונקציות הבאות:
- אינטראקציה עם מסגרת Android דרך הרכיב בצד של Java.
- העברת פקודות של מחזור האפליקציה, אירועי קלט וטקסט קלט לצד המקורי.
- מידול של קוד מקור ב-C/C++ לשלושה רכיבים לוגיים:
- פונקציות JNI של GameActivity, שתומכות ישירות בפונקציונליות של GameActivity ב-Java ומכניסות את האירועים לתור של
native_app_glue. -
native_app_glue, שפועל בעיקר בשרשור המקורי שלו (שונה מהשרשור הראשי של האפליקציה), ומבצע משימות באמצעות ה-looper שלו. - קוד המשחק של האפליקציה, שדוגם ומעבד את האירועים בתור בתוך
native_app_glueומריץ את קוד המשחק בשרשורnative_app_glue.
- פונקציות JNI של GameActivity, שתומכות ישירות בפונקציונליות של GameActivity ב-Java ומכניסות את האירועים לתור של
בעזרת 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 זמינה בערוצים הבאים:
- כחלק מספריית Android Jetpack (מומלץ)
- כקוד מקור של AOSP
קוד 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 ו-AGDK.
- שימוש ב-GameTextInput ב-GameActivity.
- מדריך להעברת נתונים (מיגרציה) של NativeActivity.
- מאמרי העזרה של GameActivity.
- הטמעה של GameActivity.
משוב
כדי לדווח על באגים או לבקש תכונות חדשות ב-GameActivity, השתמשו בכלי למעקב אחר בעיות ב-GameActivity.