其他 Unity 安裝選項

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

這個網站提供：

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

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

本頁面提供有關 Unity Package Manager 的操作說明，建議您從 Unity 說明文件瞭解這項工具。

匯入 Firebase 套件做為資產

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

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

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

下載後匯入：

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

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

使用 Unity Package Manager 匯入 Firebase 套件

從 Unity 的 Google API 下載的 .tgz 檔案中匯入 Firebase 產品時，請留意以下事項：

  • 這個方法僅適用於 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 產品。如果您使用即時資料庫或 Cloud Storage，請先匯入驗證 (com.google.firebase.auth)。

下載完成後，請使用下列其中一種方法將 .tgz 檔案匯入專案中：

套件管理員 UI

  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 套件管理工具遷移至資產套件

在某些情況下，您可能想要從使用 Unity 套件管理工具追蹤 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 套件管理工具

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

如果您不確定自己使用哪種匯入方法，請在 Unity 專案資料夾中開啟 Packages/manifest.json 檔案。如果檔案含有開頭為 com.google.firebase 的項目，則專案已使用 Unity Package Manager 進行匯入。

如何遷移至 Unity Package Manager：

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

    EDM4U 使用者介面

    1. 在開啟的 Unity 專案中，依序前往「Assets」>「External Dependency Manager」>「Version Handler」>「解除安裝受管理的套件」。
    2. 選取所有 Firebase 套件和外部依附元件管理工具。
    3. 按一下「解除安裝所選套件」。

    手動移除

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

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

  2. 按照本頁上方所述，使用 Unity Package Manager 匯入套件。