Build-Einstellungen aktualisieren

In den folgenden Abschnitten wird beschrieben, wie Sie die „Abstimmung 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 das Versionsverwaltungssystem eingecheckt haben, nehmen Sie die in den folgenden Abschnitten aufgeführten Änderungen an den Build-Einstellungen Ihres Projekts vor.

Vorbereitung

Vor der Einbindung der Abstimmung Fork-Bibliothek sollten Sie die Android Frame Pacing-Bibliothek einbinden. In diesem Fall kann die „Abstimmung Fork“-Bibliothek die Frame Time automatisch aufzeichnen. Es ist nicht notwendig, die Tick-Funktionen explizit selbst aufzurufen.

Weitere Informationen finden Sie in den folgenden Integrationsanleitungen:

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

Statische Bibliothek

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

1. Fügen Sie Ihrem Compiler-Einschließen-Pfad gamesdk/include hinzu.

2. Fügen Sie den Verknüpfungsbibliothekspfaden einen Pfad mit dem folgenden Formular 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 (z. B. gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

3. Fügen Sie Ihrem Verknüpfungsbefehl -ltuningfork_static hinzu (und -lswappy_static, wenn Sie die Android Frame Pacing-Bibliothek 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 mit einer Version der Feinabstimmungsbibliothek verknüpft, die für die angegebene ABI-, API-Level-, NDK- und STL-Kombination kompiliert wurde. Wenn die Kombination für Ihre Einstellungen nicht verfügbar ist, können Sie stattdessen eine Verknüpfung mit der gemeinsam genutzten Bibliothek erstellen:

1. Fügen Sie Ihrem Compiler-Einschließen-Pfad gamesdk/include hinzu.

2. Fügen Sie den Verknüpfungsbibliothekspfaden einen Pfad mit dem folgenden Formular hinzu:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Fügen Sie Ihrem Verknüpfungsbefehl -ltuningfork hinzu (und -lswappy, wenn Sie die Android Frame Pacing-Bibliothek integriert haben).

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

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

Durch statische Verknüpfungen wird der Code erheblich reduziert, da Sie die gemeinsam genutzte Bibliothek libtuningfork.so 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 die Dienstprogrammdatei gamesdk/samples/gamesdk.cmake, die letzte Prüfungen durchführt, die richtigen Compiler-Einschließen-Pfade hinzufügt und ein Ziel generiert, mit dem Sie die Bibliothek verknüpfen können.

So verwenden Sie dieses Dienstprogramm:

1. Nehmen Sie diese Datei in die Datei CMakeLists.txt auf: 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 der 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.