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

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

ספרייה סטטית

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

  1. מוסיפים את gamesdk/include לנתיבי ההכללה של המהדר.
  2. צריך לכלול את המאפיין swappy/swappyGL.h לשילוב עם OpenGL ספרד ברוב המקרים, קובץ הכותרת מכיל את כל הפונקציות הנדרשות לשלב את הספרייה במנוע.
  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.