更新版本設定

以下各節說明如何將 Tuning Fork 程式庫整合到您的工具鏈中，以及如何使用程式庫提供的函式。該資料庫在 AGDK 程式庫中以靜態或共用資料庫的形式提供。

在您下載 SDK 至機器並將其簽入來源控制系統後，請對專案的建構設定進行以下各節中列出的變更。

事前準備

整合 Tuning Fork 程式庫之前，請先整合 Frame Pacing 程式庫。如果您這麼操作，Tuning Fork 程式庫會自動記錄影格時間；您不需要自行呼叫刻點函式。

詳情請參閱下列整合指南：

• 將 Android Frame Pacing 整合至 OpenGL 轉譯器
• 將 Android Frame Pacing 整合至 Vulkan 轉譯器

靜態資料庫

如要將專案連結至靜態資料庫，請按照下列步驟操作：

1. 將 gamesdk/include 新增至編譯器包含路徑。

2. 在連結器程式庫路徑中新增以下形式的路徑：

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   查看 gamesdk/libs 並挑選最適合您的工具鏈的工具 (例如 gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release)。

3. 將 -ltuningfork_static 加入連結器指令 (如果您已整合 Android Frame Pacing 程式庫，還要新增 -lswappy_static)。

4. 將 INTERNET 權限新增至 AndroidManifest.xml 檔案：

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

共用資料庫

靜態資料庫一節中的步驟是以靜態方式連結針對指定 ABI、API 級別、NDK 和 STL 組合彙整的 Tuning Fork 程式庫。如果您的設定無法使用該組合，可以改為不連結至共用資料庫：

1. 將 gamesdk/include 新增至編譯器包含路徑。

2. 在連結器程式庫路徑中新增以下形式的路徑：

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. 將 -ltuningfork 加入連結器指令 (如果您已整合 Android Frame Pacing 程式庫，還要新增 -lswappy)。

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 做為依附元件 (如果您已整合 Android Frame Pacing 程式庫，則新增 swappy)： target_link_libraries(native-lib swappy tuningfork ...)

如需 CMake 的進階用法，請參閱 gamesdk.cmake 來源檔案。