跳轉至

iOS Native - SPM

iOS Native 安裝指南(SPM)

本文件說明如何將 Hercules 加入**使用 Swift Package Manager(SPM)的 iOS 專案**。


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;若要加入多個 Target,可在下一步中加入其餘 Target。


2. 確認 Target 已連結 Hercules

確認 Hercules 已加入所需的 Target;若尚未加入,請手動加入。

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,也請一併移除。