Version: 2023.1
言語: 日本語
Unity のパッケージ使用のしくみ
パッケージの状態とライフサイクル

概念

ここでは、Unity Package Manager の機能に関する多くの概念について説明します。

バージョン

各パッケージには複数のバージョンがあり、ライフサイクルに沿ってそのパッケージに変更が加えられます。開発者がパッケージを更新するたびに、新しいバージョン番号が与えられ ます。パッケージバージョンの変更は、 セマンティックバージョニングにしたがって、破壊的変更 (メジャー)、新しい後方互換性機能 (マイナー)、バグ修正のみ (パッチ) のいずれであるかを示します。

特定のパッケージで使用可能なバージョンのリストを見るには、特定のバージョンの検索 を参照してください。

マニフェスト

マニフェストファイルには 2 つのタイプがあります。

  • プロジェクトマニフェスト (manifest.json) は、Package Manager が正しいパッケージ (依存関係として宣言したパッケージやバージョンのリストなど) を見つけて読み込むために必要な情報を格納します。
  • パッケージマニフェスト (package.json) は、特定のパッケージに関する情報と、そのパッケージが必要とするパッケージとバージョンのリストを格納します。

どちらのファイルも JSON(JavaScript Object Notation) 構文を使用します。

レジストリ

Unity のパッケージマネージャの領域では、パッケージレジストリとは、パッケージのコンテンツや各パッケージのバージョンに関する情報 (メタデータ) を保存するサーバーのことです。Unity では、配布可能な公式パッケージのレジストリを一元管理しています。デフォルトでは、すべてのプロジェクトは公式の Unity パッケージレジストリを使用しますが、プライベートなパッケージを保存して配布したり、開発中のカスタムパッケージをステージングするために、追加のレジストリを作成する ことができます。

パッケージ管理

Unity Package Manager はパッケージシステム全体を管理するツールです。主なタスクは以下のとおりです。

Unity Package Manager は、サンプル、ツール、アセットを特定のマシンやデバイスのすべてのプロジェクトにインストールするのではなく、プロジェクトごとにインストールします。ダウンロードしたパッケージのメタデータとコンテンツを保存するために グローバルキャッシュ を使用します。一度プロジェクトにインストールすると、Unity は、パッケージアセット をプロジェクト内の他のアセットと同じように扱います。ただし、これらのアセットは パッケージフォルダー内 に格納され、変更不可能 である点が異なります。ローカル埋め込み のパッケージソースのコンテンツにのみ、永続的な変更を加えることができます。

パッケージソース

ソースには、 パッケージの出所が記載されています。

ソース 説明 
レジストリ Unity Package Manager がリクエストを受けると、ほとんどのパッケージをパッケージレジストリサーバーからコンピューターの グローバルキャッシュ にダウンロードします。これらのパッケージは変更不可能です。そのため、プロジェクトで使用することはできますが、パッケージの変更やパッケージマニフェストの変更はできません。
ビルトイン これらのパッケージを使用すると、Unityの機能( Terrain (地形) Physics、アニメーションなど)を有効または無効にできます。それらは不変です。詳細については、 ビルトインパッケージを参照してください。
埋め込み プロジェクトフォルダー内に格納されているパッケージは、すべて 埋み込まれて います。このソースは カスタム の状態に当たります。なぜなら、通常、 パッケージの開発を開始するときに、新しいパッケージに必要なすべてのスクリプト、ライブラリ、サンプル、その他のアセットをプロジェクトフォルダーの下のフォルダーに保存するからです。
ローカル コンピューター上の 任意のフォルダーからパッケージをインストール できます (例えば、ローカルで開発リポジトリをクローンする場合)。
.tgz ファイル (local) コンピューターの .tgz ファイルからパッケージをインストール できます。 Package Manager は .tgz ファイルからパッケージを抽出し、キャッシュに格納します。ただし、ローカルフォルダーからのインストールとは異なり、これらのパッケージは変更不可能です。
Git Package Managerは、Git ベースのパッケージを、パッケージレジストリサーバーからではなく、Git リポジトリから直接インストールします。

パッケージマニフェストを編集するには、パッケージの検査 を参照してください。

Package Manager ウィンドウに 、これらの状態の一部に対応する タグ が表示されます。詳しい情報は、Tags を参照してください。

ノート: Package Manager は、Asset Store からダウンロードしたパッケージを、グローバルキャッシュとは別のキャッシュに保存します。詳しくは、Asset Store パッケージ を参照してください。

Unity のパッケージ使用のしくみ
パッケージの状態とライフサイクル