টেস্টারদের থেকে মতামত সংগ্রহ করা

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

শুরু করার আগে

আপনি আগে থেকে না করে থাকলে, আপনার Android প্রোজেক্টে Firebase যোগ করুন।

ধাপ ১: App Distribution Tester API চালু করুন

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

  2. Firebase অ্যাপ টেস্টার API-এর অধীনে, চালু করুন বিকল্পে ক্লিক করুন।

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

App Distribution Android SDK-তে দুটি লাইব্রেরি আছে:

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

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

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

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

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

    Kotlin 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta20")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta20")
}

    Java 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta20")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta20")
}

Kotlin-নির্দিষ্ট লাইব্রেরি মডিউল খুঁজছেন? অক্টোবর ২০২৩ রিলিজ থেকে শুরু করে, Kotlin ও Java ডেভেলপাররা, দুজনেই, বিস্তারিত তথ্যের জন্য মূল লাইব্রেরি মডিউলের উপর নির্ভর করতে পারবেন, এর জন্য এই উদ্যোগ সম্পর্কে প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

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

টেস্টারদের থেকে মতামত সংগ্রহ করতে, মতামত জানানোর প্রসেস শুরু করার জন্য টেস্টারদের সুযোগ দিতে, নিম্নলিখিত ট্রিগারগুলির মধ্যে একটি ব্যবহার করুন:

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

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

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

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

  2. টেস্টার SDK-এর টেস্টিং ফিচার চালু করেছেন কিনা তা নিশ্চিত করতে চেক চালায়। পরীক্ষা করার ফিচার চালু করা না থাকলে, Android SDK পরীক্ষককে তার Google অ্যাকাউন্ট দিয়ে App Distribution-এ সাইন-ইন করার জন্য প্রম্পট দেখায়।

  3. একটি ফুল-স্ক্রিন অ্যাক্টিভিটি শুরু করে যা পরীক্ষার্থীকে তার মতামত লিখতে ও জমা দিতে দেয়।

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

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

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

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-এর ওয়েব বা Android টেস্টার অ্যাপের মাধ্যমে অ্যাপটি ডাউনলোড করুন।

  4. ধাপ ৩: অ্যাপ-মধ্যস্থ মতামত কনফিগার করুন লিঙ্কে উল্লেখ করা মেকানিজম ব্যবহার করে মতামত ট্রিগার করুন।

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

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

অ্যাপে, পরীক্ষকরা কীভাবে ফিডব্যাক শুরু করতে পারবেন না এই ধরনের সাধারণ সমস্যা সমাধান করবেন তা জানতে, SDK-এর মাধ্যমে টেস্টিং ফিচার চালু করা দেখুন।

ধাপ ৫: টেস্টারদের মতামত ম্যানেজ করা

টেস্টারদের মতামত জানানোর সুবিধা চালু করার পরে, আপনি নিম্নলিখিত টুল ব্যবহার করে সেই মতামত পর্যালোচনা করতে এবং তার ভিত্তিতে অ্যাকশন নিতে পারবেন:

Firebase কনসোলে মতামত দেখা ও মুছে দেওয়া

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

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

নতুন মতামত সম্পর্কে ইমেল সতর্কতা পান

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

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

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

ইমেল সতর্কতা বন্ধ করতে, Firebase সতর্কতা পান দেখুন।

থার্ড-পার্টি টুলে নতুন মতামত পাঠানো

এছাড়াও, আপনি 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 থেকে ইন-অ্যাপ ফিডব্যাক অ্যালার্ট ইভেন্ট ক্যাপচার করে এবং ইভেন্ট পে-লোড ম্যানেজ করে (যেমন, Discord-এ মেসেজে অ্যালার্ট সংক্রান্ত তথ্য পোস্ট করে)।

Jira-তে নতুন মতামত পাঠানোর পদ্ধতি দেখায় এমন ফাংশনের উদাহরণ দেখতে, এই ফাংশন স্যাম্পেল দেখুন।

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