適用於 Unity 的 Google 套件會發布兩種不同格式：
- 素材資源套件：
- 提供
.unitypackage擴充功能。 - 安裝至專案的
Assets目錄。 - 可在 Unity 5 以上版本中匯入。
- 通常包含依附元件套件。
- 提供
- Unity Package Manager (UPM) 套件：
- 提供
.tgz擴充功能。 - 安裝至專案的
Packages目錄。 - 可在 Unity 2018.4 以上版本中匯入。
- 參照需要個別安裝的相依套件。
- 提供
「套件」頁面含有最新的 .unitypackage 檔案
適用於所有可用套件，而部分套件的 .tgz 檔案。
「封存」頁面含有以下項目的 .unitypackage 和 .tgz 個檔案：
。
以下提供安裝這兩種套件的操作說明，以及 並附上遷移操作說明，以便從類型轉換為另一種類型
熟悉這些安裝選項後，請務必參閱 其他 Firebase 產品專屬操作說明。
匯入含有 .unitypackage 個檔案的資產套件
選取 Unity 選單選項，匯入 .unitypackage 檔案
Assets > Import package > Custom Package並匯入所有項目。
這樣就能將套件內容新增至專案的「資產」下方
目錄。
匯入包含 .tgz 檔案 (2018.4 以上版本) 的 UPM 套件
透過下列其中一種方法，將 .tgz 檔案匯入專案：
manifest.json
- 在專案的
Packages資料夾旁邊建立新資料夾，並為該資料夾命名GooglePackages。 - 將
.tgz檔案放入該資料夾。 - 使用文字編輯器開啟 Unity 專案下的
Packages/manifest.json資料夾。 請為每個要安裝的套件新增一個項目，以對應套件名稱 相對於
Packages/manifest.json檔案的位置。請務必將file:附加至.tgz檔案路徑。適用對象 例如，您安裝com.google.firebase.storage及其 build.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檔案。 - 將擷取的資料夾放在
GooglePackages資料夾中。 編輯 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... } }
套件管理員 UI
- 開啟 Unity 的「Package Manager」視窗。
按一下「Package Manager」視窗左上角的
+圖示，然後 選取Add package from tarball開啟檔案瀏覽器。
在檔案瀏覽器中選取所需 tarball。
部分舊版 Unity 不支援直接新增 tarball。 此時，您必須：
- 解壓縮
.tgz檔案。 按一下套件管理員左上角的
+圖示 視窗並選取Add package from disk，即可開啟檔案瀏覽器。
在檔案瀏覽器中選取擷取的資料夾。
請務必一併匯入套件依附元件的 .tgz 檔案。
請前往封存頁面，在「封存」頁面
找到您所需的套件部分
舉例來說，假設您安裝 com.google.firebase.storage，
請依照下列順序安裝這 .tgz 個檔案：
- 外部依附元件管理工具 (
com.google.external-dependency-manager) - Firebase Core (
com.google.firebase.app) - Firebase 驗證 (
com.google.firebase.auth) - Firebase 儲存 (
com.google.firebase.storage)
如要一次新增所有 .tgz 檔案，不用擔心
請遵循
manifest.json 分頁。
版本管控
如果您使用版本管控軟體管理專案檔案，
建議您將相關的 .tgz 檔案新增至版本管控系統。您可以手動
編輯專案的manifest.json (請參閱
上述操作說明) 及參照本機 .tgz 檔案
相對路徑
如要使用 Git，建議您
Git 大型檔案儲存空間 (LFS)
，用於管理大型 .tgz 檔案。
從 UPM 套件遷移至資產套件
在某些情況下，您可能想要 Unity 套件管理工具 管理 Google 套件，或是在「資產」資料夾下安裝套件。
使用以下程式碼，確認所有 Google 套件已從 Unity Package Manager 中移除： 下列任一方法：
套件管理員 UI
- 開啟 Unity 的「Package Manager」視窗。
在左上方的下拉式選單中選取
In Project。
在搜尋列中輸入
com.google，即可篩選 Google 包裹。
按一下每個套件名稱，然後按一下
Remove。
manifest.json
- 使用文字編輯器開啟 Unity 專案下的
Packages/manifest.json資料夾。 - 在「dependencies」底下查看是否有來自 Google 的套件。包裹 名稱開頭應為「com.google」，例如「com.google.firebase.app」。
- 請刪除這些行，並儲存 json 檔案。
- 當 Unity 重新取得焦點時，會重新載入
manifest.json檔案並移除 已刪除的套件
從 Unity Package Manager 解除安裝這些套件後，
從封存檔下載並匯入替換的 .unitypackage 檔案
頁面。
從資產套件遷移至 UPM 套件
在某些情況下，您可能想要改為安裝 透過 Unity Package Manager 安裝及追蹤產品的資產樹狀結構。
如果不確定自己使用哪一種安裝方法，請在 Unity UI 中 檢查所需的 Google 套件是否顯示在「專案」分頁的「專案」分頁中 素材資源。
如何遷移至 UPM 套件：
確認所有 Google 套件已從「素材資源」資料夾中移除。
- 如要解除安裝 Firebase 套件，請按照下列步驟操作： 這些操作說明。
- 如要解除安裝 Unity 適用的 Play 外掛程式，請刪除
GooglePlayPlugins資料夾 低於Assets。
按照下列說明使用 Unity Package Manager 安裝套件 上述。
特定產品的遷移操作說明
如需 Firebase 操作說明，請參閱這篇文章。