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

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

• Gói tài sản:
  • Có một đuôi .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.
• Các gói Trình quản lý gói Unity (UPM):
  • Có một đuôi .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.
  • Các gói phụ thuộc tham chiếu 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 có sẵn và .tgz cho một số gói.

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

Bạn có thể tìm thấy hướng dẫn ở bên dưới về cách cài đặt cả hai loại gói, cùng với kèm theo hướng dẫn di chuyển để chuyển đổi từ loại này sang loại khác.

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

Nhập các gói thành phần có tệp .unitypackage

Nhập tệp .unitypackage bằng cách chọn lựa chọn trình đơn Unity Assets > Import package > Custom Package và đang 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 mục Thành phần thư mục.

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

Nhập gói UPM có 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 rồi đặt tên cho thư mục đó GooglePackages
2. Đặt các tệp .tgz vào thư mục đó.
3. Sử dụng trình chỉnh sửa văn bản để mở Packages/manifest.json trong dự án Unity .

4. Thêm 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ị trí trên ổ đĩa, so với tệp Packages/manifest.json. Hãy nhớ thêm file: vào đường dẫn tệp .tgz. Cho Ví dụ: nếu bạn đang cài đặt com.google.firebase.storage và phần phụ thuộc, thì tệp manifest.json của bạn 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 manifest.json và nhập các gói mới được thêm vào.

Một số phiên bản Unity cũ không hỗ trợ tệp .tgz trong tệp 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 của tệp .tgz, chẳng hạn như:

   {
     "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ổ Package Manager (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 tarball bạn muốn trong trình duyệt tệp.

Một số phiên bản Unity cũ không hỗ trợ thêm trực tiếp tarball. Trong trường hợp này, bạn sẽ 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 Package Manager (Trình quản lý gói) và 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 danh sách gói ngăn.

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

Hãy nhớ nhập các tệp .tgz cho các phần phụ thuộc của gói, mà bạn có thể tìm thấy được liệt kê trên 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. Xác thực Firebase (com.google.firebase.auth)
4. Bộ nhớ Firebase (com.google.firebase.storage)

Nếu bạn muốn thêm tất cả tệp .tgz cùng một lúc mà không phải lo lắng về đơn đặt hàng, 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 .unitypackage hãy nhớ xoá phiên bản gói đó trước thêm một thiết bị mới. Xem bên dưới để xem hướng dẫn.

Quản lý phiên bản

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

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

Di chuyển từ gói UPM sang gói thành phầ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 của Google, cài đặt các gói trong thư mục Nội dung.

Đảm bảo bạn đã xoá tất cả các gói của Google khỏi Trình quản lý gói của Unity bằng cách sử dụng một trong các phương pháp 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 ở phía trên 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, sau đó nhấp vào Remove.

manifest.json

1. Sử dụng trình chỉnh sửa văn bản để mở Packages/manifest.json trong dự án Unity .
2. Kiểm tra xem có gói nào từ Google trong mục "phần phụ thuộc" hay không. Gói hàng tên phải bắt đầu bằng "com.google", ví dụ: "com.google.firebase.app".
3. Xóa các dòng đó và 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ừ kho lưu trữ .

Di chuyển từ gói thành phầ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 thành phần để 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 biết 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, kiểm tra xem các gói Google mong muốn có xuất hiện trong thẻ Project (Dự án) trong phần Thành phần.

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

1. Hãy nhớ xoá tất cả gói của Google khỏi thư mục Thành phần.

   • Để gỡ cài đặt các gói Firebase, hãy làm theo hướng dẫn tại đây.
   • Để gỡ cài đặt Trình bổ trợ Play cho Unity, hãy xoá thư mục GooglePlayPlugins dưới 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 dành riêng cho sản phẩm

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