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:
- Fügen Sie Ihrem Compiler-Einschließen-Pfad
gamesdk/include
hinzu. 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
).Fügen Sie Ihrem Verknüpfungsbefehl
-ltuningfork_static
hinzu (und-lswappy_static
, wenn Sie die Android Frame Pacing-Bibliothek integriert haben).Fügen Sie der Datei
AndroidManifest.xml
die BerechtigungINTERNET
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:
- Fügen Sie Ihrem Compiler-Einschließen-Pfad
gamesdk/include
hinzu. Fügen Sie den Verknüpfungsbibliothekspfaden einen Pfad mit dem folgenden Formular hinzu:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
Fügen Sie Ihrem Verknüpfungsbefehl
-ltuningfork
hinzu (und-lswappy
, wenn Sie die Android Frame Pacing-Bibliothek integriert haben).Fügen Sie der Datei
AndroidManifest.xml
die BerechtigungINTERNET
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:
- Nehmen Sie diese Datei in die Datei
CMakeLists.txt
auf:include("path/to/gamesdk/samples/gamesdk.cmake")
- Rufen Sie die Funktion
add_gamesdk_target
mit dem Ordner auf, der das Gamesdk enthält:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- Fügen Sie in der
target_link_libraries
für Ihre native Bibliothektuningfork
als Abhängigkeit hinzu (undswappy
, 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.