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

Firebase App Distribution Android SDK হল একটি বিটা রিলিজ । এর মানে হল যে কার্যকারিতা পশ্চাদপদ-বেমানান উপায়ে পরিবর্তিত হতে পারে। একটি বিটা রিলিজ কোন SLA বা অবচয় নীতির অধীন নয় এবং সীমিত বা কোন সমর্থন পেতে পারে।

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

আপনি শুরু করার আগে

যদি আপনি ইতিমধ্যেই না করে থাকেন তাহলে আপনার Android প্রকল্পে Firebase যোগ করুন ।

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

ধাপ 1: App Distribution টেস্টার API সক্ষম করুন

1. Google Cloud কনসোল খুলুন এবং আপনার Firebase প্রকল্প নির্বাচন করুন।

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

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

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

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

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

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

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

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

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

   Kotlin+KTX

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

   Java

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

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

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

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

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

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

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

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

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

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

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

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

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

Kotlin+KTX

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) বা তার উপরে লক্ষ্য করে, তাহলে আপনাকে অনুমতি ঘোষণা করতে হবে এবং তারপর রানটাইমে অনুরোধ করতে হবে ।

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

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

Kotlin+KTX

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

Java

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

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

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

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

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. ধাপ 3-এ বাস্তবায়িত প্রক্রিয়া ব্যবহার করে প্রতিক্রিয়া ট্রিগার করুন: অ্যাপ-মধ্যস্থ প্রতিক্রিয়া কনফিগার করুন ।

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

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

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

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

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

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

• Firebase কনসোল

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

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

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

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

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

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

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

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

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

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

তৃতীয় পক্ষের সরঞ্জামগুলিতে নতুন প্রতিক্রিয়া পাঠান

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

দ্রষ্টব্য: উন্নত সতর্কতা ক্ষমতা ব্যবহার করতে, আপনার ফায়ারবেস প্রকল্পটি অবশ্যই 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 সতর্কতার জন্য রেফারেন্স ডকুমেন্টেশন দেখুন।