Aşağıdaki bölümlerde, Tuning Fork kitaplığını araç zincirinize nasıl entegre edeceğiniz ve kitaplığın sağladığı işlevleri nasıl kullanacağınız açıklanmaktadır. Kitaplık, AGDK Kitaplıkları'nda statik veya paylaşılan kitaplık olarak kullanılabilir.
SDK'yı makinenize indirip kaynak kontrol sisteminize ekledikten sonra, projenizin derleme ayarlarında aşağıdaki bölümlerde listelenen değişiklikleri yapın.
Başlamadan önce
Tuning Fork kitaplığını entegre etmeden önce Android Frame Pacing kitaplığını entegre etmeniz gerekir. Bu işlemi yaparsanız Tuning Fork kitaplığı, kare süresini otomatik olarak kaydedebilir. Tick işlevlerini kendiniz açıkça çağırmanız gerekmez.
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:
- Derleyici ekleme yollarınıza
gamesdk/includeekleyin. Bağlayıcı kitaplığı yollarınıza aşağıdaki biçimde bir yol ekleyin:
gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
gamesdk/libsbö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.INTERNETizniniAndroidManifest.xmldosyanıza ekleyin:<uses-permission android:name="android.permission.INTERNET" />
Paylaşılan kitaplık
Statik kitaplık bölümündeki adımlar, belirli ABI, API düzeyi, NDK ve STL kombinasyonu için derlenen Tuning Fork kitaplığının bir sürümüne karşı statik olarak bağlantı oluşturur. Bu kombinasyon ayarlarınız için kullanılamıyorsa bunun yerine paylaşılan kitaplığa bağlantı oluşturabilirsiniz:
- Derleyici ekleme yollarınıza
gamesdk/includeekleyin. Bağlayıcı kitaplığı yollarınıza aşağıdaki biçimde bir yol 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.INTERNETizniniAndroidManifest.xmldosyanıza ekleyin:<uses-permission android:name="android.permission.INTERNET" />
Statik bağlantı, libtuningfork.so paylaşılan kitaplığını paketlemeniz gerekmediğinden çok daha küçük bir kod alanı sağlar.
CMake'i kullanma (yalnızca statik kitaplık)
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 yapan, uygun derleyici dahil etme yollarını ekleyen ve kitaplığı bağlamak için kullanabileceğiniz bir hedef oluşturan bir yardımcı program dosyası (gamesdk/samples/gamesdk.cmake) içerir.
Bu yardımcı programı kullanmak için aşağıdakileri yapın:
- Bu dosyayı
CMakeLists.txtdosyanıza ekleyin:include("path/to/gamesdk/samples/gamesdk.cmake") - Oyun SDK'sını içeren klasörle
add_gamesdk_targetişlevini çağırın:add_gamesdk_target(PACKAGE_DIR path/to/gamesdk) - Yerel kitaplığınızın
target_link_librariesbölümünetuningforköğesini bağımlılık olarak ekleyin (Android Frame Pacing kitaplığını entegre ettiysenizswappyöğesini de ekleyin):target_link_libraries(native-lib swappy tuningfork ...)
CMake'in gelişmiş kullanımı için gamesdk.cmake kaynak dosyasına bakın.