Aşağıdaki bölümlerde Tuning Fork kitaplığının araç zincirinize nasıl entegre edileceği ve kitaplığın sunduğu işlevlerin nasıl kullanılacağı açıklanmaktadır. Kitaplık, AGDK Kitaplıklarında statik veya paylaşılan kitaplık olarak kullanılabilir.
SDK'yı makinenize indirip kaynak kontrol sisteminizde kontrol ettikten sonra aşağıdaki bölümlerde listelenen değişiklikleri projenizin derleme ayarlarında yapın.
Başlamadan önce
Tuning Fork kitaplığını entegre etmeden önce Android Frame Pacing kitaplığını entegre etmeniz gerekir. Bunu yaparsanızTuning Fork kitaplığı kare süresini otomatik olarak kaydedebilir; onay işaretlerini sizin açıkça çağırmanıza gerek yoktur.
Daha fazla bilgi için aşağıdaki entegrasyon kılavuzlarına bakın:
- Android Frame Pacing'i OpenGL oluşturucunuza entegre etme
- Android Frame Pacing'i Vulkan oluşturucunuza entegre etme
Statik kitaplık
Projenizi statik kitaplığa bağlamak için aşağıdakileri yapın:
- Derleyicinize yol dahil etmek için
gamesdk/include
ekleyin. Bağlayıcı kitaplığı yollarınıza aşağıdaki formun bir yolunu ekleyin:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
gamesdk/libs
bölümüne bakın ve araç zincirinize en uygun olanı seçin (örneğin,gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release
).Bağlayıcı komutunuza
-ltuningfork_static
(ve Android Frame Pacing kitaplığını entegre ettiyseniz-lswappy_static
) ekleyin.AndroidManifest.xml
dosyanızaINTERNET
iznini ekleyin:<uses-permission android:name="android.permission.INTERNET" />
Paylaşılan kitaplık
Statik kitaplık bölümündeki adımlar, belirtilen ABI, API düzeyi, NDK ve STL kombinasyonu için derlenmiş bir Tuning Fork kitaplığı sürümüne statik bağlantı verir. Ayarlarınızda bu kombinasyon kullanılamıyorsa bunun yerine paylaşılan kitaplıkla bağlantı oluşturabilirsiniz:
- Derleyicinize yol dahil etmek için
gamesdk/include
ekleyin. Bağlayıcı kitaplığı yollarınıza aşağıdaki formun bir yolunu ekleyin:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
Bağlayıcı komutunuza
-ltuningfork
(ve Android Frame Pacing kitaplığını entegre ettiyseniz-lswappy
) ekleyin.AndroidManifest.xml
dosyanızaINTERNET
iznini ekleyin:<uses-permission android:name="android.permission.INTERNET" />
Statik bağlantı, libtuningfork.so
paylaşılan kitaplığını gruplandırmanız gerekmediğinden size çok daha küçük bir kod alanı sağlar.
CMake'ı kullanma (yalnızca statik kitaplık)
CMake kullanıyorsanız örnek CMake yapılandırması için gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt
dosyasına bakın. Son kontrolleri gerçekleştiren, uygun derleyici ekleme yollarını ekleyen ve kitaplığı bağlamak için kullanabileceğiniz bir hedef oluşturan gamesdk/samples/gamesdk.cmake
yardımcı program dosyasını içerir.
Bu yardımcı programı kullanmak için aşağıdakileri yapın:
- Şu dosyayı
CMakeLists.txt
dosyanıza ekleyin:include("path/to/gamesdk/samples/gamesdk.cmake")
add_gamesdk_target
işlevini, gamesdk'yı içeren klasörle çağırın:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- Yerel kitaplığınız için
target_link_libraries
içinde bağımlılık olaraktuningfork
ekleyin (Android Frame Pacing kitaplığını entegre ettiysenizswappy
):target_link_libraries(native-lib swappy tuningfork ...)
CMake'in gelişmiş kullanımı için gamesdk.cmake
kaynak dosyasını inceleyin.