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

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

তুমি শুরু করার আগে

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

ধাপ 1: অ্যাপ ডিস্ট্রিবিউশন টেস্টার API সক্ষম করুন

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

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

ধাপ 2: আপনার অ্যাপে অ্যাপ ডিস্ট্রিবিউশন যোগ করুন

অ্যাপ ডিস্ট্রিবিউশন অ্যান্ড্রয়েড SDK দুটি লাইব্রেরি নিয়ে গঠিত:

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

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

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

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

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

    Kotlin+KTX

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

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

    Java

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

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

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

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

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

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

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

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

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

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

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

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

    adb shell setprop debug.firebase.appdistro.devmode false

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

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

  1. অ্যাপ ডিস্ট্রিবিউশনে একটি নতুন অ্যাপ রিলিজ আপলোড করুন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Firebase এর জন্য ক্লাউড ফাংশন সেট আপ করুন , যার মধ্যে নিম্নলিখিত কাজগুলি রয়েছে:

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

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

    3. Firebase CLI ব্যবহার করে Firebase-এর জন্য ক্লাউড ফাংশন শুরু করুন।

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

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

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