コンテンツにスキップ

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**に、次のリポジトリURLを入力します。

https://github.com/C2SP-GameSec/Hercules-SPM

パッケージが見つかったら、インストールするバージョンを選択します。

このガイドでは、バージョン26.8.31を使用します。

項目 値
Dependency Rule Exact Version
Version 26.8.31

設定を確認し、**Add Package**を選択します。

次のポップアップで、パッケージを追加するターゲットを選択します。 ここでは1つしか選択できないため、複数のターゲットに追加する場合は、次の手順で残りのターゲットに追加します。


2. ターゲットへのHerculesのリンク確認

対象のターゲットにHerculesが追加されていることを確認し、追加されていない場合は手動で追加します。

TARGETS > General > Frameworks, Libraries, and Embedded Content

後から特定のターゲットから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関連のコードも削除します。

ターゲットの**Frameworks, Libraries, and Embedded Content**にHerculesが残っている場合は、こちらからも削除します。