其他 Unity 安裝選項

您可以從Google API 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 產品並將其升級至相同版本。

  • 不要在一個專案中混合使用匯入方法。也就是說,不要使用 Asset 套件流程和 Unity Package Manager 流程​​匯入 Firebase 產品。

下載後,導入:

  1. 在開啟的 Unity 專案中,導覽至Assets > Import Package > Custom Package

  2. 「匯入 Unity 套件」視窗中,按一下「匯入」

使用 Unity 套件管理器匯入 Firebase 套件

Google API 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 核心 ( com.google.firebase.app )
    3. 您的專案中使用的 Firebase 產品。如果您使用即時資料庫或雲端存儲,請先匯入身份驗證 ( 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. 在檔案瀏覽器中選擇解壓縮的資料夾。

清單.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 遷移到 Asset 套件

在某些情況下,您可能想要從使用 Unity Package Manager 追蹤 Firebase 產品切換到在Assets資料夾下匯入產品。

如果您不確定要使用哪種匯入方法,請在 Unity 專案資料夾中開啟檔案Packages/manifest.json 。如果檔案包含以com.google.firebase開頭的條目,則您的專案使用 Unity Package Manager 進行匯入。

遷移到資產包:

  1. 記下專案中目前的 Firebase 套件版本並將其刪除。

    1. 「視窗」功能表中,選擇「套件管理器」 。在「套件管理器」視窗中,確保選擇「套件:在專案中」。
    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 套件管理器:

  1. 確保使用下列方法之一從Assets資料夾中刪除所有 Firebase 套件和外部依賴管理器套件。

    EDM4U使用者介面

    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 套件管理器匯入套件,如本頁上述所述。