콘텐츠로 이동

iOS Native - SPM

iOS Native 설치 가이드 (SPM)

이 문서는 Swift Package Manager(SPM)를 사용하는 iOS 프로젝트에 Hercules를 추가하는 방법을 설명합니다.


1. Hercules 패키지 추가

Xcode에서 Hercules를 적용할 프로젝트를 연 후 다음 메뉴로 이동합니다.

File > Add Package Dependencies...

오른쪽 상단의 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에 추가를 원하는 경우 다음 단계에서 추가할 수 있습니다.


2. Target에 Hercules 연결 확인

원하는 Target에 Hercules가 추가되어 있는지 확인하고 없으면 직접 추가합니다.

TARGETS > General > Frameworks, Libraries, and Embedded Content

추후 특정 Target에서 Hercules를 제거하려면 이 목록에서 제거합니다.


3. API 사용

Hercules를 사용할 소스에서 Hercules.h 헤더를 포함하여 사용합니다.

예:

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

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

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


4. 버전 변경

Hercules 버전을 변경하려면 Xcode에서 프로젝트의 Package Dependencies 설정을 엽니다.

PROJECT > Package Dependencies > Hercules

Dependency Rule을 Exact Version으로 설정하고 원하는 Hercules 버전으로 변경합니다.


5. Hercules 제거

프로젝트 전체에서 Hercules를 제거하려면 Package Dependencies 설정을 엽니다.

PROJECT > Package Dependencies

목록에서 Hercules를 선택한 후 제거하고 API 관련 코드도 제거합니다.

Target의 Frameworks, Libraries, and Embedded Content에 Hercules가 남아 있다면 함께 제거합니다.