其他 Unity 安裝選項

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

這個網站提供：

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

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

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

匯入 Firebase 套件做為資產

從下載的 .unitypackage 個檔案匯入 Firebase 產品時 Unity 網站適用的 Google API， 請留意以下事項：

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

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

下載後匯入：

  1. 在開放式 Unity 專案中，前往「Assets」 >「Import 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」。在「套件」 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 套件管理工具匯入及追蹤產品。

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

如何遷移至 Unity Package Manager：

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

    EDM4U 使用者介面

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

    手動移除

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

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

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