Gradle ব্যবহার করে পরীক্ষকদের কাছে Android অ্যাপ বিতরণ করুন

আপনি App Distribution গ্রেডল প্লাগইন ব্যবহার করে আপনার অ্যান্ড্রয়েড বিল্ড প্রক্রিয়ায় App Distribution একীভূত করতে পারেন। এই প্লাগইনটি আপনাকে আপনার অ্যাপের গ্রেডল ফাইলে টেস্টার এবং রিলিজ নোট নির্দিষ্ট করার সুযোগ দেয়, যার ফলে আপনি আপনার অ্যাপের বিভিন্ন বিল্ড টাইপ এবং ভ্যারিয়েন্টের জন্য ডিস্ট্রিবিউশন কনফিগার করতে পারেন।

এই নির্দেশিকায় App Distribution গ্র্যাডল প্লাগইন ব্যবহার করে পরীক্ষকদের কাছে অ্যান্ড্রয়েড অ্যাপ বান্ডেল (AAB) বিতরণ করার পদ্ধতি বর্ণনা করা হয়েছে।

App Distribution আপনার আপলোড করা AAB ফাইলগুলো প্রসেস করতে এবং আপনার পরীক্ষকদের ডিভাইসের কনফিগারেশনের জন্য অপ্টিমাইজ করা APK সরবরাহ করতে Google Play এর অভ্যন্তরীণ অ্যাপ শেয়ারিং পরিষেবার সাথে সমন্বিত হয়। AAB ডিস্ট্রিবিউট করার মাধ্যমে আপনি নিম্নলিখিত কাজগুলো করতে পারেন:

• আপনার পরীক্ষকদের ডিভাইসের জন্য অপ্টিমাইজ করা APK (যা Google Play থেকে পাওয়া যায়) চালান।

• ডিভাইস-নির্দিষ্ট সমস্যাগুলো উদ্ঘাটন ও ডিবাগ করুন।

• অ্যাপ বান্ডেলের প্লে ফিচার ডেলিভারি এবং প্লে অ্যাসেট ডেলিভারির মতো ফিচারগুলো পরীক্ষা করুন।

• আপনার পরীক্ষকদের জন্য ডাউনলোডের আকার হ্রাস করুন।

প্রয়োজনীয় অনুমতি

App Distribution AAB আপলোড করতে হলে, আপনাকে আপনার Firebase অ্যাপটিকে Google Play এর কোনো একটি অ্যাপের সাথে লিঙ্ক করতে হবে। এই কাজগুলো করার জন্য আপনার প্রয়োজনীয় স্তরের অ্যাক্সেস থাকতে হবে।

আপনার যদি প্রয়োজনীয় Firebase অ্যাক্সেস না থাকে, তাহলে আপনি Firebase কনসোলের IAM সেটিংসের মাধ্যমে একজন Firebase প্রজেক্টের মালিককে আপনাকে প্রযোজ্য রোলটি বরাদ্দ করার জন্য অনুরোধ করতে পারেন। আপনার Firebase প্রজেক্ট অ্যাক্সেস করা, যার মধ্যে মালিককে খুঁজে বের করা বা বরাদ্দ করাও অন্তর্ভুক্ত, সে সম্পর্কে কোনো প্রশ্ন থাকলে , "Firebase প্রজেক্টে অনুমতি এবং অ্যাক্সেস" সম্পর্কিত প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQs) পর্যালোচনা করুন।

নিম্নলিখিত সারণিটি ফায়ারবেস অ্যাপকে Google Play এর কোনো অ্যাপের সাথে লিঙ্ক করা এবং এএবি (AAB) আপলোড করার ক্ষেত্রে প্রযোজ্য।

শুরু করার আগে

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

   আপনি যদি অন্য কোনো Firebase প্রোডাক্ট ব্যবহার না করেন, তাহলে আপনাকে শুধু একটি প্রজেক্ট তৈরি করে আপনার অ্যাপটি রেজিস্টার করতে হবে। আপনি যদি অতিরিক্ত প্রোডাক্ট ব্যবহার করার সিদ্ধান্ত নেন, তাহলে “Add Firebase to your Android project”- এর সমস্ত ধাপ অবশ্যই সম্পন্ন করবেন।

