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

Gdy zarejestrujesz aplikację w Sprawdzaniu aplikacji, zwykle nie będzie ona działać w emulatorze ani w trybie ciągłej integracji (CI), ponieważ te środowiska nie są uznawane za prawidłowe urządzenia. Jeśli chcesz uruchomić aplikację w takim środowisku podczas programowania i testowania, możesz utworzyć kompilację do debugowania aplikacji, która zamiast prawdziwego dostawcy potwierdzenia będzie używać dostawcy debugowania Sprawdzania aplikacji.

Platformy Apple

Aby używać dostawcy debugowania podczas interaktywnego uruchamiania aplikacji w symulatorze (np. podczas programowania):

1. Aktywuj Sprawdzanie aplikacji za pomocą dostawcy debugowania zaraz po zainicjowaniu aplikacji w 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 logowanie debugowania w projekcie Xcode (w wersji 11.0 lub nowszej):

   1. Otwórz 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 wyświetli lokalny token debugowania w danych wyjściowych debugowania. Przykład:

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

4. W konsoli Firebase otwórz Zabezpieczenia > Sprawdzanie aplikacji.

5. Zarejestruj token debugowania, który został właśnie zalogowany.

   1. Na karcie Aplikacje znajdź swoją aplikację.
   2. W rozszerzonym menu aplikacji kliknij Zarządzaj tokenami debugowania.
   3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zarejestrować token debugowania.

   

Gdy zarejestrujesz token, usługi backendu Firebase zaakceptują go 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 naruszony, natychmiast go unieważnij w konsoli Firebase.

Android

Aby używać dostawcy debugowania podczas uruchamiania aplikacji Flutter w środowisku Android, zaimplementuj w aplikacji Flutter 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 lokalny token debugowania w danych wyjściowych 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 konsoli Firebase otwórz Zabezpieczenia > Sprawdzanie aplikacji.

2. Zarejestruj token debugowania, który został właśnie zalogowany.

   1. Na karcie Aplikacje znajdź swoją aplikację.
   2. W rozszerzonym menu aplikacji kliknij Zarządzaj tokenami debugowania.
   3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zarejestrować token debugowania.

   

Gdy zarejestrujesz token, usługi backendu Firebase zaakceptują go jako prawidłowy.

Sieć

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

1. W pliku web/index.html włącz tryb debugowania, ustawiając 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ędzie dla programistów w przeglądarce. 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żywać tokena w innej przeglądarce lub na innym komputerze, ustaw self.FIREBASE_APPCHECK_DEBUG_TOKEN na ciąg tokena zamiast true.

3. W konsoli Firebase otwórz Zabezpieczenia > Sprawdzanie aplikacji.

4. Zarejestruj token debugowania, który został właśnie zalogowany.

   1. Na karcie Aplikacje znajdź swoją aplikację.
   2. W rozszerzonym menu aplikacji kliknij Zarządzaj tokenami debugowania.
   3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zarejestrować token debugowania.

   

Gdy zarejestrujesz token, usługi backendu Firebase zaakceptują go 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 naruszony, natychmiast go unieważnij w konsoli Firebase.