iOS Native - SPM
iOS Native 설치 가이드 (SPM)¶
이 문서는 Swift Package Manager(SPM)를 사용하는 iOS 프로젝트에 Hercules를 추가하는 방법을 설명합니다.
1. Hercules 패키지 추가¶
Xcode에서 Hercules를 적용할 프로젝트를 연 후 다음 메뉴로 이동합니다.
오른쪽 상단의 Search or Enter Package URL에 다음 저장소 주소를 입력합니다.
패키지가 검색되면 설치할 버전을 선택합니다.
이 가이드에서는 26.8.31 버전을 사용합니다.
| 항목 | 값 |
|---|---|
| Dependency Rule | Exact Version |
| Version | 26.8.31 |
설정을 확인한 후 Add Package를 선택합니다.
다음 팝업에서 추가를 원하는 Target을 선택합니다. 한 개만 선택할 수 있으므로, 여러 Target에 추가를 원하는 경우 다음 단계에서 추가할 수 있습니다.
2. Target에 Hercules 연결 확인¶
원하는 Target에 Hercules가 추가되어 있는지 확인하고 없으면 직접 추가합니다.
추후 특정 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 설정을 엽니다.
Dependency Rule을 Exact Version으로 설정하고 원하는 Hercules 버전으로 변경합니다.
5. Hercules 제거¶
프로젝트 전체에서 Hercules를 제거하려면 Package Dependencies 설정을 엽니다.
목록에서 Hercules를 선택한 후 제거하고 API 관련 코드도 제거합니다.
Target의 Frameworks, Libraries, and Embedded Content에 Hercules가 남아 있다면 함께 제거합니다.




