iOS Native - CocoaPods
iOS Native 설치 가이드 (CocoaPods)¶
이 문서는 CocoaPods를 사용하고 있는 iOS 프로젝트에 Hercules를 추가하는 방법을 설명합니다.
- CocoaPods의 유지보수 중지로 Xcode 향후 버전에서 호환성 문제가 발생할 가능성이 있으므로 SPM 사용을 권장합니다.
Hercules Spec 저장소:
https://github.com/Com2uSPlatformCorp/Hercules-iOS
1. Podfile에 Hercules Spec 저장소 추가¶
기존 Podfile의 source 설정에 Hercules 저장소를 추가합니다.
예:
Warning
기존 source를 제거하지 않도록 주의합니다.
2. Hercules 추가¶
버전을 선택하고 target 안에 Hercules 항목을 추가합니다. 이 가이드에서는 26.8.31 버전을 지정하여 사용했습니다.
예:
$HERCULES_VERSION = '26.8.31'
target 'GameApp' do
# 기존 Pods
pod '라이브러리 1'
pod '라이브러리 2'
# 여기에 Hercules를 추가
pod 'Hercules', $HERCULES_VERSION
end
Warning
상단 및 하단의 기존 내용을 제거하지 않도록 주의합니다.
3. Pod 설치¶
프로젝트의 Podfile이 있는 경로에서 다음 명령을 실행합니다.
4. 버전 변경¶
Hercules 버전을 변경하려면 Podfile에서 $HERCULES_VERSION 변수만 수정합니다.
예:
프로젝트의 Podfile이 있는 경로에서 다음 명령을 실행합니다.
5. 설치된 버전 확인¶
현재 프로젝트에 설치된 Hercules 버전은 Podfile.lock에서 확인할 수 있습니다.
예:
6. API 사용¶
Objective-C / Objective-C++¶
.xsworkspace로 프로젝트를 열고, Hercules.h 헤더를 포함하여 사용합니다.
예:
#import <Hercules/Hercules.h>
...
unsigned int version = HerculesGetVersion();
NSLog(@"Hercules version: %u", version);
초기화는 Hive SDK가 초기화 될 때 자동으로 진행됩니다.
따로 InitializeHercules를 호출할 필요가 없습니다.