Używanie Sprawdzania aplikacji z dostawcą debugowania w ramach Flutter

Po zarejestrowaniu aplikacji w usłudze Sprawdzanie aplikacji zwykle nie będzie ona działać w emulatorze ani w środowisku ciągłej integracji (CI), ponieważ te środowiska nie kwalifikują się jako prawidłowe urządzenia. Jeśli podczas tworzenia i testowania aplikacji chcesz ją uruchamiać w takim środowisku, możesz utworzyć jej wersję debugowania, która zamiast prawdziwego dostawcy atestów korzysta z dostawcy debugowania Sprawdzania aplikacji.

Ostrzeżenie: dostawca debugowania umożliwia dostęp do zasobów Firebase z niezweryfikowanych urządzeń. Nie używaj dostawcy debugowania w wersjach produkcyjnych aplikacji i nie udostępniaj wersji debugowania niegodnym zaufania osobom.

Platformy Apple

Aby użyć dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w symulatorze (np. w trakcie programowania), wykonaj te czynności:

1. Aktywuj Sprawdzanie aplikacji za pomocą dostawcy debugowania od razu po zainicjowaniu aplikacji Firebase:

   import 'package:flutter/material.dart';
   import 'package:firebase_core/firebase_core.dart';
   
   // Import the firebase_app_check plugin
   import 'package:firebase_app_check/firebase_app_check.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     await FirebaseAppCheck.instance.activate(
       // Set appleProvider to `AppleProvider.debug`
       appleProvider: AppleProvider.debug,
     );
     runApp(App());
   }
   

2. Włącz rejestrowanie debugowania w projekcie Xcode (wersja 11.0 lub nowsza):

   1. Kliknij Product (Produkt) > Scheme (Schemat) > Edit scheme (Edytuj schemat).
   2. W menu po lewej stronie kliknij Run (Uruchom), a następnie wybierz kartę Arguments (Argumenty).
   3. W sekcji Arguments Passed on Launch (Argumenty przekazywane przy uruchamianiu) dodaj -FIRDebugEnabled.

3. Otwórz ios/Runner.xcworkspace w Xcode i uruchom aplikację w symulatorze. Gdy Firebase spróbuje wysłać żądanie do backendu, aplikacja wydrukuje lokalny token debugowania w danych wyjściowych debugowania. Przykład:

   Firebase App Check Debug Token:
   123a4567-b89c-12d3-e456-789012345678

4. W sekcji App Check w konsoli Firebase wybierz Zarządzaj tokenami debugowania w menu aplikacji. Następnie zarejestruj token debugowania, za pomocą którego zalogowano się w poprzednim kroku.

   

Po zarejestrowaniu tokena usługi backendu Firebase będą go akceptować jako prawidłowy.

Ten token umożliwia dostęp do zasobów Firebase bez prawidłowego urządzenia, dlatego musisz zachować go w tajemnicy. Nie przesyłaj go do publicznego repozytorium, a jeśli zarejestrowany token zostanie kiedykolwiek naruszony, natychmiast go cofnij w konsoli Firebase.

Android

Aby używać dostawcy debugowania podczas uruchamiania aplikacji Flutter w środowisku Androida, zaimplementuj w niej ten kod:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    webRecaptchaSiteKey: 'recaptcha-v3-site-key',
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

Gdy Firebase spróbuje wysłać żądanie do backendu, aplikacja wyświetli w danych wyjściowych debugowania lokalny token debugowania. Przykład:

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

1. W sekcji App Check w konsoli Firebase wybierz Zarządzaj tokenami debugowania w menu aplikacji. Następnie zarejestruj token debugowania, za pomocą którego zalogowano się w poprzednim kroku.

   

Po zarejestrowaniu tokena usługi backendu Firebase będą go akceptować jako prawidłowy.

Sieć

Aby użyć dostawcy debugowania podczas uruchamiania aplikacji z localhost (np. w trakcie programowania):

Ostrzeżenie: nie próbuj włączać debugowania localhost, dodając localhost do dozwolonych domen reCAPTCHA. Dzięki temu każdy będzie mógł uruchomić Twoją aplikację na swoim komputerze.

1. W pliku web/index.html włącz tryb debugowania, ustawiając wartość self.FIREBASE_APPCHECK_DEBUG_TOKEN na true:

   <body>
     <script>
       self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
     </script>
   
     ...
   
   </body>
   

2. Uruchom aplikację internetową lokalnie i otwórz narzędzia deweloperskie przeglądarki. W konsoli debugowania zobaczysz token debugowania:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

   Ten token jest przechowywany lokalnie w przeglądarce i będzie używany za każdym razem, gdy będziesz korzystać z aplikacji w tej samej przeglądarce na tym samym komputerze. Jeśli chcesz użyć tokena w innej przeglądarce lub na innym urządzeniu, ustaw wartość self.FIREBASE_APPCHECK_DEBUG_TOKEN na ciąg tokena zamiast true.

3. W sekcji App Check w konsoli Firebase wybierz Zarządzaj tokenami debugowania w menu aplikacji. Następnie zarejestruj token debugowania, za pomocą którego zalogowano się w poprzednim kroku.

   

Po zarejestrowaniu tokena usługi backendu Firebase będą go akceptować jako prawidłowy.

Ten token umożliwia dostęp do zasobów Firebase bez prawidłowego urządzenia, dlatego musisz zachować go w tajemnicy. Nie przesyłaj go do publicznego repozytorium, a jeśli zarejestrowany token zostanie kiedykolwiek naruszony, natychmiast go cofnij w konsoli Firebase.