如果在您為 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 配置為使用調試提供程序工廠:
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
)中:聲明 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' }
將以下內容添加到 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 後端服務將接受它發送的有效令牌。