Flutter की मदद से डीबग की सेवा देने वाली कंपनी के साथ ऐप्लिकेशन की जांच करने की सुविधा का इस्तेमाल करना

App Check के लिए अपने ऐप्लिकेशन को रजिस्टर करने के बाद, आपका ऐप्लिकेशन आम तौर पर किसी एम्युलेटर या कंटीन्यूअस इंटिग्रेशन (सीआई) एनवायरमेंट में नहीं चलेगा. ऐसा इसलिए, क्योंकि इन एनवायरमेंट को मान्य डिवाइस नहीं माना जाता. अगर आपको डेवलपमेंट और टेस्टिंग के दौरान, अपने ऐप्लिकेशन को ऐसे एनवायरमेंट में चलाना है, तो अपने ऐप्लिकेशन का डीबग बिल्ड बनाया जा सकता है. यह बिल्ड, पुष्टि करने की सुविधा देने वाली असली कंपनी के बजाय, App Check की डीबग सेवा देने वाली कंपनी का इस्तेमाल करता है.

चेतावनी: डीबग प्रोवाइडर, बिना पुष्टि किए गए डिवाइसों से आपके Firebase संसाधनों को ऐक्सेस करने की अनुमति देता है. अपने ऐप्लिकेशन की प्रोडक्शन बिल्ड में डीबग प्रोवाइडर का इस्तेमाल न करें. साथ ही, अपनी डीबग बिल्ड को उन पक्षों के साथ शेयर न करें जिन पर भरोसा नहीं किया जा सकता.

Apple के प्लैटफ़ॉर्म

सिम्युलेटर में ऐप्लिकेशन को इंटरैक्टिव तरीके से चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने के लिए, यह तरीका अपनाएं. जैसे, डेवलपमेंट के दौरान:

1. अपने Firebase ऐप्लिकेशन को शुरू करने के तुरंत बाद, डीबग प्रोवाइडर के साथ App Check को चालू करें:

   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. अपने Xcode प्रोजेक्ट (v11.0 या इसके बाद के वर्शन) में डीबग लॉगिंग की सुविधा चालू करें:

   1. Product > Scheme > Edit scheme खोलें.
   2. बाईं ओर मौजूद मेन्यू से, Run को चुनें. इसके बाद, Arguments टैब को चुनें.
   3. Arguments Passed on Launch सेक्शन में, -FIRDebugEnabled जोड़ें.

3. ios/Runner.xcworkspace को Xcode की मदद से खोलें और अपने ऐप्लिकेशन को सिम्युलेटर में चलाएं. जब Firebase बैकएंड को कोई अनुरोध भेजने की कोशिश करेगा, तब आपका ऐप्लिकेशन डीबग आउटपुट में एक लोकल डीबग टोकन प्रिंट करेगा. उदाहरण के लिए:

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

4. Firebase कंसोल के App Check सेक्शन में जाकर, अपने ऐप्लिकेशन के ओवरफ़्लो मेन्यू से डीबग टोकन मैनेज करें चुनें. इसके बाद, पिछले चरण में लॉग इन किए गए डीबग टोकन को रजिस्टर करें.

   

टोकन रजिस्टर करने के बाद, Firebase की बैकएंड सेवाएं इसे मान्य के तौर पर स्वीकार करेंगी.

यह टोकन, मान्य डिवाइस के बिना भी आपके Firebase संसाधनों को ऐक्सेस करने की अनुमति देता है. इसलिए, यह ज़रूरी है कि आप इसे निजी रखें. इसे किसी सार्वजनिक रिपॉज़िटरी में सेव न करें. अगर कभी कोई रजिस्टर किया गया टोकन गलत हाथों में पड़ जाता है, तो उसे Firebase कंसोल में जाकर तुरंत रद्द करें.

Android

Android एनवायरमेंट में अपने Flutter ऐप्लिकेशन को चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने के लिए, अपने Flutter ऐप्लिकेशन में यहां दिया गया कोड लागू करें:

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());
}

जब Firebase बैकएंड को अनुरोध भेजने की कोशिश करेगा, तब आपका ऐप्लिकेशन डीबग आउटपुट में लोकल डीबग टोकन प्रिंट करेगा. उदाहरण के लिए:

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

1. Firebase कंसोल के App Check सेक्शन में जाकर, अपने ऐप्लिकेशन के ओवरफ़्लो मेन्यू से डीबग टोकन मैनेज करें चुनें. इसके बाद, पिछले चरण में लॉग इन किए गए डीबग टोकन को रजिस्टर करें.

   

टोकन रजिस्टर करने के बाद, Firebase की बैकएंड सेवाएं इसे मान्य के तौर पर स्वीकार करेंगी.

वेब

localhost से ऐप्लिकेशन चलाते समय (जैसे, डेवलपमेंट के दौरान) डीबग प्रोवाइडर का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

चेतावनी: localhost को reCAPTCHA के अनुमति वाले डोमेन में जोड़कर, localhost डीबग करने की सुविधा को चालू न करें. ऐसा करने से, कोई भी व्यक्ति अपने कंप्यूटर पर आपका ऐप्लिकेशन चला पाएगा!

1. फ़ाइल web/index.html में, self.FIREBASE_APPCHECK_DEBUG_TOKEN को true पर सेट करके डीबग मोड चालू करें:

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

2. अपने वेब ऐप्लिकेशन को स्थानीय तौर पर चलाएं और ब्राउज़र के डेवलपर टूल को खोलें. डीबग कंसोल में, आपको एक डीबग टोकन दिखेगा:

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

   यह टोकन आपके ब्राउज़र में लोकल तौर पर सेव किया जाता है. इसका इस्तेमाल तब किया जाएगा, जब एक ही मशीन पर एक ही ब्राउज़र में ऐप्लिकेशन का इस्तेमाल किया जाएगा. अगर आपको किसी दूसरे ब्राउज़र या मशीन पर टोकन का इस्तेमाल करना है, तो true के बजाय टोकन स्ट्रिंग को self.FIREBASE_APPCHECK_DEBUG_TOKEN पर सेट करें.

3. Firebase कंसोल के App Check सेक्शन में जाकर, अपने ऐप्लिकेशन के ओवरफ़्लो मेन्यू से डीबग टोकन मैनेज करें चुनें. इसके बाद, पिछले चरण में लॉग इन किए गए डीबग टोकन को रजिस्टर करें.

   

टोकन रजिस्टर करने के बाद, Firebase की बैकएंड सेवाएं इसे मान्य के तौर पर स्वीकार करेंगी.

यह टोकन, मान्य डिवाइस के बिना भी आपके Firebase संसाधनों को ऐक्सेस करने की अनुमति देता है. इसलिए, यह ज़रूरी है कि आप इसे निजी रखें. इसे किसी सार्वजनिक रिपॉज़िटरी में सेव न करें. अगर कभी कोई रजिस्टर किया गया टोकन गलत हाथों में पड़ जाता है, तो उसे Firebase कंसोल में जाकर तुरंत रद्द करें.