অ্যান্ড্রয়েডে ডিবাগ প্রদানকারীর সাথে অ্যাপ চেক ব্যবহার করুন

যদি, App Check জন্য আপনার অ্যাপটি নিবন্ধিত করার পরে, আপনি এমন একটি পরিবেশে আপনার অ্যাপটি চালাতে চান যা App Check সাধারণত বৈধ হিসাবে শ্রেণীবদ্ধ করে না, যেমন ডেভেলপমেন্টের সময় একটি এমুলেটর, অথবা একটি ক্রমাগত ইন্টিগ্রেশন (CI) পরিবেশ থেকে, তাহলে আপনি আপনার অ্যাপের একটি ডিবাগ বিল্ড তৈরি করতে পারেন যা একটি প্রকৃত প্রত্যয়ন প্রদানকারীর পরিবর্তে App Check ডিবাগ প্রদানকারী ব্যবহার করে।

একটি এমুলেটরে ডিবাগ প্রদানকারী ব্যবহার করুন

আপনার অ্যাপটি একটি এমুলেটরে ইন্টারেক্টিভভাবে চালানোর সময় (উদাহরণস্বরূপ, ডেভেলপমেন্টের সময়) ডিবাগ প্রোভাইডার ব্যবহার করতে, নিম্নলিখিতগুলি করুন:

  1. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), অ্যান্ড্রয়েডের জন্য App Check লাইব্রেরির জন্য নির্ভরতা যোগ করুন। লাইব্রেরি সংস্করণ নিয়ন্ত্রণ করতে আমরা Firebase Android BoM ব্যবহার করার পরামর্শ দিই।

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:34.4.0"))
    
        // Add the dependencies for the App Check libraries
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug")
    }

    Firebase Android BoM ব্যবহার করে, আপনার অ্যাপ সর্বদা Firebase Android লাইব্রেরির সামঞ্জস্যপূর্ণ সংস্করণ ব্যবহার করবে।

    (বিকল্প) BoM ব্যবহার না করেই Firebase লাইব্রেরি নির্ভরতা যোগ করুন

    যদি আপনি Firebase BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে প্রতিটি Firebase লাইব্রেরি সংস্করণ তার নির্ভরতা লাইনে নির্দিষ্ট করতে হবে।

    মনে রাখবেন যে আপনি যদি আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করেন, তাহলে আমরা দৃঢ়ভাবে লাইব্রেরি সংস্করণগুলি পরিচালনা করার জন্য BoM ব্যবহার করার পরামর্শ দিচ্ছি, যা নিশ্চিত করে যে সমস্ত সংস্করণ সামঞ্জস্যপূর্ণ।

    dependencies {
        // Add the dependencies for the App Check libraries
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug:19.0.1")
    }

  2. আপনার ডিবাগ বিল্ডে, ডিবাগ প্রোভাইডার ফ্যাক্টরি ব্যবহার করার জন্য App Check কনফিগার করুন:

    Kotlin

    Firebase.initialize(context = this)
    Firebase.appCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance(),
    )

    Java

    FirebaseApp.initializeApp(/*context=*/ this);
    FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
    firebaseAppCheck.installAppCheckProviderFactory(
            DebugAppCheckProviderFactory.getInstance());
  3. অ্যাপটি চালু করুন এবং একটি Firebase ব্যাকএন্ড পরিষেবাতে কল ট্রিগার করুন। SDK যখন ব্যাকএন্ডে একটি অনুরোধ পাঠানোর চেষ্টা করবে তখন একটি স্থানীয় ডিবাগ টোকেন লগ করা হবে। উদাহরণস্বরূপ:

    D DebugAppCheckProvider: Enter this debug secret into the allow list in
    the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
  4. Firebase কনসোলের App Check বিভাগে, আপনার অ্যাপের ওভারফ্লো মেনু থেকে "ডিবাগ টোকেন পরিচালনা করুন" নির্বাচন করুন। তারপর, পূর্ববর্তী ধাপে লগ ইন করা ডিবাগ টোকেনটি নিবন্ধন করুন।

    ডিবাগ টোকেন পরিচালনা করুন মেনু আইটেমের স্ক্রিনশট

