其他 Unity 安裝選項

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

這個網站提供：

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

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

本頁提供 Unity Package Manager 的相關操作說明，建議您先參閱 Unity 說明文件，瞭解這項工具。

將 Firebase 套件匯入為資產

從 Google APIs 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 檔案並匯入 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 產品。如果您使用 Realtime Database 或 Cloud Storage，請先匯入 Authentication (com.google.firebase.auth)。

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

套件管理工具使用者介面

  1. 開啟 Unity 的套件管理工具視窗。
  2. 按一下「套件管理工具」視窗左上角的 + 圖示，然後選取 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. 為要匯入的每個套件新增項目，將套件名稱對應至磁碟上的位置。請務必在 .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. 編輯 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」。在「套件管理員」視窗中，確認已選取「套件：在專案中」。
    2. 請記下匯入的 Firebase 套件版本。
    3. 按一下每個套裝組合名稱，然後按一下「移除」。請務必移除外部依附元件管理工具套件 (.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 套件和外部依附元件管理工具。
    3. 按一下「Uninstall Selected Package」(解除安裝所選套件)。

    手動移除

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

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

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