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

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

ספרייה סטטית

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

1. מוסיפים את gamesdk/include לנתיבי ההכללה של המהדר.
2. כלול את swappy/swappyVk.h לשילוב עם Vulkan. ברוב המקרים, קובץ הכותרת מכיל את כל הפונקציות הנדרשות כדי לשלב את הספרייה במנוע.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   לדוגמה: gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release

4. מוסיפים את -lswappy_static לפקודת הקישור.

ספריה משותפת

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

1. מבצעים את שלבים 1 ו-2 מהקטע הקודם כדי לעדכן את נתיבי המהדר (compiler) ולהשתמש בקובץ הכותרת המתאים.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
   

3. מוסיפים את -lswappy לפקודת הקישור.

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

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

אם משתמשים ב-CMake, כדאי לעיין בgamesdk/samples/bouncyball/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 בספרייה המקורית, צריך להוסיף את swappy בתור של תלות: target_link_libraries(native-lib swappy ...)

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