এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

আপনার পরীক্ষকদের ডিভাইসে অপ্টিমাইজ করা অপ্টিমাইজ করা APK (গুগল প্লে দ্বারা পরিবেশিত) চালান।
ডিভাইস-নির্দিষ্ট সমস্যাগুলি উন্মোচন এবং ডিবাগ করুন।
প্লে ফিচার ডেলিভারি এবং প্লে অ্যাসেট ডেলিভারির মতো অ্যাপ বান্ডেল বৈশিষ্ট্যগুলি পরীক্ষা করুন।
আপনার পরীক্ষকদের জন্য ডাউনলোডের আকার হ্রাস করুন।

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

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

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

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

Firebase কনসোলে অ্যাকশন	IAM অনুমতি প্রয়োজন	IAM ভূমিকা(গুলি) যাতে ডিফল্টরূপে প্রয়োজনীয় অনুমতি অন্তর্ভুক্ত থাকে	অতিরিক্ত প্রয়োজনীয় ভূমিকা(গুলি)
Google Play তে একটি অ্যাপের সাথে একটি Firebase অ্যাপ লিঙ্ক করুন	`firebase.playLinks.update`	নিম্নলিখিত ভূমিকাগুলির মধ্যে একটি: মালিক ফায়ারবেস অ্যাডমিন	অ্যাডমিন হিসেবে Google Play ডেভেলপার অ্যাকাউন্টে অ্যাক্সেস
App Distribution AABs আপলোড করুন	`firebaseappdistro.releases.update`	নিম্নলিখিত ভূমিকাগুলির মধ্যে একটি: মালিক সম্পাদক ফায়ারবেস অ্যাডমিন ফায়ারবেস কোয়ালিটি অ্যাডমিন ফায়ারবেস অ্যাপ ডিস্ট্রিবিউশন অ্যাডমিন	––

শুরু করার আগে

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার অ্যান্ড্রয়েড প্রোজেক্টে Firebase যোগ করুন । এই ওয়ার্কফ্লো শেষে, আপনার Firebase প্রোজেক্টে একটি Firebase Android অ্যাপ থাকবে।
যদি আপনি অন্য কোনও Firebase পণ্য ব্যবহার না করেন, তাহলে আপনাকে কেবল একটি প্রকল্প তৈরি করতে হবে এবং আপনার অ্যাপটি নিবন্ধন করতে হবে। যদি আপনি অতিরিক্ত পণ্য ব্যবহার করার সিদ্ধান্ত নেন, তাহলে আপনার Android প্রকল্পে Firebase যোগ করুন এর সমস্ত ধাপগুলি সম্পূর্ণ করতে ভুলবেন না।
সতর্কতা: যখন আপনি আপনার অ্যাপটি Firebase-এ নিবন্ধন করবেন, তখন আপনি যে অ্যাপটি বিতরণ করছেন তার একই প্যাকেজ নাম লিখুন। প্যাকেজ নামের মানটি কেস-সংবেদনশীল এবং আপনার Firebase প্রকল্পের সাথে নিবন্ধিত হওয়ার পরে Firebase-এ আপনার অ্যাপের জন্য এটি পরিবর্তন করা যাবে না।
গুগল প্লেতে একটি ফায়ারবেস লিঙ্ক তৈরি করতে এবং AAB আপলোড করতে, নিশ্চিত করুন যে আপনার অ্যাপটি নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:
- গুগল প্লেতে থাকা অ্যাপ এবং ফায়ারবেস অ্যান্ড্রয়েড অ্যাপ উভয়ই একই প্যাকেজ নাম ব্যবহার করে নিবন্ধিত।
  দ্রষ্টব্য: আপনি এমন অ্যাপের জন্য AAB আপলোড করতে পারেন যেগুলোর প্যাকেজ নাম আপনার প্রোডাকশন অ্যাপের মতো নয়। শুধু Google Play তে একটি নতুন অ্যাপ তৈরি করুন এবং সেই অ্যাপটি যেকোনো ট্র্যাকে বিতরণ করুন (আপনাকে প্রোডাকশন ট্র্যাক নির্বাচন করতে হবে না)। এরপর Google Play অ্যাপটি নিবন্ধন করতে AAB তে প্যাকেজ নাম ব্যবহার করে।
