পরীক্ষকদের কাছ থেকে প্রতিক্রিয়া সংগ্রহ করুন

Firebase App Distribution অ্যান্ড্রয়েড SDK একটি বিটা রিলিজ । এর অর্থ হল কার্যকারিতাটি বিপরীতমুখী-অসঙ্গত উপায়ে পরিবর্তিত হতে পারে। একটি বিটা রিলিজ কোনও SLA বা অবচয় নীতির অধীন নয় এবং সীমিত বা কোনও সমর্থন নাও পেতে পারে।

এই নির্দেশিকাটিতে ঐচ্ছিক Firebase App Distribution অ্যান্ড্রয়েড SDK ব্যবহার করে অ্যাপ-মধ্যস্থ প্রতিক্রিয়া কীভাবে সক্ষম করবেন তা বর্ণনা করা হয়েছে, যাতে আপনার পরীক্ষকরা সরাসরি অ্যাপে প্রতিক্রিয়া (স্ক্রিনশট সহ) জমা দিতে পারেন।

শুরু করার আগে

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার অ্যান্ড্রয়েড প্রজেক্টে Firebase যোগ করুন ।

দ্রষ্টব্য: যদি আপনার Firebase প্রজেক্টে একাধিক অ্যাপ থাকে, তাহলে নিশ্চিত করুন যে আপনি App Distribution মাধ্যমে যে অ্যাপটি বিতরণ করতে চান তার নিজস্ব google-services.json কনফিগ ফাইল আছে। আরও তথ্যের জন্য, Support multiple environments দেখুন।

ধাপ ১: App Distribution টেস্টার এপিআই সক্ষম করুন

1. Google Cloud কনসোল খুলুন এবং আপনার ফায়ারবেস প্রকল্পটি নির্বাচন করুন।

2. Firebase App Testers API-এর অধীনে, Enable এ ক্লিক করুন।

ধাপ ২: আপনার অ্যাপে App Distribution যোগ করুন

App Distribution অ্যান্ড্রয়েড এসডিকে দুটি লাইব্রেরি নিয়ে গঠিত:

• firebase-appdistribution-api : শুধুমাত্র API-ভিত্তিক লাইব্রেরি, যা আপনি সমস্ত বিল্ড ভেরিয়েন্টে অন্তর্ভুক্ত করতে পারেন।
• firebase-appdistribution : সম্পূর্ণ SDK বাস্তবায়ন (ঐচ্ছিক)।

সতর্কতা: নতুন বিল্ড সম্পর্কে পরীক্ষকদের অবহিত করার মতো বৈশিষ্ট্যগুলিকে সমর্থন করার জন্য, সম্পূর্ণ App Distribution অ্যান্ড্রয়েড SDK বাস্তবায়নে স্ব-আপডেট কার্যকারিতা রয়েছে যা Google Play নীতির লঙ্ঘন হিসাবে বিবেচিত হতে পারে, এমনকি যদি সেই কোডটি রানটাইমে কার্যকর না করা হয়। সম্পূর্ণ SDK বাস্তবায়ন অপসারণ না করে Google Play তে আপনার অ্যাপ জমা দেওয়ার ফলে আপনার অ্যাপটি Google Play থেকে সরানো হতে পারে।

API-only লাইব্রেরি আপনার কোডকে SDK-তে কল করতে দেয়। সম্পূর্ণ SDK বাস্তবায়ন উপস্থিত না থাকলে কলগুলির কোনও প্রভাব থাকবে না।

1. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ) App Distribution অ্যান্ড্রয়েড SDK এর জন্য নির্ভরতা ঘোষণা করুন।

2. আপনার Google Play বিল্ডগুলিতে সম্পূর্ণ SDK বাস্তবায়নের স্ব-আপডেট কার্যকারিতা অন্তর্ভুক্ত করা এড়াতে, বিল্ড ভেরিয়েন্টগুলি সনাক্ত করুন, যার মধ্যে বিল্ডের ধরণ বা পণ্যের স্বাদ অন্তর্ভুক্ত রয়েছে যা আপনি App Distribution এর মাধ্যমে বিতরণ করবেন।

3. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত app/build.gradle ) App Distribution অ্যান্ড্রয়েড SDK এর জন্য নির্ভরতা ঘোষণা করুন। শুধুমাত্র প্রি-রিলিজ পরীক্ষার জন্য তৈরি ভেরিয়েন্টগুলিতে সম্পূর্ণ SDK বাস্তবায়ন যোগ করুন:

   Kotlin

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta15")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta17")
   }

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta17")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta17")
   }

ধাপ ৩: অ্যাপ-মধ্যস্থ প্রতিক্রিয়া কনফিগার করুন

আপনার পরীক্ষকদের কাছ থেকে প্রতিক্রিয়া সংগ্রহ করতে, পরীক্ষকদের প্রতিক্রিয়া শুরু করতে সক্ষম করতে নিম্নলিখিত ট্রিগারগুলির মধ্যে একটি ব্যবহার করুন:

• বিল্ট-ইন নোটিফিকেশন ট্রিগার : App Distribution অ্যান্ড্রয়েড এসডিকে একটি চলমান নোটিফিকেশন প্রদর্শন করতে পারে যা পরীক্ষক অ্যাপের যেকোনো স্থান থেকে ট্যাপ করতে পারবেন। আপনি যদি আরও দ্রুত শুরু করতে চান এবং আপনার পরীক্ষকরা কীভাবে প্রতিক্রিয়া প্রদান করেন তা কাস্টমাইজ করার প্রয়োজন না হয় তবে এই ট্রিগারটি ব্যবহার করুন।

• কাস্টম ট্রিগার : আপনি আপনার নিজস্ব ট্রিগার প্রক্রিয়া প্রদান করতে পারেন, যেমন আপনার অ্যাপে একটি বোতাম বা মেনু আইটেম ট্যাপ করা বা ডিভাইসটি ঝাঁকানো।

যখন আপনি এই ট্রিগারগুলির যেকোনো একটি ব্যবহার করেন এবং পরীক্ষক প্রতিক্রিয়া জমা দেন, তখন Android SDK নিম্নলিখিত ক্রিয়াগুলি সম্পাদন করে:

1. অ্যাপের বর্তমান কার্যকলাপের একটি স্ক্রিনশট ক্যাপচার করে।

2. পরীক্ষক SDK এর পরীক্ষামূলক বৈশিষ্ট্যগুলি সক্ষম করেছেন কিনা তা নিশ্চিত করার জন্য পরীক্ষা চালায়। যদি পরীক্ষামূলক বৈশিষ্ট্যগুলি সক্ষম না থাকে, তাহলে Android SDK পরীক্ষককে তাদের Google অ্যাকাউন্ট দিয়ে App Distribution সাইন ইন করতে অনুরোধ করে।

   দ্রষ্টব্য: পরীক্ষামূলক ডিভাইসে পরীক্ষার বৈশিষ্ট্যগুলি সক্ষম করা একটি এককালীন প্রক্রিয়া এবং আপনার অ্যাপের আপডেট জুড়ে এটি চলতে থাকে। পরীক্ষক অ্যাপটি আনইনস্টল না করা পর্যন্ত বা অ্যাপটি signOutTester পদ্ধতিতে কল না করা পর্যন্ত পরীক্ষামূলক ডিভাইসে পরীক্ষার বৈশিষ্ট্যগুলি সক্ষম থাকে।

3. একটি পূর্ণ-স্ক্রিন কার্যকলাপ শুরু করে যা পরীক্ষককে তাদের প্রতিক্রিয়া লিখতে এবং জমা দিতে দেয়।

বিকল্প ১: বিজ্ঞপ্তি ট্রিগার

পরীক্ষকের ডিভাইসে একটি স্থায়ী বা চলমান বিজ্ঞপ্তি প্রদর্শনের জন্য showFeedbackNotification() ব্যবহার করুন যা তারা প্রতিক্রিয়া শুরু করতে ট্যাপ করতে পারে। যখন আপনি বিজ্ঞপ্তিটি কনফিগার করেন, তখন আপনাকে কিছু টেক্সট প্রদান করতে হবে যা পরীক্ষক প্রতিক্রিয়া জমা দেওয়ার আগে তাকে প্রদর্শিত হবে, এবং বিজ্ঞপ্তির জন্য একটি স্তরের বাধা (বিজ্ঞপ্তি চ্যানেলের গুরুত্বের সাথে সঙ্গতিপূর্ণ)। আপনি যদি আপনার পরীক্ষকদের তাদের প্রতিক্রিয়া ডেটা সংগ্রহ এবং প্রক্রিয়াকরণ সম্পর্কে নোটিশ প্রদান করতে চান, তাহলে আপনি এই ধরনের নোটিশ প্রদানের জন্য টেক্সট ব্যবহার করতে পারেন।

