Tùy chọn cài đặt Unity bổ sung

Thay vì tải xuống một tệp .zip lớn chứa tất cả các tệp .unitypackage cho cả .NET 3.X và .NET 4.X, bạn có thể tải xuống các gói riêng lẻ từ trang web Google API dành cho Unity .

Trang web cung cấp:

  • Các tệp .NET 4.X .unitypackage riêng lẻ để nhập dưới dạng gói Tài sản.
  • Các kho lưu trữ .tgz riêng lẻ để nhập bằng Trình quản lý gói Unity.

Điều này đặc biệt hữu ích khi ứng dụng của bạn sử dụng một sản phẩm Firebase, vì các tệp .unitypackage riêng lẻ chứa tất cả các phần phụ thuộc cần thiết và các tệp .tgz được liệt kê cùng với các tệp .tgz có liên quan mà chúng phụ thuộc vào.

Trang này cung cấp các hướng dẫn liên quan đến Trình quản lý gói Unity, vì vậy bạn nên tìm hiểu về công cụ này từ tài liệu Unity .

Nhập gói Firebase làm Tài sản

Khi nhập sản phẩm Firebase từ tệp .unitypackage được tải xuống từ API Google cho trang web Unity , hãy ghi nhớ những điều sau:

  • Nếu bạn đang sử dụng nhiều sản phẩm Firebase trong dự án của mình, bạn phải tải xuống và nâng cấp tất cả các sản phẩm Firebase lên cùng một phiên bản.

  • Không kết hợp các phương thức nhập trong một dự án. Nghĩa là không nhập các sản phẩm Firebase bằng luồng Gói nội dung và sử dụng luồng Trình quản lý gói Unity.

Sau khi tải xuống, để nhập:

  1. Trong dự án Unity đang mở của bạn, hãy điều hướng đến Tài sản > Gói nhập > Gói tùy chỉnh .

  2. Trong cửa sổ Nhập gói Unity , nhấp vào Nhập .

Nhập gói Firebase bằng Trình quản lý gói Unity

Khi nhập sản phẩm Firebase từ tệp .tgz được tải xuống từ kho lưu trữ Google API dành cho Unity , hãy ghi nhớ những điều sau:

  • Phương pháp này chỉ khả dụng trong 2018.3+.

  • Nếu bạn đang sử dụng nhiều sản phẩm Firebase trong dự án của mình, bạn phải tải xuống và nâng cấp tất cả các sản phẩm Firebase lên cùng một phiên bản.

  • Không kết hợp các phương thức nhập trong một dự án. Nghĩa là không nhập các sản phẩm Firebase bằng luồng Gói nội dung và với luồng Trình quản lý gói Unity.

  • Các phần phụ thuộc cho mỗi tệp .tgz của sản phẩm được liên kết cùng với các tệp .tgz của riêng chúng. Bạn phải tải xuống và nhập tệp .tgz của sản phẩm cũng như các tệp .tgz phụ thuộc, theo đúng thứ tự:

    1. Trình quản lý phụ thuộc bên ngoài ( com.google.external-dependency-manager )
    2. Cốt lõi Firebase ( com.google.firebase.app )
    3. Các sản phẩm Firebase được sử dụng trong dự án của bạn. Nếu bạn sử dụng Cơ sở dữ liệu thời gian thực hoặc Bộ nhớ đám mây, trước tiên hãy nhập Xác thực ( com.google.firebase.auth ).

Sau khi tải xuống, hãy nhập tệp .tgz vào dự án của bạn bằng một trong các phương pháp sau:

Giao diện người dùng quản lý gói

  1. Mở cửa sổ Trình quản lý gói của Unity.
  2. Nhấp vào biểu tượng + ở góc trên 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.
  3. Chọn tarball mong muốn trong trình duyệt tệp.

Một số phiên bản Unity 2019 cũ hơn không hỗ trợ thêm tarball trực tiếp. 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 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.
  3. Chọn thư mục giải nén trong trình duyệt tệp.

