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ả .unitypackage xuống cho cả .NET 3.X và .NET 4.X, bạn có thể tải các gói riêng lẻ từ API của Google dành cho trang web Unity.

Trang web này cung cấp:

  • Các tệp .unitypackage .NET 4.X riêng lẻ để nhập dưới dạng gói Tài sản.
  • Các bản 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 có 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, đây là một tài liệu ý tưởng để tìm hiểu về công cụ này trong tài liệu của Unity.

Nhập các gói Firebase dưới dạng Thành phần

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

  • Nếu đang sử dụng nhiều sản phẩm của Firebase trong dự án, bạn phải tải xuống và nâng cấp tất 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à đừng nhập Các sản phẩm của Firebase có quy trình Gói thành phần và sử dụng Gói Unity Luồng của người quản lý.

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

  1. Trong dự án Unity đang mở, hãy chuyển đến Assets (Thành phần) > Nhập gói > Gói tuỳ chỉnh.

  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ừ .tgz tệp được tải xuống từ API của Google dành cho kho lưu trữ 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 của Firebase trong dự án, bạn phải tải xuống và nâng cấp tất 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à đừng nhập Các sản phẩm của Firebase với quy trình gói Thành phần và với Trình quản lý gói Unity luồng.

  • Các phần phụ thuộc của mỗi tệp .tgz của sản phẩm đều được liên kết cùng với tệp riêng .tgz tệp. Bạn phải tải xuống và nhập tệp .tgz của sản phẩm và nhập phần phụ thuộc của các tệp .tgz 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 Cơ sở dữ liệu theo thời gian thực hoặc Cloud Storage, trước tiên, hãy nhập phương thức Xác thực (com.google.firebase.auth).

Sau khi tải xuống, hãy 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:

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 2019 cũ không hỗ trợ việc thêm trực tiếp tệp tar. 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.
  3. Chọn thư mục đã giải nén 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 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 nhập, liên kết tên gói vào vị trí trên đĩa. Hãy 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à của phần phụ thuộc, 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 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 đã giải nén 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...
  }
}

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

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

Cách di chuyển sang Gói thành phần:

  1. Hãy ghi chú các phiên bản gói Firebase hiện tại trong dự án của bạn và xoá chúng.

    1. Trên trình đơn Window (Cửa sổ), hãy chọn Package Manager (Trình quản lý gói). Trong Package (Gói) Manager (Trình quản lý), hãy đảm bảo "Packages: In Project" (Gói: Trong dự án) được chọn.
    2. Hãy lưu ý 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 Xoá. Hãy nhớ gỡ bỏ 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 và nhập như 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 từng gói như mô tả ở trên trên trang này.

Di chuyển từ Gói thành phầ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 sản phẩm trong Thư mục Assets để nhập và theo dõi sản phẩm bằng Trình quản lý gói Unity.

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

Cách 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ần phụ thuộc bên ngoài bị xoá khỏi thư mục Assets bằng một trong hai 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 Assets (Thành phần) > Ngoài Trình quản lý phần phụ thuộc > Trình xử lý phiên bản > Gỡ cài đặt ứng dụng được quản lý Packages (Gói).
    2. Chọn mọi gói Firebase và Trình quản lý phần phụ thuộc bên ngoài.
    3. Nhấp vào Gỡ cài đặt gói đã chọn.

    Xoá thủ công

    Bằng cách sử dụng công cụ hệ thống tệp, hãy xoá 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 các gói bằng Trình quản lý gói Unity, như mô tả ở trên trên trang này.