本頁面由 Cloud Translation API 翻譯而成。

在 Android 上將 App Check 與調試提供程序一起使用

如果在您為 App Check 註冊了您的應用程序後，您希望在 App Check 通常不會歸類為有效的環境中運行您的應用程序，例如開發期間的模擬器或持續集成 (CI) 環境，您可以創建使用 App Check 調試提供程序而不是真正的證明提供程序的應用程序的調試版本。

在模擬器中使用調試提供程序

要在以交互方式在模擬器中運行您的應用程序時（例如在開發期間）使用調試提供程序，請執行以下操作：

在您的模塊（應用級）Gradle 文件（通常是app/build.gradle ）中，聲明 App Check Android 庫的依賴項：
Java
```
dependencies {
    implementation 'com.google.firebase:firebase-appcheck-debug:16.0.0'
}
```
Kotlin+KTX
```
dependencies {
    implementation 'com.google.firebase:firebase-appcheck-debug:16.0.0'
}
```
注意：由於 App Check 目前處於測試階段，因此它不包含在Firebase BoM中。聲明 App Check 依賴項時必須指定完整的版本號。

在您的調試版本中，將 App Check 配置為使用調試提供程序工廠：

Java

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

Kotlin+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 資源，因此將其保密至關重要。不要將其提交到公共存儲庫，如果已註冊的令牌遭到破壞，請立即在 Firebase 控制台中將其撤消。

在 CI 環境中使用調試提供程序進行單元測試

要在持續集成 (CI) 環境中使用調試提供程序進行單元測試，請執行以下操作：

在 Firebase 控制台的應用檢查部分，從應用的溢出菜單中選擇管理調試令牌。然後，創建一個新的調試令牌。您將在下一步中需要該令牌。
由於此令牌允許在沒有有效設備的情況下訪問您的 Firebase 資源，因此將其保密至關重要。不要將其提交到公共存儲庫，如果已註冊的令牌遭到破壞，請立即在 Firebase 控制台中將其撤消。
將您剛剛創建的調試令牌添加到 CI 系統的安全密鑰存儲區（例如，GitHub Actions 的加密機密或 Travis CI 的加密變量）。
如有必要，配置您的 CI 系統以使您的調試令牌在 CI 環境中作為環境變量可用。將變量命名為APP_CHECK_DEBUG_TOKEN_FROM_CI之類的名稱。
在您的模塊（應用程序級）Gradle 文件（通常是app/build.gradle ）中：
1. 聲明 App Check Android 調試庫的測試依賴項：
  Java
```
dependencies {
    androidTestImplementation 'com.google.firebase:firebase-appcheck-debug-testing:16.0.0'
}
```
  Kotlin+KTX
```
dependencies {
    androidTestImplementation 'com.google.firebase:firebase-appcheck-debug-testing:16.0.0'
}
```
  注意：由於 App Check 目前處於測試階段，因此它不包含在Firebase BoM中。聲明 App Check 依賴項時必須指定完整的版本號。
2. 將以下內容添加到 CI 構建變體的配置中：
```
testInstrumentationRunnerArgument "firebaseAppCheckDebugSecret", System.getenv("APP_CHECK_DEBUG_TOKEN_FROM_CI") ?: ''
```

在您的測試類中，使用DebugAppCheckTestHelper包裝任何需要 App Check 令牌的代碼：

Java

@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.
                });
    }
}

Kotlin+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 後端服務將接受它發送的有效令牌。