Build-Einstellungen aktualisieren

Nachdem Sie die Bibliothek auf Ihren Computer heruntergeladen und in Ihr Quellcodeverwaltungssystem eingecheckt haben, nehmen Sie die folgenden Änderungen an den Buildeinstellungen Ihres Projekts vor.

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 swappy/swappyGL.h für die Integration mit OpenGL ES ein. In den meisten Fällen enthält die Headerdatei alle Funktionen, die Sie zum Einbinden der Bibliothek in Ihre Engine benötigen.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Beispiel: gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release

4. Fügen Sie Ihrem Linker-Befehl -lswappy_static hinzu.

Gemeinsam genutzte Bibliothek

Bei den oben genannten Schritten wird statisch mit einer Version der Frame Pacing-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 einen Link zur geteilten Mediathek erstellen:

1. Folgen Sie Schritt 1 und 2 aus dem vorherigen Abschnitt, um die Include-Pfade des Compilers zu aktualisieren und die entsprechende Header-Datei zu verwenden.

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

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/swappy
   

3. Fügen Sie Ihrem Linker-Befehl -lswappy hinzu.

Durch die statische Verknüpfung wird der Code-Footprint deutlich kleiner, da Sie die gemeinsam genutzte libswappy.so-Bibliothek nicht bündeln müssen.

CMake verwenden (nur statische Bibliothek)

Wenn Sie CMake verwenden, finden Sie in der Datei gamesdk/samples/bouncyball/app/CMakeLists.txt in der heruntergeladenen Bibliothek ein Beispiel für die 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 der Datei target_link_libraries für Ihre native Bibliothek swappy als Abhängigkeit hinzu: target_link_libraries(native-lib swappy ...)

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