Check out what’s new from Firebase at Google I/O 2022. Learn more

追加のUnityインストールオプション

.NET3.Xと.NET4.Xの両方のすべての.unitypackageファイルを含む大きな.zipファイルをダウンロードするのではなく、UnityサイトのGoogleAPIから個々のパッケージをダウンロードできます。

このサイトは以下を提供します：

  • アセットパッケージとしてインポートする個々の.unitypackageファイル。
  • UnityPackageManagerを使用してインポートする個々の.tgzアーカイブ。

これは、アプリが単一のFirebase製品を使用する場合に特に便利です。これは、個々の.unitypackageファイルに必要なすべての依存関係が含まれており、 .tgzファイルがそれらが依存する関連する.tgzファイルと一緒に一覧表示されるためです。

このページでは、Unity Package Managerに関する手順を説明しているため、Unityのドキュメントからツールについて学ぶことをお勧めします。

Firebaseパッケージをアセットとしてインポートする

UnityサイトのGoogleAPIからダウンロードした.unitypackageファイルからFirebase製品をインポートする場合は、次の点に注意してください。

  • プロジェクトで複数のFirebase製品を使用している場合は、すべてのFirebase製品をダウンロードして同じバージョンにアップグレードする必要があります。

  • 1つのプロジェクトにインポート方法を混在させないでください。つまり、AssetパッケージフローとUnityPackageManagerフローを使用してFirebase製品をインポートしないでください。

ダウンロード後、インポートするには：

  1. 開いているUnityプロジェクトで、[アセット] >[パッケージのインポート] >[カスタムパッケージ]に移動します。

  2. [ Unityパッケージのインポート]ウィンドウで、[インポート]をクリックします。

UnityPackageManagerを使用してFirebaseパッケージをインポートする

Unityアーカイブ用のGoogleAPIからダウンロードした.tgzファイルからFirebase製品をインポートする場合は、次の点に注意してください。

  • この方法は2018.3以降でのみ使用できます。

  • プロジェクトで複数のFirebase製品を使用している場合は、すべてのFirebase製品をダウンロードして同じバージョンにアップグレードする必要があります。

  • 1つのプロジェクトにインポート方法を混在させないでください。つまり、AssetパッケージフローとUnityPackageManagerフローを使用してFirebase製品をインポートしないでください。

  • 各製品の.tgzファイルの依存関係は、独自の.tgzファイルと一緒にリンクされています。製品の.tgzファイルと依存関係の.tgzファイルを正しい順序でダウンロードしてインポートする必要があります。

    1. 外部依存関係マネージャー（ com.google.external-dependency-manager ）
    2. Firebase Core（ com.google.firebase.app ）
    3. プロジェクトで使用されているFirebase製品。 RealtimeDatabaseまたはCloudStorageを使用する場合は、最初に認証（ com.google.firebase.auth ）をインポートします。

ダウンロード後、次のいずれかの方法を使用して.tgzファイルをプロジェクトにインポートします。

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

  1. Unityのパッケージマネージャーウィンドウを開きます。
  2. [パッケージマネージャー]ウィンドウの左上隅にある[ + ]アイコンをクリックし、[ Add package from tarball ]を選択してファイルブラウザーを開きます。
  3. ファイルブラウザで目的のtarballを選択します。

Unity 2019の一部の古いバージョンは、tarballの直接追加をサポートしていません。この場合、次のことを行う必要があります。

  1. .tgzファイルを解凍します。
  2. [パッケージマネージャー]ウィンドウの左上隅にある[ + ]アイコンをクリックし、[ Add package from disk ]を選択してファイルブラウザーを開きます。
  3. ファイルブラウザで解凍したフォルダを選択します。

マニフェスト.json

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

  4. インポートするパッケージごとにエントリを追加し、パッケージ名をディスク上の場所にマッピングします。必ずfile:を.tgzファイルパスに追加してください。たとえば、 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. 次のように、 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...
  }
}

UnityPackageManagerからAssetパッケージに移行する

場合によっては、Unity Package Managerを使用してFirebase製品を追跡することから、 Assetsフォルダーの下に製品をインポートすることへと切り替えることができます。

使用しているインポート方法がわからない場合は、UnityプロジェクトフォルダーでPackages/manifest.jsonファイルを開きます。ファイルにcom.google.firebaseで始まるエントリが含まれている場合、プロジェクトはインポートにUnityPackageManagerを使用しました。

アセットパッケージに移行するには：

  1. プロジェクト内の現在のFirebaseパッケージのバージョンをメモし、それらを削除します。

    1. [ウィンドウ]メニューから、[パッケージマネージャー]を選択します。 [パッケージマネージャー]ウィンドウで、[パッケージ：プロジェクト内]が選択されていることを確認します。
    2. インポートされたFirebaseパッケージのバージョンに注意してください。
    3. 各パッケージ名をクリックしてから、[削除]をクリックします。外部依存関係マネージャーパッケージ（ .com.google.external-dependency-manager ）とFirebaseパッケージを必ず削除してください。

  2. 置換.unitypackageファイルをダウンロードしてインポートします。 2つのオプションがあります。

    • 各パッケージの最新バージョンにアップグレードできる場合は、Firebase Unity SDK zipファイルをダウンロードし、「FirebaseをUnityプロジェクトに追加する」の説明に従ってインポートします。
    • 現在の.unitypackageバージョンを保持する必要がある場合は、このページの上記の説明に従って、個々のパッケージをダウンロードしてインポートできます。

アセットパッケージからUnityパッケージマネージャーへの移行

場合によっては、 Assetsフォルダーの下の製品のインポートからUnityPackageManagerを使用した製品のインポートと追跡に切り替えたいことがあります。

使用しているインポート方法がわからない場合は、UnityプロジェクトフォルダーでPackages/manifest.jsonファイルを開きます。ファイルにcom.google.firebaseで始まるエントリが含まれている場合、プロジェクトはすでにUnityPackageManagerをインポートに使用しています。

Unity Package Managerに移行するには：

  1. 次のいずれかの方法を使用して、すべてのFirebaseパッケージとExternalDependencyManagerパッケージがAssetsフォルダーから削除されていることを確認します。

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

    1. 開いているUnityプロジェクトで、 [アセット]>[外部依存関係マネージャー]>[バージョンハンドラー]>[管理パッケージのアンインストール]に移動します。
    2. すべてのFirebaseパッケージとExternalDependencyManagerを選択します。
    3. [選択したパッケージのアンインストール]をクリックします。

    手動での取り外し

    ファイルシステムツールを使用して、次のフォルダを手動で削除します。

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. このページの上記の説明に従って、UnityPackageManagerを使用してパッケージをインポートします。