更新版本設定

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

將 SDK 下載到電腦後 使用您的原始碼控制系統進行檢查，然後在 新增至專案的建構設定。

事前準備

建議您整合 Android Frame Pacing 程式庫 再整合 Tuning Fork 程式庫執行這個動作後 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 加入連結器指令中 (如果符合，請將 -lswappy_static 您整合了 Android Frame Pacing 程式庫)。

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

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

共用資料庫

以靜態方式連結靜態資料庫一節中的步驟 對照針對指定 ABI 編譯的 Tuning Fork 程式庫 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 新增為 依附元件 (如果您已整合 Android Frame Pacing，也需使用 swappy) 程式庫)： target_link_libraries(native-lib swappy tuningfork ...)

，瞭解如何調查及移除這項存取權。

注意： include 和 add_gamesdk_target 使用的 Gamesdk 路徑可 可以是絕對值 (例如 /home/yourusername/gamesdk 或 C:\Android\gamesdk) 或相對的 CMakeLists.txt 檔案。

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