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 thành phần:
  • Có tiện ích .unitypackage.
  • Cài đặt vào thư mục Assets của dự án.
  • Có thể nhập vào Unity 5 trở lên.
  • Thường bao gồm các gói phụ thuộc.
• Các gói Unity Package Manager (UPM):
  • Có tiện ích .tgz.
  • Cài đặt vào thư mục Packages của dự án.
  • Có thể nhập vào 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à tệp .tgz cho một số gói.

Trang Lưu trữ chứa các tệp .unitypackage và .tgz cho tất cả cá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 đã nắm rõ các lựa chọn cài đặt này, hãy nhớ tham khảo hướng dẫn bổ sung dành riêng cho sản phẩm đối với 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. Trình bổ trợ này 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, chẳng hạn như trình bổ trợ Play Integrity 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 mục trong 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ó phạm vi vào cửa sổ Package Manager (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 mục trong 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 của trình quản lý để chọn Sổ đăng ký của tôi.

   

5. Chọn gói Trình bổ trợ Play Integrity của Google cho Unity trong danh sách gói rồi nhấn vào 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 lựa chọn Assets > Import package > Custom Package trong trình đơn Unity và 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 bên dưới để biết hướng dẫn.

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

Nhập tệp .tgz vào dự án của bạ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 rồi đặt tên là GooglePackages.
2. Đặt các tệp .tgz vào thư mục đó.
3. Dùng trình chỉnh sửa 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 từng 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ớ thêm 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 nó, thì 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 Unity lấy lại tiêu điểm, Unity sẽ tải lại manifest.json và nhập các gói mới được thêm.

Một số phiên bản cũ của Unity 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 các 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 lưu trữ tar mà bạn muốn trong trình duyệt tệp.

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

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 cùng 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.

Đừng quên nhập 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 phần 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ả cá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 đó của gói trước khi thêm một phiên bản mới. Hãy xem bên dưới để biết hướng dẫn.

Quản lý phiên bản

Nếu đang sử dụng phần mềm quản lý phiên bản để quản lý các tệp dự án, bạn nên thêm các tệp .tgz có liên quan vào chế độ quản lý 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 dùng git, bạn nên sử dụng Git Large File Storage (LFS) để quản lý các tệp .tgz có kích thước lớn.

Di chuyển từ các gói UPM sang các 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 Unity Package Manager để quản lý các gói Google sang cài đặt các gói trong thư mục Assets.

Đảm bảo bạn đã xoá tất cả các gói Google khỏi Unity Package Manager bằng một trong hai 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 biểu tượng In Project trong trình đơn thả xuống ở phía 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. Dùng trình chỉnh sửa 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 "dependencies" (các phần phụ thuộc) hay không. Tên gói phải bắt đầu bằng "com.google", chẳng hạn như "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ừ việc cài đặt sản phẩm trong cây Assets (Tài sản) sang cài đặt và theo dõi sản phẩm bằng Unity Package Manager.

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

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

1. Đảm bảo rằng bạn đã xoá tất cả gói Google khỏi thư mục Assets.

   • Để 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 từng sản phẩm

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