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

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

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

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

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

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

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

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

  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

ก่อนหน้า
เปิดใช้ Android Performance Parameters API
ถัดไป
กำหนดคำอธิบายประกอบ พารามิเตอร์ความแม่นยำ และการตั้งค่า