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

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

  • Gói tài sản:
    • Có một tiện ích .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ó một tiện ích .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 Gói chứa các tệp .unitypackage mới nhất cho tất cả các gói có sẵn.

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

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

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

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

Nhập tệp .unitypackage bằng cách chọn tùy 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.

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

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

tệp kê khai

  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 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 bên dưới thư mục dự án Unity của bạn.
  4. Thêm một mục 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, tệp kê khai của bạn sẽ trô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 kê khai.json.

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

Một số phiên bản Unity cũ không hỗ trợ tệp .tgz trong tệp kê khai.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 đã trích xuất vào thư mục GooglePackages.
  3. Chỉnh sửa tệp kê khai của bạn để sử dụng đường dẫn đến thư mục đượ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ổ Trình quản lý gói của Unity\39;s.
  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 và chọn Add package from tarball để mở trình duyệt tệp.

    Ảnh chụp màn hình Cửa sổ Trình quản lý gói Unity, áp dụng "Thêm gói từ tarball" mục thả xuống được chọn

  3. Chọn biểu tượng tarball mong 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 bóng 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 và chọn Add package from disk để mở trình duyệt tệp.

    Ảnh chụp màn hình Cửa sổ Trình quản lý gói Unity, trong đó mục "Thêm gói từ đĩa" mục đã thả xuống được chọn

  3. Chọn thư mục đã trích xuất trong trình duyệt tệp.

Đảm bảo bạn cũng nhập tệp .tgz cho các phần phụ thuộc của gói mà bạn có thể tìm thấy trên trang lưu trữ trong phần 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 muốn thêm tất cả các tệp .tgz cùng 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.

Kiểm soát 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 tệp .tgz có liên quan vào phần 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 dùng Git Big Storage Storage (LFS) để quản lý các tệp .tgz lớn.

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ừ sử dụng Trình quản lý gói Unity để quản lý các gói của Google, sang cài đặt các gói trong thư mục Tài sản.

Hãy đảm bảo bạn xóa tất cả các gói của Google khỏi Trình quản lý gói Unity bằng một trong những cách sau:

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

  1. Mở cửa sổ Trình quản lý gói của Unity\39;s.
  2. Chọn In Project trong trình đơn thả xuống ở phía trên bên trái.

    Ảnh chụp màn hình Cửa sổ Trình quản lý gói Unity, trong đó mục "In Project" trình đơn thả xuống được chọn

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

    Ảnh chụp màn hình Cửa sổ Trình quản lý gói Unity có "com.google" trên thanh tìm kiếm, ngăn bên trái chỉ chứa các Gói Goaogle

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

tệp kê khai

  1. Sử dụng trình chỉnh sửa văn bản để mở Packages/manifest.json bên dưới thư mục dự án Unity của bạn.
  2. Kiểm tra xem có gói nào của Google trong "dependencies" không. Tên gói sẽ bắt đầu bằng "com.google" chẳng hạn; "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à xóa các gói đã xóa.

Sau khi gỡ cài đặt những 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 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, hãy kiểm tra xem các gói Google bạn muốn có xuất hiện trong thẻ Dự án trong phần Tài sản hay không.

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

  1. Hãy đảm bảo bạn xóa tất cả gói của Google khỏi thư mục Tài sản.

    • Để gỡ cài đặt các gói Firebase, hãy làm theo các hướng dẫn này.
    • Để gỡ cài đặt Play Plugins cho Unity, hãy xóa thư mục GooglePlayPlugins trong phần 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 cụ thể

Hãy xem hướng dẫn về Firebase trong đây.