Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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

  1. 在你的模块(应用程序级)摇篮文件(通常是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'
    }
    
  2. 在您的调试版本中,将 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()
    )
  3. 启动应用程序并触发对 Firebase 后端服务的调用。当 SDK 尝试向后端发送请求时,将记录本地调试令牌。例如:

    D DebugAppCheckProvider: Enter this debug secret into the allow list in
    the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
  4. 项目设置>应用程序检查的火力地堡控制台部分,从您的应用程序的溢出菜单管理调试令牌。然后,注册您在上一步中登录的调试令牌。

    “管理调试令牌”菜单项的屏幕截图

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

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

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

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

  1. 项目设置>应用程序检查的火力地堡控制台部分,从您的应用程序的溢出菜单管理调试令牌。然后,创建一个新的调试令牌。您将在下一步中需要令牌。

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

    “管理调试令牌”菜单项的屏幕截图

  2. 添加调试令牌,你刚刚创建的CI系统的安全密钥存储(例如,GitHub的操作加密机密或特拉维斯CI的加密变量)。

  3. 如有必要,配置您的 CI 系统,使您的调试令牌在 CI 环境中作为环境变量可用。命名变量类似APP_CHECK_DEBUG_TOKEN_FROM_CI

  4. 在你的模块(应用程序级)摇篮文件(通常是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'
      }
      
    2. 将以下内容添加到 CI 构建变体的配置中:

      testInstrumentationRunnerArgument "firebaseAppCheckDebugSecret", System.getenv("APP_CHECK_DEBUG_TOKEN_FROM_CI") ?: ''
      
  5. 在你的测试类,使用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 后端服务将接受它发送的有效令牌。