2. Google Play-তে Firebase লিঙ্ক তৈরি করতে এবং AAB আপলোড করতে, নিশ্চিত করুন যে আপনার অ্যাপটি নিম্নলিখিত শর্তাবলী পূরণ করে:

   • গুগল প্লে-এর অ্যাপ এবং ফায়ারবেস অ্যান্ড্রয়েড অ্যাপ উভয়ই একই প্যাকেজ নাম ব্যবহার করে নিবন্ধিত।

   • গুগল প্লে-তে থাকা অ্যাপটি অ্যাপ ড্যাশবোর্ডে সেট আপ করা হয় এবং গুগল প্লে-র ট্র্যাকগুলোর (অভ্যন্তরীণ টেস্টিং, ক্লোজড টেস্টিং, ওপেন টেস্টিং, বা প্রোডাকশন) যেকোনো একটিতে বিতরণ করা হয়।

   • গুগল প্লে-তে অ্যাপটির পর্যালোচনা সম্পন্ন হয়েছে এবং অ্যাপটি প্রকাশিত হয়েছে। আপনার অ্যাপটি প্রকাশিত হয়েছে যদি 'অ্যাপ স্ট্যাটাস' কলামে নিম্নলিখিত স্ট্যাটাসগুলির মধ্যে একটি প্রদর্শিত হয়: অভ্যন্তরীণ পরীক্ষা (খসড়া অভ্যন্তরীণ পরীক্ষা নয়), বন্ধ পরীক্ষা, খোলা পরীক্ষা, অথবা উৎপাদন।

3. আপনার ফায়ারবেস অ্যান্ড্রয়েড অ্যাপটিকে আপনার গুগল প্লে ডেভেলপার অ্যাকাউন্টের সাথে লিঙ্ক করুন:

   1. Firebase কনসোলে, আপনার প্রজেক্ট সেটিংস- settings , তারপর ইন্টিগ্রেশন ট্যাবটি নির্বাচন করুন।

   2. গুগল প্লে কার্ডে থাকা লিঙ্কে ক্লিক করুন।
      আপনার যদি আগে থেকেই গুগল প্লে-এর লিঙ্ক থাকে, তাহলে তার পরিবর্তে 'ম্যানেজ'-এ ক্লিক করুন।

   3. App Distribution ইন্টিগ্রেশন চালু করতে এবং কোন ফায়ারবেস অ্যান্ড্রয়েড অ্যাপগুলোকে গুগল প্লে-এর সাথে লিঙ্ক করবেন তা নির্বাচন করতে স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

   গুগল প্লে-এর সাথে সংযোগ স্থাপন সম্পর্কে আরও জানুন।

ধাপ ১. আপনার অ্যান্ড্রয়েড প্রজেক্ট সেট আপ করুন।

1. আপনার রুট-লেভেলের (প্রজেক্ট-লেভেলের) Gradle ফাইলে ( <project>/build.gradle.kts অথবা <project>/build.gradle ), App Distribution Gradle প্লাগইনটিকে একটি ডিপেন্ডেন্সি হিসেবে যোগ করুন:

   Kotlin

   plugins {
       // ...
       id("com.android.application") version "7.3.0" apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.4" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "5.2.1" apply false
   }

   Groovy

   plugins {
       // ...
       id 'com.android.application' version '7.3.0' apply false
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.4' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '5.2.1' apply false
   }

2. আপনার মডিউল (অ্যাপ-লেভেল) Gradle ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), App Distribution Gradle প্লাগইনটি যোগ করুন:

   Kotlin

   plugins {
     id("com.android.application")
   
     // Make sure that you have the Google services Gradle plugin
     id("com.google.gms.google-services")
   
     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution")
   }

   Groovy

   plugins {
     id 'com.android.application'
   
     // Make sure that you have the Google services Gradle plugin
     id 'com.google.gms.google-services'
   
     // Add the App Distribution Gradle plugin
     id 'com.google.firebase.appdistribution'
   }

