Firebase is back at Google I/O on May 10! Register now

其他 Unity 安裝選項

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

無需下載包含 .NET 3.X 和 .NET 4.X 的所有.unitypackage文件的大型.zip文件，您可以從Google APIs for Unity 站點下載單獨的包。

該網站提供：

  • 要作為資產包導入的單個 .NET 4.X .unitypackage文件。
  • 要使用 Unity 包管理器導入的單個.tgz存檔。

當您的應用程序使用單個 Firebase 產品時，這尤其有用，因為各個.unitypackage文件包含所有需要的依賴項，並且.tgz文件與它們所依賴的相關.tgz文件一起列出。

此頁面提供了涉及 Unity 包管理器的說明，因此最好從 Unity 文檔 中了解該工具。

將 Firebase 包作為資產導入

從Google APIs for Unity 站點下載的.unitypackage文件導入 Firebase 產品時，請記住以下幾點：

  • 如果您在項目中使用多個 Firebase 產品，則必須下載所有 Firebase 產品並將其升級到同一版本。

  • 不要在一個項目中混用導入方法。也就是說，不要使用資產包流程和使用 Unity 包管理器流程導入 Firebase 產品。

下載後導入：

  1. 在您打開的 Unity 項目中，導航到Assets > Import Package > Custom Package 。

  2. 在“導入 Unity 包”窗口中，單擊“導入” 。

使用 Unity 包管理器導入 Firebase 包

從Google APIs for Unity archive下載的.tgz文件導入 Firebase 產品時，請記住以下幾點：

  • 此方法僅適用於 2018.3+。

  • 如果您在項目中使用多個 Firebase 產品，則必須下載所有 Firebase 產品並將其升級到同一版本。

  • 不要在一個項目中混用導入方法。也就是說，不要使用資產包流程和 Unity 包管理器流程導入 Firebase 產品。

  • 每個產品.tgz文件的依賴項都鏈接在它們自己的.tgz文件中。您必須以正確的順序下載並導入產品.tgz文件和依賴項.tgz文件：

    1. 外部依賴管理器 ( com.google.external-dependency-manager )
    2. Firebase 核心 ( com.google.firebase.app )
    3. 您的項目中使用的 Firebase 產品。如果您使用實時數據庫或云存儲，請先導入身份驗證 ( com.google.firebase.auth )。

下載後，使用以下方法之一將.tgz文件導入到您的項目中：

包管理器用戶界面

  1. 打開 Unity 的包管理器窗口。
  2. 單擊包管理器窗口左上角的+圖標，然後選擇Add package from tarball以打開文件瀏覽器。
  3. 在文件瀏覽器中選擇所需的 tarball。

一些舊版本的 Unity 2019 不支持直接添加壓縮包。在這種情況下，您需要：

  1. 解壓縮.tgz文件。
  2. 單擊包管理器窗口左上角的+圖標，然後選擇Add package from disk以打開文件瀏覽器。
  3. 在文件瀏覽器中選擇提取的文件夾。

清單.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 Package Manager 跟踪 Firebase 產品切換到在Assets文件夾下導入產品。

如果您不確定您使用的是哪種導入方法，請在您的 Unity 項目文件夾中打開文件Packages/manifest.json 。如果文件包含以com.google.firebase開頭的條目，則您的項目使用 Unity Package Manager 進行導入。

遷移到資產包：

  1. 記下項目中當前的 Firebase 包版本並將其刪除。

    1. 從窗口菜單中，選擇包管理器。在“包管理器”窗口中，確保選中“包：在項目中”。
    2. 請注意導入的 Firebase 包的版本。
    3. 單擊每個包名稱，然後單擊Remove 。請務必刪除外部依賴管理器包 ( .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 包管理器：

  1. 使用以下任一方法，確保所有 Firebase 包和外部依賴管理器包都已從Assets文件夾中刪除。

    包管理器用戶界面

    1. 在打開的 Unity 項目中，導航到Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages 。
    2. 選擇所有 Firebase 包和外部依賴管理器。
    3. 單擊卸載選定的程序包。

    手動移除

    使用文件系統工具，手動刪除以下文件夾：

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

  2. 使用 Unity 包管理器導入包，如本頁上文所述。