Derleme ayarlarınızı güncelleyin

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:

1. Derleyici ekleme yollarınıza gamesdk/include ekleyin.

2. Bağlayıcı kitaplığı yollarınıza aşağıdaki biçimde bir yol 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).

3. Bağlayıcı komutunuza -ltuningfork_static (ve Android Frame Pacing kitaplığını entegre ettiyseniz -lswappy_static) ekleyin.

4. INTERNET iznini AndroidManifest.xml dosyanı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:

1. Derleyici ekleme yollarınıza gamesdk/include ekleyin.

2. Bağlayıcı kitaplığı yollarınıza aşağıdaki biçimde bir yol ekleyin:

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. Bağlayıcı komutunuza -ltuningfork (ve Android Frame Pacing kitaplığını entegre ettiyseniz -lswappy) ekleyin.

4. INTERNET iznini AndroidManifest.xml dosyanı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:

1. Bu dosyayı CMakeLists.txt dosyanıza ekleyin: include("path/to/gamesdk/samples/gamesdk.cmake")
2. Oyun SDK'sını içeren klasörle add_gamesdk_target işlevini çağırın: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. Yerel kitaplığınızın target_link_libraries bölümüne tuningfork öğesini bağımlılık olarak ekleyin (Android Frame Pacing kitaplığını entegre ettiyseniz swappy öğesini de ekleyin): target_link_libraries(native-lib swappy tuningfork ...)

Not: include ve add_gamesdk_target için kullanılan gamesdk'nın yolu mutlak (ör. /home/yourusername/gamesdk veya C:\Android\gamesdk) ya da CMakeLists.txt dosyasına göre göreceli olabilir.

CMake'in gelişmiş kullanımı için gamesdk.cmake kaynak dosyasına bakın.