iOS Native - SPM
คู่มือการติดตั้ง iOS Native (SPM)¶
เอกสารนี้อธิบายวิธีเพิ่ม Hercules ลงใน โปรเจกต์ iOS ที่ใช้ Swift Package Manager (SPM)
1. เพิ่มแพ็กเกจ Hercules¶
เปิดโปรเจกต์ที่จะใช้ Hercules ใน Xcode แล้วไปที่เมนูต่อไปนี้
ป้อน URL ของที่เก็บต่อไปนี้ในช่อง Search or Enter Package URL ที่มุมขวาบน
เมื่อพบแพ็กเกจแล้ว ให้เลือกเวอร์ชันที่ต้องการติดตั้ง
คู่มือนี้ใช้เวอร์ชัน 26.8.31
| รายการ | ค่า |
|---|---|
| Dependency Rule | Exact Version |
| Version | 26.8.31 |
ตรวจสอบการตั้งค่า แล้วเลือก Add Package
ในหน้าต่างป๊อปอัปถัดไป ให้เลือก Target ที่ต้องการเพิ่มแพ็กเกจ สามารถเลือกได้เพียงหนึ่ง Target เท่านั้น หากต้องการเพิ่มแพ็กเกจให้กับหลาย Target สามารถเพิ่มให้กับ Target อื่นได้ในขั้นตอนถัดไป
2. ตรวจสอบการลิงก์ Hercules กับ Target¶
ตรวจสอบว่าได้เพิ่ม Hercules ให้กับ Target ที่ต้องการแล้ว หากยังไม่มี ให้เพิ่มด้วยตนเอง
หากต้องการนำ Hercules ออกจาก Target ใดในภายหลัง ให้ลบออกจากรายการนี้
3. ใช้ API¶
include เฮดเดอร์ Hercules.h ในซอร์สโค้ดที่จะใช้ Hercules
ตัวอย่าง:
#import <Hercules/Hercules.h>
...
unsigned int version = HerculesGetVersion();
NSLog(@"Hercules version: %u", version);
ระบบจะเริ่มต้นการทำงานโดยอัตโนมัติเมื่อ Hive SDK เริ่มต้นการทำงาน
ไม่จำเป็นต้องเรียก InitializeHercules แยกต่างหาก
4. เปลี่ยนเวอร์ชัน¶
หากต้องการเปลี่ยนเวอร์ชันของ Hercules ให้เปิดการตั้งค่า Package Dependencies ของโปรเจกต์ใน Xcode
ตั้งค่า Dependency Rule เป็น Exact Version แล้วเปลี่ยนเป็นเวอร์ชันของ Hercules ที่ต้องการ
5. นำ Hercules ออก¶
หากต้องการนำ Hercules ออกจากทั้งโปรเจกต์ ให้เปิดการตั้งค่า Package Dependencies
เลือก Hercules จากรายการแล้วลบออก และลบโค้ดที่เกี่ยวข้องกับ API ด้วย
หากยังมี Hercules อยู่ใน Frameworks, Libraries, and Embedded Content ของ Target ให้ลบออกจากที่นั่นด้วย




