安裝適用於 Unity 的 Google 套件

適用於 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 CLI，可以使用下列指令安裝 OpenUPM 登錄：

openupm add com.google.play.integrity

OpenUPM

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

  2. 將 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

  3. 選取 Unity 選單選項「Window」>「Package Manager」，即可開啟「package manager」選單。

  4. 將管理員範圍下拉式選單設為「我的註冊中心」。

  5. 從套件清單中選取「Google Play Integrity 外掛程式 (適用於 Unity)」套件，然後按下「Install」。

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

選取 Unity 選單選項 Assets > Import package > Custom Package 並匯入所有項目，即可匯入 .unitypackage 檔案。這樣一來，包裝內容就會新增至「Assets」目錄下的專案中。

使用 .tgz 檔案匯入 UPM 套件 (2018.4 以上版本)

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

manifest.json

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

  4. 為每個要安裝的套件新增項目，將套件名稱對應至磁碟上的相依 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...
  }
}

  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...
  }
}

套件管理工具使用者介面

  1. 開啟 Unity 的 Package Manager 視窗。

  2. 按一下 Package Manager 視窗左上角的 + 圖示，然後選取 Add package from tarball 即可開啟檔案瀏覽器。

    Unity Package Manager 視窗的螢幕截圖，其中包含

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

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

  1. 解壓縮 .tgz 檔案。

  2. 按一下 Package Manager 視窗左上角的 + 圖示，然後選取 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 Auth (com.google.firebase.auth)
  4. 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 套件：

套件管理工具使用者介面

  1. 開啟 Unity 的 Package Manager 視窗。

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

    Unity Package Manager 視窗的螢幕截圖，其中包含

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

    Unity Package Manager 視窗的螢幕截圖，其中包含

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

manifest.json

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

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

從資產包遷移至 UPM 套件

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

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

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

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

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

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

產品專屬遷移操作說明

如需 Firebase 操作說明，請參閱這篇文章。