Aktualizowanie ustawień kompilacji

W kolejnych sekcjach dowiesz się, jak zintegrować bibliotekę Tuning Fork do łańcucha narzędzi i używania funkcji dostępnych w bibliotece. jest dostępna jako biblioteka statyczna lub udostępniona w bibliotekach AGDK.

Gdy pobierzesz pakiet SDK na swój komputer i sprawdź ją w systemie kontroli źródła, wprowadź zmiany do ustawień kompilacji projektu.

Zanim zaczniesz

Zalecamy zintegrowanie biblioteki Android Frame Pacing. przed zintegrowaniem biblioteki Tuning Fork. W takim przypadku tag Biblioteka Tuning Fork może automatycznie rejestrować czas renderowania klatki. nie ma musisz samodzielnie wywoływać funkcje znacznika.

Więcej informacji znajdziesz w tych przewodnikach po integracji:

• Zintegruj funkcję Android Frame Pacing z mechanizmem renderowania OpenGL
• Integrowanie Android Frame Pacing z mechanizmem renderowania Vulkan

Biblioteka statyczna

Aby połączyć projekt z biblioteką statyczną:

1. Dodaj ścieżkę gamesdk/include do kompilatora i dodaj ścieżki.

2. Dodaj do ścieżek biblioteki kreatora linków ścieżkę tego formularza:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   Otwórz aplikację gamesdk/libs i wybierz ten, który najlepiej pasuje do Twojego łańcucha narzędzi (na np. gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release).

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

4. Dodaj uprawnienie INTERNET do pliku AndroidManifest.xml:

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

Zasoby wspólne

Kroki w sekcji biblioteki statycznej są statyczne z wersją biblioteki Tuning Fork skompilowanej dla danego interfejsu ABI, Kombinacja poziomu interfejsu API, NDK i STL. Jeśli kombinacja nie jest dostępna dla swoje ustawienia, możesz utworzyć link do biblioteki udostępnionej:

1. Dodaj ścieżkę gamesdk/include do kompilatora i dodaj ścieżki.

2. Dodaj do ścieżek biblioteki kreatora linków ścieżkę tego formularza:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Dodaj -ltuningfork do polecenia łączącego (i -lswappy, jeśli masz zintegrowany) w bibliotece Android Frame Pacing).

4. Dodaj uprawnienie INTERNET do pliku AndroidManifest.xml:

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

Połączenia statyczne ograniczają ilość kodu, ponieważ nie trzeba ich pakietu zasobów wspólnych libtuningfork.so.

Korzystanie z CMake (tylko biblioteka statyczna)

Jeśli używasz CMake, zapoznaj się z gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt plik do przykładu Konfiguracja CMake. Zawiera plik narzędziowy, Funkcja gamesdk/samples/gamesdk.cmake, która przeprowadza ostateczne testy, dodaje odpowiednie zawierają ścieżki i generuje obiekt docelowy, za pomocą którego można połączyć bibliotece.

Aby użyć tego narzędzia, wykonaj następujące czynności:

1. Dołącz ten plik do pliku CMakeLists.txt: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Wywołaj funkcję add_gamesdk_target, używając folderu zawierającego Gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. W sekcji target_link_libraries dotyczącej biblioteki natywnej dodaj tuningfork jako (oraz swappy, jeśli zintegrowano obsługę Android Frame Pacing) biblioteka): target_link_libraries(native-lib swappy tuningfork ...)

.

Uwaga: ścieżka do pakietu SDK gamesdk używana w pakietach include i add_gamesdk_target może może być bezwzględna (na przykład /home/yourusername/gamesdk lub C:\Android\gamesdk) lub w stosunku do pliku CMakeLists.txt.

Informacje o zaawansowanym korzystaniu z CMake znajdziesz w pliku źródłowym gamesdk.cmake.