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

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 ที่มีอยู่

ตัวอย่าง:

source 'https://github.com/Com2uSPlatformCorp/Hercules-iOS.git'
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 ของโปรเจกต์

pod install --repo-update

4. เปลี่ยนเวอร์ชัน

หากต้องการเปลี่ยนเวอร์ชันของ Hercules ให้แก้ไขเฉพาะตัวแปร $HERCULES_VERSION ใน Podfile

ตัวอย่าง:

$HERCULES_VERSION = '26.8.31'

เรียกใช้คำสั่งต่อไปนี้ในไดเรกทอรีที่มี Podfile ของโปรเจกต์

pod update Hercules --repo-update

5. ตรวจสอบเวอร์ชันที่ติดตั้ง

สามารถตรวจสอบเวอร์ชันของ Hercules ที่ติดตั้งอยู่ในโปรเจกต์ได้จาก Podfile.lock

ตัวอย่าง:

PODS:
  - Hercules (26.8.31)

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 แยกต่างหาก