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

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

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

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

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

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

   1. प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें खोलें.
   2. बाईं ओर मौजूद मेन्यू में जाकर, चालू करें चुनें. इसके बाद, आर्ग्युमेंट टैब चुनें.
   3. लॉन्च के समय पास किए गए आर्ग्युमेंट सेक्शन में, -FIRDebugEnabled जोड़ें.

3. Xcode में ios/Runner.xcworkspace खोलें और सिम्युलेटर में अपना ऐप्लिकेशन चलाएं. जब 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 से अपने ऐप्लिकेशन को चलाते समय, डीबग प्रोवाइडर का इस्तेमाल करने के लिए (उदाहरण के लिए, डेवलपमेंट के दौरान), यह तरीका अपनाएं:

चेतावनी: reCAPTCHA की अनुमति वाले डोमेन में localhost जोड़कर, 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 कंसोल में जाकर तुरंत रद्द कर दें.