Các lựa chọn cài đặt Unity khác

Thay vì tải 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 từng gói xuống từ trang web Google APIs for Unity.

Trang web này cung cấp:

  • Các tệp .unitypackage riêng lẻ của .NET 4.X để nhập dưới dạng Gói tài sản.
  • Các tệp 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 duy nhất, 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 liên quan mà chúng phụ thuộc vào.

Trang này cung cấp 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 trong tài liệu Unity.

Nhập các gói Firebase dưới dạng Tài sản

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

  • Nếu đang sử dụng nhiều sản phẩm Firebase trong dự án, 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. Tức là không nhập các sản phẩm Firebase bằng quy trình Gói tài sản và bằng quy trình Trình quản lý gói Unity.

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

  1. Trong dự án Unity đang mở, hãy chuyển đến Assets > Import Package > Custom Package.

  2. Trong cửa sổ Import Unity Package (Nhập gói Unity), hãy nhấp vào Import (Nhập).

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

Khi nhập các sản phẩm Firebase từ các tệp .tgz được tải xuống từ kho lưu trữ Google APIs for Unity, hãy lưu ý những điều sau:

  • Phương thức này chỉ có trong phiên bản 2018.3 trở lên.

  • Nếu đang sử dụng nhiều sản phẩm Firebase trong dự án, 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. Tức là không nhập các sản phẩm Firebase bằng quy trình Gói tài sản và bằng quy trình Trình quản lý gói Unity flow.

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

    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. 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 Realtime Database hoặc Cloud Storage, hãy nhập Authentication (com.google.firebase.auth) trước.

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

Giao diện người dùng Trình 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 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.
  3. Chọn tarball mong muốn trong trình duyệt tệp.

Một số phiên bản cũ của Unity 2019 không hỗ trợ việc thêm trực tiếp tarball. Trong trường hợp này, bạn 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.
  3. Chọn thư mục đã trích xuất trong trình duyệt tệp.

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. Sử 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 cho từng gói mà bạn muốn nhập, ánh xạ tên gói đến vị trí trên đĩa. Nhớ 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 gói đó , 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 thêm.

Một số phiên bản cũ của Unity không hỗ trợ các 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. Chỉnh sửa manifest.json để sử dụng đường dẫn đến thư mục đã trích xuất, thay vì .tgz tệp, 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 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 Trình quản lý gói Unity để theo dõi các sản phẩm Firebase sang việc nhập các 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, hãy mở tệp Packages/manifest.json trong thư mục dự án Unity. 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.

Cách di chuyển sang các gói Tài sản:

  1. Ghi lại các phiên bản gói Firebase hiện tại trong dự án của bạn rồi xoá chúng.

    1. Trong trình đơn Window (Cửa sổ), hãy chọn Package Manager (Trình quản lý gói). Trong cửa sổ Package Manager (Trình quản lý gói), hãy đảm bảo bạn đã chọn "Packages: In Project" (Gói: Trong dự án).
    2. Ghi lại các phiên bản của các gói Firebase đã nhập.
    3. Nhấp vào từng tên gói, sau đó nhấp vào Remove (Xoá). Nhớ xoá gói Trình quản lý phần 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 tuỳ chọn:

    • Nếu có thể nâng cấp lên phiên bản mới nhất của từng gói, hãy tải tệp zip Firebase Unity SDK xuống và nhập như mô tả trong bài viết Thêm Firebase vào dự án Unity.
    • 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 từng gói như mô tả ở trên trên trang này.

Di chuyển từ các 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ừ việc nhập các sản phẩm trong thư mục Assets sang việc nhập và theo dõi các 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, hãy mở tệp Packages/manifest.json trong thư mục dự án Unity. 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.

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

  1. Đảm bảo bạn đã xoá tất cả các gói Firebase và gói Trình quản lý phần phụ thuộc bên ngoài khỏi thư mục Assets bằng một trong các phương thức sau.

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

    1. Trong dự án Unity đang mở, hãy chuyển đến Tài sản > Trình quản lý phần phụ thuộc bên ngoài > Trình xử lý phiên bản > Gỡ cài đặt các gói được quản lý.
    2. Chọn tất cả các gói Firebase và Trình quản lý phần phụ thuộc bên ngoài.
    3. Nhấp vào Uninstall Selected Package (Gỡ cài đặt gói đã chọn).

    Xoá theo cách thủ công

    Sử dụng các công cụ hệ thống tệp để xoá các thư mục sau theo cách thủ công:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Nhập các gói bằng Trình quản lý gói Unity, như mô tả ở trên trang này.