bảng kê khai.json

  1. Tạo một thư mục mới bên cạnh thư mục Packages của dự án của bạ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 của bạn.
  4. Thêm mục nhập cho mỗi gói bạn muốn nhập, ánh xạ tên gói tới vị trí trên đĩa. Đảm bảo nối thêm file: vào đường dẫn tệp .tgz . Ví dụ: nếu bạn đang nhập com.google.firebase.storage và phần phụ thuộc của nó, thì manifest.json của bạn sẽ trông như thế này:

    {
      "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ê manifest.json .

  6. Khi Unity lấy lại tiêu điểm, nó sẽ tải lại tệp 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ũ hơn 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. Chỉnh sửa manifest.json của bạn để sử dụng đường dẫn đến thư mục được giải nén, 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...
      }
    }
    

Di chuyển từ Trình quản lý gói Unity 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 để theo dõi các sản phẩm Firebase sang nhập sản phẩm trong thư mục Assets .

Nếu bạn không chắc mình đang sử dụng phương thức nhập nào, trong thư mục dự án Unity, hãy mở tệp Packages/manifest.json . Nếu tệp chứa các mục bắt đầu bằng com.google.firebase thì dự án của bạn đã sử dụng Trình quản lý gói Unity để nhập.

Để di chuyển sang gói Tài sản:

  1. Lưu ý các phiên bản gói Firebase hiện tại trong dự án của bạn và xóa chúng.

    1. Từ menu Cửa sổ , chọn Trình quản lý gói . Trong cửa sổ Trình quản lý gói , đảm bảo đã chọn "Gói: Trong dự án".
    2. Lưu ý các phiên bản của gói Firebase đã nhập.
    3. Click vào tên từng gói rồi nhấn Remove . Đảm bảo xóa gói Trình quản lý phụ thuộc bên ngoài ( .com.google.external-dependency-manager ) cũng như các gói Firebase.
  2. Tải xuống và nhập các tệp .unitypackage thay thế. Bạn có hai lựa chọn:

    • Nếu bạn có thể nâng cấp lên phiên bản mới nhất của mỗi gói, hãy tải xuống tệp zip Firebase Unity SDK và nhập như được mô tả trong Thêm Firebase vào dự án Unity của bạn .
    • Nếu cần giữ lại các phiên bản .unitypackage hiện tại, bạn có thể tải xuống và nhập các gói riêng lẻ như mô tả ở trên trên trang này.

Di chuyển từ gói Tài sản sang Trình quản lý gói Unity

Trong một số trường hợp, bạn có thể muốn chuyển từ nhập sản phẩm trong thư mục Assets sang nhập 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 nhập nào, trong thư mục dự án Unity, hãy mở tệp Packages/manifest.json . Nếu tệp chứa các mục bắt đầu bằng com.google.firebase thì dự án của bạn đã sử dụng Trình quản lý gói Unity để nhập.

Để di chuyển sang Trình quản lý gói Unity:

  1. Đảm bảo tất cả các gói Firebase và gói Trình quản lý phụ thuộc bên ngoài đều bị xóa khỏi thư mục Assets bằng một trong các phương pháp sau.

    Giao diện người dùng EDM4U

    1. Trong dự án Unity đang mở của bạn, hãy điều hướng đến Nội dung > Trình quản lý phụ thuộc bên ngoài > Trình xử lý phiên bản > Gỡ cài đặt gói được quản lý .
    2. Chọn tất cả các gói Firebase và Trình quản lý phụ thuộc bên ngoài.
    3. Nhấp vào Gỡ cài đặt gói đã chọn .

    Xóa thủ công

    Sử dụng các công cụ hệ thống tệp, xóa thủ công các thư mục sau:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. Nhập gói bằng Trình quản lý gói Unity, như được mô tả ở trên trên trang này.