以下各節說明如何將 Tuning Fork 程式庫整合至您的工具鍊,以及如何使用程式庫提供的函式。該程式庫在 AGDK 程式庫中以靜態或共用資料庫的形式提供。
下載 SDK 至機器並簽入原始碼控制系統後,請針對專案的建構設定進行以下各節所列的變更。
事前準備
整合 Tuning Fork 程式庫之前,請先整合 Android Frame Pacing 程式庫。這樣一來,Tuning Fork 程式庫會自動記錄影格時間;無需自行呼叫刻點函式。
詳情請參閱以下整合指南:
靜態資料庫
如要將專案連結至靜態資料庫,請按照下列步驟操作:
- 將
gamesdk/include
新增至編譯器,包含路徑。 在連結器程式庫路徑中新增以下形式的路徑:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
查看
gamesdk/libs
並挑選最適合您的工具鍊的工具 (例如gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
)。將
-ltuningfork_static
加入連結器指令 (如果您已整合 Android Frame Pacing 程式庫,還要新增-lswappy_static
)。將
INTERNET
權限新增至AndroidManifest.xml
檔案:<uses-permission android:name="android.permission.INTERNET" />
共用資料庫
靜態資料庫一節中的步驟會以靜態方式連結為指定 ABI、API 級別、NDK 和 STL 組合編譯的 Tuning Fork 程式庫版本。如果您的設定無法使用該組合,可以改為不連結至共用資料庫:
- 將
gamesdk/include
新增至編譯器,包含路徑。 在連結器程式庫路徑中新增以下形式的路徑:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
將
-ltuningfork
加入連結器指令 (如果您已整合 Android Frame Pacing 程式庫,還要新增-lswappy
)。將
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
,新增適當的編譯器包含路徑,以及產生可用於連結程式庫的目標。
如要使用這個公用程式,請執行下列步驟:
- 在
CMakeLists.txt
檔案中加入這個檔案:include("path/to/gamesdk/samples/gamesdk.cmake")
- 呼叫
add_gamesdk_target
函式,請使用包含 gamesdk 的資料夾:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- 在原生資料庫的
target_link_libraries
中,新增tuningfork
做為依附元件 (如果您已整合 Android Frame Pacing 程式庫,則為swappy
):target_link_libraries(native-lib swappy tuningfork ...)
如需 CMake 的進階用法,請參閱 gamesdk.cmake
來源檔案。