ข้ามไปที่เนื้อหา

iOS Native - SPM

คู่มือการติดตั้ง iOS Native (SPM)

เอกสารนี้อธิบายวิธีเพิ่ม Hercules ลงใน โปรเจกต์ iOS ที่ใช้ Swift Package Manager (SPM)


1. เพิ่มแพ็กเกจ Hercules

เปิดโปรเจกต์ที่จะใช้ Hercules ใน Xcode แล้วไปที่เมนูต่อไปนี้

File > Add Package Dependencies...

ป้อน URL ของที่เก็บต่อไปนี้ในช่อง Search or Enter Package URL ที่มุมขวาบน

https://github.com/C2SP-GameSec/Hercules-SPM

เมื่อพบแพ็กเกจแล้ว ให้เลือกเวอร์ชันที่ต้องการติดตั้ง

คู่มือนี้ใช้เวอร์ชัน 26.8.31

รายการ ค่า
Dependency Rule Exact Version
Version 26.8.31

ตรวจสอบการตั้งค่า แล้วเลือก Add Package

ในหน้าต่างป๊อปอัปถัดไป ให้เลือก Target ที่ต้องการเพิ่มแพ็กเกจ สามารถเลือกได้เพียงหนึ่ง Target เท่านั้น หากต้องการเพิ่มแพ็กเกจให้กับหลาย Target สามารถเพิ่มให้กับ Target อื่นได้ในขั้นตอนถัดไป


2. ตรวจสอบการลิงก์ Hercules กับ Target

ตรวจสอบว่าได้เพิ่ม Hercules ให้กับ Target ที่ต้องการแล้ว หากยังไม่มี ให้เพิ่มด้วยตนเอง

TARGETS > General > Frameworks, Libraries, and Embedded Content

หากต้องการนำ 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

PROJECT > Package Dependencies > Hercules

ตั้งค่า Dependency Rule เป็น Exact Version แล้วเปลี่ยนเป็นเวอร์ชันของ Hercules ที่ต้องการ


5. นำ Hercules ออก

หากต้องการนำ Hercules ออกจากทั้งโปรเจกต์ ให้เปิดการตั้งค่า Package Dependencies

PROJECT > Package Dependencies

เลือก Hercules จากรายการแล้วลบออก และลบโค้ดที่เกี่ยวข้องกับ API ด้วย

หากยังมี Hercules อยู่ใน Frameworks, Libraries, and Embedded Content ของ Target ให้ลบออกจากที่นั่นด้วย