Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Sử dụng Kiểm tra ứng dụng với nhà cung cấp gỡ lỗi bằng Flutter

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.

Sau khi bạn đã đăng ký ứng dụng của mình để Kiểm tra ứng dụng, ứng dụng của bạn thường sẽ không chạy trong trình giả lập hoặc từ môi trường tích hợp liên tục (CI), vì những môi trường đó không đủ điều kiện là thiết bị hợp lệ. Nếu bạn muốn chạy ứng dụng của mình trong một môi trường như vậy trong quá trình phát triển và thử nghiệm, bạn có thể tạo một bản dựng gỡ lỗi cho ứng dụng của mình bằng cách 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ự.

Nền tảng của Apple

Để 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 tệp ios/Runner/AppDelegate.swift (hoặc AppDelegate.m ), tạo và đặt nhà máy cung cấp gỡ lỗi Kiểm tra ứng dụng trong bản dựng Gỡ lỗi:

    Nhanh

    import UIKit
    import Flutter
    import Firebase  // Add the Firebase import.
    
    @UIApplicationMain
    @objc class AppDelegate: FlutterAppDelegate {
      override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
      ) -> Bool {
        // Use the debug provider in Debug builds:
    #if DEBUG
        let providerFactory = AppCheckDebugProviderFactory()
        AppCheck.setAppCheckProviderFactory(providerFactory)
    #endif
    
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
      }
    }
    

    Objective-C

    #import "AppDelegate.h"
    #import "GeneratedPluginRegistrant.h"
    @import Firebase;  // Add the Firebase import.
    
    @implementation AppDelegate
    
    - (BOOL)application:(UIApplication *)application
        didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
      // Use the debug provider in Debug builds:
    #if DEBUG
      FIRAppCheckDebugProviderFactory *providerFactory = [[FIRAppCheckDebugProviderFactory alloc] init];
      [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    #endif
      [GeneratedPluginRegistrant registerWithRegistry:self];
      // Override point for customization after application launch.
      return [super application:application didFinishLaunchingWithOptions:launchOptions];
    }
    
    @end
    
  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. Mở ios/Runner.xcworkspace bằng Xcode và chạy ứng dụng của bạn trong Trình mô phỏng. Ứng dụng của bạn sẽ in mã thông báo gỡ lỗi cục bộ tới đầu ra gỡ lỗi khi Firebase cố gắng gửi yêu cầu đến chương trình 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ệ.

Bởi 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 khai 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.

Android

Để sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng Flutter của bạn trong môi trường Android, hãy triển khai mã sau trong ứng dụng Flutter của bạn:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    webRecaptchaSiteKey: 'recaptcha-v3-site-key',
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

Ứng dụng của bạn sẽ in mã thông báo gỡ lỗi cục bộ tới đầu ra gỡ lỗi khi Firebase cố gắng gửi yêu cầu đến chương trình phụ trợ. Ví dụ:

D DebugAppCheckProvider: Enter this debug secret into the allow list in
the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
  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 đó, đă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ệ.

Web

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

  1. Trong tệp web/index.html , bật chế độ gỡ lỗi bằng cách đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành true :

    <body>
      <script>
        self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
      </script>
    
      ...
    
    </body>
    
  2. Chạy ứng dụng web của bạn cục bộ và mở công cụ dành cho nhà phát triển của trình duyệt. Trong bảng điều khiển gỡ lỗi, bạn sẽ thấy mã thông báo gỡ lỗi:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
    need to safelist it in the Firebase console for it to work.

    Mã thông báo này được lưu trữ cục bộ trong trình duyệt của bạn và sẽ được sử dụng bất cứ khi nào bạn sử dụng ứng dụng của mình trong cùng một trình duyệt trên cùng một máy. Nếu bạn muốn sử dụng mã thông báo trong một trình duyệt khác hoặc trên một máy tính khác, hãy đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành chuỗi mã thông báo thay vì true .

  3. 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ệ.

Bởi 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 khai 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.