- গুগল প্লেতে থাকা অ্যাপটি অ্যাপ ড্যাশবোর্ডে সেট আপ করা আছে এবং গুগল প্লে ট্র্যাকগুলির একটিতে (অভ্যন্তরীণ পরীক্ষা, বন্ধ পরীক্ষা, উন্মুক্ত পরীক্ষা, অথবা উৎপাদন) বিতরণ করা হয়।
- গুগল প্লেতে অ্যাপটির পর্যালোচনা সম্পূর্ণ হয়েছে এবং অ্যাপটি প্রকাশিত হয়েছে। অ্যাপের স্ট্যাটাস কলামে নিম্নলিখিত স্ট্যাটাসগুলির মধ্যে একটি প্রদর্শিত হলে আপনার অ্যাপটি প্রকাশিত হবে: অভ্যন্তরীণ পরীক্ষা (ড্রাফ্ট অভ্যন্তরীণ পরীক্ষা নয়), বন্ধ পরীক্ষা, উন্মুক্ত পরীক্ষা, অথবা উৎপাদন।
আপনার Firebase Android অ্যাপটি আপনার Google Play ডেভেলপার অ্যাকাউন্টের সাথে লিঙ্ক করুন:
1. Firebase কনসোলে, আপনার প্রকল্প সেটিংস , তারপর ইন্টিগ্রেশন ট্যাব নির্বাচন করুন।
2. গুগল প্লে কার্ডে, লিঙ্ক এ ক্লিক করুন।
  যদি আপনার ইতিমধ্যেই Google Play-তে লিঙ্ক থাকে, তাহলে পরিবর্তে Manage-এ ক্লিক করুন।
3. App Distribution ইন্টিগ্রেশন সক্ষম করতে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন এবং কোন ফায়ারবেস অ্যান্ড্রয়েড অ্যাপগুলি গুগল প্লেতে লিঙ্ক করবেন তা নির্বাচন করুন।
গুগল প্লেতে লিঙ্ক করা সম্পর্কে আরও জানুন।

ধাপ ১. আপনার অ্যাপ তৈরি করুন

যখন আপনি আপনার অ্যাপের একটি প্রি-রিলিজ সংস্করণ পরীক্ষকদের কাছে বিতরণ করতে প্রস্তুত হন, তখন আপনার AAB তৈরি করুন (নির্দেশাবলীর জন্য Android Studio ডকুমেন্টেশন দেখুন)।

দ্রষ্টব্য: জেনারেট করা APK গুলি Google Play দ্বারা স্বয়ংক্রিয়ভাবে একটি পরীক্ষামূলক অ্যাপ সাইনিং কী সার্টিফিকেট ব্যবহার করে বাতিল করা হয়। অনুরোধ করা হলে, যদি আপনি তাদের তৃতীয় পক্ষের পরিষেবাগুলি ব্যবহার চালিয়ে যেতে চান তবে আপনাকে API প্রদানকারীদের সাথে আপনার অ্যাপটি নিবন্ধন করতে হবে। একবার স্বাক্ষরিত হয়ে গেলে, আপনার অ্যাপের পরীক্ষামূলক সার্টিফিকেট Firebase কনসোলে দেখা যাবে।

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

পরীক্ষকদের কাছে আপনার অ্যাপ বিতরণ করতে, Firebase CLI ব্যবহার করে আপনার অ্যাপের ফাইল আপলোড করুন:

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

