Trang này được dịch bởi Cloud Translation API.

Bắt đầu sử dụng Firebase Crashlytics

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

Việc thiết lập Crashlytics đòi hỏi bạn phải thực hiện các thao tác trong cả bảng điều khiển Firebase và IDE (chẳng hạn như thêm tệp cấu hình Firebase và SDK Crashlytics). Để hoàn tất quá trình thiết lập, bạn cần xác định sự cố thử nghiệm để gửi báo cáo sự cố đầu tiên đến Firebase.

Trước khi bắt đầu

Nếu chưa thực hiện, hãy thêm Firebase vào dự án Apple của bạn. Nếu không có ứng dụng Apple, bạn có thể tải ứng dụng mẫu xuống.
Đề xuất: Để tự động nhận nhật ký đường dẫn nhằm hiểu rõ các hành động của người dùng dẫn đến sự kiện gặp sự cố, không nghiêm trọng hoặc ANR, bạn cần bật Google Analytics trong dự án Firebase của mình.
- 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 trong thẻ Tích hợp của > Cài đặt dự án trong bảng điều khiển Firebase.
- Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.
Xin lưu ý rằng nhật ký đường dẫn có sẵn cho tất cả các nền tảng của Apple mà Crashlytics hỗ trợ, ngoại trừ watchOS.

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

Sử dụng Swift Package Manager để cài đặt và quản lý các phần phụ thuộc của Firebase.

Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
Khi được nhắc, hãy thêm kho lưu trữ SDK Firebase cho các nền tảng của Apple:

  https://github.com/firebase/firebase-ios-sdk.git

Chọn thư viện Crashlytics.
Để tận dụng nhật ký đường dẫn, hãy thêm Firebase SDK cho Google Analytics vào ứng dụng của bạn. Đảm bảo rằng Google Analytics đã được bật trong dự án Firebase của bạn.
Thêm cờ -ObjC vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu.
(Chỉ dành cho macOS) Trong Info.plist, hãy thêm khoá NSApplicationCrashOnExceptions và đặt khoá đó thành YES.
Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc của bạn xuống ở chế độ nền.

Tiếp theo, hãy định cấu hình mô-đun Firebase:

Nhập mô-đun Firebase vào cấu trúc App hoặc UIApplicationDelegate:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Định cấu hình một phiên bản dùng chung FirebaseApp, thường là trong phương thức application(_:didFinishLaunchingWithOptions:) của uỷ quyền ứng dụng:
Swift
```
// Use the Firebase library to configure APIs.
FirebaseApp.configure()
```
Objective-C
```
// Use the Firebase library to configure APIs.
[FIRApp configure];
```

Bước 2: Thiết lập Xcode để tự động tải các tệp dSYM lên

Để tạo báo cáo sự cố mà con người có thể đọc được, Crashlytics cần các tệp biểu tượng gỡ lỗi (dSYM) của dự án. Các bước sau đây mô tả cách định cấu hình Xcode để tự động tạo dSYM, xử lý và tải các tệp lên bất cứ khi nào bạn tạo ứng dụng.

Mở không gian làm việc Xcode của dự án, sau đó chọn tệp dự án trong trình điều hướng bên trái.
Trong danh sách TARGETS (MỤC TIÊU), hãy chọn mục tiêu chính của bản dựng.
Nhấp vào thẻ Build Settings (Cài đặt bản dựng), sau đó hoàn tất các bước sau để Xcode tạo dSYM cho các bản dựng của bạn.
1. Nhấp vào Tất cả, sau đó tìm debug information format.
2. Đặt Định dạng thông tin gỡ lỗi thành DWARF with dSYM File cho tất cả các loại bản dựng.
Nhấp vào thẻ Build Phases (Giai đoạn xây dựng), sau đó hoàn tất các bước sau để Xcode có thể xử lý dSYM và tải tệp lên.
1. Nhấp vào > New Run Script Phase (Giai đoạn tập lệnh chạy mới).
  
  Đảm bảo giai đoạn Run Script (Chạy tập lệnh) mới này là giai đoạn xây dựng cuối cùng của dự án; nếu không, Crashlytics sẽ không thể xử lý dSYM đúng cách.
2. Mở rộng mục Chạy tập lệnh mới.
  
  Lưu ý: Đối với các bước phụ còn lại, hãy sao chép và dán chính xác các đường dẫn như đã chỉ định, Xcode sẽ phân giải các đường dẫn đó. Tuy nhiên, nếu gặp vấn đề với Xcode khi phân giải các đường dẫn này hoặc có một cấu trúc dự án riêng biệt, bạn có thể chỉ định các đường dẫn theo cách thủ công.
3. Trong trường tập lệnh (nằm bên dưới nhãn Shell), hãy thêm tập lệnh chạy sau đây.
  
  Tập lệnh này xử lý các tệp dSYM của dự án và tải các tệp lên Crashlytics.
```
"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
```
4. Trong phần Input Files (Tệp đầu vào), hãy thêm đường dẫn cho vị trí của các tệp sau:
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
```
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
```
```
$(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
```
```
$(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)
```
  Nếu bạn có ENABLE_USER_SCRIPT_SANDBOXING=YES và ENABLE_DEBUG_DYLIB=YES trong chế độ cài đặt bản dựng dự án, hãy thêm những nội dung sau:
