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

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

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

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

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

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

• ผสานรวมการเว้นวรรคเฟรมของ Android เข้ากับโปรแกรมแสดงผล OpenGL
• ผสานรวมการเว้นวรรคเฟรมของ Android เข้ากับตัวแสดงผล 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)

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)

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 โดยใช้โฟลเดอร์ที่มี gamesdk: add_gamesdk_target(PACKAGE_DIR path/to/gamesdk)
3. ใน target_link_libraries สำหรับไลบรารีเนทีฟ ให้เพิ่ม tuningfork เป็น การอ้างอิง (และ swappy หากคุณผสานรวมไลบรารี Android Frame Pacing ): target_link_libraries(native-lib swappy tuningfork ...)

ดูการใช้งาน CMake ขั้นสูงได้ที่gamesdk.cmakeไฟล์ต้นฉบับ