Các tùy chọn cài đặt Unity bổ sung
Thay vì tải xuống một .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ừ Google API cho trang Unity .
Trang web cung cấp:
- Các tệp
.unitypackage
.NET 4.X riêng lẻ để nhập dưới dạng gói Nội dung. - 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 vì các tệp .unitypackage
riêng lẻ chứa tất cả các tệp phụ thuộc cần thiết và .tgz
được liệt kê cùng với .tgz
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 Unity Package Manager, 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 các gói Firebase dưới dạng Nội dung
Khi nhập các sản phẩm Firebase từ tệp .unitypackage
được tải xuống từ Google API cho trang 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 pháp nhập trong một dự án. Đó là, không nhập các sản phẩm Firebase với luồng gói Nội dung và sử dụng luồng Trình quản lý gói thống nhất.
Sau khi tải xuống, để nhập:
Trong dự án Unity đang mở của bạn, điều hướng đến Nội dung > Gói nhập> Gói tùy chỉnh .
Trong cửa sổ Nhập Gói Hợp nhất , bấm 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ừ Google API cho kho lưu trữ 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 pháp nhập trong một dự án. Đó là, không nhập các sản phẩm Firebase với quy trình gói Nội dung và với quy trình Trình quản lý gói thống nhất.
Các phần phụ thuộc cho mỗi sản phẩm
.tgz
được liên kết cùng với các.tgz
của riêng chúng. Bạn phải tải xuống và nhập.tgz
sản phẩm và.tgz
phụ thuộc, theo đúng thứ tự:- Trình quản lý phụ thuộc bên ngoài (
com.google.external-dependency-manager
) - Firebase Core (
com.google.firebase.app
) - 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 Lưu trữ đám mây, trước tiên hãy nhập Xác thực (
com.google.firebase.auth
).
- Trình quản lý phụ thuộc bên ngoài (
Sau khi tải xuống, hãy nhậ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 Trình quản lý gói
- Mở cửa sổ Trình quản lý gói của Unity.
- 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ọnAdd package from tarball
để mở trình duyệt tệp. - 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 trực tiếp tarball. Trong trường hợp này, bạn sẽ cần:
- Giải nén
.tgz
. - 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ọnAdd package from disk
để mở trình duyệt tệp. - Chọn thư mục đã giải nén trong trình duyệt tệp.
manifest.json
- Tạo một thư mục mới bên cạnh thư mục
Packages
trong dự án của bạn và đặt tên làGooglePackages
. - Đặt các
.tgz
vào thư mục đó. - 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. Thêm mục nhập cho mỗi gói bạn muốn nhập, ánh xạ tên gói vào vị trí trên đĩa. Đảm bảo nối
file:
vào đường dẫn tệp.tgz
. Ví dụ: nếu bạn đang nhậpcom.google.firebase.storage
và phụ thuộc của nó, thìmanifest.json
của bạn sẽ trông giố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... } }
Lưu
manifest.json
.Khi Unity lấy lại tiêu điểm, nó 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ũ hơn không hỗ trợ .tgz
trong manifest.json
. Trong trường hợp này, bạn nên:
- Giải nén
.tgz
. 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ì.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 Nội dung
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 pháp 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 Unity Package Manager để nhập.
Để chuyển sang gói Nội dung:
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.
- 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 , hãy đảm bảo rằng "Gói: Trong dự án" được chọn.
- Lưu ý các phiên bản của gói Firebase đã nhập.
- Nhấp vào từng tên gói, sau đó nhấp vào Xóa . Đả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.
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 bạn cần duy trì 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ư được mô tả ở trên trên trang này.
Di chuyển từ gói Nội dung 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 pháp 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 Unity Package Manager để nhập.
Để di chuyển sang Trình quản lý gói Unity:
Đảm bảo rằng tất cả các gói Firebase và gói Trình quản lý phụ thuộc bên ngoài đều được 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 Trình quản lý gói
- Trong dự án Unity đang mở của bạn, đ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ý .
- Chọn tất cả các gói Firebase và Trình quản lý phụ thuộc bên ngoài.
- Nhấp vào Gỡ cài đặt gói đã chọn .
Loại bỏ thủ công
Sử dụng 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
Nhập các gói bằng Trình quản lý gói Unity, như được mô tả ở trên trên trang này.