この記事の要点

Unity でパッケージを取り込む方法は大別して 3 つ: Package Manager / .unitypackage / Asset Store Package Manager（Window → Package Manager）が公式の標準窓口。Unity Registry / My Assets / Git URL / Local からインストール可 .unitypackage ファイルは古い配布形式。Assets → Import Package → Custom Package で取り込む Asset Store で購入したアセットは My Assets タブから直接インポート可能 依存関係は manifest.json（プロジェクト全体）と package.json（個別パッケージ）で管理 社内 npm / scoped registry を使うと、組織独自のパッケージ配信が可能

Unity のパッケージ取り込み方法 3 種

Unity に外部アセット / ライブラリを取り込む方法は、配布形式によって主に 3 通りあります。それぞれの使い方と仕組みを解説します。

方法	配布形式	取り込み口	主な用途
Package Manager	UPM パッケージ	Window → Package Manager	公式機能、Unity 純正、社内 npm
.unitypackage	単一ファイル（.unitypackage）	Assets → Import Package	Asset Store の旧配布、配布物
Asset Store（My Assets）	UPM または .unitypackage	Package Manager の My Assets タブ	購入済みストアアセット

方法 1: Package Manager（標準）

Unity 2018.1+ の標準窓口。Window → Package Manager を開くと、左上のドロップダウンで取得元を切替できます:

• Unity Registry: Unity 公式パッケージ（Cinemachine、ProBuilder、TextMeshPro 等）
• In Project: 現プロジェクトにインストール済み一覧
• My Assets: Asset Store で購入したアセット
• Built-in: Unity 本体の標準モジュール

Unity Registry からインストール

1. Package Manager を開く
2. 左上ドロップダウン → Unity Registry
3. パッケージを選択 → 右下 Install
4. バージョンが複数ある場合は See other versions

Git URL からインストール

GitHub 上のリポジトリを直接パッケージとして取り込めます:

1. Package Manager 左上の ＋ ボタン
2. Install package from git URL... を選択
3. 例: https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask

// Packages/manifest.json に直接追加もできる
{
  "dependencies": {
    "com.unity.cinemachine": "2.10.0",
    "com.unity.textmeshpro": "3.0.6",
    "com.cysharp.unitask": "https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask"
  }
}

Local パッケージ

ローカルフォルダにある UPM パッケージを取り込む方法。社内ライブラリの開発時によく使います:

1. Package Manager → ＋ → Install package from disk...
2. パッケージフォルダ内の package.json を選択

方法 2: .unitypackage ファイル

古い形式（Asset Store 旧配布、コミュニティ配布）。エクスプローラからファイルを直接プロジェクトにドラッグするか、メニューから取り込みます:

1. Assets → Import Package → Custom Package...
2. .unitypackage ファイルを選択
3. 取り込むファイル一覧のダイアログが出る → 必要なものだけチェック
4. Import ボタン

取り込み先は Assets/ 配下にそのまま展開されます。同名ファイルがあれば上書きされる点に注意。

逆: .unitypackage を作る

1. Project ウィンドウでフォルダ / ファイルを選択
2. 右クリック → Export Package...
3. 依存関係も含めるかチェック → Export

方法 3: Asset Store からインポート

Unity 2020+ では Asset Store の購入アセットは Package Manager の My Assets タブからインポートします（ブラウザでの操作は購入のみ）:

1. https://assetstore.unity.com でログイン → 購入
2. Unity Editor で Package Manager を開く
3. 左上ドロップダウン → My Assets
4. アセット選択 → Download → Import

manifest.json と package.json

Unity の UPM はパッケージマネージャ npm をベースにしています。設定ファイルは 2 種類:

Packages/manifest.json（プロジェクト全体）

{
  "dependencies": {
    "com.unity.cinemachine": "2.10.0",
    "com.unity.inputsystem": "1.7.0",
    "com.unity.render-pipelines.universal": "14.0.8"
  },
  "scopedRegistries": [
    {
      "name": "OpenUPM",
      "url": "https://package.openupm.com",
      "scopes": [ "com.cysharp", "jp.hadashikick" ]
    }
  ]
}

package.json（個別パッケージのメタデータ）

{
  "name": "com.example.mylib",
  "version": "1.0.0",
  "displayName": "My Library",
  "description": "社内共通ライブラリ",
  "unity": "2022.3",
  "dependencies": {
    "com.unity.textmeshpro": "3.0.6"
  }
}

Scoped Registry（社内 / OpenUPM）

独自レジストリを設定することで、組織独自のパッケージや OpenUPM 上のサードパーティパッケージをまとめて管理できます:

1. Edit → Project Settings → Package Manager
2. Scoped Registries に Name / URL / Scope を追加
3. Package Manager の左上ドロップダウンに新しいタブが追加

OpenUPM の例:

• Name: OpenUPM
• URL: https://package.openupm.com
• Scope(s): com.cysharp など

依存関係のトラブル

Q: パッケージインストール後にコンパイルエラー
A: ① Unity バージョンがパッケージ要件を満たしていない、② 他パッケージとバージョン衝突、③ asmdef の参照不足。Package Manager の Dependencies 欄で要件を確認。

Q: .unitypackage インポートで既存ファイルが上書きされた
A: バージョン管理（Git）必須。インポート前にコミットしておくと差分確認と巻き戻しができます。

Q: Package Manager が固まる / Loading が終わらない
A: Library/PackageCache を削除して Editor 再起動。または Packages/packages-lock.json を削除して再解決。

FAQ

Q: Asset Store のアセットを CI に含めるには？
A: 規約上、購入者のみの利用。チームメンバーが各自購入してリポジトリ外で取り込むか、組織ライセンスを買って .unitypackage を共有。

Q: UPM パッケージと .unitypackage どちらを選ぶ？
A: 新規は UPM が標準。アップデート・依存解決が楽。.unitypackage は 1 回ぽっきりのコピー配布で、後から修正の追従が手動になります。