安裝適用於 Unity 的 Google 套件

適用於 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

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

套件管理員 UI

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

    含有

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

部分舊版 Unity 不支援直接新增 tarball。在此情況下,您必須:

  1. 解壓縮 .tgz 檔案。
  2. 按一下套件管理員視窗左上角的 + 圖示,然後選取 Add package from disk 即可開啟檔案瀏覽器。

    含有

  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 儲存空間 (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

  1. 開啟 Unity 的「Package Manager」視窗。
  2. 在左上方的下拉式選單中選取 In Project

    含有

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

    包含以下項目的 Unity 套件管理員視窗螢幕截圖:

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

manifest.json

  1. 使用文字編輯器開啟 Unity 專案資料夾下的 Packages/manifest.json
  2. 查看「依附元件」下是否有 Google 提供的包裹。套件名稱的開頭應為「com.google」,例如「com.google.firebase.app」。
  3. 刪除這幾行內容並儲存 JSON 檔案。
  4. Unity 重新聚焦時,會重新載入 manifest.json 檔案並移除已刪除的套件。

從 Unity 套件管理員解除安裝這些套件後,您可以從封存頁面下載及匯入替換的 .unitypackage 檔案。

從資產套件遷移至 UPM 套件

在某些情況下,您可能想切換使用 Assets 樹狀結構安裝產品,然後使用 Unity Package Manager 安裝及追蹤產品。

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

如要遷移至 UPM 套件:

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

    • 如要解除安裝 Firebase 套件,請按照這些操作說明操作。
    • 如要解除安裝 Unity 的 Play 外掛程式,請刪除 Assets 底下的 GooglePlayPlugins 資料夾。
  2. 上文所述,使用 Unity Package Manager 安裝套件。

產品專屬遷移操作說明

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