Gradle ব্যবহার করে টেস্টারদের কাছে Android অ্যাপ ডিস্ট্রিবিউট করা

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

এই গাইড থেকে আপনি জানতে পারবেন কীভাবে App Distribution Gradle প্লাগ-ইন ব্যবহার করে টেস্টারদের মধ্যে Android অ্যাপ বান্ডেল (AAB) ডিস্ট্রিবিউট করতে হয়।

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

• আপনার টেস্টারদের ডিভাইসের জন্য অপ্টিমাইজ করা অপ্টিমাইজড APK (Google Play-এর মাধ্যমে পরিবেশিত) চালান।

• ডিভাইস-নির্দিষ্ট সমস্যা খুঁজে বের করা ও তার সমাধান করা।

• Play ফিচার ডেলিভারি ও Play অ্যাসেট ডেলিভারির মতো অ্যাপ বান্ডেল ফিচার টেস্ট করুন।

• টেস্টারদের জন্য ডাউনলোডের সাইজ কমান।

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

App Distribution-এ AAB আপলোড করতে, আপনাকে অবশ্যই Google Play-এর কোনও অ্যাপের সাথে Firebase অ্যাপ লিঙ্ক করতে হবে। এইসব অ্যাকশন পারফর্ম করার জন্য আপনার কাছে প্রয়োজনীয় লেভেলের অ্যাক্সেস থাকতে হবে।

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

নিচের সারণীটি Google Play-এর কোনও অ্যাপের সাথে Firebase অ্যাপ লিঙ্ক করা এবং AAB আপলোড করার ক্ষেত্রে প্রযোজ্য।

শুরু করার আগে

1. আপনি আগে থেকে না করে থাকলে, আপনার Android প্রোজেক্টে Firebase যোগ করুন। এই ওয়ার্কফ্লোর শেষে, আপনার Firebase প্রোজেক্টে একটি Firebase Android অ্যাপ থাকবে।

   আপনি অন্য কোনও Firebase প্রোডাক্ট ব্যবহার না করলে, আপনাকে শুধু একটি প্রোজেক্ট তৈরি করতে হবে এবং আপনার অ্যাপ রেজিস্টার করতে হবে। আপনি অতিরিক্ত প্রোডাক্ট ব্যবহার করার সিদ্ধান্ত নিলে, আপনার Android প্রোজেক্টে Firebase যোগ করুন লিঙ্কে দেওয়া সব ধাপ সম্পূর্ণ করতে ভুলবেন না।

2. Firebase কনসোলের App Distribution পৃষ্ঠা খুলুন। প্রম্পট করা হলে আপনার Firebase প্রোজেক্ট বেছে নিন, অ্যাপ সুইচার ব্যবহার করে আপনার অ্যাপ বেছে নিন এবং শুরু করুন বিকল্পে ক্লিক করুন।

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

   • Google Play-তে থাকা অ্যাপ এবং Firebase Android অ্যাপ, দুটিই একই প্যাকেজের নাম ব্যবহার করে রেজিস্টার করা হয়েছে।

   • Google Play-তে অ্যাপটি অ্যাপ ড্যাশবোর্ডে সেট-আপ করা হয় এবং Google Play ট্র্যাকের (ইন্টার্নাল টেস্টিং, ক্লোজড টেস্টিং, ওপেন টেস্টিং বা প্রোডাকশন) কোনও একটিতে ডিস্ট্রিবিউট করা হয়।

   • Google Play-তে অ্যাপের পর্যালোচনা সম্পূর্ণ হয়েছে এবং অ্যাপটি প্রকাশ করা হয়েছে। অ্যাপের স্ট্যাটাস কলামে নিম্নলিখিত স্ট্যাটাসগুলির মধ্যে একটি দেখালে আপনার অ্যাপ প্রকাশ করা হয়েছে বলে ধরে নেওয়া হবে: ইন্টার্নাল টেস্টিং (ড্রাফ্ট ইন্টার্নাল টেস্টিং নয়), ক্লোজড টেস্টিং, ওপেন টেস্টিং বা প্রোডাকশন।

4. আপনার Firebase Android অ্যাপকে Google Play ডেভেলপার অ্যাকাউন্টের সাথে লিঙ্ক করুন:

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

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

   3. App Distribution ইন্টিগ্রেশন চালু করতে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন এবং Google Play-এর সাথে কোন Firebase Android অ্যাপ লিঙ্ক করবেন তা বেছে নিন।

   Google Play-তে লিঙ্ক করা সম্পর্কে আরও জানুন।

ধাপ ১. আপনার Android প্রোজেক্ট সেট-আপ করা

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.5.0" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "5.3.0" 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.5.0' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '5.3.0' 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. আপনি কর্পোরেট প্রক্সি বা ফায়ারওয়ালের পিছনে থাকলে, নিম্নলিখিত Java সিস্টেম প্রপার্টি যোগ করুন যা Firebase-এ আপনার ডিস্ট্রিবিউশন আপলোড করার জন্য App Distribution চালু করে:

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

ধাপ ২. Firebase-এর মাধ্যমে যাচাইকরণ

Gradle প্লাগ-ইন ব্যবহার করার আগে, আপনাকে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে আপনার Firebase প্রোজেক্টের সাথে প্রথমে যাচাই করিয়ে নিতে হবে। সাধারণত, অন্য কোনও যাচাইকরণ পদ্ধতি ব্যবহার করা না হলে, Gradle প্লাগ-ইন Firebase CLI থেকে ক্রেডেনশিয়াল খোঁজে।

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

আপনার মডিউল (অ্যাপ-লেভেল) Gradle ফাইলে (সাধারণত <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"

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

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

ধাপ ৪. টেস্টারদের কাছে আপনার অ্যাপ ডিস্ট্রিবিউট করা

1. সবশেষে, আপনার টেস্ট অ্যাপ প্যাকেজ করতে এবং পরীক্ষকদের আমন্ত্রণ জানাতে, আপনার প্রোজেক্টের Gradle র‍্যাপারের সাথে টার্গেট BUILD-VARIANT এবং appDistributionUploadBUILD-VARIANT তৈরি করুন, যেখানে 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. এছাড়াও, আপনি build.gradle ফাইলে সেট করা ভ্যালু ওভাররাইড করতে পারেন। এর জন্য --<property-name>=<property-value>-এর মতো কমান্ড লাইন আর্গুমেন্ট পাস করুন। যেমন:

   • 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"

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

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

   appDistributionAddTesters ও appDistributionRemoveTesters টাস্ক এছাড়াও নিম্নলিখিত আর্গুমেন্ট গ্রহণ করে:

   • projectNumber: আপনার Firebase প্রোজেক্ট নম্বর।

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

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

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

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

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

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

পরবর্তী ধাপ

• আপনার অ্যাপ সম্পর্কে পরীক্ষার্থীদের থেকে মতামত সংগ্রহ করতে ইন-অ্যাপ মতামত প্রয়োগ করুন (এর মধ্যে স্ক্রিনশট অন্তর্ভুক্ত)।

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

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

• CI/CD ব্যবহার করে QA টেস্টারদের কাছে Android অ্যাপ ডিস্ট্রিবিউট করার পেশাদার পদ্ধতি সম্পর্কে জানুন।