此页面由 Cloud Translation API 翻译。

在 Android 上通过调试提供程序使用 App Check

如果在为 App Check 注册您的应用程序后，您想要在 App Check 通常不会将其归类为有效的环境中运行您的应用程序，例如开发期间的模拟器，或者从持续集成 (CI) 环境中运行您的应用程序，您可以创建使用 App Check 调试提供程序而不是真正的证明提供程序的应用程序的调试版本。

在模拟器中使用调试提供程序

要在模拟器中以交互方式运行您的应用程序时使用调试提供程序（例如，在开发期间），请执行以下操作：

在你的模块（应用程序级）摇篮文件（通常是app/build.gradle ），声明依赖的应用程序查看Android库：
爪哇
```
dependencies {
    implementation 'com.google.firebase:firebase-appcheck-debug:16.0.0-beta03'
}
```
科特林+KTX
```
dependencies {
    implementation 'com.google.firebase:firebase-appcheck-debug:16.0.0-beta03'
}
```
注意：由于App检查是目前处于测试阶段，它不包括在火力地堡物料清单。您在声明 App Check 依赖项时必须指定完整版本号。

在您的调试版本中，将 App Check 配置为使用调试提供程序工厂：

爪哇

FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());

科特林+KTX

FirebaseApp.initializeApp(/*context=*/this)
val firebaseAppCheck = FirebaseAppCheck.getInstance()
firebaseAppCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance()
)

启动应用程序并触发对 Firebase 后端服务的调用。当 SDK 尝试向后端发送请求时，将记录本地调试令牌。例如：

D DebugAppCheckProvider: Enter this debug secret into the allow list in
the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

在项目设置>应用程序检查的火力地堡控制台部分，从您的应用程序的溢出菜单管理调试令牌。然后，注册您在上一步中登录的调试令牌。

注册令牌后，Firebase 后端服务将接受它为有效。

由于此令牌允许在没有有效设备的情况下访问您的 Firebase 资源，因此将其保密至关重要。不要将其提交到公共存储库，如果注册的令牌遭到破坏，请立即在 Firebase 控制台中撤销它。

在 CI 环境中使用调试提供程序进行单元测试

要在持续集成 (CI) 环境中使用调试提供程序进行单元测试，请执行以下操作：

在项目设置>应用程序检查的火力地堡控制台部分，从您的应用程序的溢出菜单管理调试令牌。然后，创建一个新的调试令牌。您将在下一步中需要令牌。
由于此令牌允许在没有有效设备的情况下访问您的 Firebase 资源，因此将其保密至关重要。不要将其提交到公共存储库，如果注册的令牌遭到破坏，请立即在 Firebase 控制台中撤销它。
添加调试令牌，你刚刚创建的CI系统的安全密钥存储（例如，GitHub的操作加密机密或特拉维斯CI的加密变量）。
如有必要，配置您的 CI 系统，使您的调试令牌在 CI 环境中作为环境变量可用。命名变量类似APP_CHECK_DEBUG_TOKEN_FROM_CI 。
在你的模块（应用程序级）摇篮文件（通常是app/build.gradle ）：
1. 声明 App Check Android 调试库的测试依赖项：
  爪哇
```
dependencies {
    androidTestImplementation 'com.google.firebase:firebase-appcheck-debug-testing:16.0.0-beta03'
}
```
  科特林+KTX
```
dependencies {
    androidTestImplementation 'com.google.firebase:firebase-appcheck-debug-testing:16.0.0-beta03'
}
```
  注意：由于App检查是目前处于测试阶段，它不包括在火力地堡物料清单。您在声明 App Check 依赖项时必须指定完整版本号。
2. 将以下内容添加到 CI 构建变体的配置中：
```
testInstrumentationRunnerArgument "firebaseAppCheckDebugSecret", System.getenv("APP_CHECK_DEBUG_TOKEN_FROM_CI") ?: ''
```

在你的测试类，使用DebugAppCheckTestHelper包需要一个应用程序检查令牌的代码：

爪哇

@RunWith(AndroidJunit4.class)
public class YourTests {
    private final DebugAppCheckTestHelper debugAppCheckTestHelper =
            DebugAppCheckTestHelper.fromInstrumentationArgs();

    @Test
    public void testWithDefaultApp() {
        debugAppCheckTestHelper.withDebugProvider(() -> {
            // Test code that requires a debug AppCheckToken.
        });
    }

    @Test
    public void testWithNonDefaultApp() {
        debugAppCheckTestHelper.withDebugProvider(
                FirebaseApp.getInstance("nonDefaultApp"),
                () -> {
                    // Test code that requires a debug AppCheckToken.
                });
    }
}

科特林+KTX

@RunWith(AndroidJunit4::class)
class MyTests {
    private val debugAppCheckTestHelper =
        DebugAppCheckTestHelper.fromInstrumentationArgs()

    @Test
    fun testWithDefaultApp() {
        debugAppCheckTestHelper.withDebugProvider {
            // Test code that requires a debug AppCheckToken.
        }
    }

    @Test
    fun testWithNonDefaultApp() {
        debugAppCheckTestHelper.withDebugProvider(
            FirebaseApp.getInstance("nonDefaultApp")
        ) {
            // Test code that requires a debug AppCheckToken.
        }
    }
}

当您的应用在 CI 环境中运行时，Firebase 后端服务将接受它发送的有效令牌。