更新建構設定

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

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

事前準備

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

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

靜態資料庫

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

  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 來源檔案