যখন আপনি showFeedbackNotification() ব্যবহার করেন এবং অ্যাপটি ব্যাকগ্রাউন্ডে চলে যায়, তখন বিজ্ঞপ্তিটি লুকানো থাকে। যদি আপনি স্পষ্টভাবে বিজ্ঞপ্তিটি লুকাতে চান, তাহলে cancelFeedbackNotification() ব্যবহার করুন। আমরা আপনাকে আপনার প্রধান কার্যকলাপের onCreate() এ showFeedbackNotification() রাখার পরামর্শ দিচ্ছি।

Kotlin

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

দ্রষ্টব্য: Android 13 এবং উচ্চতর সংস্করণে, এই পদ্ধতিতে বিজ্ঞপ্তি পাঠানোর জন্য রানটাইম অনুমতি প্রয়োজন: POST_NOTIFICATIONS । যদি আপনার অ্যাপটি Android 13 (API লেভেল 33) বা উচ্চতর সংস্করণকে লক্ষ্য করে, তাহলে আপনাকে অনুমতি ঘোষণা করতে হবে এবং তারপর রানটাইমে অনুরোধ করতে হবে ।

বিকল্প ২: কাস্টম ট্রিগার

আপনার পছন্দের একটি পদ্ধতি ব্যবহার করে প্রতিক্রিয়া শুরু করতে startFeedback() পদ্ধতি ব্যবহার করুন। উদাহরণস্বরূপ, প্রতিক্রিয়া ট্রিগার করার জন্য আপনি আপনার অ্যাপের অ্যাকশন মেনুতে "প্রতিক্রিয়া পাঠান" মেনু আইটেম যোগ করতে পারেন, অথবা আপনার পরীক্ষকদের তাদের ডিভাইসটি ঝাঁকাতে বা একটি স্ক্রিনশট নিতে দিতে পারেন। প্রতিক্রিয়া ট্রিগার করার সময়, প্রতিক্রিয়া জমা দেওয়ার আগে পরীক্ষককে দেখানো হবে এমন কিছু পাঠ্য প্রদান করুন। আপনি যদি আপনার পরীক্ষকদের তাদের প্রতিক্রিয়া ডেটা সংগ্রহ এবং প্রক্রিয়াকরণ সম্পর্কে একটি বিজ্ঞপ্তি প্রদান করতে চান, তাহলে আপনি এই পাঠ্যটি ব্যবহার করে এই জাতীয় বিজ্ঞপ্তি প্রদান করতে পারেন।

Kotlin

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

ধাপ ৪: আপনার বাস্তবায়ন তৈরি করুন এবং পরীক্ষা করুন

স্থানীয় পরীক্ষা

প্রথমে অ্যাপটি বিতরণ না করেই আপনার বাস্তবায়ন পরীক্ষা করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. আপনার স্থানীয় ডিভাইসে ডেভেলপার মোড সক্ষম করুন:

   adb shell setprop debug.firebase.appdistro.devmode true

2. আপনার অ্যাপটি একটি প্রি-রিলিজ ভেরিয়েন্ট হিসেবে তৈরি করুন যাতে সম্পূর্ণ App Distribution লাইব্রেরি অন্তর্ভুক্ত থাকে এবং ধাপ 3: ইন-অ্যাপ ফিডব্যাক কনফিগার করুন -এ বাস্তবায়িত প্রক্রিয়া ব্যবহার করে আপনি প্রতিক্রিয়া ট্রিগার করতে পারেন কিনা তা পরীক্ষা করুন। ডেভ মোডে থাকাকালীন প্রতিক্রিয়া জমা দেওয়া হয় না।

3. পরীক্ষার পর, আপনি আপনার ডিভাইসে ডেভ মোড অক্ষম করতে পারেন:

   adb shell setprop debug.firebase.appdistro.devmode false