আপনার অ্যাপটি আপলোড করতে এবং পরীক্ষকদের কাছে বিতরণ করতে appdistribution:distribute কমান্ডটি চালান। বিতরণ কনফিগার করতে নিম্নলিখিত প্যারামিটারগুলি ব্যবহার করুন:

অ্যাপডিস্ট্রিবিউশন:ডিস্ট্রিবিউট অপশন
`--app`	প্রয়োজনীয় : আপনার অ্যাপের Firebase অ্যাপ আইডি। আপনি Firebase কনসোলে, জেনারেল সেটিংস পৃষ্ঠায় অ্যাপ আইডিটি খুঁজে পেতে পারেন। --app 1:1234567890:android:0a1b2c3d4e5f67890
`--token`	Firebase সিএলআই দিয়ে আপনার সিআই পরিবেশ প্রমাণীকরণের সময় একটি রিফ্রেশ টোকেন মুদ্রিত হয় (আরও তথ্যের জন্য সিআই সিস্টেমের সাথে সিআই সিস্টেম ব্যবহার করুন পড়ুন)। --token "$FIREBASE_TOKEN"
`--release-notes` `--release-notes-file`	এই বিল্ডের জন্য রিলিজ নোট। আপনি সরাসরি রিলিজ নোটগুলি নির্দিষ্ট করতে পারেন: --release-notes "Text of release notes" অথবা, একটি প্লেইন টেক্সট ফাইলের পথ নির্দিষ্ট করুন: --release-notes-file "/path/to/release-notes.txt"
`--testers` `--testers-file`	আপনি যে পরীক্ষকদের আমন্ত্রণ জানাতে চান তাদের ইমেল ঠিকানা। আপনি পরীক্ষকদের কমা দ্বারা পৃথক করা ইমেল ঠিকানার তালিকা হিসাবে নির্দিষ্ট করতে পারেন: --testers "ali@example.com, bri@example.com, cal@example.com" অথবা, আপনি কমা দ্বারা পৃথক করা ইমেল ঠিকানার তালিকা সম্বলিত একটি প্লেইন টেক্সট ফাইলের পথ নির্দিষ্ট করতে পারেন: --testers-file "/path/to/testers.txt"
`--groups` `--groups-file`	আপনি যে পরীক্ষক গোষ্ঠীগুলিকে আমন্ত্রণ জানাতে চান ( পরীক্ষকদের পরিচালনা করুন দেখুন)। গোষ্ঠীগুলি ব্যবহার করে নির্দিষ্ট করা হয় গ্রুপ উপনাম , যা আপনি Firebase কনসোলে দেখতে পারেন। আপনি কমা দ্বারা পৃথক তালিকা হিসাবে গোষ্ঠীগুলিকে নির্দিষ্ট করতে পারেন: --groups "qa-team, trusted-testers" অথবা, আপনি কমা দ্বারা পৃথক করা গ্রুপ নামের তালিকা সম্বলিত একটি প্লেইন টেক্সট ফাইলের পথ নির্দিষ্ট করতে পারেন: --groups-file "/path/to/groups.txt"
`--debug`	ভার্বোজ লগ আউটপুট প্রিন্ট করার জন্য আপনি একটি পতাকা অন্তর্ভুক্ত করতে পারেন।
`--test-devices` `--test-devices-file`	নিম্নলিখিত বিতরণ প্রকারগুলি অটোমেটেড টেস্টার বিটা বৈশিষ্ট্যের অংশ। আপনি যে পরীক্ষামূলক ডিভাইসগুলিতে বিল্ড বিতরণ করতে চান ( Automated tests দেখুন)। আপনি পরীক্ষকদের কমা দ্বারা পৃথক করা ইমেল ঠিকানার তালিকা হিসাবে নির্দিষ্ট করতে পারেন: --test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" অথবা, আপনি একটি প্লেইন টেক্সট ফাইলের পাথ নির্দিষ্ট করতে পারেন যেখানে সেমিকোলন-বিচ্ছিন্ন পরীক্ষা ডিভাইসের তালিকা রয়েছে: --test-devices-file: "/path/to/test-devices.txt"
`--test-username`	স্বয়ংক্রিয় পরীক্ষার সময় ব্যবহৃত স্বয়ংক্রিয় লগইনের ব্যবহারকারীর নাম।
`--test-password` `--test-password-file`	স্বয়ংক্রিয় পরীক্ষার সময় স্বয়ংক্রিয় লগইনের জন্য পাসওয়ার্ড ব্যবহার করা হবে। অথবা, আপনি একটি পাসওয়ার্ড ধারণকারী একটি প্লেইন টেক্সট ফাইলের পথ নির্দিষ্ট করতে পারেন: --test-password-file: "/path/to/test-password.txt"
`--test-username-resource`	স্বয়ংক্রিয় পরীক্ষার সময় স্বয়ংক্রিয় লগইনের জন্য ব্যবহারকারীর নাম ক্ষেত্রের জন্য রিসোর্সের নাম।
`--test-password-resource`	স্বয়ংক্রিয় পরীক্ষার সময় স্বয়ংক্রিয় লগইনের জন্য পাসওয়ার্ড ক্ষেত্রের রিসোর্সের নাম।
`--test-non-blocking`	স্বয়ংক্রিয় পরীক্ষাগুলি অ্যাসিঙ্ক্রোনাসভাবে চালান। স্বয়ংক্রিয় পরীক্ষার ফলাফলের জন্য Firebase কনসোলটি দেখুন।

