อัปเดตการตั้งค่าบิลด์

ส่วนต่อไปนี้จะอธิบายวิธีผสานรวมไลบรารี Tuning Fork ลงในเครื่องมือและวิธีใช้ฟังก์ชันต่างๆ ที่ไลบรารีมีให้ ไลบรารีที่พร้อมใช้งานเป็นไลบรารีแบบคงที่หรือไลบรารีที่ใช้ร่วมกันในไลบรารี AGDK

หลังจากดาวน์โหลด SDK ลงในเครื่องและ ตรวจสอบโมเดลดังกล่าวลงในระบบควบคุมแหล่งที่มา แล้วทำการเปลี่ยนแปลงตามที่แสดงใน ส่วนต่างๆ ต่อไปนี้ในการตั้งค่าบิลด์ของโปรเจ็กต์

ก่อนเริ่มต้น

คุณควรผสานรวมไลบรารี Android Frame Pacing ก่อนที่จะผสานรวมไลบรารี Tuning Fork หากคุณทำเช่นนี้ ไลบรารีของ Tuning Fork จะบันทึกเวลาที่ใช้ในการแสดงผลเฟรมได้โดยอัตโนมัติ ไม่มี คุณต้องเรียกฟังก์ชันเห็บด้วยตนเองอย่างชัดแจ้ง

โปรดดูข้อมูลเพิ่มเติมในคู่มือการผสานรวมต่อไปนี้

• ผสานรวมการกำหนดอัตราการแสดงโฆษณาของ Android Frame เข้ากับโหมดแสดงภาพ OpenGL
• ผสานรวม Android Frame Pacing กับโหมดแสดงภาพ Vulkan

ไลบรารีแบบคงที่

หากต้องการลิงก์โปรเจ็กต์กับไลบรารีแบบคงที่ ให้ทำตามขั้นตอนต่อไปนี้

1. เพิ่ม gamesdk/include ลงในเส้นทางการรวมของคอมไพเลอร์

2. เพิ่มเส้นทางของแบบฟอร์มต่อไปนี้ในเส้นทางไลบรารี Linker ของคุณ

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release
   

   ดูใน gamesdk/libs แล้วเลือกตัวเลือกที่เหมาะกับเชนเครื่องมือของคุณมากที่สุด (สำหรับ เช่น gamesdk/libs/arm64-v8a_API24_NDK17_cpp_static_Release)

3. เพิ่ม -ltuningfork_static ลงในคำสั่ง Linker (และ -lswappy_static หาก คุณได้ผสานรวมไลบรารี Android Frame Pacing)

4. เพิ่มสิทธิ์ INTERNET ให้กับไฟล์ AndroidManifest.xml ดังนี้

   <uses-permission android:name="android.permission.INTERNET" />
   

คลังที่ใช้ร่วมกัน

ขั้นตอนในส่วนไลบรารีแบบคงที่ลิงก์แบบคงที่ เทียบกับเวอร์ชันของไลบรารี Tuning Fork ที่คอมไพล์สำหรับ ABI ที่ระบุ ชุดค่าผสมของระดับ API, NDK และ STL หากชุดค่าผสมไม่พร้อมใช้งานสำหรับ การตั้งค่าของคุณ คุณสามารถเชื่อมโยงกับไลบรารีที่ใช้ร่วมกันได้:

1. เพิ่ม gamesdk/include ลงในเส้นทางการรวมของคอมไพเลอร์

2. เพิ่มเส้นทางของแบบฟอร์มต่อไปนี้ในเส้นทางไลบรารี Linker ของคุณ

   gamesdk/libs/architecture_APIapiLevel_NDKndkVersion_stlVersion_Release/lib/tuningfork
   

3. เพิ่ม -ltuningfork ลงในคำสั่ง Linker (และ -lswappy หากผสานรวม ไลบรารี Android Frame Pacing)

4. เพิ่มสิทธิ์ INTERNET ให้กับไฟล์ AndroidManifest.xml ดังนี้

   <uses-permission android:name="android.permission.INTERNET" />
   

การลิงก์แบบคงที่ช่วยให้คุณมีรอยเท้าโค้ดขนาดเล็กลงมากเนื่องจากคุณไม่ต้อง รวมไลบรารีที่ใช้ร่วมกันของ libtuningfork.so

การใช้ CMake (ไลบรารีแบบคงที่เท่านั้น)

หากคุณใช้ CMake โปรดดู gamesdk/samples/tuningfork/insightsdemo/app/CMakeLists.txt ไฟล์เป็นตัวอย่าง การกำหนดค่า CMake โดยมีไฟล์ยูทิลิตี gamesdk/samples/gamesdk.cmake ซึ่งดำเนินการตรวจสอบขั้นสุดท้ายได้เพิ่ม คอมไพเลอร์จะมีเส้นทาง และสร้างเป้าหมายที่คุณสามารถใช้เพื่อเชื่อมโยง ไลบรารี

หากต้องการใช้ยูทิลิตีนี้ ให้ทำตามขั้นตอนต่อไปนี้

1. รวมไฟล์นี้ในไฟล์ CMakeLists.txt วันที่ include("path/to/gamesdk/samples/gamesdk.cmake")
2. เรียกฟังก์ชัน add_gamesdk_target ที่มีโฟลเดอร์ที่มีฟังก์ชัน SDK เกม: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. ในtarget_link_librariesสำหรับไลบรารีเนทีฟ ให้เพิ่ม tuningfork เป็น Dependency (และ swappy หากคุณผสานรวม Android Frame Pacing ไลบรารี): target_link_libraries(native-lib swappy tuningfork ...)

สำหรับการใช้งานขั้นสูงของ CMake โปรดดูไฟล์ต้นฉบับ gamesdk.cmake