콘텐츠로 이동

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 저장소를 추가합니다.

예:

source 'https://github.com/Com2uSPlatformCorp/Hercules-iOS.git'
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이 있는 경로에서 다음 명령을 실행합니다.

pod install --repo-update

4. 버전 변경

Hercules 버전을 변경하려면 Podfile에서 $HERCULES_VERSION 변수만 수정합니다.

예:

$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로 프로젝트를 열고, Hercules.h 헤더를 포함하여 사용합니다.

예:

#import <Hercules/Hercules.h>
...
unsigned int version = HerculesGetVersion();
NSLog(@"Hercules version: %u", version);

초기화는 Hive SDK가 초기화 될 때 자동으로 진행됩니다.

따로 InitializeHercules를 호출할 필요가 없습니다.