উদাহরণস্বরূপ:

firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

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

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

পরীক্ষক এবং গোষ্ঠী পরিচালনা করুন

রিলিজ বিতরণের পাশাপাশি, আপনি নতুন পরীক্ষকদের আমন্ত্রণ জানাতে অথবা আপনার Firebase প্রকল্প থেকে বিদ্যমান পরীক্ষকদের অপসারণ করতে appdistribution:testers:add এবং appdistribution:testers:remove ব্যবহার করতে পারেন।

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

উদাহরণস্বরূপ:

firebase appdistribution:testers:add anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com

পরীক্ষক ইমেলগুলিকে একটি স্পেস দিয়ে আলাদা করতে হবে। আপনি --file /path/to/testers.txt ব্যবহার করেও পরীক্ষক নির্দিষ্ট করতে পারেন।

যদি আপনার প্রচুর সংখ্যক পরীক্ষক থাকে তবে আপনার গ্রুপ ব্যবহার করার কথা বিবেচনা করা উচিত: আপনি আপনার Firebase প্রকল্পে গ্রুপ তৈরি বা মুছে ফেলার জন্য appdistribution:group:create এবং appdistribution:group:delete ব্যবহার করতে পারেন।

appdistribution:testers:add এবং appdistribution:testers:remove কমান্ডের জন্য একটি গ্রুপ নির্দিষ্ট করতে --group-alias ব্যবহার করুন।

উদাহরণস্বরূপ:

firebase appdistribution:group:create "QA team" qa-team

firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com

firebase appdistribution:group:delete qa-team

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

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

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

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

পরীক্ষকদের আপনার অ্যাপ সম্পর্কে প্রতিক্রিয়া পাঠানো সহজ করার জন্য (স্ক্রিনশট সহ) অ্যাপ-মধ্যস্থ প্রতিক্রিয়া বাস্তবায়ন করুন।
আপনার অ্যাপের নতুন বিল্ড ইনস্টল করার জন্য উপলব্ধ হলে আপনার পরীক্ষকদের কাছে অ্যাপ-মধ্যস্থ সতর্কতাগুলি কীভাবে প্রদর্শন করবেন তা শিখুন।
CI/CD ব্যবহার করে QA পরীক্ষকদের কাছে অ্যান্ড্রয়েড অ্যাপ বিতরণের সেরা অনুশীলনগুলি শিখুন।