3. আপনি যদি কোনো কর্পোরেট প্রক্সি বা ফায়ারওয়ালের পিছনে থাকেন, তাহলে নিম্নলিখিত জাভা সিস্টেম প্রপার্টিটি যোগ করুন যা App Distribution আপনার ডিস্ট্রিবিউশনগুলি ফায়ারবেসে আপলোড করতে সক্ষম করে:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

ধাপ ২. ফায়ারবেস দিয়ে প্রমাণীকরণ করুন।

গ্রেডল প্লাগইন ব্যবহার করার আগে, আপনাকে অবশ্যই নিম্নলিখিত উপায়গুলির মধ্যে একটি ব্যবহার করে আপনার ফায়ারবেস প্রজেক্টের সাথে প্রমাণীকরণ করতে হবে। ডিফল্টরূপে, অন্য কোনো প্রমাণীকরণ পদ্ধতি ব্যবহার না করা হলে গ্রেডল প্লাগইন Firebase সিএলআই (CLI) থেকে ক্রেডেনশিয়াল খুঁজে নেয়।

ধাপ ৩. আপনার ডিস্ট্রিবিউশন প্রোপার্টিগুলো কনফিগার করুন।

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

উদাহরণস্বরূপ, পরীক্ষকদের কাছে release বিল্ড বিতরণ করতে, এই নির্দেশাবলী অনুসরণ করুন:

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("release") {
          firebaseAppDistribution {
              artifactType = "AAB"
              releaseNotesFile = "/path/to/releasenotes.txt"
              testers = "ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      release {
          firebaseAppDistribution {
              artifactType="AAB"
              releaseNotesFile="/path/to/releasenotes.txt"
              testers="ali@example.com, bri@example.com, cal@example.com"
          }
      }
  }

  // ...
}

আপনি বিল্ড টাইপ এবং প্রোডাক্ট ফ্লেভারের জন্য App Distribution কনফিগার করতে পারেন।

উদাহরণস্বরূপ, debug এবং release বিল্ডগুলিকে 'ডেমো' এবং 'ফুল' প্রোডাক্ট ফ্লেভারে বিতরণ করতে, এই নির্দেশাবলী অনুসরণ করুন:

import com.google.firebase.appdistribution.gradle.firebaseAppDistribution

android {

  // ...

  buildTypes {
      getByName("debug") {...}
      getByName("release") {...}
  }

  flavorDimensions += "version"
  productFlavors {
      create("demo") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for demo version"
              testers = "demo@testers.com"
          }
      }
      create("full") {
          dimension = "version"
          firebaseAppDistribution {
              releaseNotes = "Release notes for full version"
              testers = "full@testers.com"
          }
      }
  }

  // ...
}

android {

  // ...

  buildTypes {
      debug {...}
      release {...}
  }

  flavorDimensions "version"
  productFlavors {
      demo {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for demo version"
              testers="demo@testers.com"
          }
      }
      full {
          dimension "version"
          firebaseAppDistribution {
              releaseNotes="Release notes for full version"
              testers="full@testers.com"
          }
      }
  }

  // ...
}

ডিস্ট্রিবিউশনটি কনফিগার করতে নিম্নলিখিত প্যারামিটারগুলো ব্যবহার করুন:

appId="1:1234567890:android:321abc456def7890"

testers="ali@example.com, bri@example.com, cal@example.com"

testersFile="/path/to/testers.txt"

groups="qa-team, android-testers"

groupsFile="/path/to/tester-groups.txt"

testDevices="model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

testDevicesFile="/path/to/testDevices.txt"

testPasswordFile="/path/to/testPassword.txt"

ধাপ ৪। আপনার অ্যাপটি পরীক্ষকদের মধ্যে বিতরণ করুন।

