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 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 của bạn để tải các 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ố IL2CPP của Unity trên Android. Tuy nhiên, để xem dấu vết ngăn xếp được biểu thị bằng ký hiệu 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 ký hiệu lên tại thời gian tạo bằng cách sử dụng CLI Firebase.

  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 bạn đã 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 ứng dụng dùng Android API 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ỏ:

      1. Đánh dấu vào ô Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Cài đặt trình phát Android > Cài đặt xuất bản > Bản 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 những ứ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 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 biểu thị bằng ký hiệu trong bảng điều khiển Firebase.

    1. Trong 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 dự án Android Studio để tạo dự án; hoặc

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

    2. Sau khi quá trình tạo 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 rồi tải tệp đó lên các máy chủ của Firebase bằng cách chạy lệnh CLI Firebase sau:

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

      • FIREBASE_APP_ID: Mã ứng dụng Firebase cho Android (không phải tên gói)
        Ví dụ về mã ứng dụng Firebase cho Android: 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 đã xuất sau khi bạn tạo ứng dụng thông qua Gradle hoặc Android Studio.

        • Tạo tệp APK ngay 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 lựa chọn nâng cao để sử dụng lệnh CLI Firebase cho việc 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 mặc định cho việc 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à bạn muốn ghi đè cờ này để 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 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