การกำหนดค่าการเพิ่มประสิทธิภาพแนะนำโดยโปรไฟล์ใน Visual Studio

เปิดตัวการสนับสนุนการเพิ่มประสิทธิภาพแบบมีการแนะนำโปรไฟล์ใน AGDE เวอร์ชัน 22.2.71

การค้นหาการตั้งค่า PGO

เปิดการตั้งค่าโปรเจ็กต์จาก Solution Explorer

รูปที่ 1: หน้าต่างสำรวจโซลูชันของ Visual Studio

ตรวจสอบว่าแพลตฟอร์มของคุณได้รับการตั้งค่าเป็นการกำหนดค่า Android (เช่น Android-arm64-v8a)

ในแผงด้านซ้าย ให้เลือกคุณสมบัติการกำหนดค่า > ทั่วไป มองหา กลุ่มพร็อพเพอร์ตี้ชื่อ PGO

รูปที่ 2: กล่องโต้ตอบคุณสมบัติของโปรเจ็กต์

หมายเหตุ: หากไม่มีตัวเลือกเหล่านี้ (หรือประเภทแพลตฟอร์ม Android) คุณควร กำหนดค่าโปรเจ็กต์เพื่อใช้กับ AGDE

เปิดใช้บิลด์ที่ใช้ PGO ในโปรเจ็กต์

เพิ่มการกำหนดค่าใหม่ที่ชื่อว่า Instrumented ลงในโปรเจ็กต์ ข้อมูลนี้อิงตาม การกำหนดค่าที่คุณใช้ระหว่างการพัฒนาสำหรับการทดสอบ ซึ่งควรเป็น บิลด์ดั้งเดิมที่เพิ่มประสิทธิภาพแล้ว (คุณยังคงแก้ไขข้อบกพร่องเพิ่มเติมได้ คุณลักษณะที่เปิดใช้ตราบใดที่คุณเก็บการตั้งค่าการเพิ่มประสิทธิภาพของคอมไพเลอร์ไว้)

คลิกเครื่องมือจัดการการกำหนดค่า... ในกล่องโต้ตอบของหน้าพร็อพเพอร์ตี้

รูปที่ 3: กล่องโต้ตอบเครื่องมือจัดการการกำหนดค่า

ในกล่องโต้ตอบเครื่องมือจัดการการกำหนดค่า ให้เลือกโซลูชันที่ใช้งานอยู่ การกำหนดค่าและเลือก <New...>

รูปที่ 4: การสร้างการกำหนดค่าบิลด์ใหม่

... และสร้างการกำหนดค่าใหม่โดยใช้เครื่องมือ PGO

รูปที่ 5: กล่องโต้ตอบการกำหนดค่าโซลูชันใหม่

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

รูปที่ 6: กล่องโต้ตอบคุณสมบัติของโปรเจ็กต์ที่ไฮไลต์การตั้งค่า PGO

สำหรับการตั้งค่าโปรไฟล์การเพิ่มประสิทธิภาพที่แนะนำโดยโปรไฟล์ ให้ป้อนเส้นทางไปยัง เพื่อเขียนไฟล์ข้อมูลโปรไฟล์เอาต์พุตดิบในอุปกรณ์ Android โดยทั่วไปแล้วค่านี้ควรเป็น /data/data/<package name>/cache/ โดยที่ <package name> คือชื่อแพ็กเกจแบบเต็ม APK – เช่น com.google.sample.tunnel

สำหรับข้อมูลเชิงลึกเพิ่มเติมเกี่ยวกับวิธีการทำงาน โปรดดูที่ Clang เอกสารประกอบ

เขียนข้อมูลโปรไฟล์ที่ใช้ PGO ลงในอุปกรณ์

ระบบการวัดคุม PGO มักจะเขียนข้อมูล PGO ลงในอุปกรณ์เมื่อ การออกจากกระบวนการ บน Android จะไม่มีการออกจากแอป และเพราะแอปเหล่านั้นจะถูกยุติการใช้งานเสมอ ช่วงเวลานี้ หมายถึง "เขียนไปยังดิสก์" เริ่มต้น ฟังก์ชันการทำงานไม่เคยทริกเกอร์ จึงต้อง เพื่อเขียนข้อมูล PGO ด้วยตนเอง

แอปของคุณคุณควรเรียกใช้ __llvm_profile_write_file อย่างชัดแจ้งเพื่อเขียน ข้อมูลโปรไฟล์ สัญลักษณ์นี้ใช้ได้เฉพาะเมื่อสร้างอุปกรณ์ที่ใช้ PGO เท่านั้น งานสร้าง เพื่อให้ง่ายขึ้น เราขอแนะนำให้ใช้รูปแบบต่อไปนี้เมื่อ โดยประกาศ __llvm_profile_write_file ไปข้างหน้า

