This guide contains instructions for the latest version of the Firebase Crashlytics SDK. If you migrated your app from Fabric, make sure it's been upgraded and no longer uses the deprecated legacy Fabric SDK.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Bắt đầu với Firebase Crashlytics

Phần bắt đầu nhanh này mô tả cách thiết lập Firebase Crashlytics trong ứng dụng của bạn với SDK Firebase Crashlytics, vì vậy bạn có thể nhận được báo cáo sự cố toàn diện trong bảng điều khiển Firebase .

Trước khi bắt đầu

  1. Nếu bạn chưa có, hãy thêm Firebase vào dự án Unity của bạn. Nếu bạn không có dự án Unity, bạn có thể tải xuống một ứng dụng mẫu .

    Lưu ý rằng việc thêm Firebase vào dự án Unity của bạn liên quan đến các tác vụ trong bảng điều khiển Firebase và trong dự án Unity đang mở của bạn (ví dụ: bạn tải xuống tệp cấu hình Firebase từ bảng điều khiển, sau đó di chuyển chúng vào dự án Unity của bạn).

  2. Tùy chọn : Để nhận các chỉ số sự cố, chẳng hạn như người dùng không gặp sự cố, đường dẫn và sự kiện tùy chỉnh, bạn cần bật Google Analytics trong dự án Firebase của mình.

    1. Nếu dự án Firebase hiện tại của bạn chưa bật Google Analytics, bạn có thể bật Google Analytics từ tab Tích hợp trong > Cài đặt dự án .

      Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quá trình tạo dự án.

    2. Cuối cùng, trong bảng điều khiển Google Analytics, hãy bật chia sẻ dữ liệu trong tab Quản trị > Cài đặt tài khoản > Cài đặt chia sẻ dữ liệu .

      Đối với các dự án Firebase cũ hơn, hãy lưu ý rằng bạn có thể cần bật chia sẻ dữ liệu trong tab Tích hợp của > Cài đặt dự án (trong bảng điều khiển Firebase).

Bước 1 : Thiết lập Crashlytics trong bảng điều khiển Firebase

  1. Nhấp vào Crashlytics trong bảng điều hướng bên trái của bảng điều khiển Firebase .

  2. Nếu dự án Firebase của bạn có nhiều ứng dụng được đăng ký, hãy chọn ứng dụng bạn vừa thêm từ menu thả xuống bên cạnh Crashlytics ở thanh trên cùng của bảng điều khiển.

  3. Nhấp vào Bật Crashlytics .

Bước 2 : Thêm Firebase Crashlytics vào ứng dụng của bạn

  1. Tải xuống Firebase Unity SDK , sau đó giải nén SDK ở nơi nào đó thuận tiện.

    SDK Unity Firebase không dành riêng cho nền tảng.

  2. 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 .

  3. Từ SDK đã giải nén, hãy chọn nhập Crashlytics SDK ( FirebaseCrashlytics.unitypackage ).

    Bạn cũng có thể nhập bất kỳ sản phẩm Firebase được hỗ trợ nào khác.

  4. Trong cửa sổ Nhập Gói Hợp nhất , bấm Nhập .

Bước 3 : Khởi tạo Crashlytics

  1. Tạo một tập lệnh C # mới, sau đó thêm nó vào một GameObject trong cảnh.

    1. Mở cảnh đầu tiên của bạn, sau đó tạo một GameObject trống có tên là CrashlyticsInitializer .

    2. Bấm Thêm thành phần trong Thanh tra cho đối tượng mới.

    3. Chọn tập lệnh CrashlyticsInit của bạn để thêm nó vào đối tượng CrashlyticsInitializer .

  2. Khởi tạo Crashlytics trong phương thức Start của tập lệnh:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

Với SDK được thêm vào và khởi chạy, Crashlytics tự động bắt đầu hoạt động lắng nghe và thu thập báo cáo sự cố.

Bước 4 : Chạy dự án của bạn

Sau khi xuất dự án của bạn sang iOS hoặc Android , hãy xác minh rằng dự án được xuất chính xác.

Nếu có vẻ như các tệp bị thiếu sau khi so sánh dự án của bạn với các cấu hình xuất mẫu bên dưới, hãy mở Unity Editor, sau đó chạy Trình phân giải dịch vụ của Google Play .

iOS

Android

Chạy trình phân giải (tùy chọn)

Bộ phân giải các dịch vụ của Google Play đảm bảo rằng dự án Unity của bạn có các phụ thuộc thích hợp để xuất ứng dụng của bạn sang iOS hoặc Android .

Để biết thêm thông tin về trình phân giải, hãy truy cập README cho Trình phân giải Jar Unity .

iOS

Trình phân giải iOS chạy tự động và tận dụng Cocoapods để đưa các phần phụ thuộc iOS vào thư mục Pods xuất.

  • Để tải Cocoapods về máy của bạn:

    • Điều hướng đến Nội dung > Trình phân giải dịch vụ Play > Trình phân giải iOS > Cài đặt Cocoapods
  • Để bật hoặc tắt tạo podfiles (tùy chọn) :

    • Điều hướng đến Nội dung > Trình phân giải dịch vụ Play > Trình phân giải iOS > Cài đặt

Android

Android Resolver chạy tự động và tận dụng gradle để đưa các phần phụ thuộc của Android vào Assets/Plugins/Android .

  • Để chạy trình phân giải theo cách thủ công:

    • Điều hướng đến Nội dung > Trình phân giải dịch vụ Play > Trình phân giải Android > Giải quyết
  • Để bật hoặc tắt độ phân giải tự động (được bật theo mặc định):

    • Điều hướng đến Nội dung > Trình phân giải dịch vụ Play > Trình phân giải Android > Cài đặt

Bước tiếp theo