其他 Unity 安裝選項

您可以從 Google APIs for Unity 網站下載個別套件，而不必下載包含 .NET 3.X 和 .NET 4.X 所有 .unitypackage 檔案的大型 .zip 檔案。

這個網站提供：

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

如果應用程式使用單一 Firebase 產品，這項功能就特別實用，因為個別 .unitypackage 檔案包含所有必要的依附元件，且 .tgz 檔案會與其依附的相關 .tgz 檔案一併列出。

本頁的操作說明涉及 Unity Package Manager，建議您參閱 Unity 說明文件，瞭解這項工具。

將 Firebase 套件匯入為資產

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

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

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

下載後，請按照下列步驟匯入：

  1. 在已開啟的 Unity 專案中，依序點選「Assets」 >「Import Package」 >「Custom Package」。

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

使用 Unity Package Manager 匯入 Firebase 套件

從 Google APIs for Unity 封存下載 .tgz 檔案，並從中匯入 Firebase 產品時，請注意下列事項：

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

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

  • 請勿在單一專案中混用匯入方法。也就是說，請勿同時使用 Asset 套件流程和 Unity Package Manager 流程匯入 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 檔案匯入專案：

Package Manager UI

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

部分舊版 Unity 2019 不支援直接新增 tarball。在這種情況下，您需要：

  1. 解壓縮 .tgz 檔案。
  2. 按一下 Package Manager 視窗左上角的 + 圖示，然後選取 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 遷移至資產套件

在某些情況下，您可能想從使用 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. 按一下每個套件名稱，然後點選「移除」。請務必移除 External Dependency Manager 套件 (.com.google.external-dependency-manager) 和 Firebase 套件。

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

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

從資產套件遷移至 Unity Package Manager

在某些情況下，您可能需要從匯入 Assets 資料夾下的產品，切換為使用 Unity Package Manager 匯入及追蹤產品。

如果不確定使用的是哪種匯入方法，請在 Unity 專案資料夾中開啟 Packages/manifest.json 檔案。如果檔案包含以 com.google.firebase 開頭的項目，表示專案已使用 Unity Package Manager 匯入。

如要遷移至 Unity Package Manager，請按照下列步驟操作：

  1. 請使用下列任一方法，確認所有 Firebase 套件和 External Dependency Manager 套件都已從 Assets 資料夾中移除。

    EDM4U UI

    1. 在已開啟的 Unity 專案中，依序前往「Assets」>「External Dependency Manager」>「Version Handler」>「Uninstall Managed Packages」。
    2. 選取所有 Firebase 套件和 External Dependency Manager。
    3. 按一下「解除安裝所選套件」。

    手動移除

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

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

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