適用於 Unity 的 Google 套件會以兩種不同的格式發布:
- 素材資源套件:
- 使用
.unitypackage
擴充功能。 - 安裝至專案的
Assets
目錄。 - 可在 Unity 5 以上版本中匯入。
- 通常會包含相依套件。
- 使用
- Unity Package Manager (UPM) 套件:
- 使用
.tgz
擴充功能。 - 安裝至專案的
Packages
目錄。 - 可在 Unity 2018.4 以上版本中匯入。
- 參照需要個別安裝的相依套件。
- 使用
「Packages」頁面包含所有可用套件的最新 .unitypackage
檔案,以及部分套件的 .tgz
檔案。
「Archive」頁面包含所有套件版本的 .unitypackage
和 .tgz
檔案。
請參閱下方的操作說明,瞭解如何安裝這兩種套件,以及如何從一種類型轉換至另一種類型。
熟悉這些安裝選項後,請務必參閱 Firebase 的產品專屬操作說明。
使用 OpenUPM 匯入套件
您可以使用 OpenUPM 登錄機制,將外部套件新增至 Unity 專案。OpenUPM 會代管許多實用的外掛程式和 SDK,例如 Google Play Integrity 外掛程式,可協助保護應用程式免於遭受詐欺和濫用行為。
以下說明如何使用 OpenUPM 新增 Google Play Integrity 外掛程式。
如果您已安裝 OpenUPM CLI,可以使用下列指令安裝 OpenUPM 登錄:
openupm add com.google.play.integrity
選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」,開啟套件管理工具設定。
將 OpenUPM 新增為 Package Manager 視窗中的有範圍限制的登錄檔:
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.integrity
選取 Unity 選單選項「Window」>「Package Manager」,即可開啟「package manager」選單。
將管理員範圍下拉式選單設為「我的註冊中心」。
從套件清單中選取「Google Play Integrity 外掛程式 (適用於 Unity)」套件,然後按下「Install」。
使用 .unitypackage
檔案匯入資產套件
選取 Unity 選單選項 Assets > Import package > Custom Package
並匯入所有項目,即可匯入 .unitypackage
檔案。這樣一來,包裝內容就會新增至「Assets」目錄下的專案中。
使用 .tgz
檔案匯入 UPM 套件 (2018.4 以上版本)
請使用下列任一方法,將 .tgz
檔案匯入專案:
- 在專案的
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... } }
- 開啟 Unity 的 Package Manager 視窗。
按一下 Package Manager 視窗左上角的
+
圖示,然後選取Add package from tarball
即可開啟檔案瀏覽器。在檔案瀏覽器中選取所需的 tarball。
部分舊版 Unity 不支援直接新增 tarball。在這種情況下,您需要:
- 解壓縮
.tgz
檔案。 按一下 Package Manager 視窗左上角的
+
圖示,然後選取Add package from disk
即可開啟檔案瀏覽器。在檔案瀏覽器中選取已解壓縮的資料夾。
請務必一併匯入套件依附元件的 .tgz
檔案,您可以在存檔頁面的所需套件專區下方找到這些檔案。
舉例來說,如果您要安裝 com.google.firebase.storage
,請按照下列順序安裝這些 .tgz
檔案:
- 外部依附元件管理工具 (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - Firebase Auth (
com.google.firebase.auth
) - Firebase 儲存空間 (
com.google.firebase.storage
)
如果您想一次新增所有 .tgz
檔案,而不必擔心順序問題,可以按照 manifest.json 分頁中的指示操作。
版本管控
如果您使用版本控制軟體管理專案檔案,建議您將相關的 .tgz
檔案加入版本控制。您可以手動編輯專案的 manifest.json
(請參閱上述操作說明),並使用相對路徑參照本機 .tgz
檔案。
如果您使用的是 Git,建議您使用 Git Large File Storage (LFS) 管理大型 .tgz
檔案。
從 UPM 套件遷移至資產包
在某些情況下,您可能會想改用「資產」資料夾底下的套件,而非使用 Unity Package Manager 管理 Google 套件。
請使用下列任一方法,確認已從 Unity Package Manager 移除所有 Google 套件:
- 開啟 Unity 的 Package Manager 視窗。
在左上方的下拉式選單中選取
In Project
。在搜尋列中輸入
com.google
,即可篩選 Google 套件。按一下每個套件名稱,然後按一下
Remove
。
- 使用文字編輯器開啟 Unity 專案資料夾下的
Packages/manifest.json
。 - 檢查「依附元件」下方是否有任何 Google 套件。套件名稱開頭應為「com.google」,例如「com.google.firebase.app」。
- 刪除這些行並儲存 JSON 檔案。
- 當 Unity 重新獲得焦點時,它會重新載入
manifest.json
檔案,並移除已刪除的套件。
從 Unity Package Manager 解除安裝這些套件後,您可以從存檔頁面下載並匯入替換的 .unitypackage
檔案。
從資產包遷移至 UPM 套件
在某些情況下,您可能會想改為從安裝資產樹狀結構下的產品,改為使用 Unity Package Manager 安裝及追蹤產品。
如果不確定使用的安裝方法,請在 Unity UI 中檢查「Project」分頁的「Assets」下方,是否顯示所需的 Google 套件。
如要遷移至 UPM 套件,請按照下列步驟操作:
請確認已從 Assets 資料夾中移除所有 Google 套件。
- 如要解除安裝 Firebase 套件,請按照這些操作說明操作。
- 如要解除安裝 Unity 專用 Play 外掛程式,請刪除
Assets
底下的GooglePlayPlugins
資料夾。
使用 Unity Package Manager 安裝套件,如上文所述。
產品專屬遷移操作說明
如需 Firebase 操作說明,請參閱這篇文章。