เพิ่ม Audience Network SDK ลงในแอพ iOS ของคุณ

คู่มือนี้อธิบายถึงวิธีเพิ่ม Audience Network SDK ลงในแอพ iOS เพื่อให้คุณสามารถเรียกใช้ API ของ Audience Network ได้ โดยวิธีที่แนะนำคือ ให้ใช้ CocoaPods เพื่อจัดการ Dependency อย่างไรก็ตาม เราได้ให้ตำแหน่งดาวน์โหลดสำหรับการผสานการทำงานด้วยตนเองด้วยเช่นกัน

CocoaPods (วิธีการดาวน์โหลดที่แนะนำ)

เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์ของคุณ

pod 'FBAudienceNetwork'

เรียกใช้คำสั่งต่อไปนี้

pod install

ดาวน์โหลดด้วยตนเอง

หากคุณไม่สามารถใช้ CocoaPods ได้ คุณก็สามารถดาวน์โหลด Audience Network SDK ได้จากตำแหน่งที่ระบุไว้ในตารางต่อไปนี้

หลังจากที่ดาวน์โหลด Audience Network SDK แล้ว ให้ดำเนินการผสานการทำงานให้เสร็จสมบูรณ์ดังต่อไปนี้

1. เปิดโปรเจ็กต์ของคุณใน XCode
2. ลาก FBAudienceNetwork.xcframework จากโฟลเดอร์ Dynamic ในคลัง Audience Network SDK สำหรับ iOS มาปล่อยลงใน XCode
3. เลือก Embed & Sign (ฝังและลงชื่อ) สำหรับ FBAudienceNetwork.xcframework ในแท็บ General (ทั่วไป) ในการตั้งค่าเป้าหมายสำหรับแอพพลิเคชั่นของคุณ

หมายเหตุ

• คุณสามารถใช้ตัวแปรแบบคงที่ของ Audience Network SDK ที่มีให้ในการดาวน์โหลดได้เช่นกัน โดยมีวิธีคือ ให้ลากและปล่อย FBAudienceNetwork.xcframework จากโฟลเดอร์ Static
• หากคุณต้องการใช้ตัวแปรแบบคงที่ ให้ตรวจสอบให้แน่ใจว่าโปรเจ็กต์ของคุณใช้ Swift อยู่ หากโปรเจ็กต์ของคุณไม่ได้ใช้ Swift ให้เพิ่มไฟล์ Swift เปล่า (File (ไฟล์) -> New (ใหม่) -> Swift ใน XCode) ลงในโปรเจ็กต์
• หากโปรเจ็กต์กำหนดเป้าหมายเวอร์ชั่น iOS ที่เก่ากว่า 12.4 ให้ตรวจสอบให้แน่ใจว่าได้กำหนดการตั้งค่า Always embed Swift standard libraries (ฝังคลังมาตรฐาน Swift เสมอ) เป็น YES ในส่วน Build settings (การตั้งค่าบิลด์) ของเป้าหมายแอพพลิเคชั่นใน XCode
• ให้ใช้ CocoaPods เพื่อหลีกเลี่ยงการปรับแต่งเพิ่มเติมหลังการติดตั้งด้วยตนเอง

การแก้ไขปัญหาสำหรับ SDK ตั้งแต่เวอร์ชั่น 6.9.0 ขึ้นไป

Audience Network SDK สำหรับ iOS ได้เปิดใช้งาน Swift แล้วตั้งแต่เวอร์ชั่น 6.9.0 เป็นต้นไป โปรดดูประเด็นต่างๆ ด้านล่างนี้ เพื่อจัดการปัญหาที่พบได้บ่อยที่สุดในการติดตั้ง SDK และการทำงานร่วมกันของ Swift

• XCode แสดงข้อผิดพลาด ได้แก่ 'Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection' และ 'Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider' ข้อผิดพลาดเหล่านี้หมายความว่าคุณไม่ได้ใช้ XCode เวอร์ชั่นล่าสุด ให้อัพเดตเป็น XCode เวอร์ชั่น 13 ขึ้นไปเพื่อแก้ไขข้อผิดพลาดนี้
• XCode แสดงข้อผิดพลาด Undefined symbol__swift_FORCE_LOAD_$_ จำนวนมาก ข้อผิดพลาดเหล่านี้หมายความว่าคุณไม่ได้เปิดใช้งานการรองรับ Swift สำหรับโปรเจ็กต์ของคุณ ซึ่งวิธีที่ง่ายที่สุดในการแก้ไขปัญหานี้คือ ให้เพิ่มไฟล์ Swift เปล่า ('File (ไฟล์)' -> 'New (ใหม่)' -> 'Swift file (ไฟล์ Swift)' ใน XCode)
• เมื่อเรียกใช้บนอุปกรณ์ แอพพลิเคชั่นจะขัดข้องทันทีหลังจากเริ่มทำงาน โดยแสดงข้อผิดพลาดว่า 'dyld: Library not loaded: @rpath/FBAudienceNetwork.framework' ข้อผิดพลาดนี้หมายความว่าคุณไม่ได้ฝัง Audience Network SDK ลงในแอพ โปรดไปที่การตั้งค่าเป้าหมายของคุณแล้วเลือก 'Embed & Sign (ฝังและลงชื่อ)' สำหรับ 'FBAudienceNetwork.xcframework' บนแท็บ 'General (ทั่วไป)'
• แอพพลิเคชั่นขัดข้องทันทีหลังจากเริ่มทำงาน โดยแสดงข้อผิดพลาดว่า 'dyld: Library not loaded: @rpath/libswiftCore.dylib' ข้อผิดพลาดนี้หมายความว่า คุณกำลังเรียกใช้แอพบน iOS ที่เก่ากว่าเวอร์ชั่น 12.4 และไม่ได้กำหนดค่าเป็น 'YES' สำหรับการตั้งค่า "Always embed Swift standard libraries (ฝังคลังมาตรฐาน Swift เสมอ)" โปรดตรวจสอบให้แน่ใจว่าได้กำหนดการตั้งค่า "Always embed Swift standard libraries (ฝังคลังมาตรฐาน Swift เสมอ)" เป็น "YES" ในส่วน "Build settings (การตั้งค่าบิลด์)" ของเป้าหมายแอพพลิเคชั่นใน XCode