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

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

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

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

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

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

• שילוב קצב הפריימים של Android בכלי לרינדור OpenGL
• שילוב קצב הפריימים של Android ברינדור Vulkan

ספרייה סטטית

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

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

2. מוסיפים נתיב מהטופס הבא לנתיבים של ספריית המקשרים:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

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

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

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

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

ספריה משותפת

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

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

2. מוסיפים נתיב מהטופס הבא לנתיבים של ספריית המקשרים:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

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

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

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

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

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

אם אתם משתמשים ב-CMake, כדאי לעיין לדוגמה, קובץ gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt CMake תצורה. הוא כולל קובץ שירות, 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 ): target_link_libraries(native-lib swappy tuningfork ...)

הערה: הנתיב ל-gamesdk שבו משתמשים ב-include וב-add_gamesdk_target יכול להיות להיות מוחלטים (לדוגמה, /home/yourusername/gamesdk או C:\Android\gamesdk) או ביחס לקובץ CMakeLists.txt.

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