টোকেনটি নিবন্ধন করার পরে, Firebase ব্যাকএন্ড পরিষেবাগুলি এটিকে বৈধ হিসাবে গ্রহণ করবে।

যেহেতু এই টোকেনটি কোনও বৈধ ডিভাইস ছাড়াই আপনার ফায়ারবেস রিসোর্সে অ্যাক্সেসের অনুমতি দেয়, তাই এটি ব্যক্তিগত রাখা অত্যন্ত গুরুত্বপূর্ণ। এটি কোনও পাবলিক রিপোজিটরিতে জমা দেবেন না এবং যদি কোনও নিবন্ধিত টোকেন কখনও আপস করা হয়, তাহলে Firebase কনসোলে তা অবিলম্বে প্রত্যাহার করুন।

CI পরিবেশে ইউনিট পরীক্ষার জন্য ডিবাগ প্রদানকারী ব্যবহার করুন

একটি কন্টিনিউয়াস ইন্টিগ্রেশন (CI) পরিবেশে ইউনিট পরীক্ষার জন্য ডিবাগ প্রোভাইডার ব্যবহার করতে, নিম্নলিখিতগুলি করুন:

  1. Firebase কনসোলের App Check বিভাগে, আপনার অ্যাপের ওভারফ্লো মেনু থেকে "ডিবাগ টোকেন পরিচালনা করুন" নির্বাচন করুন। তারপর, একটি নতুন ডিবাগ টোকেন তৈরি করুন। পরবর্তী ধাপে আপনার টোকেনটি প্রয়োজন হবে।

    যেহেতু এই টোকেনটি কোনও বৈধ ডিভাইস ছাড়াই আপনার ফায়ারবেস রিসোর্সে অ্যাক্সেসের অনুমতি দেয়, তাই এটি ব্যক্তিগত রাখা অত্যন্ত গুরুত্বপূর্ণ। এটি কোনও পাবলিক রিপোজিটরিতে জমা দেবেন না এবং যদি কোনও নিবন্ধিত টোকেন কখনও আপস করা হয়, তাহলে Firebase কনসোলে তা অবিলম্বে প্রত্যাহার করুন।

    ডিবাগ টোকেন পরিচালনা করুন মেনু আইটেমের স্ক্রিনশট

  2. আপনার তৈরি করা ডিবাগ টোকেনটি আপনার CI সিস্টেমের সুরক্ষিত কী স্টোরে যোগ করুন (উদাহরণস্বরূপ, GitHub Actions-এর এনক্রিপ্ট করা গোপন তথ্য অথবা Travis CI-এর এনক্রিপ্ট করা ভেরিয়েবল )।

  3. প্রয়োজনে, আপনার CI সিস্টেমটি এমনভাবে কনফিগার করুন যাতে আপনার ডিবাগ টোকেনটি CI পরিবেশের মধ্যে একটি পরিবেশ পরিবর্তনশীল হিসেবে উপলব্ধ থাকে। পরিবর্তনশীলটির নাম APP_CHECK_DEBUG_TOKEN_FROM_CI মতো কিছু রাখুন।

  4. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), অ্যান্ড্রয়েডের জন্য App Check লাইব্রেরির জন্য নির্ভরতা যোগ করুন। লাইব্রেরি সংস্করণ নিয়ন্ত্রণ করতে আমরা Firebase Android BoM ব্যবহার করার পরামর্শ দিই।

    Kotlin

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:34.4.0"))
    
        // Add the dependency for the App Check library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug")
    }

    Firebase Android BoM ব্যবহার করে, আপনার অ্যাপ সর্বদা Firebase Android লাইব্রেরির সামঞ্জস্যপূর্ণ সংস্করণ ব্যবহার করবে।

    (বিকল্প) BoM ব্যবহার না করেই Firebase লাইব্রেরি নির্ভরতা যোগ করুন

    যদি আপনি Firebase BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে প্রতিটি Firebase লাইব্রেরি সংস্করণ তার নির্ভরতা লাইনে নির্দিষ্ট করতে হবে।

    মনে রাখবেন যে আপনি যদি আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করেন, তাহলে আমরা দৃঢ়ভাবে লাইব্রেরি সংস্করণগুলি পরিচালনা করার জন্য BoM ব্যবহার করার পরামর্শ দিচ্ছি, যা নিশ্চিত করে যে সমস্ত সংস্করণ সামঞ্জস্যপূর্ণ।

    dependencies {
        // Add the dependency for the App Check library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug:19.0.1")
    }

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:34.4.0"))
    
        // Add the dependency for the App Check library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug")
    }

    Firebase Android BoM ব্যবহার করে, আপনার অ্যাপ সর্বদা Firebase Android লাইব্রেরির সামঞ্জস্যপূর্ণ সংস্করণ ব্যবহার করবে।

    (বিকল্প) BoM ব্যবহার না করেই Firebase লাইব্রেরি নির্ভরতা যোগ করুন

    যদি আপনি Firebase BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে প্রতিটি Firebase লাইব্রেরি সংস্করণ তার নির্ভরতা লাইনে নির্দিষ্ট করতে হবে।

    মনে রাখবেন যে আপনি যদি আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করেন, তাহলে আমরা দৃঢ়ভাবে লাইব্রেরি সংস্করণগুলি পরিচালনা করার জন্য BoM ব্যবহার করার পরামর্শ দিচ্ছি, যা নিশ্চিত করে যে সমস্ত সংস্করণ সামঞ্জস্যপূর্ণ।

    dependencies {
        // Add the dependency for the App Check library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-appcheck-debug:19.0.1")
    }

  5. আপনার CI বিল্ড ভেরিয়েন্টের কনফিগারেশনে নিম্নলিখিতগুলি যোগ করুন:

    testInstrumentationRunnerArguments["firebaseAppCheckDebugSecret"] =
        System.getenv("APP_CHECK_DEBUG_TOKEN_FROM_CI") ?: ""
    
  6. আপনার পরীক্ষার ক্লাসে, App Check টোকেনের প্রয়োজন এমন যেকোনো কোড মোড়ানোর জন্য DebugAppCheckTestHelper ব্যবহার করুন:

    Kotlin

    @RunWith(AndroidJunit4::class)
    class MyTests {
        private val debugAppCheckTestHelper =
            DebugAppCheckTestHelper.fromInstrumentationArgs()
    
        @Test
        fun testWithDefaultApp() {
            debugAppCheckTestHelper.withDebugProvider {
                // Test code that requires a debug AppCheckToken.
            }
        }
    
        @Test
        fun testWithNonDefaultApp() {
            debugAppCheckTestHelper.withDebugProvider(
                FirebaseApp.getInstance("nonDefaultApp")
            ) {
                // Test code that requires a debug AppCheckToken.
            }
        }
    }
    

    Java

    @RunWith(AndroidJunit4.class)
    public class YourTests {
        private final DebugAppCheckTestHelper debugAppCheckTestHelper =
                DebugAppCheckTestHelper.fromInstrumentationArgs();
    
        @Test
        public void testWithDefaultApp() {
            debugAppCheckTestHelper.withDebugProvider(() -> {
                // Test code that requires a debug AppCheckToken.
            });
        }
    
        @Test
        public void testWithNonDefaultApp() {
            debugAppCheckTestHelper.withDebugProvider(
                    FirebaseApp.getInstance("nonDefaultApp"),
                    () -> {
                        // Test code that requires a debug AppCheckToken.
                    });
        }
    }
    

যখন আপনার অ্যাপটি CI পরিবেশে চলে, তখন Firebase ব্যাকএন্ড পরিষেবাগুলি তাদের পাঠানো টোকেনটিকে বৈধ হিসেবে গ্রহণ করবে।