您可以從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 產品。
下載後,導入:
在開啟的 Unity 專案中,導覽至Assets > Import Package > Custom Package 。
在「匯入 Unity 套件」視窗中,按一下「匯入」 。
使用 Unity 套件管理器匯入 Firebase 套件
從Google API for Unity 檔案下載的.tgz
檔案匯入 Firebase 產品時,請記住以下幾點:
此方法僅適用於2018.3+。
如果您在專案中使用多個 Firebase 產品,則必須下載所有 Firebase 產品並將其升級至相同版本。
不要在一個專案中混合使用匯入方法。也就是說,不要使用 Asset 套件流程和 Unity Package Manager 流程匯入 Firebase 產品。
每個產品
.tgz
檔案的依賴項都連結在其自己的.tgz
檔案中。您必須按照正確的順序下載並匯入產品.tgz
檔案和依賴項.tgz
檔案:- 外部
com.google.external-dependency-manager
) - Firebase 核心 (
com.google.firebase.app
) - 您的專案中使用的 Firebase 產品。如果您使用即時資料庫或雲端存儲,請先匯入身份驗證 (
com.google.firebase.auth
)。
- 外部
下載後,使用以下方法之一將.tgz
檔案匯入到您的專案中:
套件管理器使用者介面
- 開啟 Unity 的套件管理器視窗。
- 點擊“套件管理器”視窗左上角的
+
圖標,然後選擇Add package from tarball
以開啟檔案瀏覽器。 - 在檔案瀏覽器中選擇所需的 tarball。
某些舊版的 Unity 2019 不支援直接新增 tarball。在這種情況下,您將需要:
- 解壓縮
.tgz
檔。 - 按一下「套件管理器」視窗左上角的
+
圖標,然後選擇Add package from disk
以開啟檔案瀏覽器。 - 在檔案瀏覽器中選擇解壓縮的資料夾。
清單.json
- 在專案的
Packages
資料夾旁邊建立一個新資料夾,並將其命名為GooglePackages
。 - 將
.tgz
檔案放入該資料夾中。 - 使用文字編輯器開啟 Unity 專案資料夾下的
Packages/manifest.json
。 為要匯入的每個包新增一個條目,將包名稱對應到磁碟上的位置。請務必將
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... } }
儲存
manifest.json
檔。當Unity重新獲得焦點時,它將重新載入
manifest.json
並匯入新新增的套件。
某些舊版的 Unity 不支援manifest.json
中的.tgz
檔。在這種情況下,您應該:
- 解壓縮
.tgz
檔。 編輯您的
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 進行匯入。
遷移到資產包:
記下專案中目前的 Firebase 套件版本並將其刪除。
- 從「視窗」功能表中,選擇「套件管理器」 。在「套件管理器」視窗中,確保選擇「套件:在專案中」。
- 請注意導入的 Firebase 包的版本。
- 按一下每個套件名稱,然後按一下「刪除」 。請務必刪除外部依賴管理器套件 (
.com.google.external-dependency-manager
) 以及 Firebase 套件。
下載並導入替換
.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 套件管理器:
確保使用下列方法之一從
Assets
資料夾中刪除所有 Firebase 套件和外部依賴管理器套件。EDM4U使用者介面
- 在開啟的 Unity 專案中,導覽至Assets > external Dependency Manager > Version Handler > Uninstall Managed Packages 。
- 選擇所有 Firebase 套件和外部相依性管理器。
- 按一下「卸載選定的套件」 。
手動移除
使用檔案系統工具手動刪除以下資料夾:
-
Assets/Editor Default Resources/Firebase
-
Assets/ExternalDependencyManager
-
Assets/Firebase
-
Assets/Parse
-
Assets/Plugins/iOS/Firebase
使用 Unity 套件管理器匯入套件,如本頁上述所述。