Derleme ayarlarınızı güncelleyin

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:

Statik kitaplık

Projenizi statik kitaplığa bağlamak için aşağıdakileri yapın:

  1. Derleyicinize gamesdk/include kodunu ekleyin ve yol içerir.
  2. 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).

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

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

  1. Derleyicinize gamesdk/include kodunu ekleyin ve yol içerir.
  2. Bağlayıcı kitaplığı yollarınıza aşağıdaki formun bir yolunu ekleyin:

    gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
    
  3. Bağlayıcı komutunuza -ltuningfork ekleyin (ve Android Frame Pacing kitaplığını entegre ettiyseniz -lswappy).

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

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

CMake'in ileri düzey kullanımı için gamesdk.cmake kaynak dosyasını inceleyin.