Nhận báo cáo sự cố dễ đọc trong trang tổng quan Crashlytics (Unity)

Chọn nền tảng: iOS+ Android Flutter Unity


iOS+ (Nền tảng Apple)

Đối với các ứng dụng trên nền tảng Apple sử dụng Crashlytics Unity SDK 8.2.0 trở lên, trình bổ trợ Firebase Unity Editor 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 các ứ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ố Unity IL2CPP trên Android. Tuy nhiên, để xem dấu vết ngăn xếp được biểu tượng hoá cho các sự cố thư viện gốc trong trang tổng quan Crashlytics, bạn phải tải thông tin biểu tượng lên tại thời gian xây dựng bằng Firebase CLI.

  1. Đả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 Firebase CLI.

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

    2. (chỉ dành cho các ứng dụng sử dụng cấp độ API Android 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ỏ:

      1. Đánh dấu vào hộp Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Cài đặt trình phát Android > Cài đặt phát hành > Tạo bản dựng > Tệp kê khai chính tuỳ chỉnh).

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

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

  3. Tạo bản dựng dự án và tải biểu tượng lên.

    Hoàn tất các bước này mỗi khi bạn tạo 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 được thay thế bằng biểu tượng trong Firebase bảng điều khiển.

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

      • Xuất sang dự án Android Studio để tạo bản dựng dự án; hoặc

      • Tạo APK trực tiếp từ Unity Editor.
        Trước khi tạo bản dựng, hãy đảm bảo rằng hộp kiểm Create symbols.zip (Tạo symbols.zip) được đánh dấu 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 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:

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

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

      • PATH/TO/SYMBOLS: Đường dẫn đến tệp biểu tượng do CLI tạo

        • Đã xuất sang 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 đã xuất sau khi bạn tạo bản 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 đã 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 Firebase lệnh CLI nhằm tạo và tải tệp biểu tượng lê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 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

      Xin 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 symbolGenerator { csym() } vào cấu hình bản dựng và muốn ghi đè để sử dụng Breakpad.

      --dry-run

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

      Cờ này 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