Build-Einstellungen aktualisieren

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

Nachdem Sie das SDK auf Ihren Computer heruntergeladen und in Ihr Versionsverwaltungssystem eingecheckt haben, nehmen Sie die im folgenden Abschnitten zu den Build-Einstellungen Ihres Projekts hinzu.

Hinweis

Sie sollten die Android Frame Pacing Library einbinden. bevor Sie die Tuning Fork-Bibliothek einbinden. In diesem Fall Die Tuning Fork-Bibliothek kann Frame Time automatisch aufzeichnen. es gibt keine müssen Sie die Tick-Funktionen explizit selbst aufrufen.

Weitere Informationen finden Sie in den folgenden Integrationsanleitungen:

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

Static-Bibliothek

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

1. Fügen Sie gamesdk/include zu Ihren Compiler-Include-Pfaden hinzu.

2. Fügen Sie den Pfaden der Verknüpfungsbibliothek einen Pfad im folgenden Format hinzu:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Suchen Sie in gamesdk/libs und wählen Sie diejenige aus, die am besten zu Ihrer Toolchain passt (für Beispiel: gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. Fügen Sie Ihrem Verknüpfungsbefehl -ltuningfork_static hinzu (und -lswappy_static, wenn die Android Frame Pacing Library integriert haben.)

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

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

Gemeinsam genutzte Bibliothek

Die Schritte im Abschnitt Statische Bibliothek sind statisch verknüpft. für eine Version der Tuning Fork-Bibliothek, die für das angegebene ABI kompiliert wurde, Kombination aus API-Ebene, NDK und STL. Wenn die Kombination für Einstellungen ausgewählt haben, können Sie stattdessen eine Verknüpfung mit der gemeinsam genutzten Bibliothek erstellen:

1. Fügen Sie gamesdk/include zu Ihren Compiler-Include-Pfaden hinzu.

2. Fügen Sie den Pfaden der Verknüpfungsbibliothek einen Pfad im folgenden Format hinzu:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Fügen Sie Ihrem Verknüpfungsbefehl -ltuningfork hinzu (und -lswappy, falls Sie der Android Frame Pacing-Bibliothek).

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

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

Bei der statischen Verknüpfung wird der Code viel weniger genutzt, da Sie sich die gemeinsam genutzte Bibliothek von libtuningfork.so bündeln.

CMake verwenden (nur statische Bibliothek)

Wenn Sie CMake verwenden, lesen Sie den gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt-Datei für ein Beispiel CMake-Konfiguration. Es enthält eine Dienstprogrammdatei, gamesdk/samples/gamesdk.cmake, der letzte Prüfungen durchführt, fügt die korrekten -Compiler enthält Pfade und generiert ein Ziel, mit dem Sie den Bibliothek.

So verwenden Sie dieses Dienstprogramm:

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 die Gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. Fügen Sie in der Datei target_link_libraries Ihrer nativen Bibliothek tuningfork als Abhängigkeit (und swappy, wenn Sie die Android Frame Pacing integriert haben) Bibliothek): target_link_libraries(native-lib swappy tuningfork ...)

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