Build-Einstellungen aktualisieren

In den folgenden Abschnitten wird beschrieben, wie Sie die Tuning Fork-Bibliothek in Ihre Toolchain einbinden und die von der Bibliothek bereitgestellten Funktionen verwenden. Die Bibliothek ist als statische oder gemeinsam genutzte Bibliothek in den AGDK-Bibliotheken verfügbar.

Nachdem Sie das SDK auf Ihren Computer heruntergeladen und in Ihr Quellcodeverwaltungssystem eingecheckt haben, nehmen Sie die in den folgenden Abschnitten aufgeführten Änderungen an den Buildeinstellungen Ihres Projekts vor.

Hinweis

Sie sollten die Android Frame Pacing-Bibliothek einbinden, bevor Sie die Tuning Fork-Bibliothek einbinden. In diesem Fall kann die Tuning Fork-Bibliothek die Frame-Zeit automatisch aufzeichnen. Sie müssen die Tick-Funktionen nicht explizit aufrufen.

Weitere Informationen finden Sie in den folgenden Integrationsleitfäden:

• Android Frame Pacing in Ihren OpenGL-Renderer einbinden
• Android Frame Pacing in den Vulkan-Renderer einbinden

Statische Bibliothek

So verknüpfen Sie Ihr Projekt mit der statischen Bibliothek:

1. Fügen Sie gamesdk/include zu den Include-Pfaden Ihres Compilers hinzu.

2. Fügen Sie in Ihre Linker-Bibliothekspfade einen Pfad der folgenden Form ein:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Suchen Sie in gamesdk/libs nach dem Eintrag, der am besten zu Ihrer Toolchain passt (z. B. gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. Fügen Sie Ihrem Linker-Befehl -ltuningfork_static hinzu (und -lswappy_static, wenn Sie die Android Frame Pacing-Bibliothek eingebunden haben).

4. Fügen Sie der Datei AndroidManifest.xml die Berechtigung INTERNET hinzu:

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

Gemeinsam genutzte Bibliothek

Bei den Schritten im Abschnitt Statische Bibliothek wird statisch mit einer Version der Tuning Fork-Bibliothek verknüpft, die für die angegebene Kombination aus ABI, API-Level, NDK und STL kompiliert wurde. Wenn die Kombination für Ihre Einstellungen nicht verfügbar ist, können Sie stattdessen die gemeinsam genutzte Bibliothek verknüpfen:

1. Fügen Sie gamesdk/include zu den Include-Pfaden Ihres Compilers hinzu.

2. Fügen Sie in Ihre Linker-Bibliothekspfade einen Pfad der folgenden Form ein:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Fügen Sie Ihrem Linker-Befehl -ltuningfork hinzu (und -lswappy, wenn Sie die Android Frame Pacing-Bibliothek eingebunden haben).

4. Fügen Sie der Datei AndroidManifest.xml die Berechtigung INTERNET hinzu:

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

Durch die statische Verknüpfung ist der Code viel kleiner, da Sie die gemeinsam genutzte libtuningfork.so-Bibliothek nicht bündeln müssen.

CMake verwenden (nur statische Bibliothek)

Wenn Sie CMake verwenden, finden Sie in der Datei gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt ein Beispiel für eine CMake-Konfiguration. Sie enthält eine Hilfsdatei (gamesdk/samples/gamesdk.cmake), die letzte Prüfungen durchführt, die richtigen Compiler-Include-Pfade hinzufügt und ein Ziel generiert, mit dem Sie die Bibliothek verknüpfen können.

So verwenden Sie dieses Tool:

1. Fügen Sie diese Datei in Ihre CMakeLists.txt-Datei ein: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Rufen Sie die Funktion add_gamesdk_target mit dem Ordner auf, der das GameSDK enthält: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. Fügen Sie in Ihrer target_link_libraries für Ihre native Bibliothek tuningfork als Abhängigkeit hinzu (und swappy, wenn Sie die Android Frame Pacing-Bibliothek eingebunden haben): target_link_libraries(native-lib swappy tuningfork ...)

Informationen zur erweiterten Verwendung von CMake finden Sie in der gamesdk.cmake-Quelldatei.