Unity 用の Google パッケージは、次の 2 種類の形式で配布されています。
- アセット パッケージ:
.unitypackage
拡張機能がある。- プロジェクトの
Assets
ディレクトリにインストールします。 - Unity 5 以降でインポートできる。
- 通常、依存パッケージを含めます。
- Unity Package Manager(UPM)パッケージ:
.tgz
拡張機能がある。- プロジェクトの
Packages
ディレクトリにインストールします。 - Unity 2018.4 以降でインポートできる。
- 個別にインストールする必要がある依存パッケージを参照します。
[パッケージ] ページには、利用可能なすべてのパッケージの最新の .unitypackage
ファイルが表示されます。
[アーカイブ] ページには、すべてのパッケージ バージョンの .unitypackage
ファイルと .tgz
ファイルが含まれています。
以下に、両方のタイプのパッケージをインストールする方法と、別のタイプに移行する手順を示します。
これらのインストール オプションを理解したら、Firebase のプロダクト固有の手順をご覧ください。
.unitypackage
ファイルを含むアセット パッケージのインポート
Unity メニュー オプション Assets > Import package > Custom Package
を選択し、すべてのアイテムをインポートして、.unitypackage
ファイルをインポートします。これにより、パッケージの内容が [Assets] ディレクトリ下のプロジェクトに追加されます。
.tgz
ファイルを使用して UPM パッケージをインポートする(2018.4 以降)
次のいずれかの方法で .tgz
ファイルをプロジェクトにインポートします。
manifest.json
- プロジェクトの
Packages
フォルダの横に新しいフォルダを作成し、GooglePackages
という名前を付けます。 - そのフォルダに
.tgz
ファイルを配置します。 - テキスト エディタを使用して、Unity プロジェクト フォルダにある
Packages/manifest.json
を開きます。 インストールする各パッケージのエントリを追加し、パッケージ名を
Packages/manifest.json
ファイルからの相対パスにマッピングします。.tgz
ファイルのパスに必ずfile:
を追加してください。たとえば、com.google.firebase.storage
とその依存関係をインストールする場合、manifest.json は次のようになります。{ "dependencies": { "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz", "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz", "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz", "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz", // com.unity package entries... } }
manifest.json ファイルを保存します。
Unity がフォーカスを取り戻すと、manifest.json を再読み込みして、新しく追加されたパッケージをインポートします。
古いバージョンの Unity の中には、 manifest.json 内の .tgz
ファイルをサポートしていないものがあります。この場合は、次のようにします。
.tgz
ファイルを解凍します。- 抽出したフォルダを
GooglePackages
フォルダに配置します。 manifest.json を編集して、次のように、
.tgz
ファイルではなく、抽出したフォルダへのパスを使用します。{ "dependencies": { "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164", "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0", "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0", "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0", // com.unity package entries... } }
パッケージ マネージャーの UI
- Unity の Package Manager ウィンドウを開きます。
[Package Manager] ウィンドウの左上にある
+
アイコンをクリックし、Add package from tarball
を選択してファイル ブラウザを開きます。ファイル ブラウザで目的の tarball を選択します。
古いバージョンの Unity の中には、tarball を直接追加できないものもあります。この場合は、以下を行う必要があります。
.tgz
ファイルを解凍します。[Package Manager] ウィンドウの左上にある
+
アイコンをクリックし、Add package from disk
を選択してファイル ブラウザを開きます。ファイル ブラウザで、抽出したフォルダを選択します。
パッケージの依存関係の .tgz
ファイルもインポートしてください。依存関係は、アーカイブ ページの目的のパッケージのセクションで確認できます。
たとえば、com.google.firebase.storage
をインストールする場合は、これらの .tgz
ファイルを次の順序でインストールします。
- External Dependency Manager(
com.google.external-dependency-manager
) - Firebase Core(
com.google.firebase.app
) - Firebase Auth(
com.google.firebase.auth
) - Firebase Storage(
com.google.firebase.storage
)
順序を気にせずにすべての .tgz
ファイルを一度に追加したい場合は、manifest.json タブの手順に沿って操作します。
バージョン管理
バージョン管理ソフトウェアを使用してプロジェクト ファイルを管理している場合は、関連する .tgz
ファイルをバージョン管理に追加することをおすすめします。プロジェクトの manifest.json
を手動で編集し(上記の手順を参照)、相対パスを使用してローカルの .tgz
ファイルを参照できます。
Git を使用している場合、サイズの大きい .tgz
ファイルを管理するために Git Large File Storage(LFS)の使用をおすすめします。
UPM パッケージからアセット パッケージへの移行
Unity Package Manager を使用した Google パッケージの管理から、Assets フォルダにあるパッケージのインストールに切り替えることもできます。
次のいずれかの方法で、すべての Google パッケージを Unity Package Manager から削除します。
パッケージ マネージャーの UI
- Unity の Package Manager ウィンドウを開きます。
左上のプルダウンから [
In Project
] を選択します。検索バーに「
com.google
」と入力して、Google パッケージをフィルタします。各パッケージ名をクリックし、[
Remove
] をクリックします。
manifest.json
- テキスト エディタを使用して、Unity プロジェクト フォルダにある
Packages/manifest.json
を開きます。 - [依存関係] に Google のパッケージがあるかどうかを確認します。パッケージ名は「com.google」で始まる必要があります(例: 「com.google.firebase.app」)。
- これらの行を削除し、json ファイルを保存します。
- Unity がフォーカスを取り戻すと、
manifest.json
ファイルが再読み込みされ、削除されたパッケージが削除されます。
これらのパッケージを Unity Package Manager からアンインストールすると、アーカイブ ページから置換用の .unitypackage
ファイルをダウンロードしてインポートできます。
アセット パッケージから UPM パッケージへの移行
アセットツリーの下にあるプロダクトのインストールから、Unity Package Manager を使用したプロダクトのインストールとトラッキングに切り替えたい場合があります。
使用しているインストール方法がわからない場合は、Unity UI の [Project] タブの [Assets] に目的の Google パッケージが表示されているかどうかを確認します。
UPM パッケージに移行するには:
Assets フォルダからすべての Google パッケージが削除されていることを確認します。
- Firebase パッケージをアンインストールするには、こちらの手順に沿って操作します。
- Unity 用 Play プラグインをアンインストールするには、
Assets
のGooglePlayPlugins
フォルダを削除します。
上記の説明に沿って、Unity Package Manager を使用してパッケージをインストールします。
プロダクト固有の移行手順
Firebase の手順については、こちらをご覧ください。