1. অবশেষে, আপনার টেস্ট অ্যাপটি প্যাকেজ করতে এবং পরীক্ষকদের আমন্ত্রণ জানাতে, টার্গেটগুলো বিল্ড করুন। BUILD-VARIANT এবং appDistributionUpload BUILD-VARIANT আপনার প্রোজেক্টের Gradle র‍্যাপার ব্যবহার করুন, যেখানে BUILD-VARIANT হলো ঐচ্ছিক প্রোডাক্ট ফ্লেভার এবং বিল্ড টাইপ যা আপনি আগের ধাপে কনফিগার করেছেন। প্রোডাক্ট ফ্লেভার সম্পর্কে আরও তথ্যের জন্য, বিল্ড ভ্যারিয়েন্ট কনফিগার করুন দেখুন।

   উদাহরণস্বরূপ, release বিল্ড ভ্যারিয়েন্ট ব্যবহার করে আপনার অ্যাপটি ডিস্ট্রিবিউট করতে, নিম্নলিখিত কমান্ডটি চালান:

   ./gradlew bundleRelease appDistributionUploadRelease
   

   অথবা, যদি আপনি আপনার Google অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করে থাকেন এবং আপনার Gradle বিল্ড ফাইলে ক্রেডেনশিয়াল প্রদান না করে থাকেন, তাহলে FIREBASE_TOKEN ভেরিয়েবলটি অন্তর্ভুক্ত করুন:

   export FIREBASE_TOKEN=1/a1b2c3d4e5f67890
   ./gradlew --stop // Only needed for environment variable changes
   ./gradlew bundleRelease appDistributionUploadRelease
   

