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


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

শুরু করার আগে

যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার অ্যান্ড্রয়েড প্রজেক্টে Firebase যোগ করুন ।

যদি আপনি অন্য কোনও Firebase পণ্য ব্যবহার না করেন, তাহলে আপনাকে কেবল একটি প্রকল্প তৈরি করতে হবে এবং আপনার অ্যাপটি নিবন্ধন করতে হবে। তবে, যদি আপনি ভবিষ্যতে অতিরিক্ত পণ্য ব্যবহার করার সিদ্ধান্ত নেন, তাহলে উপরে লিঙ্ক করা পৃষ্ঠার সমস্ত পদক্ষেপগুলি সম্পূর্ণ করতে ভুলবেন না।

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

যখন আপনি আপনার অ্যাপের একটি প্রি-রিলিজ সংস্করণ পরীক্ষকদের কাছে বিতরণ করার জন্য প্রস্তুত হবেন, তখন আপনার স্বাভাবিক প্রক্রিয়া ব্যবহার করে আপনার APK তৈরি করুন। আপনাকে অবশ্যই আপনার ডিবাগ কী বা অ্যাপ সাইনিং কী দিয়ে APK সাইন করতে হবে।

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

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

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

  2. আপনার অ্যাপটি আপলোড করতে এবং পরীক্ষকদের কাছে বিতরণ করতে 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.apk  \
    --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 কনসোলে একটি মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি প্রদর্শিত হয়। পরীক্ষক সারির ড্রপ-ডাউন মেনু ব্যবহার করে এটি পুনরায় পাঠিয়ে একটি আমন্ত্রণ পুনর্নবীকরণ করা যেতে পারে।

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