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

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

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

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

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

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

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

• আপনার পরীক্ষকদের জন্য ডাউনলোডের আকার কমিয়ে দিন।

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

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

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

নিম্নলিখিত সারণীটি Google Play এর একটি অ্যাপের সাথে একটি Firebase অ্যাপ লিঙ্ক করার পাশাপাশি AABs আপলোড করার ক্ষেত্রে প্রযোজ্য।

আপনি শুরু করার আগে

1. যদি আপনি ইতিমধ্যেই না করে থাকেন তাহলে আপনার Android প্রকল্পে Firebase যোগ করুন । এই কর্মপ্রবাহের শেষে, আপনার Firebase প্রকল্পে একটি Firebase Android অ্যাপ থাকবে।

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

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

   • Google Play-এর অ্যাপ এবং Firebase অ্যান্ড্রয়েড অ্যাপ উভয়ই একই প্যাকেজের নাম ব্যবহার করে নিবন্ধিত।

   • Google Play-তে অ্যাপটি অ্যাপ ড্যাশবোর্ডে সেট আপ করা হয়েছে এবং Google Play ট্র্যাকের একটিতে বিতরণ করা হয়েছে (অভ্যন্তরীণ পরীক্ষা, বন্ধ পরীক্ষা, ওপেন টেস্টিং বা উৎপাদন)।

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

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

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

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

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

   Google Play-এ লিঙ্ক করার বিষয়ে আরও জানুন।

ধাপ 1. আপনার Android প্রকল্প সেট আপ করুন

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

   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.2" apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id("com.google.firebase.appdistribution") version "5.0.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.4.2' apply false
   
       // Add the dependency for the App Distribution Gradle plugin
       id 'com.google.firebase.appdistribution' version '5.0.0' apply false
   }

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

   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
   

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

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

ধাপ 3. আপনার বিতরণ বৈশিষ্ট্য কনফিগার করুন

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

উদাহরণস্বরূপ, পরীক্ষকদের কাছে 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"

ধাপ 4. পরীক্ষকদের কাছে আপনার অ্যাপ বিতরণ করুন

1. অবশেষে, আপনার পরীক্ষার অ্যাপ প্যাকেজ করতে এবং পরীক্ষকদের আমন্ত্রণ জানাতে, লক্ষ্যগুলি তৈরি করুন BUILD-VARIANT এবং appDistributionUpload BUILD-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. আপনি --<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 : আপনার Google পরিষেবা শংসাপত্র ফাইলের পথ। এটি আপলোড ক্রিয়া দ্বারা ব্যবহৃত একই যুক্তি।

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

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

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

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

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

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

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

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

• ধাপে ধাপে কীভাবে অ্যাপ বান্ডেল রিলিজ বিতরণ করতে হয় তা জানতে Android অ্যাপ বান্ডেল কোডল্যাবে যান।

• CI/CD ব্যবহার করে QA পরীক্ষকদের কাছে অ্যান্ড্রয়েড অ্যাপ বিতরণের সর্বোত্তম অনুশীলন শিখুন।