iOS+ (Nền tảng của Apple)
Đối với các ứng dụng nền tảng Apple sử dụng SDK Unity Crashlytics phiên bản 8.2.0 trở lên, trình bổ trợ Trình chỉnh sửa Unity của Firebase sẽ tự động định cấu hình dự án Xcode để tải biểu tượng lên. Tải phiên bản mới nhất xuống.
Android
Đối với ứng dụng Android, Crashlytics Unity SDK 8.6.1 trở lên sẽ tự động bao gồm tính năng báo cáo sự cố NDK, cho phép Crashlytics tự động báo cáo các sự cố IL2CPP của Unity trên Android. Tuy nhiên, để xem dấu vết ngăn xếp được thay thế bằng biểu tượng cho các sự cố xảy ra với thư viện gốc trên trang tổng quan Crashlytics, bạn phải tải thông tin về biểu tượng lên tại thời điểm xây dựng bằng cách sử dụng Giao diện dòng lệnh (CLI) của Firebase.
Hãy đảm bảo rằng bạn đang sử dụng SDK Unity Crashlytics phiên bản 8.6.1 trở lên. Tải phiên bản mới nhất xuống.
Thiết lập môi trường và dự án để tải biểu tượng lên:
Làm theo hướng dẫn để cài đặt Firebase CLI.
Nếu bạn đã cài đặt CLI, hãy nhớ cập nhật lên phiên bản mới nhất.
(chỉ dành cho ứng dụng sử dụng API Android cấp 30 trở lên) Cập nhật mẫu
AndroidManifest.xml
của ứng dụng để tắt tính năng Gắn thẻ con trỏ:Chọn hộp Android Player Settings > Publishing Settings > Build > Custom Manifest (Cài đặt trình phát Android > Cài đặt phát hành > Bản dựng > Tệp kê khai chính tuỳ chỉnh).
Mở mẫu tệp kê khai nằm tại
Assets/Plugins/Android/AndroidManifest.xml
.(chỉ dành cho ứng dụng sử dụng phiên bản SDK trước 8.8.0) Hãy thêm thuộc tính sau vào thẻ ứng dụng:
<application android:allowNativeHeapPointerTagging="false" ... />
Tạo dự án và tải biểu tượng lên.
Hãy hoàn tất các bước này mỗi khi bạn tạo một bản phát hành hoặc bất kỳ bản dựng nào mà bạn muốn xem dấu vết ngăn xếp thay thế bằng biểu tượng trong bảng điều khiển của Firebase.
Trên hộp thoại Build Settings (Cài đặt bản dựng), hãy làm theo một trong những cách sau:
Xuất sang một dự án Android Studio để tạo dự án; hoặc
Tạo APK trực tiếp từ Trình chỉnh sửa Unity.
Trước khi tạo, hãy nhớ đánh dấu vào hộp Create Shorts (Tạo ký hiệu.zip) trong hộp thoại Build Settings (Cài đặt bản dựng).
Sau khi bản dựng hoàn tất, hãy tạo một tệp biểu tượng tương thích với Crashlytics và tải tệp đó lên máy chủ Firebase bằng cách chạy lệnh Firebase CLI sau đây:
firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS
FIREBASE_APP_ID: Mã ứng dụng Android Firebase của bạn (không phải tên gói)
Mã ứng dụng Android Firebase mẫu:1:567383003300:android:17104a2ced0c9b9b
PATH/TO/SYMBOLS: Đường dẫn đến tệp biểu tượng do CLI tạo
Được xuất sang một dự án Android Studio – PATH/TO/SYMBOLS là thư mục
unityLibrary/symbols
, được tạo trong thư mục gốc của dự án được xuất sau khi bạn xây dựng ứng dụng thông qua Gradle hoặc Android Studio.Tạo APK trực tiếp từ trong Unity – PATH/TO/SYMBOLS là đường dẫn của tệp biểu tượng được nén được tạo trong thư mục gốc của dự án khi bản dựng hoàn tất (ví dụ:
).myproject/myapp-1.0-v100.symbols.zip
Xem các tuỳ chọn nâng cao để sử dụng lệnh CLI Firebase để tạo và tải tệp biểu tượng lên
Gắn cờ Nội dung mô tả --generator=csym
Sử dụng trình tạo tệp biểu tượng cSYM cũ thay vì trình tạo Breakpad mặc định
Không nên dùng. Bạn nên sử dụng trình tạo tệp biểu tượng Breakpad mặc định.
--generator=breakpad
Sử dụng trình tạo tệp biểu tượng Breakpad
Lưu ý rằng giá trị mặc định để tạo tệp biểu tượng là Breakpad. Chỉ sử dụng cờ này nếu bạn đã thêm
vào cấu hình bản dựng và muốn ghi đè lên đó để sử dụng Breakpad.symbolGenerator { csym() }
--dry-run
Tạo các tệp biểu tượng nhưng không tải chúng lên
Cờ này sẽ hữu ích nếu bạn muốn kiểm tra nội dung của các tệp được gửi.
--debug
Cung cấp thông tin gỡ lỗi bổ sung