Nhận báo cáo sự cố có thể đọc được trên trang tổng quan Crashlytics

iOS+ (nền tảng của Apple)

Đối với các ứng dụng nền tảng của Apple sử dụng Crashlytics Unity SDK 8.2.0 trở lên, Firebase Trình bổ trợ Trình chỉnh sửa Unity tự động định cấu hình dự án Xcode của bạn để tải 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+ 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 Unity IL2CPP gặp sự cố 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 thư viện gốc sự cố trong 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 gian xây dựng bằng cách sử dụng Giao diện dòng lệnh (CLI) của Firebase.

  1. Hãy đảm bảo rằng bạn đang sử dụng Crashlytics Unity SDK phiên bản 8.6.1 trở lên. Tải phiên bản mới nhất xuống.

  2. Thiết lập môi trường và dự án để tải biểu tượng lên:

    1. Làm theo hướng dẫn để cài đặt Giao diện dòng lệnh (CLI) của Firebase.

      Nếu bạn đã cài đặt CLI, hãy đảm bảo cập nhật lên phiên bản mới nhất.

    2. (chỉ dành cho ứng dụng sử dụng API Android cấp 30 trở lên Hãy cập nhật Mẫu AndroidManifest.xml để tắt tính năng Gắn thẻ con trỏ:

      1. Chọn hộp Android Player Settings > Cài đặt xuất bản > Xây dựng > Tệp kê khai chính tuỳ chỉnh.

      2. Mở mẫu tệp kê khai tại Assets/Plugins/Android/AndroidManifest.xml.

      3. (chỉ dành cho ứng dụng sử dụng phiên bản SDK trước đó 8.8.0) Thêm thuộc tính sau đây vào thẻ ứng dụng: <application android:allowNativeHeapPointerTagging="false" ... />

  3. Xây dựng dự án và tải biểu tượng lên.

    Hoàn thành các bước này mỗi khi bạn tạo một bản phát hành hay một bản dựng bất kỳ mà bạn muốn xem dấu vết ngăn xếp được thay thế bằng biểu tượng trong bảng điều khiển của Firebase.

    1. Từ hộp thoại Build Settings (Cài đặt bản dựng), hãy thực hiện một trong những thao tác sau:

      • Xuất sang một dự án Android Studio để xây dựng dự án; hoặc

      • Tạo APK trực tiếp trong Trình chỉnh sửa Unity.
        Trước khi tạo, hãy nhớ đánh dấu vào hộp Create mỹ.zip chọn trong hộp thoại Build Settings (Cài đặt bản dựng).

    2. Sau khi bản dựng hoàn tất, hãy tạo một biểu tượng tương thích với Crashlytics rồi tải tệp đó lên máy chủ Firebase bằng cách chạy lệnh sau Lệnh CLI của Firebase:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: Mã ứng dụng Android trên Firebase của bạn (không phải tên gói)
        Ví dụ về mã ứng dụng Android trên Firebase: 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS: Đường dẫn đến tệp biểu tượng được tạo bởi Giao diện dòng lệnh (CLI)

        • Đã xuất sang một dự án Android Studio — PATH/TO/SYMBOLS là thư mục unityLibrary/symbols Mã này được tạo trong thư mục gốc của dự án đã xuất sau khi bạn tạo ứng dụng thông qua Gradle hoặc Android Studio.

        • Tạo APK trực tiếp từ bên 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 của bạn 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 của 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 sử dụng. Bạn nên dùng chế độ cài đặt mặc định Trình tạo tệp biểu tượng Breakpad.

      --generator=breakpad

      Sử dụng trình tạo tệp biểu tượng Breakpad

      Lưu ý: Chế độ 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 symbolGenerator { csym() } trong cấu hình bản dựng và bạn muốn ghi đè để sử dụng Thay vào đó, breakpad.

      --dry-run

      Tạo tệp biểu tượng nhưng không tải chúng lên

      Cờ này hữu ích nếu bạn muốn kiểm tra nội dung của tệp được gửi đi.

      --debug Cung cấp thông tin gỡ lỗi bổ sung