iOS Native - CocoaPods
คู่มือการติดตั้ง iOS Native (CocoaPods)¶
เอกสารนี้อธิบายวิธีเพิ่ม Hercules ลงใน โปรเจกต์ iOS ที่ใช้ CocoaPods อยู่แล้ว
- แนะนำให้ใช้ SPM เนื่องจากการยุติการบำรุงรักษา CocoaPods อาจทำให้เกิดปัญหาความเข้ากันได้กับ Xcode เวอร์ชันในอนาคต
ที่เก็บ Hercules Spec:
https://github.com/Com2uSPlatformCorp/Hercules-iOS
1. เพิ่มที่เก็บ Hercules Spec ลงใน Podfile¶
เพิ่มที่เก็บ Hercules ลงในการตั้งค่า source ของ Podfile ที่มีอยู่
ตัวอย่าง:
Warning
ระวังอย่าลบ source เดิม
2. เพิ่ม Hercules¶
เลือกเวอร์ชันและเพิ่มรายการ Hercules ภายใน target คู่มือนี้ระบุให้ใช้เวอร์ชัน 26.8.31
ตัวอย่าง:
$HERCULES_VERSION = '26.8.31'
target 'GameApp' do
# Pods ที่มีอยู่เดิม
pod 'ไลบรารี 1'
pod 'ไลบรารี 2'
# เพิ่ม Hercules ที่นี่
pod 'Hercules', $HERCULES_VERSION
end
Warning
ระวังอย่าลบเนื้อหาเดิมที่อยู่ด้านบนและด้านล่าง
3. ติดตั้ง Pods¶
เรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีที่มี Podfile ของโปรเจกต์
4. เปลี่ยนเวอร์ชัน¶
หากต้องการเปลี่ยนเวอร์ชันของ Hercules ให้แก้ไขเฉพาะตัวแปร $HERCULES_VERSION ใน Podfile
ตัวอย่าง:
เรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีที่มี Podfile ของโปรเจกต์
5. ตรวจสอบเวอร์ชันที่ติดตั้ง¶
สามารถตรวจสอบเวอร์ชันของ Hercules ที่ติดตั้งอยู่ในโปรเจกต์ได้จาก Podfile.lock
ตัวอย่าง:
6. ใช้ API¶
Objective-C / Objective-C++¶
เปิดโปรเจกต์ผ่าน .xsworkspace แล้ว include เฮดเดอร์ Hercules.h เพื่อใช้ API
ตัวอย่าง:
#import <Hercules/Hercules.h>
...
unsigned int version = HerculesGetVersion();
NSLog(@"Hercules version: %u", version);
ระบบจะเริ่มต้นการทำงานโดยอัตโนมัติเมื่อ Hive SDK เริ่มต้นการทำงาน
ไม่จำเป็นต้องเรียก InitializeHercules แยกต่างหาก