適用於 Unity 的 Google 套件以兩種不同格式發布:
- 素材資源套件:
- 具有
.unitypackage
擴充功能。 - 安裝到專案的
Assets
目錄。 - 可在 Unity 5 以上版本中匯入。
- 通常包含相依套件。
- 具有
- Unity Package Manager (UPM) 套件:
- 具有
.tgz
擴充功能。 - 安裝到專案的
Packages
目錄。 - 可在 Unity 2018.4 以上版本中匯入。
- 參照必須單獨安裝的相依套件。
- 具有
「Packages」頁麵包含所有可用套件的最新 .unitypackage
檔案。
「Archive」(封存) 頁麵包含所有套件版本的 .unitypackage
和 .tgz
檔案。
以下說明如何安裝這兩種套件,以及從類型轉換至另一種類型的遷移操作說明。
熟悉這些安裝選項後,請務必參考 Firebase 的其他產品專屬操作說明。
匯入含有 .unitypackage
個檔案的資產套件
選取 Unity 選單選項 Assets > Import package > Custom Package
並匯入所有項目,藉此匯入 .unitypackage
檔案。這麼做會將套件內容新增至「Assets」目錄下的專案。
匯入含有 .tgz
檔案的 UPM 套件 (2018.4 以上版本)
請使用下列其中一種方法將 .tgz
檔案匯入專案:
manifest.json
- 在專案的
Packages
資料夾旁邊建立新資料夾,並命名為GooglePackages
。 - 將
.tgz
檔案放入該資料夾。 - 使用文字編輯器開啟 Unity 專案資料夾下的
Packages/manifest.json
。 針對您要安裝的每個套件新增一個項目,將套件名稱對應至磁碟上的位置 (相對於
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
檔案。 - 將擷取的資料夾放在
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」視窗。
按一下套件管理員視窗左上角的
+
圖示,然後選取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 套件遷移至資產套件
在某些情況下,您可能想要將 Google 套件改成使用 Unity Package Manager 管理 Google 套件,以及安裝「Assets」資料夾下的套件。
使用下列任一方法,確認所有 Google 套件都從 Unity Package Manager 中移除:
套件管理員 UI
- 開啟 Unity 的「Package Manager」視窗。
在左上方的下拉式選單中選取
In Project
。在搜尋列中輸入
com.google
,即可篩選 Google 套件。按一下每個套件名稱,然後按一下
Remove
。
manifest.json
- 使用文字編輯器開啟 Unity 專案資料夾下的
Packages/manifest.json
。 - 查看「依附元件」下是否有 Google 提供的包裹。套件名稱的開頭應為「com.google」,例如「com.google.firebase.app」。
- 刪除這幾行內容並儲存 JSON 檔案。
- Unity 重新聚焦時,會重新載入
manifest.json
檔案並移除已刪除的套件。
從 Unity 套件管理員解除安裝這些套件後,您可以從封存頁面下載及匯入替換的 .unitypackage
檔案。
從資產套件遷移至 UPM 套件
在某些情況下,您可能想切換使用 Assets 樹狀結構安裝產品,然後使用 Unity Package Manager 安裝及追蹤產品。
如果您不確定要使用哪種安裝方法,請在 Unity UI 中檢查「Project」分頁的「Assets」下方是否顯示所需的 Google 套件。
如要遷移至 UPM 套件:
確認所有 Google 套件都已從 Assets 資料夾中移除。
- 如要解除安裝 Firebase 套件,請按照這些操作說明操作。
- 如要解除安裝 Unity 的 Play 外掛程式,請刪除
Assets
底下的GooglePlayPlugins
資料夾。
如上文所述,使用 Unity Package Manager 安裝套件。
產品專屬遷移操作說明
如需 Firebase 操作說明,請參閱這篇文章。