iOS Native - SPM
iOS Native 安裝指南(SPM)¶
本文件說明如何將 Hercules 加入**使用 Swift Package Manager(SPM)的 iOS 專案**。
1. 加入 Hercules 套件¶
在 Xcode 中開啟要使用 Hercules 的專案,然後前往下列選單。
在右上角的 Search or Enter Package URL 中輸入下列儲存庫網址。
找到套件後,選擇要安裝的版本。
本指南使用 26.8.31 版本。
| 項目 | 值 |
|---|---|
| Dependency Rule | Exact Version |
| Version | 26.8.31 |
確認設定後,選擇 Add Package。
在接下來的彈出視窗中,選擇要加入套件的 Target。 此處只能選擇一個 Target;若要加入多個 Target,可在下一步中加入其餘 Target。
2. 確認 Target 已連結 Hercules¶
確認 Hercules 已加入所需的 Target;若尚未加入,請手動加入。
日後若要從特定 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,也請一併移除。




