Unity 用の Google パッケージをインストールする

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] ディレクトリ下のプロジェクトに追加されます。

注: Unity の [Package Manager] ウィンドウを使用してパッケージをインストール済みの場合は、古いバージョンのパッケージをアンインストールしてから、新しいパッケージをインポートします。手順については、下記をご覧ください。

.tgz ファイルを使用して UPM パッケージをインポートする（2018.4 以降）

次のいずれかの方法で .tgz ファイルをプロジェクトにインポートします。

manifest.json

1. プロジェクトの Packages フォルダの横に新しいフォルダを作成し、GooglePackages という名前を付けます。
2. そのフォルダに .tgz ファイルを配置します。
3. テキスト エディタを使用して、Unity プロジェクト フォルダにある Packages/manifest.json を開きます。

4. インストールする各パッケージのエントリを追加し、パッケージ名を 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...
     }
   }
   

5. manifest.json ファイルを保存します。

6. Unity がフォーカスを取り戻すと、manifest.json を再読み込みして、新しく追加されたパッケージをインポートします。

古いバージョンの Unity の中には、 manifest.json 内の .tgz ファイルをサポートしていないものがあります。この場合は、次のようにします。

1. .tgz ファイルを解凍します。
2. 抽出したフォルダを GooglePackages フォルダに配置します。

3. 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

1. Unity の Package Manager ウィンドウを開きます。

2. [Package Manager] ウィンドウの左上にある + アイコンをクリックし、Add package from tarball を選択してファイル ブラウザを開きます。

   

3. ファイル ブラウザで目的の tarball を選択します。

古いバージョンの Unity の中には、tarball を直接追加できないものもあります。この場合は、以下を行う必要があります。

1. .tgz ファイルを解凍します。

2. [Package Manager] ウィンドウの左上にある + アイコンをクリックし、Add package from disk を選択してファイル ブラウザを開きます。

   

   注: Unity 2018 では、+ アイコンがパッケージ リストペインの左下に配置されます。

3. ファイル ブラウザで、抽出したフォルダを選択します。

パッケージの依存関係の .tgz ファイルもインポートしてください。依存関係は、アーカイブ ページの目的のパッケージのセクションで確認できます。

たとえば、com.google.firebase.storage をインストールする場合は、これらの .tgz ファイルを次の順序でインストールします。

1. External Dependency Manager（com.google.external-dependency-manager）
2. Firebase Core（com.google.firebase.app）
3. Firebase Auth（com.google.firebase.auth）
4. Firebase Storage（com.google.firebase.storage）

順序を気にせずにすべての .tgz ファイルを一度に追加したい場合は、manifest.json タブの手順に沿って操作します。

注: すでに .unitypackage ファイルを使用してパッケージをインストールしている場合は、新しいパッケージを追加する前に、そのバージョンのパッケージを削除してください。手順については、下記をご覧ください。

バージョン管理

バージョン管理ソフトウェアを使用してプロジェクト ファイルを管理している場合は、関連する .tgz ファイルをバージョン管理に追加することをおすすめします。プロジェクトの manifest.json を手動で編集し（上記の手順を参照）、相対パスを使用してローカルの .tgz ファイルを参照できます。

Git を使用している場合、サイズの大きい .tgz ファイルを管理するために Git Large File Storage（LFS）の使用をおすすめします。

UPM パッケージからアセット パッケージへの移行

Unity Package Manager を使用した Google パッケージの管理から、Assets フォルダにあるパッケージのインストールに切り替えることもできます。

次のいずれかの方法で、すべての Google パッケージを Unity Package Manager から削除します。

パッケージ マネージャーの UI

1. Unity の Package Manager ウィンドウを開きます。

2. 左上のプルダウンから [In Project] を選択します。

   

3. 検索バーに「com.google」と入力して、Google パッケージをフィルタします。

   

4. 各パッケージ名をクリックし、[Remove] をクリックします。

manifest.json

1. テキスト エディタを使用して、Unity プロジェクト フォルダにある Packages/manifest.json を開きます。
2. [依存関係] に Google のパッケージがあるかどうかを確認します。パッケージ名は「com.google」で始まる必要があります（例: 「com.google.firebase.app」）。
3. これらの行を削除し、json ファイルを保存します。
4. Unity がフォーカスを取り戻すと、manifest.json ファイルが再読み込みされ、削除されたパッケージが削除されます。

これらのパッケージを Unity Package Manager からアンインストールすると、アーカイブ ページから置換用の .unitypackage ファイルをダウンロードしてインポートできます。

アセット パッケージから UPM パッケージへの移行

アセットツリーの下にあるプロダクトのインストールから、Unity Package Manager を使用したプロダクトのインストールとトラッキングに切り替えたい場合があります。

使用しているインストール方法がわからない場合は、Unity UI の [Project] タブの [Assets] に目的の Google パッケージが表示されているかどうかを確認します。

UPM パッケージに移行するには:

1. Assets フォルダからすべての Google パッケージが削除されていることを確認します。

   • Firebase パッケージをアンインストールするには、こちらの手順に沿って操作します。
   • Unity 用 Play プラグインをアンインストールするには、Assets の GooglePlayPlugins フォルダを削除します。

2. 上記の説明に沿って、Unity Package Manager を使用してパッケージをインストールします。

プロダクト固有の移行手順

Firebase の手順については、こちらをご覧ください。