W kolejnych sekcjach opisano, jak zintegrować bibliotekę Tuning Fork z łańcuchem narzędzi oraz korzystać z dostępnych w niej funkcji. Biblioteka jest dostępna w bibliotekach AGDK jako biblioteka statyczna lub udostępniona.
Po pobraniu pakietu SDK na komputer i sprawdzeniu go w systemie kontroli źródła wprowadź zmiany wymienione w sekcjach poniżej w ustawieniach kompilacji projektu.
Zanim zaczniesz
Przed integracją biblioteki Tuning Fork musisz zintegrować bibliotekę Android Frame Pacing. Jeśli to zrobisz, biblioteka dostrajania będzie mogła automatycznie rejestrować czas renderowania klatki – nie musisz samodzielnie wywoływać funkcji znacznika.
Więcej informacji znajdziesz w tych przewodnikach po integracji:
- Zintegruj funkcję Android Frame Pacing z mechanizmem renderowania OpenGL
- Zintegruj Android Frame Pacing z mechanizmem renderowania Vulkan
Biblioteka statyczna
Aby połączyć projekt z biblioteką statyczną:
- Dodaj do kompilatora
gamesdk/include
, uwzględnij ścieżki. Dodaj ścieżkę do tego formularza w ścieżkach biblioteki łączącej:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
Wyszukaj w
gamesdk/libs
i wybierz ten, który najlepiej pasuje do Twojego łańcucha narzędzi (np.gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
).Dodaj
-ltuningfork_static
do polecenia tagu łączącego (i-lswappy_static
, jeśli zintegrowano bibliotekę Android Frame Pacing).Dodaj do pliku
AndroidManifest.xml
uprawnienieINTERNET
:<uses-permission android:name="android.permission.INTERNET" />
Zasoby wspólne
Czynności w sekcji biblioteki statycznej są statycznie połączone z wersją biblioteki Tuning Fork skompilowaną pod kątem danej kombinacji interfejsu ABI, poziomu API, NDK i STL. Jeśli taka kombinacja ustawień nie jest dostępna w Twoich ustawieniach, możesz zamiast niej przejść do udostępnionej biblioteki:
- Dodaj do kompilatora
gamesdk/include
, uwzględnij ścieżki. Dodaj ścieżkę do tego formularza w ścieżkach biblioteki łączącej:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
Dodaj
-ltuningfork
do polecenia tagu łączącego (i-lswappy
, jeśli masz zintegrowaną bibliotekę Android Frame Pacing).Dodaj do pliku
AndroidManifest.xml
uprawnienieINTERNET
:<uses-permission android:name="android.permission.INTERNET" />
Połączenie statyczne zapewnia znacznie mniejszy ślad kodu, ponieważ nie trzeba łączyć udostępnianych zasobów libtuningfork.so
w pakiety.
Przy użyciu CMake (tylko biblioteka statyczna)
Jeśli używasz CMake, zapoznaj się z przykładową konfiguracją CMake w pliku gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt
. Zawiera on plik narzędziowy gamesdk/samples/gamesdk.cmake
, który wykonuje końcowe testy, dodaje odpowiedni kompilator uwzględniający ścieżki i generuje środowisko docelowe, którego można użyć do połączenia biblioteki.
Aby użyć tego narzędzia, wykonaj następujące czynności:
- Umieść ten plik w pliku
CMakeLists.txt
:include("path/to/gamesdk/samples/gamesdk.cmake")
- Wywołaj funkcję
add_gamesdk_target
, używając folderu zawierającego pakiet SDK gry:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- W
target_link_libraries
biblioteki natywnej dodajtuningfork
jako zależność (iswappy
, jeśli masz zintegrowaną bibliotekę Android Frame Pacing):target_link_libraries(native-lib swappy tuningfork ...)
Zaawansowane informacje na temat CMake znajdziesz w pliku źródłowym gamesdk.cmake
.