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

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

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

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

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

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

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

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

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

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

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

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

তুমি শুরু করার আগে

  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 কনসোলে, আপনার প্রকল্প সেটিংস , তারপর ইন্টিগ্রেশন ট্যাব নির্বাচন করুন।

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

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

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

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

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

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

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

  1. Firebase CLI- এর সর্বশেষ সংস্করণে ইনস্টল বা আপডেট করুন (আমরা আপনার OS-এর জন্য নির্দিষ্ট CLI-এর জন্য স্বতন্ত্র বাইনারি ডাউনলোড করার পরামর্শ দিই)। সাইন ইন করা নিশ্চিত করুন এবং পরীক্ষা করুন যে আপনি আপনার প্রকল্পগুলি অ্যাক্সেস করতে পারেন।
  2. Firebase কনসোলের অ্যাপ বিতরণ পৃষ্ঠায় , আপনি যে অ্যাপটি বিতরণ করতে চান সেটি নির্বাচন করুন, তারপর শুরু করুন ক্লিক করুন।
  3. আপনার অ্যাপ আপলোড করতে এবং পরীক্ষকদের কাছে বিতরণ করতে appdistribution:distribute কমান্ড চালান। বিতরণ কনফিগার করতে নিম্নলিখিত পরামিতি ব্যবহার করুন:

    appdistribution:অপশন বিতরণ করুন
    --app

    প্রয়োজনীয় : আপনার অ্যাপের ফায়ারবেস অ্যাপ আইডি। আপনি সাধারণ সেটিংস পৃষ্ঠায় Firebase কনসোলে অ্যাপ আইডি খুঁজে পেতে পারেন।

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    একটি রিফ্রেশ টোকেন যা প্রিন্ট করা হয় যখন আপনি Firebase CLI এর সাথে আপনার CI পরিবেশকে প্রমাণীকরণ করেন (আরও তথ্যের জন্য CI সিস্টেমের সাথে CLI ব্যবহার করুন )।

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

    নিম্নলিখিত বিতরণ প্রকারগুলি স্বয়ংক্রিয় পরীক্ষক বিটা বৈশিষ্ট্যের অংশ৷

    আপনি বিল্ড বিতরণ করতে চান এমন পরীক্ষা ডিভাইসগুলি ( স্বয়ংক্রিয় পরীক্ষা পড়ুন)।

    আপনি ইমেল ঠিকানাগুলির একটি কমা দ্বারা পৃথক তালিকা হিসাবে পরীক্ষকদের নির্দিষ্ট করতে পারেন:

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

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

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

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

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

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

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

    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 ব্যবহার করে পরীক্ষকদেরও নির্দিষ্ট করতে পারেন।

    আপনার যদি প্রচুর সংখ্যক পরীক্ষক থাকে তবে আপনার গ্রুপগুলি ব্যবহার করার কথা বিবেচনা করা উচিত: আপনি আপনার ফায়ারবেস প্রোজেক্টে 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 কনসোলের অ্যাপ ডিস্ট্রিবিউশন ড্যাশবোর্ডে 150 দিনের (পাঁচ মাস) জন্য উপলব্ধ হয়ে যায়। বিল্ডের মেয়াদ শেষ হওয়ার 30 দিন হলে, কনসোল এবং আপনার পরীক্ষকের তাদের টেস্ট ডিভাইসে বিল্ডের তালিকা উভয়েই একটি মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি প্রদর্শিত হবে।

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

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

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