#ifdef PGO_INSTRUMENT
extern "C" int __llvm_profile_write_file(void);
#else
extern "C" int __llvm_profile_write_file(void) { return 0; }
#endif

การเรียกใช้ฟังก์ชันนี้จะเขียนข้อมูลโปรไฟล์ลงในโฟลเดอร์ที่คุณระบุ ก่อนหน้านี้

การดำเนินการเรียกใช้โปรไฟล์

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

ในขั้นตอนนี้ ให้คัดลอกโปรไฟล์ออกจากอุปกรณ์เพื่อนำไปใช้โดยคอมไพเลอร์

กำลังเตรียมข้อมูลโปรไฟล์ที่คอมไพเลอร์จะใช้

เมื่อใช้แบบแยกเดี่ยว เครื่องมือบรรทัดคำสั่ง llvm-profdata ที่จัดส่งเป็นส่วนหนึ่งของ ของ Clang/LLVM ใน Android NDK ใช้เพื่อเตรียมไฟล์ข้อมูลโปรไฟล์สำหรับการใช้งาน โดยคอมไพเลอร์ระหว่างการเพิ่มประสิทธิภาพบิลด์โดยใช้แนวทางโปรไฟล์

AGDE ทำขั้นตอนนี้ให้คุณโดยอัตโนมัติด้วยการรวมโปรไฟล์ใดๆ เข้าด้วยกัน ไฟล์ข้อมูลที่คุณเพิ่มลงในโครงการ และการนำไฟล์ดังกล่าวไปใช้เมื่อ การตั้งค่าโหมดการเพิ่มประสิทธิภาพที่แนะนำโดยโปรไฟล์ในหน้าพร็อพเพอร์ตี้ของโปรเจ็กต์ ตั้งค่าเป็นเพิ่มประสิทธิภาพ

การสร้างโปรเจ็กต์ที่มีการเปิดใช้การเพิ่มประสิทธิภาพตามโปรไฟล์

เมื่อคุณได้บันทึกโปรไฟล์และเพิ่มไว้ในโปรเจ็กต์แล้ว คอมไพเลอร์สามารถใช้ข้อมูลดังกล่าวเพื่อปรับแต่งการเพิ่มประสิทธิภาพของบิลด์ได้

สร้างการกำหนดค่าโปรเจ็กต์ใหม่สำหรับบิลด์ที่เพิ่มประสิทธิภาพ PGO เพื่อให้คุณ สร้างในโหมดนี้เมื่อจำเป็น

รูปที่ 7: การสร้างการกำหนดค่าบิลด์ที่เพิ่มประสิทธิภาพ PGO ใหม่

ตั้งค่าโหมดการเพิ่มประสิทธิภาพที่แนะนำโดยโปรไฟล์ในพร็อพเพอร์ตี้ของโปรเจ็กต์ เพื่อเพิ่มประสิทธิภาพ

รูปที่ 8: การตั้งค่าโหมดการเพิ่มประสิทธิภาพ PGO เป็น "เพิ่มประสิทธิภาพ"

คัดลอกไฟล์จากอุปกรณ์และเพิ่มไฟล์ลงในโปรเจ็กต์ในโซลูชัน สำรวจ คอมไพเลอร์จะใช้ไฟล์ข้อมูลโปรไฟล์เหล่านี้ในครั้งถัดไป คุณสร้างการกำหนดค่าที่เพิ่มประสิทธิภาพ PGO และใช้เพื่อปรับแต่งวิธีที่คอมไพเลอร์ ช่วยเพิ่มประสิทธิภาพโค้ดของคุณ

คุณสามารถคัดลอกไฟล์ข้อมูลโปรไฟล์ลงในโปรเจ็กต์จากอุปกรณ์โดยใช้ ADB หรือใช้โปรแกรมสำรวจอุปกรณ์ Android

การใช้การเพิ่มประสิทธิภาพแบบมีการแนะนำโปรไฟล์นอก AGDE

หากคุณใช้ระบบบิลด์ที่ AGDE ไม่สนับสนุน คุณอาจต้อง แก้ไขบิลด์โดยตรง ของ Clang เอกสารประกอบ ครอบคลุมสวิตช์ที่จำเป็น – -fprofile-generate และ -fprofile-use

หากคุณใช้เครื่องมือมิดเดิลแวร์สำหรับเกมของคุณ โปรดอ่านเอกสาร สำหรับเครื่องมือของคุณเพื่อดูวิธีเปิดใช้ PGO (หากรองรับ)