Sử dụng Kiểm tra ứng dụng với nhà cung cấp gỡ lỗi trên nền tảng Apple

Nếu sau khi đăng ký ứng dụng của mình để Kiểm tra ứng dụng, bạn muốn chạy ứng dụng của mình trong môi trường mà Kiểm tra ứng dụng thường không được phân loại là hợp lệ, chẳng hạn như trình mô phỏng trong quá trình phát triển hoặc từ môi trường tích hợp liên tục (CI), bạn có thể tạo bản dựng gỡ lỗi của ứng dụng của bạn sử dụng nhà cung cấp gỡ lỗi Kiểm tra ứng dụng thay vì nhà cung cấp chứng thực thực sự.

Sử dụng trình cung cấp gỡ lỗi trong trình mô phỏng

Để sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng của bạn trong trình mô phỏng một cách tương tác (ví dụ: trong quá trình phát triển), hãy làm như sau:

  1. Trong bản dựng gỡ lỗi của bạn, trước khi sử dụng bất kỳ dịch vụ phụ trợ Firebase nào, hãy tạo và đặt nhà máy cung cấp dịch vụ gỡ lỗi Kiểm tra ứng dụng:

    Nhanh

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];
  2. Bật ghi nhật ký gỡ lỗi trong dự án Xcode của bạn (v11.0 hoặc mới hơn):

    1. Mở Sản phẩm> Lược đồ> Chỉnh sửa lược đồ .
    2. Chọn Chạy từ menu bên trái, sau đó chọn tab Đối số .
    3. Trong phần Đối số được truyền khi khởi chạy , hãy thêm -FIRDebugEnabled .
  3. Khởi chạy ứng dụng. Mã thông báo gỡ lỗi cục bộ sẽ được ghi lại khi SDK cố gắng gửi yêu cầu đến phần phụ trợ. Ví dụ:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
    123a4567-b89c-12d3-e456-789012345678
  4. Trong phần Kiểm tra ứng dụng của bảng điều khiển Firebase, chọn Quản lý mã thông báo gỡ lỗi từ menu mục bổ sung của ứng dụng của bạn. Sau đó, đăng ký mã thông báo gỡ lỗi mà bạn đã đăng nhập ở bước trước.

    Ảnh chụp màn hình của mục menu Quản lý mã thông báo gỡ lỗi

Sau khi bạn đăng ký mã thông báo, các dịch vụ phụ trợ của Firebase sẽ chấp nhận nó là hợp lệ.

Vì mã thông báo này cho phép truy cập vào tài nguyên Firebase của bạn mà không cần thiết bị hợp lệ, điều quan trọng là bạn phải giữ nó ở chế độ riêng tư. Đừng chuyển nó vào một kho lưu trữ công cộng và nếu một mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi nó ngay lập tức trong bảng điều khiển Firebase.

Sử dụng trình cung cấp gỡ lỗi trong môi trường CI

Để sử dụng trình cung cấp gỡ lỗi trong môi trường tích hợp liên tục (CI), hãy làm như sau:

  1. Trong phần Kiểm tra ứng dụng của bảng điều khiển Firebase, chọn Quản lý mã thông báo gỡ lỗi từ menu mục bổ sung của ứng dụng của bạn. Sau đó, tạo mã thông báo gỡ lỗi mới. Bạn sẽ cần mã thông báo trong bước tiếp theo.

    Vì mã thông báo này cho phép truy cập vào tài nguyên Firebase của bạn mà không cần thiết bị hợp lệ, điều quan trọng là bạn phải giữ nó ở chế độ riêng tư. Đừng chuyển nó vào một kho lưu trữ công cộng và nếu một mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi nó ngay lập tức trong bảng điều khiển Firebase.

    Ảnh chụp màn hình của mục menu Quản lý mã thông báo gỡ lỗi

  2. Thêm mã gỡ lỗi bạn vừa tạo vào kho khóa bảo mật của hệ thống CI của bạn (ví dụ: bí mật được mã hóa của GitHub Actions hoặc các biến được mã hóa của Travis CI).

  3. Nếu cần, hãy định cấu hình hệ thống CI của bạn để cung cấp mã thông báo gỡ lỗi của bạn trong môi trường CI dưới dạng một biến môi trường. Đặt tên biến giống như APP_CHECK_DEBUG_TOKEN_FROM_CI .

  4. Trong Xcode, hãy thêm một biến môi trường vào lược đồ thử nghiệm của bạn với tên FIRAAppCheckDebugToken và một giá trị như $(APP_CHECK_DEBUG_TOKEN) .

  5. Định cấu hình tập lệnh kiểm tra CI của bạn để chuyển mã thông báo gỡ lỗi dưới dạng biến môi trường. Ví dụ:

    xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
    APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
  6. Trong bản dựng gỡ lỗi của bạn, trước khi sử dụng bất kỳ dịch vụ phụ trợ Firebase nào, hãy tạo và đặt nhà máy cung cấp dịch vụ gỡ lỗi Kiểm tra ứng dụng:

    Nhanh

    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    
    FirebaseApp.configure()

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];

Khi ứng dụng của bạn chạy trong môi trường CI, các dịch vụ phụ trợ của Firebase sẽ chấp nhận mã thông báo mà nó gửi là hợp lệ.