এন্ড-টু-এন্ড পরীক্ষা

দ্রষ্টব্য: ডিফল্টরূপে, নতুন প্রতিক্রিয়া সমস্ত Firebase প্রকল্পের মালিক এবং সম্পাদকদের ইমেল এবং ইন-কনসোল সতর্কতা ট্রিগার করে।

আপনার অ্যাপটি প্রতিক্রিয়া পাঠাতে পারে কিনা তা পরীক্ষা করার জন্য, আপনার অ্যাপটিকে একটি প্রি-রিলিজ ভেরিয়েন্ট হিসেবে তৈরি করুন যাতে সম্পূর্ণ App Distribution লাইব্রেরি অন্তর্ভুক্ত থাকে এবং এই পদক্ষেপগুলি অনুসরণ করে আপনার বাস্তবায়ন পরীক্ষা করুন:

1. App Distribution একটি নতুন অ্যাপ রিলিজ আপলোড করুন।

2. আপনার অ্যাক্সেসের অনুমতি আছে এমন একটি অ্যাকাউন্টে অ্যাপ রিলিজটি বিতরণ করুন।

3. App Distribution ওয়েব অথবা অ্যান্ড্রয়েড টেস্টার অ্যাপের মাধ্যমে অ্যাপটি ডাউনলোড করুন।

4. ধাপ ৩: অ্যাপ-মধ্যস্থ প্রতিক্রিয়া কনফিগার করুন -এ বাস্তবায়িত প্রক্রিয়া ব্যবহার করে প্রতিক্রিয়া ট্রিগার করুন।

5. আপনি যে অ্যাকাউন্টে অ্যাপ রিলিজটি বিতরণ করেছেন সেই অ্যাকাউন্ট দিয়েই সাইন ইন করেছেন কিনা তা নিশ্চিত করুন এবং প্রতিক্রিয়া জমা দিন।

6. Firebase কনসোলে নতুন রিলিজের কার্ডে আপনার প্রতিক্রিয়া দেখুন।

সতর্কতা: গুগল প্লে স্টোরে আপনার অ্যাপটি প্রকাশ করার আগে, আপনার অ্যাপটি পরীক্ষা করে দেখুন যে আপনি কেবল API-কেবল লাইব্রেরি নির্ভরতা অন্তর্ভুক্ত করছেন এবং আপনার প্রতিক্রিয়া প্রক্রিয়াটি আপনার রিলিজ ভেরিয়েন্টে অন্তর্ভুক্ত নয়। আরও তথ্যের জন্য, ধাপ 2 দেখুন: আপনার অ্যাপে App Distribution যোগ করুন ।

অ্যাপে পরীক্ষকদের প্রতিক্রিয়া শুরু করতে না পারার মতো সাধারণ সমস্যাগুলি কীভাবে সমাধান করবেন তা জানতে, SDK দিয়ে পরীক্ষার বৈশিষ্ট্যগুলি সক্ষম করা দেখুন।

ধাপ ৫: পরীক্ষকদের প্রতিক্রিয়া পরিচালনা করুন

আপনার পরীক্ষকদের প্রতিক্রিয়া পাঠানোর সুযোগ দেওয়ার পরে, আপনি সেই প্রতিক্রিয়া পর্যালোচনা করতে এবং তার উপর কাজ করতে নিম্নলিখিত সরঞ্জামগুলি ব্যবহার করতে পারেন:

• Firebase কনসোল

• নতুন প্রতিক্রিয়ার জন্য ইমেল সতর্কতা

• তৃতীয় পক্ষের সরঞ্জাম

Firebase কনসোলে প্রতিক্রিয়া দেখুন এবং মুছুন

আপনি Firebase কনসোলে একটি নির্দিষ্ট রিলিজের অধীনে "পরীক্ষক প্রতিক্রিয়া" ট্যাবটি খুলে স্ক্রিনশট সহ ব্যবহারকারীর প্রতিক্রিয়া পর্যালোচনা করতে এবং মুছে ফেলতে পারেন। ব্যবহারকারীর প্রতিক্রিয়া রিলিজ অনুসারে সংগঠিত হয় যাতে আপনি প্রতিক্রিয়াটি কোন সংস্করণে প্রযোজ্য তা নিশ্চিত করতে পারেন।

