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

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

শুরু করার আগে

যদি আগে থেকে না করে থাকেন, তাহলে আপনার অ্যান্ড্রয়েড প্রজেক্টে ফায়ারবেস যোগ করুন ।

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

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

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

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

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

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

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

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

  2. আপনার গুগল প্লে বিল্ডগুলিতে সম্পূর্ণ SDK ইমপ্লিমেন্টেশনের সেলফ-আপডেট কার্যকারিতা অন্তর্ভুক্ত করা এড়াতে, সেই বিল্ড ভ্যারিয়েন্টগুলি শনাক্ত করুন, যার মধ্যে বিল্ড টাইপ বা প্রোডাক্ট ফ্লেভার অন্তর্ভুক্ত থাকবে, যা আপনি App Distribution মাধ্যমে বিতরণ করবেন।

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

    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 অ্যান্ড্রয়েড এসডিকে একটি চলমান নোটিফিকেশন প্রদর্শন করতে পারে, যেটিতে পরীক্ষক অ্যাপের যেকোনো জায়গা থেকে ট্যাপ করতে পারেন। আপনি যদি আরও দ্রুত কাজ শুরু করতে চান এবং আপনার পরীক্ষকরা কীভাবে প্রতিক্রিয়া জানাবেন তা কাস্টমাইজ করার প্রয়োজন না হয়, তবে এই ট্রিগারটি ব্যবহার করুন।

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

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

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

  2. পরীক্ষক এসডিকে-এর টেস্টিং ফিচারগুলো চালু করেছেন কিনা, তা নিশ্চিত করতে যাচাই করা হয়। যদি টেস্টিং ফিচারগুলো চালু করা না থাকে, তাহলে অ্যান্ড্রয়েড এসডিকে পরীক্ষককে তার গুগল অ্যাকাউন্ট দিয়ে App Distribution সাইন ইন করতে অনুরোধ করে।

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

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

আপনার পছন্দের কোনো পদ্ধতি ব্যবহার করে ফিডব্যাক শুরু করতে 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. পরীক্ষা করার পর, আপনি আপনার ডিভাইসে ডেভ মোড নিষ্ক্রিয় করতে পারেন:

    adb shell setprop debug.firebase.appdistro.devmode false

এন্ড-টু-এন্ড টেস্টিং

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

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

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

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

  4. ধাপ ৩: ইন-অ্যাপ ফিডব্যাক কনফিগার করুন -এ বাস্তবায়িত পদ্ধতি ব্যবহার করে ফিডব্যাক চালু করুন।

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

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

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

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

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

Firebase কনসোলে ফিডব্যাক দেখুন এবং মুছে ফেলুন

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

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

নতুন মতামতের জন্য ইমেল সতর্কতা গ্রহণ করুন

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

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

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

ইমেল অ্যালার্ট নিষ্ক্রিয় করতে, “Receive Firebase alerts” দেখুন।

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

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

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 অ্যালার্ট- এর রেফারেন্স ডকুমেন্টেশন দেখুন।