Sử dụng tính năng Kiểm tra ứng dụng với trình cung cấp gỡ lỗi trên các nền tảng của Apple
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.
Nếu sau khi đăng ký ứng dụng cho App Check, bạn muốn chạy ứng dụng trong một môi trường mà App Check thường không phân loại là hợp lệ, chẳng hạn như trình mô phỏng hoặc thiết bị 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 gỡ lỗi của ứng dụng sử dụng trình cung cấp gỡ lỗi App Check thay vì trình cung cấp chứng thực thực.
Sử dụng trình cung cấp gỡ lỗi trong quá trình phát triển
Để sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụ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:
Trong bản gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ nào của Firebase, hãy tạo và đặt nhà máy trình cung cấp gỡ lỗi App Check:
FIRAppCheckDebugProviderFactory*providerFactory=[[FIRAppCheckDebugProviderFactoryalloc]init];[FIRAppChecksetAppCheckProviderFactory:providerFactory];// Use Firebase library to configure APIs[FIRAppconfigure];
Bật tính năng ghi nhật ký gỡ lỗi trong dự án Xcode (phiên bản 11.0 trở lên):
Trong phần App Check của bảng điều khiển Firebase, hãy chọn Quản lý mã gỡ lỗi trong trình đơn tràn của ứng dụng. Sau đó, hãy đăng ký mã thông báo gỡ lỗi mà bạn đã đăng nhập ở bước trước.
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 mã thông báo đó là hợp lệ.
Vì mã thông báo này cho phép truy cập vào các tài nguyên Firebase của bạn mà không cần thiết bị hợp lệ, nên bạn cần phải giữ bí mật mã thông báo này. Đừng cam kết mã thông báo này với một kho lưu trữ công khai và nếu mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi ngay mã thông báo đó 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:
Trong phần App Check của bảng điều khiển Firebase, hãy chọn Quản lý mã gỡ lỗi trong trình đơn tràn của ứng dụng. Sau đó, hãy tạo một mã thông báo gỡ lỗi mới. Bạn sẽ cần mã thông báo này trong bước tiếp theo.
Vì mã thông báo này cho phép truy cập vào các tài nguyên Firebase của bạn mà không cần thiết bị hợp lệ, nên bạn cần phải giữ bí mật mã thông báo này. Đừng cam kết mã thông báo này với một kho lưu trữ công khai và nếu mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi ngay mã thông báo đó trong bảng điều khiển Firebase.
Thêm mã gỡ lỗi mà bạn vừa tạo vào kho khoá bảo mật của hệ thống CI (ví dụ: bí mật được mã hoá của GitHub Actions hoặc biến được mã hoá của Travis CI).
Nếu cần, hãy định cấu hình hệ thống CI để cung cấp mã gỡ lỗi trong môi trường CI dưới dạng một biến môi trường. Đặt tên cho biến, chẳng hạn như APP_CHECK_DEBUG_TOKEN_FROM_CI.
Trong Xcode, hãy thêm một biến môi trường vào chương trình kiểm thử của bạn bằng tên FIRAAppCheckDebugToken và một giá trị nào đó như $(APP_CHECK_DEBUG_TOKEN).
Định cấu hình tập lệnh kiểm thử CI để truyền mã thông báo gỡ lỗi dưới dạng một 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)
Trong bản gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ nào của Firebase, hãy tạo và đặt nhà máy trình cung cấp gỡ lỗi App Check:
FIRAppCheckDebugProviderFactory*providerFactory=[[FIRAppCheckDebugProviderFactoryalloc]init];[FIRAppChecksetAppCheckProviderFactory:providerFactory];// Use Firebase library to configure APIs[FIRAppconfigure];
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à ứng dụng gửi dưới dạng mã thông báo hợp lệ.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["If, after you have registered your app for App Check, you want to run your\napp in an environment that App Check would normally not classify as valid,\nsuch as a simulator or device during development, or from a continuous\nintegration (CI) environment, you can create a debug build of your app that uses\nthe App Check debug provider instead of a real attestation provider.\n| **Warning:** The debug provider allows access to your Firebase resources from unverified devices. **Don't** use the debug provider in production builds of your app, and be careful not to leak your debug token.\n\nUse the debug provider in development\n\nTo use the debug provider while running your app interactively\n(during development, for example), do the following:\n\n1. In your debug build, before using any Firebase backend services, create and\n set the App Check debug provider factory:\n\n Swift \n\n ```swift\n let providerFactory = AppCheckDebugProviderFactory()\n AppCheck.setAppCheckProviderFactory(providerFactory)\n\n FirebaseApp.configure()\n ```\n\n Objective-C \n\n ```objective-c\n FIRAppCheckDebugProviderFactory *providerFactory =\n [[FIRAppCheckDebugProviderFactory alloc] init];\n [FIRAppCheck setAppCheckProviderFactory:providerFactory];\n\n // Use Firebase library to configure APIs\n [FIRApp configure];\n ```\n2. Enable debug logging in your Xcode project (v11.0 or newer):\n\n 1. Open **Product \\\u003e Scheme \\\u003e Edit scheme**.\n 2. Select **Run** from the left menu, then select the **Arguments** tab.\n 3. In the **Arguments Passed on Launch** section, add `-FIRDebugEnabled`.\n3. Launch the app. A local debug token will be logged when the SDK tries to\n send a request to the backend. For example:\n\n ```\n [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:\n 123a4567-b89c-12d3-e456-789012345678\n ```\n4. In the [**App Check**](//console.firebase.google.com/project/_/appcheck) section\n of the Firebase console, choose **Manage debug tokens** from your app's\n overflow menu. Then, register the debug token you logged in the previous\n step.\n\nAfter you register the token, Firebase backend services will accept it as valid.\n\nBecause this token allows access to your Firebase resources without a\nvalid device, it is crucial that you keep it private. Don't commit it to a\npublic repository, and if a registered token is ever compromised, revoke it\nimmediately in the Firebase console.\n\nUse the debug provider in a CI environment\n\nTo use the debug provider in a continuous integration (CI) environment, do the\nfollowing:\n\n1. In the [**App Check**](//console.firebase.google.com/project/_/appcheck) section\n of the Firebase console, choose **Manage debug tokens** from your app's\n overflow menu. Then, create a new debug token. You'll need the token in the\n next step.\n\n Because this token allows access to your Firebase resources without\n a valid device, it is crucial that you keep it private. Don't commit it to a\n public repository, and if a registered token is ever compromised, revoke it\n immediately in the Firebase console.\n\n2. Add the debug token you just created to your CI system's secure key store\n (for example, GitHub Actions' [encrypted secrets](https://docs.github.com/en/actions/reference/encrypted-secrets)\n or Travis CI's [encrypted variables](https://docs.travis-ci.com/user/environment-variables/#defining-encrypted-variables-in-travisyml)).\n\n3. If necessary, configure your CI system to make your debug token available\n within the CI environment as an environment variable. Name the variable\n something like `APP_CHECK_DEBUG_TOKEN_FROM_CI`.\n\n4. In Xcode, add an environment variable to your testing scheme with the name\n `FIRAAppCheckDebugToken` and something like `$(APP_CHECK_DEBUG_TOKEN)` as\n the value.\n\n5. Configure your CI test script to pass the debug token as an environment\n variable. For example:\n\n ```\n xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \\\n APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)\n ```\n6. In your debug build, before using any Firebase backend services, create and\n set the App Check debug provider factory:\n\n Swift \n\n ```swift\n let providerFactory = AppCheckDebugProviderFactory()\n AppCheck.setAppCheckProviderFactory(providerFactory)\n\n FirebaseApp.configure()\n ```\n\n Objective-C \n\n ```objective-c\n FIRAppCheckDebugProviderFactory *providerFactory =\n [[FIRAppCheckDebugProviderFactory alloc] init];\n [FIRAppCheck setAppCheckProviderFactory:providerFactory];\n\n // Use Firebase library to configure APIs\n [FIRApp configure];\n ```\n\nWhen your app runs in a CI environment, Firebase backend services will accept\nthe token it sends as valid."]]
