コンテンツにスキップ

Unity

Hercules Unity Package インストールガイド

Herculesは、Unity Package Manager(UPM)からインストールできます。

以下の2つの方法のいずれかを選択し、レジストリとHerculesパッケージを追加します。


方法1. manifest.jsonファイルを直接編集してインストール

Unityプロジェクトの次のファイルを開きます。

<Unityプロジェクトのパス>/Packages/manifest.json

manifest.jsonのルートに次の内容を追加するか、既存の設定にマージします。

{
  "scopedRegistries": [
    {
      "name": "Com2uS Platform Security Repo",
      "url": "https://aas-auth.withhive.com/upm",
      "scopes": [
        "com.com2us.security"
      ]
    }
  ],
  "dependencies": {
    "com.com2us.security.hercules": "26.9.8",
    ...
  }
}
Warning

既存のscopedRegistriesまたはdependenciesがある場合は、削除や上書きをせず、上記の内容を既存の一覧に追加します。

設定を保存した後、Unityプロジェクトを開くと、Herculesパッケージが自動的にインストールされます。

バージョンの変更

dependenciesに指定されたバージョンを変更すると、目的のHerculesバージョンに更新できます。

"com.com2us.security.hercules": "26.9.8"

削除

dependenciesから次の項目を削除すると、Herculesパッケージが削除されます。

"com.com2us.security.hercules": "26.9.8"

Herculesを使用しなくなった場合は、scopedRegistriesに追加したCom2uS Platform Security Repoも削除できます。

manifest.jsonの編集方法の詳細は、Unityの公式ドキュメントを参照してください。


方法2. Unity Editorでインストール

1. Scoped Registryの追加

Unityプロジェクトを開き、次のメニューに移動します。

Edit > Project Settings > Package Manager

**Scoped Registries**に次のレジストリを追加します。

項目 値
Name Com2uS Platform Security Repo
URL https://aas-auth.withhive.com/upm
Scope(s) com.com2us.security

2. Herculesパッケージの追加

次のメニューを開きます。

Window > Package Manager

Package Managerの左上にある + ボタンをクリックし、Add package by name... を選択します。

次の情報を入力します。

項目 値
Name com.com2us.security.hercules
Version インストールするHerculesのバージョン(任意)

Versionを入力しない場合は、最新バージョンが選択されます。

インストールが完了すると、Package ManagerでHerculesパッケージを確認できます。

バージョンの変更と削除

インストール後は、Unity Package ManagerでHerculesのバージョンを変更したり、パッケージを削除したりできます。

Herculesを削除し、レジストリも使用しなくなった場合は、次の場所で追加したScoped Registryも削除します。

Edit > Project Settings > Package Manager > Scoped Registries

Herculesパッケージを直接編集して使用する方法

インストール済みのHerculesパッケージを直接編集して使用するには、パッケージを**Embedded package**に変更します。

Unity EditorのProjectウィンドウで、インストール済みのHerculesパッケージを右クリックし、Show in Explorer(Windows)または**Reveal in Finder**(macOS)を選択します。

開いたHerculesパッケージフォルダーをプロジェクトのPackagesフォルダーにコピーし、フォルダー名の末尾にある@<fingerprint>を削除します。

たとえば、インストール済みのパッケージが次の場所にある場合:

Library/PackageCache/com.com2us.security.hercules@26.9.8

次のような構成にします。

Packages/com.com2us.security.hercules

コピーしたパッケージは、Unityプロジェクトに含まれる**Embedded package**として認識されます。以降は、Packages/com.com2us.security.herculesフォルダー内のファイルを直接編集して使用できます。

Embedded packageの詳細は、Unityの公式ドキュメントを参照してください。