Unity インストール

このページではパッケージのインストールだけを扱います。完了後は Unity Quick Start に進んでください。

前提条件

• Windows 10 以上
• Unity 2022.3 LTS
• 登録済みの appId

インストール方式を選ぶ

現在のリリースは、同じ機能を含む 2 種類の完全なオフライン形式を提供します。

方式	適したプロジェクト	配置と更新単位
Unity Package	既存プロジェクトと従来の import workflow	Assets/IGP.UnitySDK* に入り、再 import はファイル単位の置換
UPM .tgz	新規プロジェクトと package 単位のバージョン管理	Package Manager が管理し、manifest と lock file に記録

同じ module に両方の形式を使わないでください。すべてのプロジェクトで Core を先に導入し、Multiplayer、Compliance、GameKit を必要に応じて追加します。 Core は現在の Unity runtime platform を判定して、一致する Desktop または Mobile Host Session runtime を 1 つだけ作成します。利用者による設定は不要です。 公開 Multiplayer は初期化 mode を持たず、Core から descriptor を取得するか、 呼び出し元から明示的に受け取って RoomNode Game データプレーンだけを作成します。

Unity Package を使う

リリースノート から必要なファイルをダウンロードします。

• cn.indiegp.sdk.unity-0.3.4.unitypackage - Core（必須）
• cn.indiegp.sdk.unity.multiplayer-0.3.4.unitypackage - Multiplayer（任意）
• cn.indiegp.sdk.unity.compliance-0.3.4.unitypackage - Compliance（任意）
• cn.indiegp.sdk.unity.game-kit-0.3.4.unitypackage - GameKit / Leaderboard / Share（任意）

Core は com.unity.nuget.newtonsoft-json、Multiplayer はさらに com.unity.ugui を必要とします。未導入の場合は先に Package Manager から追加します。

"com.unity.nuget.newtonsoft-json": "3.2.1",
"com.unity.ugui": "1.0.0"

Unity Editor の Assets > Import Package > Custom Package... から Core を先に import し、その後で必要な任意 module をすべての SDK file を選択して import します。

オフライン UPM tarball を使う

同じバージョンの .tgz をダウンロードします。

• core-igp-0.3.4.tgz - Core（必須）
• multiplayer-igp-0.3.4.tgz - Multiplayer（任意）
• compliance-igp-0.3.4.tgz - Compliance（任意）
• game-kit-igp-0.3.4.tgz - GameKit / Leaderboard / Share（任意）

必要な package ごとに次を実行します。

1. Window > Package Manager を開きます。
2. 左上の + から Add package from tarball... を選びます。
3. 最初に core-igp-0.3.4.tgz を選び、compile 後に任意 module を追加します。

短い archive 名はダウンロードファイルだけの名称です。Package Manager では安定した cn.indiegp.sdk.unity* package ID が表示されます。Unity の package cache は編集しないでください。

チームや CI では tarball を LocalPackages/ などの安定した repository path に置きます。Package Manager は次のような entry を記録します。

"cn.indiegp.sdk.unity": "file:../LocalPackages/core-igp-0.3.4.tgz"

Packages/manifest.json、Packages/packages-lock.json、参照する tarball を commit し、すべての開発者と clean CI が同じ path を解決できるようにします。UPM は欠けたローカル tarball をこの Site から自動 download しません。

Unity Package から UPM へ移行する

最初は SDK version を変えずに移行します。

1. プロジェクト所有の IGPConfig、変更した sample、custom script を退避します。
2. 現在の module と version を記録します。
3. 対応する旧 directory、Assets/IGP.UnitySDK、Assets/IGP.UnitySDK.Multiplayer、Assets/IGP.UnitySDK.Compliance、Assets/IGP.UnitySDK.GameKit を削除します。
4. 同じ version の Core tarball を入れ、以前使っていた任意 module を追加します。
5. プロジェクト所有の設定を戻して明示的に bind し、scene と Prefab の Missing Script を確認します。
6. 重複 type や assembly error がないことを確認してから、必要なら新しい SDK version に更新します。

SDK はプロジェクト asset を scan、移動、または自動修復しません。旧 directory の削除と自有 content の移行は明示的に行います。

UPM package の更新と削除

更新は Add package from tarball... で対象 version を選び、manifest と lock file が新しい tarball を参照していることを確認します。導入済み IGP module の SDK version はそろえてください。

削除は Package Manager で任意 module を先に Remove し、Core を最後に削除します。

インストール確認

• Unity Package：対応する Assets/IGP.UnitySDK* が存在します。
• UPM：Package Manager に cn.indiegp.sdk.unity* が表示され、同じ module の旧 Assets directory が残っていません。
• Console に SDK compile、重複 assembly、依存解決 error がありません。
• 導入済み public IGP module の version が一致します。

Unity Quick Start に進んでください。

Unity 公式ドキュメント：ローカル tarball からのインストール、package の依存関係と解決。