安裝 Google Unity 套件

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 檔案。 系統會將套件內容新增至專案，並新增至「素材資源」目錄。

匯入包含 .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's Package Manager 視窗。

  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 儲存 (com.google.firebase.storage)

如果您偏好一次新增所有 .tgz 檔案，且不想擔心順序，可以按照 manifest.json 分頁中的說明操作。

版本管控

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

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

從 UPM 套件遷移至 Asset 套件

在某些情況下，建議您從 Unity 套件管理員管理 Google 套件，並安裝到 Assets 資料夾底下的套件。

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

套件管理員 UI

  1. 開啟 Unity's 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 的套件。套件名稱開頭應為「quot;com.google"」，例如 "com.google.firebase.app"。
  3. 請刪除這些行，然後儲存 JSON 檔案。
  4. Unity 恢復焦點時，會重新載入 manifest.json 檔案並移除已刪除的套件。

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

從資產套件遷移至 UPM 套件

在某些情況下，建議您從資產樹狀結構底下安裝產品，並使用 Unity Package Manager 安裝及追蹤產品。

如果你不確定自己使用的安裝方法為何，請在 Unity 使用者介面中，查看「Assets」(專案) 下方的「Asset」分頁是否顯示所需的 Google 套件。

如要遷移至 UPM 套件：

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

    • 如要解除安裝 Firebase 套件，請按照這篇文章的指示操作。
    • 如要解除安裝 Unity 的 Play 外掛程式，請刪除 Assets 下的 GooglePlayPlugins 資料夾。

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

產品遷移操作說明

如需 Firebase 的操作說明，請按這裡。