```
${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}.debug.dylib
```
  Hiểu lý do bạn cần biết vị trí của những tệp này
  
  Xcode tìm kiếm các tệp đầu vào này ở những vị trí được chỉ định để đảm bảo rằng các tệp bản dựng có sẵn cho tập lệnh chạy. Ngoài ra, nếu bạn bật User Script Sandboxing (Hộp cát tập lệnh người dùng), thì Xcode chỉ cho phép tập lệnh chạy truy cập vào các tệp được chỉ định trong Input Files (Tệp đầu vào).
  - Việc cung cấp vị trí của các tệp dSYM trong dự án sẽ cho phép Crashlytics xử lý dSYM.
  - Việc cung cấp vị trí của tệp GoogleService-Info.plist đã tạo của ứng dụng cho phép Crashlytics liên kết dSYM với ứng dụng Firebase của bạn.
  - Việc cung cấp vị trí của tệp thực thi của ứng dụng cho phép tập lệnh chạy ngăn chặn việc tải lên trùng lặp cùng một dSYM. Xin lưu ý rằng các tệp nhị phân của ứng dụng không được tải lên.

Để biết thêm thông tin chi tiết về tệp dSYM và Crashlytics (bao gồm cả cách tải tệp dSYM lên theo cách thủ công), hãy truy cập vào bài viết Nhận báo cáo sự cố đã gỡ rối mã nguồn.

Bước 3: Xác định sự cố thử nghiệm để hoàn tất việc thiết lập

Để hoàn tất việc thiết lập Crashlytics và xem dữ liệu ban đầu trên trang tổng quan Crashlytics của bảng điều khiển Firebase, bạn cần xác định sự cố thử nghiệm.

Thêm mã vào ứng dụng mà bạn có thể dùng để buộc xảy ra sự cố trong quá trình kiểm thử.

Bạn có thể dùng mã sau để thêm một nút vào ứng dụng. Khi nhấn nút này, ứng dụng sẽ gặp sự cố. Nút này có nhãn "Test Crash" (Kiểm thử sự cố).

SwiftUI

Button("Crash") {
  fatalError("Crash was triggered")
}

UIKit

Swift

import UIKit

class ViewController: UIViewController {
  override func viewDidLoad() {
      super.viewDidLoad()

      // Do any additional setup after loading the view, typically from a nib.

      let button = UIButton(type: .roundedRect)
      button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
      button.setTitle("Test Crash", for: [])
      button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
      view.addSubview(button)
  }

  @IBAction func crashButtonTapped(_ sender: AnyObject) {
      let numbers = [0]
      let _ = numbers[1]
  }
}

Objective-C

#import "ViewController.h"

@implementation ViewController
‐ (void)viewDidLoad {
    [super viewDidLoad];

    // Do any additional setup after loading the view, typically from a nib.

    UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
    button.frame = CGRectMake(20, 50, 100, 30);
    [button setTitle:@"Test Crash" forState:UIControlStateNormal];
    [button addTarget:self action:@selector(crashButtonTapped:)
        forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:button];
}

‐ (IBAction)crashButtonTapped:(id)sender {
    @[][1];
}

@end

Tạo và chạy ứng dụng trong Xcode khi trình gỡ lỗi Xcode bị ngắt kết nối.

Trình gỡ lỗi Xcode ngăn gửi báo cáo sự cố đến Crashlytics. Hoàn tất các bước sau để ngắt kết nối thiết bị thử nghiệm hoặc trình mô phỏng khỏi trình gỡ lỗi Xcode trước khi buộc xảy ra sự cố.
1. Nhấp vào Tạo rồi chạy chương trình hiện tại để tạo ứng dụng trên thiết bị kiểm thử hoặc trình mô phỏng.
2. Đợi cho đến khi ứng dụng của bạn đang chạy, sau đó nhấp vào Stop running the scheme or action (Dừng chạy lược đồ hoặc thao tác) để đóng phiên bản ban đầu của ứng dụng. Phiên bản ban đầu này bao gồm trình gỡ lỗi gây trở ngại cho Crashlytics.
Buộc sự cố kiểm thử xảy ra để gửi báo cáo sự cố đầu tiên của ứng dụng:
1. Mở ứng dụng trên màn hình chính của thiết bị kiểm thử hoặc trình mô phỏng.
2. Trong ứng dụng của bạn, hãy nhấn vào nút "Test Crash" (Kiểm thử sự cố) mà bạn đã thêm bằng mã ở trên.
3. Sau khi ứng dụng gặp sự cố, hãy chạy lại ứng dụng đó từ Xcode để ứng dụng có thể gửi báo cáo sự cố đến Firebase.
Chuyển đến Crashlytics trang tổng quan của bảng điều khiển Firebase để xem sự cố trong quá trình kiểm thử.

Nếu bạn đã làm mới bảng điều khiển nhưng vẫn không thấy sự cố kiểm thử sau 5 phút, hãy bật tính năng ghi nhật ký gỡ lỗi để xem ứng dụng của bạn có gửi báo cáo sự cố hay không.

Vậy là xong! Crashlytics hiện đang giám sát ứng dụng của bạn để phát hiện sự cố. Truy cập vào Crashlytics trang tổng quan để xem và tìm hiểu tất cả báo cáo và số liệu thống kê của bạn.

Các bước tiếp theo

Tuỳ chỉnh chế độ thiết lập báo cáo sự cố bằng cách thêm báo cáo chọn tham gia, nhật ký, khoá và tính năng theo dõi lỗi không nghiêm trọng.

Bắt đầu sử dụng Firebase Crashlytics Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Trước khi bắt đầu

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

Swift

Objective-C

Swift

Objective-C

Bước 2: Thiết lập Xcode để tự động tải các tệp dSYM lên

Bước 3: Xác định sự cố thử nghiệm để hoàn tất việc thiết lập

SwiftUI

UIKit

Swift

Objective-C

Các bước tiếp theo

Bắt đầu sử dụng Firebase Crashlytics