עדכון הגדרות ה-build

בקטעים הבאים מוסבר איך לשלב את ספריית Tuning Fork בשרשרת הכלים ואיך להשתמש בפונקציות שהספרייה מספקת. הספרייה זמינה כספרייה סטטית או משותפת בספריות AGDK.

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

לפני שמתחילים

מומלץ לשלב את ספריית Android Frame Pacing לפני שמשלבים את ספריית Tuning Fork. אם עושים את זה, ספריית Tuning Fork יכולה לתעד באופן אוטומטי את זמן הפריימים, ואין צורך להפעיל את פונקציות הטיקים באופן ידני.

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

• שילוב של Android Frame Pacing במעבד ה-OpenGL
• שילוב של Android Frame Pacing במעבד התצוגה של Vulkan

ספרייה סטטית

כדי לקשר את הפרויקט לספרייה הסטטית:

1. מוסיפים את gamesdk/include לנתיבי ההכללה של הקומפיילר.

2. מוסיפים נתיב מהצורה הבאה לנתיבי הספרייה של ה-linker:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   מחפשים את הקובץ ב-gamesdk/libs ובוחרים את הקובץ שהכי מתאים לשרשרת הכלים שלכם (לדוגמה, gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. מוסיפים את -ltuningfork_static לפקודת ה-linker (ואת -lswappy_static אם שילבתם את ספריית Android Frame Pacing).

4. מוסיפים את ההרשאה INTERNET לקובץ AndroidManifest.xml:

   <uses-permission android:name="android.permission.INTERNET" />
   

ספרייה משותפת

השלבים בקטע ספרייה סטטית מקשרים באופן סטטי לגרסה של ספריית Tuning Fork שעברה קומפילציה עבור שילוב ה-ABI, רמת ה-API, ה-NDK וה-STL שצוינו. אם השילוב לא זמין בהגדרות שלכם, אפשר לקשר במקום זאת לספרייה המשותפת:

1. מוסיפים את gamesdk/include לנתיבי ההכללה של הקומפיילר.

2. מוסיפים נתיב מהצורה הבאה לנתיבי הספרייה של ה-linker:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. מוסיפים את -ltuningfork לפקודת ה-linker (ואת -lswappy אם שילבתם את ספריית Android Frame Pacing).

4. מוסיפים את ההרשאה INTERNET לקובץ AndroidManifest.xml:

   <uses-permission android:name="android.permission.INTERNET" />
   

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

שימוש ב-CMake (ספרייה סטטית בלבד)

אם אתם משתמשים ב-CMake, תוכלו לראות דוגמה להגדרת CMake בקובץ gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt. הוא כולל קובץ כלי עזר, gamesdk/samples/gamesdk.cmake, שמבצע בדיקות סופיות, מוסיף את נתיבי ההכללה המתאימים של הקומפיילר ויוצר יעד שאפשר להשתמש בו כדי לקשר את הספרייה.

כדי להשתמש בכלי הזה:

1. כוללים את הקובץ הזה בקובץ CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
2. קוראים לפונקציה add_gamesdk_target עם התיקייה שמכילה את ה-gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. ב-target_link_libraries של הספרייה המקורית, מוסיפים את tuningfork כתלות (ואת swappy אם שילבתם את הספרייה Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

לשימוש מתקדם ב-CMake, אפשר לעיין בקובץ המקור gamesdk.cmake.