Cài đặt các gói Google cho Unity

Các gói của Google dành cho Unity được phân phối ở hai định dạng:

• Gói tài sản:
  • Có phần mở rộng .unitypackage.
  • Cài đặt vào thư mục Assets của dự án.
  • Có thể nhập trong Unity 5 trở lên.
  • Thường bao gồm các gói phụ thuộc.
• Gói Trình quản lý gói Unity (UPM):
  • Có phần mở rộng .tgz.
  • Cài đặt vào thư mục Packages của dự án.
  • Có thể nhập trong Unity 2018.4 trở lên.
  • Tham chiếu các gói phụ thuộc cần được cài đặt riêng.

Trang Packages (Gói) chứa các tệp .unitypackage mới nhất cho tất cả các gói hiện có và các tệp .tgz cho một số gói.

Trang Archive (Lưu trữ) chứa các tệp .unitypackage và .tgz cho tất cả phiên bản gói.

Dưới đây là hướng dẫn cách cài đặt cả hai loại gói, cùng với hướng dẫn di chuyển để chuyển đổi từ loại này sang loại khác.

Sau khi bạn đã quen thuộc với các tuỳ chọn cài đặt này, hãy nhớ tham khảo thêm hướng dẫn dành riêng cho sản phẩm cho Firebase.

Nhập gói bằng OpenUPM

Bạn có thể thêm các gói bên ngoài vào dự án Unity bằng cách sử dụng sổ đăng ký OpenUPM. OpenUPM lưu trữ nhiều trình bổ trợ và SDK hữu ích, chẳng hạn như trình bổ trợ Tính toàn vẹn của Google Play, giúp bảo vệ ứng dụng của bạn khỏi hành vi gian lận và sai trái.

Dưới đây là cách thêm trình bổ trợ Tính toàn vẹn của Google Play bằng OpenUPM.

OpenUPM-CLI

Nếu đã cài đặt OpenUPM CLI, bạn có thể cài đặt sổ đăng ký OpenUPM bằng lệnh sau:

openupm add com.google.play.integrity

OpenUPM

1. Mở chế độ cài đặt trình quản lý gói bằng cách chọn tuỳ chọn trình đơn Unity Edit > Project Settings > Package Manager (Chỉnh sửa > Cài đặt dự án > Trình quản lý gói).

2. Thêm OpenUPM làm sổ đăng ký có giới hạn vào cửa sổ Trình quản lý gói:

   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. Mở trình đơn trình quản lý gói bằng cách chọn tuỳ chọn trình đơn Unity Window > Package Manager (Cửa sổ > Trình quản lý gói).

4. Đặt trình đơn thả xuống phạm vi người quản lý để chọn Registries của tôi.

   

5. Chọn gói Trình bổ trợ Tính toàn vẹn của Google Play cho Unity trong danh sách gói rồi nhấn Install (Cài đặt).

Nhập gói tài sản bằng tệp .unitypackage

Nhập tệp .unitypackage bằng cách chọn tuỳ chọn trình đơn Unity Assets > Import package > Custom Package rồi nhập tất cả các mục. Thao tác này sẽ thêm nội dung gói vào dự án của bạn trong thư mục Tài sản.

Lưu ý: Nếu bạn đã cài đặt gói bằng cửa sổ Trình quản lý gói của Unity, hãy gỡ cài đặt phiên bản cũ của gói trước khi nhập phiên bản mới. Hãy xem hướng dẫn bên dưới.

Nhập gói UPM bằng tệp .tgz (2018.4 trở lên)

Nhập tệp .tgz vào dự án bằng một trong các phương thức sau:

manifest.json

1. Tạo một thư mục mới bên cạnh thư mục Packages của dự án và đặt tên là GooglePackages.
2. Đặt các tệp .tgz vào thư mục đó.
3. Sử dụng trình soạn thảo văn bản để mở Packages/manifest.json trong thư mục dự án Unity.