2. আপনি --<property-name>=<property-value> ` এই ফর্ম্যাটে কমান্ড লাইন আর্গুমেন্ট পাস করে আপনার build.gradle ফাইলে সেট করা মানগুলিকেও ওভাররাইড করতে পারেন। উদাহরণস্বরূপ:

   • App Distribution একটি ডিবাগ বিল্ড আপলোড করতে:

     ./gradlew bundleDebug appDistributionUploadDebug
         --artifactType="AAB"

   • আপনার Firebase প্রজেক্ট থেকে অতিরিক্ত পরীক্ষকদের আমন্ত্রণ জানাতে বা বিদ্যমান পরীক্ষকদের সরাতে:

     ./gradlew appDistributionAddTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"
     ./gradlew appDistributionRemoveTesters
         --projectNumber=<project_number>
         --emails="anothertester@email.com, moretesters@email.com"

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

   আপনি --emails এর পরিবর্তে --file="/path/to/testers.txt" ব্যবহার করেও পরীক্ষকদের নির্দিষ্ট করতে পারেন।

   appDistributionAddTesters এবং appDistributionRemoveTesters টাস্কগুলো নিম্নলিখিত আর্গুমেন্টগুলোও গ্রহণ করে:

   • projectNumber : আপনার ফায়ারবেস প্রজেক্ট নম্বর।

   • serviceCredentialsFile : আপনার গুগল পরিষেবা ক্রেডেনশিয়াল ফাইলের পাথ। আপলোড অ্যাকশনে ব্যবহৃত আর্গুমেন্টটিই এটি।

রিলিজ আপলোড করার পর গ্রেডল প্লাগইনটি নিম্নলিখিত লিঙ্কগুলি আউটপুট করে। এই লিঙ্কগুলি আপনাকে বাইনারিগুলি পরিচালনা করতে এবং পরীক্ষক ও অন্যান্য ডেভেলপারদের কাছে সঠিক রিলিজটি পৌঁছেছে কিনা তা নিশ্চিত করতে সাহায্য করে:

• firebase_console_uri - Firebase কনসোলের একটি লিঙ্ক, যেখানে একটিমাত্র রিলিজ প্রদর্শিত হয়। আপনি আপনার প্রতিষ্ঠানের অন্যান্য ডেভেলপারদের সাথে এই লিঙ্কটি শেয়ার করতে পারেন।
• testing_uri - টেস্টার এক্সপেরিয়েন্সে (অ্যান্ড্রয়েড নেটিভ অ্যাপ) থাকা রিলিজের একটি লিঙ্ক, যা টেস্টারদের রিলিজ নোট দেখতে এবং তাদের ডিভাইসে অ্যাপটি ইনস্টল করতে দেয়। লিঙ্কটি ব্যবহার করার জন্য টেস্টারের রিলিজটিতে অ্যাক্সেস থাকা প্রয়োজন।
• binary_download_uri - একটি স্বাক্ষরিত লিঙ্ক যা সরাসরি অ্যাপের বাইনারি (APK বা AAB ফাইল) ডাউনলোড এবং ইনস্টল করে। লিঙ্কটি এক ঘণ্টা পর মেয়াদোত্তীর্ণ হয়ে যায়।

একবার আপনি আপনার বিল্ড ডিস্ট্রিবিউট করলে, এটি Firebase কনসোলের App Distribution ড্যাশবোর্ডে ১৫০ দিনের (পাঁচ মাস) জন্য উপলব্ধ থাকে। বিল্ডটির মেয়াদ শেষ হওয়ার ৩০ দিন আগে, কনসোল এবং আপনার পরীক্ষকের টেস্ট ডিভাইসে থাকা বিল্ডের তালিকায় একটি মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি প্রদর্শিত হয়।

যেসব পরীক্ষককে অ্যাপটি পরীক্ষা করার জন্য আমন্ত্রণ জানানো হয়নি, তারা কাজ শুরু করার জন্য ইমেল আমন্ত্রণ পান এবং বিদ্যমান পরীক্ষকরা একটি নতুন বিল্ড পরীক্ষার জন্য প্রস্তুত হলে ইমেল বিজ্ঞপ্তি পান (টেস্ট অ্যাপটি কীভাবে ইনস্টল করতে হয় তার নির্দেশাবলীর জন্য পরীক্ষক সেটআপ গাইডটি পড়ুন)। আপনি Firebase কনসোলে প্রতিটি পরীক্ষকের অবস্থা—তারা আমন্ত্রণ গ্রহণ করেছে কিনা এবং তারা অ্যাপটি ডাউনলোড করেছে কিনা—পর্যবেক্ষণ করতে পারেন।

অ্যাপটি পরীক্ষা করার জন্য একটি আমন্ত্রণ গ্রহণ করার জন্য পরীক্ষকদের ৩০ দিন সময় থাকে, এরপর আমন্ত্রণটির মেয়াদ শেষ হয়ে যায়। যখন কোনো আমন্ত্রণের মেয়াদ শেষ হতে ৫ দিন বাকি থাকে, তখন রিলিজের সময় Firebase কনসোলে পরীক্ষকের পাশে একটি মেয়াদ শেষের বিজ্ঞপ্তি দেখা যায়। পরীক্ষকের সারিতে থাকা ড্রপ-ডাউন মেনু ব্যবহার করে আমন্ত্রণটি পুনরায় পাঠিয়ে নবায়ন করা যেতে পারে।

পরবর্তী পদক্ষেপ

• পরীক্ষকদের জন্য আপনার অ্যাপ সম্পর্কে মতামত (স্ক্রিনশট সহ) পাঠানো সহজ করতে অ্যাপের মধ্যেই ফিডব্যাক ব্যবস্থা চালু করুন।

• আপনার অ্যাপের নতুন বিল্ড ইনস্টল করার জন্য উপলব্ধ হলে, আপনার পরীক্ষকদের কীভাবে অ্যাপের মধ্যেই অ্যালার্ট দেখাবেন তা জেনে নিন।

• ধাপে ধাপে অ্যাপ বান্ডেল রিলিজ বিতরণ করার পদ্ধতি জানতে অ্যান্ড্রয়েড অ্যাপ বান্ডেল কোডল্যাব পরিদর্শন করুন।

• CI/CD ব্যবহার করে QA টেস্টারদের কাছে অ্যান্ড্রয়েড অ্যাপ বিতরণের সেরা পদ্ধতিগুলো জানুন।