安裝適用於 Unity 的 Google 套件

適用於 Unity 的 Google 套件有兩種發布格式：

  • 素材資源包：
    • 使用 .unitypackage 副檔名。
    • 安裝至專案的 Assets 目錄。
    • 可匯入 Unity 5 以上版本。
    • 通常包含相依套件。
  • Unity Package Manager (UPM) 套件：
    • 使用 .tgz 副檔名。
    • 安裝至專案的 Packages 目錄。
    • 可在 Unity 2018.4 以上版本匯入。
    • 參考需要個別安裝的相依套件。

「套件」頁面會顯示所有可用套件的最新 .unitypackage 檔案，以及部分套件的 .tgz 檔案。

「封存」頁面包含所有套件版本的 .unitypackage 和 .tgz 檔案。

下方說明如何安裝這兩種套件，以及如何從一種套件遷移至另一種。

熟悉這些安裝選項後，請務必參閱 Firebase 的其他產品專屬操作說明。

使用 OpenUPM 匯入套件

您可以使用 OpenUPM 登錄檔，將外部套件新增至 Unity 專案。OpenUPM 託管許多實用外掛程式和 SDK，例如 Google Play Integrity 外掛程式，可協助保護應用程式免於詐欺和濫用行為。

以下說明如何使用 OpenUPM 新增 Google Play Integrity 外掛程式等項目。

OpenUPM-CLI

如果已安裝 OpenUPM CLI，可以使用下列指令安裝 OpenUPM 登錄檔：

openupm add com.google.play.integrity

OpenUPM

  1. 在 Unity 選單中，依序選取「Edit」>「Project Settings」>「Package Manager」，開啟套件管理工具設定。

  2. 在「套件管理工具」視窗中，將 OpenUPM 新增為指定範圍套件來源：

    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

  3. 在 Unity 選單中，依序選取「Window」>「Package Manager」，開啟套件管理工具選單。

  4. 設定管理員範圍下拉式選單，選取「My Registries」。

  5. 從套件清單中選取「Google Play Integrity plugin for Unity」套件，然後按一下「Install」。

使用 .unitypackage 檔案匯入資產套件

如要匯入 .unitypackage 檔案，請在 Unity 選單中選取 Assets > Import package > Custom Package，然後匯入所有項目。這會將套件內容新增至資產目錄下的專案。

匯入含有 .tgz 檔案的 UPM 套件 (2018.4 以上版本)

使用下列任一方法，將 .tgz 檔案匯入專案：

manifest.json

  1. 在專案的 Packages 資料夾旁建立新資料夾，並命名為 GooglePackages。
  2. 將 .tgz 檔案放入該資料夾。
  3. 使用文字編輯器開啟 Unity 專案資料夾下的 Packages/manifest.json。

  4. 為要安裝的每個套件新增項目，將套件名稱對應至磁碟上的位置 (相對於 Packages/manifest.json 檔案)。請務必在 .tgz 檔案路徑中附加 file:。舉例來說，如果您要安裝 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. 將解壓縮的資料夾放入 GooglePackages 資料夾。

  3. 編輯 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

  1. 開啟 Unity 的套件管理工具視窗。

  2. 按一下「套件管理員」視窗左上角的 + 圖示，然後選取 Add package from tarball 開啟檔案瀏覽器。

    螢幕截圖：Unity Package Manager 視窗，

  3. 在檔案瀏覽器中選取所需的 tarball。

部分舊版 Unity 不支援直接新增 tarball。 在這種情況下，您需要：

  1. 解壓縮 .tgz 檔案。

  2. 按一下「套件管理員」視窗左上角的 + 圖示，然後選取 Add package from disk 開啟檔案瀏覽器。

    螢幕截圖：Unity Package Manager 視窗，

  3. 在檔案瀏覽器中選取解壓縮的資料夾。

請務必匯入套件依附元件的 .tgz 檔案，您可以在封存頁面上找到所需套件區段下方的清單。

舉例來說，如果您要安裝 com.google.firebase.storage，請依下列順序安裝這些 .tgz 檔案：

  1. 外部依附元件管理工具 (com.google.external-dependency-manager)
  2. Firebase Core (com.google.firebase.app)
  3. Firebase 驗證 (com.google.firebase.auth)
  4. Firebase Storage (com.google.firebase.storage)

如要一次加入所有 .tgz 檔案，不必擔心順序問題，請按照「manifest.json」分頁中的操作說明進行。

版本管控

如果您使用版本控制軟體管理專案檔案，建議將相關的 .tgz 檔案加入版本控制。您可以手動編輯專案的 manifest.json (請參閱上述操作說明)，並使用相對路徑參照本機 .tgz 檔案。

如果您使用 Git，建議使用 Git Large File Storage (LFS) 管理大型 .tgz 檔案。

從 UPM 套件遷移至資產套件

在某些情況下，您可能想從使用 Unity Package Manager 管理 Google 套件，改為在 Assets 資料夾下安裝套件。

請務必使用下列任一方法，從 Unity Package Manager 移除所有 Google 套件：

套件管理工具 UI

  1. 開啟 Unity 的套件管理工具視窗。

  2. 選取左上角下拉式選單中的 In Project。

    螢幕截圖：Unity Package Manager 視窗，

  3. 在搜尋列中輸入 com.google，即可篩選 Google 套件。

    螢幕截圖：Unity Package Manager 視窗，

  4. 按一下每個套件名稱，然後按一下 Remove。

manifest.json

  1. 使用文字編輯器開啟 Unity 專案資料夾下的 Packages/manifest.json。
  2. 檢查「dependencies」下方是否有任何 Google 套件。套件名稱開頭應為「com.google」，例如「com.google.firebase.app」。
  3. 刪除這些程式碼行，然後儲存 JSON 檔案。
  4. Unity 重新取得焦點時，會重新載入 manifest.json 檔案，並移除已刪除的套件。

從 Unity Package Manager 解除安裝這些套件後，即可從封存頁面下載並匯入替代的 .unitypackage 檔案。

從資產套件遷移至 UPM 套件

在某些情況下，您可能會想從在 Assets 樹狀結構下安裝產品，改為使用 Unity Package Manager 安裝及追蹤產品。

如果不確定使用哪種安裝方法，請在 Unity UI 中檢查「Assets」下方的「Project」分頁，確認是否顯示所需的 Google 套件。

如要遷移至 UPM 套件，請按照下列步驟操作：

  1. 確認已從 Assets 資料夾中移除所有 Google 套件。

    • 如要解除安裝 Firebase 套件，請按照這些操作說明操作。
    • 如要解除安裝 Unity 適用的 Play 外掛程式，請刪除 Assets 底下的 GooglePlayPlugins 資料夾。

  2. 使用 Unity Package Manager 安裝套件，如上文所述。

產品專屬遷移操作說明

如需 Firebase 操作說明，請參閱這裡。