レジストリから名前を指定してパッケージをインストールする

インストールしたいパッケージの正確な名前が分かる場合は、Add package by name オプションを使用してインストールできます。これは、レジストリからパッケージを素早くインストールするひとつの方法です。

バージョンの指定は必須ではありません。インストールするバージョンがわからない場合や、最新の互換バージョンをインストールしたい場合は、パッケージ名のみを入力してください。

ノート: 最新の互換バージョンは最新の公開パッケージではない場合があります。パッケージの リリース バージョンと、より新しい プレリリース または 実験的 バージョンがある場合、Version フィールドに明示的に値を入力 (任意) しない限り、Package Manager がリリースバージョンを選択します。

はじめに

パッケージ名を確認してください。パッケージ名は一意の識別子であり、ユーザーインターフェースやドキュメントで使用される表示名ではありません。

Unity レジストリ内のパッケージの場合、名前の一意な識別子には逆ドメイン名表記が使用され、com.unity.example という形式になります。スコープ付きレジストリ内のパッケージの場合、名前が同じパターンに従わない場合があります。

Unity レジストリや追加したスコープ付きレジストリの場合、Package Manager にパッケージが表示されていれば、それを選択して Inspector ウィンドウに詳細を表示できます。Name の値がパッケージ名です。

パッケージ名を特定する他の方法は、それをホストするレジストリによって変わります。

• Unity レジストリ内のパッケージの場合:
  • リリースパッケージ と プレリリースパッケージ のリストを使用して、表示名 (例: 2D Animation) からパッケージを特定します。ハイパーリンクの値がそのパッケージの名前です (例: com.unity.2d.animation)。
  • パッケージドキュメント に、Name の値を明示したインストール手順が含まれている場合があります。
  • 多くの場合、パッケージドキュメント の URL に、そのパッケージの名前が含まれています。例えば、AR Foundation パッケージのドキュメントの URL は https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.0/manual/index.html で、com.unity.xr.arfoundation がパッケージ名です。

• スコープ付きレジストリ内のパッケージに関しては、Package Manager と Inspector ウィンドウで名前が特定できない場合は、パッケージ作成者に連絡してパッケージ名をリクエストしてください。パッケージ作成者は、パッケージマニフェスト ファイル (package.json) 内の必須プロパティとしてこの名前を記録しています。

手順

名前を使ってレジストリパッケージを加える場合は、以下の手順で行います。

1. Unity で Package Manager ウィンドウ を (既に開いていない場合は) 開きます。

2. ステータスバーの Add ボタンをクリックします。パッケージを追加するためのオプションが表示されます。

   

3. 追加メニューから Add package by name を選択します。2 つのテキストボックスと Add ボタンが表示されます。

4. はじめに セクションに記載の方法で特定した、パッケージの Name を入力します。

   

   ノート: 無効なパッケージ名やバージョンを入力すると、Package Manager は、その名前やバージョンが見つからないという警告を表示します。正しいパッケージ名とバージョンを確認し、もう一度やり直してください。

5. (任意) インストールするバージョンが分かっている場合は、Version (optional) ボックスに 完全なパッケージバージョン名 (例えば 1.3.0-pre.2 など) を入力します。

6. Add をクリックします。Unity がパッケージを正常にインストールできた場合、そのパッケージが、レジストリからインストールされた他のパッケージと同様に、パッケージリスト に表示されます。

ノート: この方法は、現在 Unity のパッケージレジストリにホストされているすべてのパッケージとバージョン、または現在のプロジェクトで設定した スコープ付きパッケージレジストリ に対して有効です。