4. Thêm một mục nhập cho mỗi gói bạn muốn cài đặt, liên kết tên gói với vị trí trên ổ đĩa, tương ứng với tệp Packages/manifest.json. Hãy nhớ nối file: vào đường dẫn tệp .tgz. Ví dụ: nếu bạn đang cài đặt com.google.firebase.storage và các phần phụ thuộc của tệp này, thì tệp manifest.json sẽ có dạng như sau:

   {
     "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. Lưu tệp manifest.json.

6. Khi lấy lại tiêu điểm, Unity sẽ tải lại tệp manifest.json và nhập các gói mới thêm.

Một số phiên bản Unity cũ không hỗ trợ tệp .tgz trong manifest.json. Trong trường hợp này, bạn nên:

1. Giải nén tệp .tgz.
2. Đặt thư mục đã giải nén vào thư mục GooglePackages.

3. Chỉnh sửa manifest.json để sử dụng đường dẫn đến thư mục đã trích xuất thay vì tệp .tgz, như sau:

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

Giao diện người dùng của Trình quản lý gói

1. Mở cửa sổ Package Manager (Trình quản lý gói) của Unity.

2. Nhấp vào biểu tượng + ở góc trên cùng bên trái của cửa sổ Trình quản lý gói rồi chọn Add package from tarball để mở trình duyệt tệp.

   

3. Chọn tệp tarball mà bạn muốn trong trình duyệt tệp.

Một số phiên bản Unity cũ không hỗ trợ việc thêm trực tiếp tệp tarball. Trong trường hợp này, bạn sẽ cần:

1. Giải nén tệp .tgz.

2. Nhấp vào biểu tượng + ở góc trên cùng bên trái của cửa sổ Trình quản lý gói rồi chọn Add package from disk để mở trình duyệt tệp.

   

   Lưu ý: Unity 2018 đặt biểu tượng + ở góc dưới bên trái của ngăn danh sách gói.

3. Chọn thư mục đã giải nén trong trình duyệt tệp.

Ngoài ra, hãy nhớ nhập các tệp .tgz cho các phần phụ thuộc của gói. Bạn có thể tìm thấy các tệp này trong trang lưu trữ trong mục của gói mong muốn.

Ví dụ: nếu đang cài đặt com.google.firebase.storage, bạn sẽ cài đặt các tệp .tgz này theo thứ tự sau:

1. Trình quản lý phần phụ thuộc bên ngoài (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase Auth (com.google.firebase.auth)
4. Bộ nhớ Firebase (com.google.firebase.storage)

Nếu muốn thêm tất cả tệp .tgz cùng một lúc mà không cần lo lắng về thứ tự, bạn có thể làm theo hướng dẫn trong thẻ manifest.json.

Lưu ý: Nếu bạn đã cài đặt gói bằng tệp .unitypackage, hãy nhớ xoá phiên bản gói đó trước khi thêm phiên bản mới. Hãy xem hướng dẫn bên dưới.

Quản lý phiên bản

Nếu đang sử dụng phần mềm kiểm soát phiên bản để quản lý các tệp dự án, bạn nên thêm các tệp .tgz liên quan vào phần mềm kiểm soát phiên bản. Bạn có thể chỉnh sửa manifest.json của dự án theo cách thủ công (xem hướng dẫn ở trên) và tham chiếu các tệp .tgz cục bộ bằng đường dẫn tương đối.

Nếu đang sử dụng git, bạn nên sử dụng Bộ nhớ tệp lớn Git (LFS) để quản lý các tệp .tgz lớn.

Di chuyển từ gói UPM sang gói Tài sản

Trong một số trường hợp, bạn có thể muốn chuyển từ việc sử dụng Trình quản lý gói Unity để quản lý các gói Google sang cài đặt các gói trong thư mục Assets (Tài sản).

Đảm bảo tất cả gói Google đều bị xoá khỏi Trình quản lý gói Unity bằng một trong các phương thức sau:

Giao diện người dùng của Trình quản lý gói

1. Mở cửa sổ Package Manager (Trình quản lý gói) của Unity.

2. Chọn In Project trong trình đơn thả xuống ở trên cùng bên trái.

   

3. Nhập com.google vào thanh tìm kiếm để lọc các gói của Google.

   

4. Nhấp vào từng tên gói rồi nhấp vào Remove.

manifest.json

1. Sử dụng trình soạn thảo văn bản để mở Packages/manifest.json trong thư mục dự án Unity.
2. Kiểm tra xem có gói nào của Google trong phần "phần phụ thuộc" hay không. Tên gói phải bắt đầu bằng "com.google", ví dụ: "com.google.firebase.app".
3. Xoá các dòng đó rồi lưu tệp json.
4. Khi lấy lại tiêu điểm, Unity sẽ tải lại tệp manifest.json và xoá các gói đã xoá.

Sau khi gỡ cài đặt các gói đó khỏi Trình quản lý gói Unity, bạn có thể tải xuống và nhập các tệp .unitypackage thay thế từ trang lưu trữ.

Di chuyển từ gói Tài sản sang gói UPM

Trong một số trường hợp, bạn có thể muốn chuyển từ cài đặt sản phẩm trong cây Tài sản sang cài đặt và theo dõi sản phẩm bằng Trình quản lý gói Unity.

Nếu bạn không chắc mình đang sử dụng phương thức cài đặt nào, trong giao diện người dùng Unity, hãy kiểm tra xem các gói Google mong muốn có xuất hiện trong thẻ Project (Dự án) trong mục Assets (Tài sản) hay không.

Cách di chuyển sang các gói UPM:

1. Đảm bảo xoá tất cả gói Google khỏi thư mục Tài sản.

   • Để gỡ cài đặt các gói Firebase, hãy làm theo hướng dẫn này.
   • Để gỡ cài đặt Trình bổ trợ Play cho Unity, hãy xoá thư mục GooglePlayPlugins trong Assets.

2. Cài đặt các gói bằng Trình quản lý gói Unity, như mô tả ở trên.

Hướng dẫn di chuyển theo sản phẩm

Xem hướng dẫn về Firebase tại đây.