Aşağıdaki bölümlerde Tuning Fork kitaplığının araç zincirinize nasıl entegre edileceği ve kitaplığın sağladığı 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ız Tuning Fork kitaplığı kare süresini otomatik olarak kaydedebilir; işaretleme işlevlerini açıkça çağırmanıza gerek yoktur.
Daha fazla bilgi için aşağıdaki entegrasyon kılavuzlarını inceleyin:
- 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
gamesdk/include
kodunu ekleyin ve yol içerir. Bağlayıcı kitaplığı yollarınıza aşağıdaki formun bir yolunu ekleyin:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
gamesdk/libs
aracını inceleyin 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
ekleyin (ve Android Frame Pacing kitaplığını entegre ettiyseniz-lswappy_static
).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, belirli bir ABI, API düzeyi, NDK ve STL kombinasyonu için derlenmiş Tuning Fork kitaplığının bir 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
gamesdk/include
kodunu ekleyin ve yol içerir. 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
ekleyin (ve Android Frame Pacing kitaplığını entegre ettiyseniz-lswappy
).AndroidManifest.xml
dosyanızaINTERNET
iznini ekleyin:<uses-permission android:name="android.permission.INTERNET" />
Statik bağlantı, libtuningfork.so
paylaşılan kitaplığını gruplandırmanıza gerek kalmadığından çok daha küçük bir kod alanı sunar.
CMake (yalnızca statik kitaplık) kullanma
CMake kullanıyorsanız örnek bir CMake yapılandırması için gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt
dosyasına bakın. Son kontrolleri gerçekleştiren, doğru derleyici ekleme yollarını ekleyen ve kitaplığı bağlamak için kullanabileceğiniz bir hedef oluşturan gamesdk/samples/gamesdk.cmake
yardımcı programı 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'ı içeren klasörle çağırın:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
- Yerel kitaplığınız için
target_link_libraries
bölümüne bağımlılık olaraktuningfork
ifadesini (ve Android Frame Hız kitaplığını entegre ettiysenizswappy
) ekleyin:target_link_libraries(native-lib swappy tuningfork ...)
CMake'in ileri düzey kullanımı için gamesdk.cmake
kaynak dosyasını inceleyin.