ব্যবহারকারীর প্রতিক্রিয়া পর্যালোচনা করার পর, আপনি "প্রতিক্রিয়া মুছে ফেলুন" বোতামে ক্লিক করে সেই প্রতিক্রিয়াটি মুছে ফেলতে পারেন। মুছে ফেলা প্রতিক্রিয়াটি আপনার রিলিজ থেকে সরানো হবে।

নতুন প্রতিক্রিয়ার জন্য ইমেল সতর্কতা পান

নতুন পরীক্ষকদের প্রতিক্রিয়া সম্পর্কে সক্রিয়ভাবে জানতে, একজন পরীক্ষক প্রতিক্রিয়া জমা দিলে আপনি ইমেল সতর্কতা পেতে পারেন। ইমেল সতর্কতায় আপনার পরীক্ষক কর্তৃক প্রদত্ত লিখিত প্রতিক্রিয়া এবং তাদের জমা দেওয়া যেকোনো স্ক্রিনশটের লিঙ্ক অন্তর্ভুক্ত থাকে।

এই ডিফল্ট পদ্ধতির মাধ্যমে App Distribution ইমেল সতর্কতা পেতে, আপনার firebase.projects.update অনুমতি থাকতে হবে। নিম্নলিখিত ভূমিকাগুলিতে ডিফল্টরূপে এই প্রয়োজনীয় অনুমতি অন্তর্ভুক্ত থাকে: Firebase Admin অথবা project Owner অথবা Editor ।

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

ইমেল সতর্কতা নিষ্ক্রিয় করতে, Firebase সতর্কতা গ্রহণ করুন দেখুন।

তৃতীয় পক্ষের টুলগুলিতে নতুন প্রতিক্রিয়া পাঠান

আপনি Cloud Functions for Firebase ব্যবহার করে আপনার দলের পছন্দের বিজ্ঞপ্তি চ্যানেলে App Distribution সতর্কতা পাঠাতে পারেন। উদাহরণস্বরূপ, আপনি এমন একটি ফাংশন লিখতে পারেন যা নতুন ইন-অ্যাপ প্রতিক্রিয়ার জন্য একটি সতর্কতা ইভেন্ট ক্যাপচার করে এবং সতর্কতা তথ্য Discord, Slack, অথবা Jira এর মতো তৃতীয় পক্ষের পরিষেবাতে পোস্ট করে।

দ্রষ্টব্য: উন্নত সতর্কতা ক্ষমতা ব্যবহার করতে, আপনার Firebase প্রকল্পকে অবশ্যই Blaze মূল্য পরিকল্পনা ব্যবহার করতে হবে।

Cloud Functions for Firebase ব্যবহার করে উন্নত সতর্কতা ক্ষমতা সেট আপ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. Cloud Functions for Firebase সেট আপ করুন , যার মধ্যে নিম্নলিখিত কাজগুলি অন্তর্ভুক্ত রয়েছে:

   1. Node.js এবং npm ডাউনলোড করুন।

   2. Firebase CLI ইনস্টল করুন এবং সাইন ইন করুন।

   3. Firebase CLI ব্যবহার করে Cloud Functions for Firebase শুরু করুন।

2. এমন একটি ফাংশন লিখুন এবং স্থাপন করুন যা App Distribution থেকে একটি ইন-অ্যাপ ফিডব্যাক সতর্কতা ইভেন্ট ক্যাপচার করে এবং ইভেন্ট পেলোড পরিচালনা করে (উদাহরণস্বরূপ, ডিসকর্ডে একটি বার্তায় সতর্কতা তথ্য পোস্ট করে)।

জিরাতে নতুন প্রতিক্রিয়া কীভাবে পাঠাতে হয় তা দেখানোর জন্য একটি উদাহরণ ফাংশন দেখতে, এই নমুনাটি দেখুন।

আপনি যে সমস্ত সতর্কতা ইভেন্টগুলি ক্যাপচার করতে পারেন সেগুলি সম্পর্কে জানতে, App Distribution সতর্কতার জন্য রেফারেন্স ডকুমেন্টেশন দেখুন।