[Firebase Auth] setAppVerificationDisabledForTesting for Android

[yamauchieduardo]

When the user log-in using Phone Verification (using phones numbers configured in the Firebase Console), the reCAPTCHA process starts.

In the Flutter Fire Documentation the method setSetting could enable appVerificationDisabledForTesting feature just for iOS and Web.

This setting only applies to iOS and web platforms. When set to true, this property disables app verification for the purpose of testing phone authentication. For this property to take effect, it needs to be set before handling a reCAPTCHA app verifier. When this is disabled, a mock reCAPTCHA is rendered instead. This is useful for manual testing during development or for automated integration tests.

https://pub.dev/documentation/firebase_auth/latest/firebase_auth/FirebaseAuth/setSettings.html

This method could be used with android too. Reading the Kottlin SDK documentation, we have:

Disables application verification flows for Phone Authentication and Phone Multi-Factor flows. Intended for use with the phone numbers configured in the Firebase Console for testing (Authentication > Sign In Method > Phone), or with the Firebase Auth emulator.

Once this has been called, every call to PhoneAuthProvider#verifyPhoneNumber() will skip the SafetyNet and reCAPTCHA verification flows.

https://firebase.google.com/docs/reference/kotlin/com/google/firebase/auth/FirebaseAuthSettings.html#setappverificationdisabledfortesting

This feature is very necessary, because now I can't run integration tests using android emulators. The reCAPTCHA always blocks the integration test process.

[hab25]

There is a partial workaround for this: using the firebase emulators, as in that case the reCAPTCHA flow is not performed (see https://firebase.google.com/docs/emulator-suite/connect_auth#emulated_phonesms_authentication).

For convenience here's a snippet of code for this. Includes firestore emulator as well:

import 'package:flutter/foundation.dart';
import 'package:flutter/widgets.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:cloud_firestore/cloud_firestore.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  if (kDebugMode) {
    final ipAddress = defaultTargetPlatform == TargetPlatform.android
        ? '10.0.2.2'
        : 'localhost';
    FirebaseFirestore.instance.settings = Settings(host: '$ipAddress:8080', sslEnabled: false);
    await FirebaseAuth.instance.useEmulator('http://$ipAddress:9099');
  }
  runApp(/*...*/)
}