其他 Unity 安裝選項

與其下載包含所有 .unitypackage 的大型 .zip 檔案 .NET 3.X 和 .NET 4.X 這兩種檔案，您可以透過 適用於 Unity 的 Google API。

這個網站提供：

  • 個別的 .NET 4.X .unitypackage 檔案，可匯入為資產套件。
  • 個別 .tgz 封存檔，可使用 Unity Package Manager 匯入。

當應用程式使用單一 Firebase 產品時，這種做法特別實用，因為個別的 .unitypackage 檔案會包含所有必要的依附元件，而 .tgz 檔案會與其依附的相關 .tgz 檔案一併列出。

本頁面提供有關 Unity 套件管理工具的操作說明， 瞭解 Unity 說明文件中的這項工具。

將 Firebase 套件匯入為資產

從 Google API for Unity 網站下載 .unitypackage 檔案時，如果要匯入 Firebase 產品，請注意下列事項：

  • 如果您在專案中使用多項 Firebase 產品，請務必下載 並將所有 Firebase 產品升級至相同版本

  • 請勿在單一專案中混用匯入方法。也就是說，不要匯入 採用資產套件流程和使用 Unity 套件的 Firebase 產品 管理員流程。

下載後匯入：

  1. 在您開啟的 Unity 專案中，依序前往「Assets」>「Import Package」>「Custom Package」。

  2. 在「Import Unity Package」視窗中，按一下「Import」。

使用 Unity Package Manager 匯入 Firebase 套件

從 Google APIs for Unity 存檔下載 .tgz 檔案時，請注意下列事項：

  • 這個方法僅適用於 2018.3 以上版本。

  • 如果您在專案中使用多項 Firebase 產品，請務必下載並將所有 Firebase 產品升級至相同版本。

  • 請勿在單一專案中混用匯入方法。也就是說，請勿使用資產套件流程和 Unity 套件管理員流程匯入 Firebase 產品。

  • 每個產品 .tgz 檔案的依附元件會在其專屬的 .tgz 檔案中連結。您必須下載並匯入產品 .tgz 檔案 依正確順序排列 .tgz 檔案：

    1. 外部依附元件管理工具 (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. 專案中使用的 Firebase 產品。如果您使用 Realtime Database 或 Cloud Storage，請先匯入 Authentication (com.google.firebase.auth)。

下載完成後，請使用.tgz 方法如下：

套件管理工具使用者介面

  1. 開啟 Unity 的「Package Manager」視窗。
  2. 按一下「Package Manager」視窗左上角的 + 圖示，然後 選取 Add package from tarball 開啟檔案瀏覽器。
  3. 在檔案瀏覽器中選取所需的 tarball。

某些舊版 Unity 2019 不支援直接新增 tarball。 此時，您必須：

  1. 解壓縮 .tgz 檔案。
  2. 按一下套件管理員左上角的 + 圖示 視窗並選取 Add package from disk，即可開啟檔案瀏覽器。
  3. 在檔案瀏覽器中選取擷取的資料夾。

manifest.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...
  }
}

從 Unity Package Manager 遷移至 Asset 套件

在某些情況下，您可能會想改用 Unity Package Manager 追蹤 Firebase 產品，並匯入 Assets 資料夾下的產品。

如果您不確定自己使用哪種匯入方法，請前往 Unity 專案 資料夾，開啟 Packages/manifest.json 檔案。如果檔案中包含項目 自 com.google.firebase起，您的專案使用 Unity Package Manager： 匯入。

如何遷移至資產套件：

  1. 記下專案中目前的 Firebase 套件版本，並移除這些版本。

    1. 在「Window」選單中，選取「Package Manager」。在「Package Manager」視窗中，確認已選取「Packages: In Project」。
    2. 記下已匯入 Firebase 套件的版本。
    3. 按一下每個套件名稱，然後按一下「移除」。請務必移除 外部依附元件管理工具套件 (.com.google.external-dependency-manager) 以及 Firebase 套件

  2. 下載並匯入替換的 .unitypackage 檔案。您可以採用兩種方法：

    • 如果可以升級至各套件最新版本，請下載 Firebase Unity SDK ZIP 檔案，然後按照「將 Firebase 新增至 Unity 專案」一文所述匯入。
    • 如果您需要保留目前的 .unitypackage 版本，可以按照本頁上方所述，下載及匯入個別套件。

從資產包遷移至 Unity Package Manager

在某些情況下，您可能會想要從匯入產品 Assets 資料夾，用於使用 Unity 套件管理工具匯入及追蹤產品。

如果不確定使用的是哪種匯入方法，請在 Unity 專案資料夾中開啟檔案 Packages/manifest.json。如果檔案中包含項目 從 com.google.firebase 開始，您的專案已使用 Unity 套件 用於匯入的管理員。

如要改用 Unity Package Manager，請按照下列步驟操作：

  1. 確認所有 Firebase 套件和外部依附元件管理工具套件 就會透過下列任一方法，從 Assets 資料夾中移除。

    EDM4U UI

    1. 在開放式 Unity 專案中，前往資產 >(外部連結) 依附元件管理員 >版本處理常式 >解除安裝受管理的應用程式 套件。
    2. 選取所有 Firebase 套件和外部依附元件管理工具。
    3. 按一下「解除安裝所選套件」。

    手動移除

    使用檔案系統工具手動刪除下列資料夾：

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

  2. 使用 Unity Package Manager 匯入套件，如上文所述 。