Aktualizowanie ustawień kompilacji

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ą:

1. Dodaj do kompilatora gamesdk/include, uwzględnij ścieżki.

2. 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).

3. Dodaj -ltuningfork_static do polecenia tagu łączącego (i -lswappy_static, jeśli zintegrowano bibliotekę Android Frame Pacing).

4. Dodaj do pliku AndroidManifest.xml uprawnienie INTERNET:

   <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:

1. Dodaj do kompilatora gamesdk/include, uwzględnij ścieżki.

2. Dodaj ścieżkę do tego formularza w ścieżkach biblioteki łączącej:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Dodaj -ltuningfork do polecenia tagu łączącego (i -lswappy, jeśli masz zintegrowaną bibliotekę Android Frame Pacing).

4. Dodaj do pliku AndroidManifest.xml uprawnienie INTERNET:

   <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:

1. Umieść ten plik w pliku CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Wywołaj funkcję add_gamesdk_target, używając folderu zawierającego pakiet SDK gry: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. W target_link_libraries biblioteki natywnej dodaj tuningfork jako zależność (i swappy, jeśli masz zintegrowaną bibliotekę Android Frame Pacing): target_link_libraries(native-lib swappy tuningfork ...)

Uwaga: ścieżka do pakietu SDK do gier używanego na potrzeby usług include i add_gamesdk_target może być bezwzględna (np. /home/yourusername/gamesdk lub C:\Android\gamesdk) lub względna względem pliku CMakeLists.txt.

Zaawansowane informacje na temat CMake znajdziesz w pliku źródłowym gamesdk.cmake.