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

এই নির্দেশিকাটি বর্ণনা করে কিভাবে ফাস্টলেন (fastlane) ব্যবহার করে পরীক্ষকদের কাছে AAB বিল্ড বিতরণ করা যায়। ফাস্টলেন হলো একটি ওপেন সোর্স প্ল্যাটফর্ম যা iOS এবং Android অ্যাপ তৈরি ও রিলিজ করার প্রক্রিয়াকে স্বয়ংক্রিয় করে। এটি একটি Fastfile -এ সংজ্ঞায়িত সহজ নির্দেশাবলী অনুসরণ করে। ফাস্টলেন এবং আপনার Fastfile সেট আপ করার পরে, আপনি আপনার ফাস্টলেন কনফিগারেশনের সাথে App Distribution একীভূত করতে পারবেন।

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

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

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

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

• আপনার পরীক্ষকদের জন্য ডাউনলোডের আকার হ্রাস করুন।

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

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

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

নিম্নলিখিত সারণিটি ফায়ারবেস অ্যাপকে Google Play এর কোনো অ্যাপের সাথে লিঙ্ক করা এবং এএবি (AAB) আপলোড করার ক্ষেত্রে প্রযোজ্য।

শুরু করার আগে

1. যদি আগে থেকে না করে থাকেন, তাহলে আপনার অ্যান্ড্রয়েড প্রজেক্টে ফায়ারবেস যোগ করুন । এই প্রক্রিয়াটি শেষে, আপনার ফায়ারবেস প্রজেক্টে একটি ফায়ারবেস অ্যান্ড্রয়েড অ্যাপ তৈরি হয়ে যাবে।

   আপনি যদি অন্য কোনো Firebase প্রোডাক্ট ব্যবহার না করেন, তাহলে আপনাকে শুধু একটি প্রজেক্ট তৈরি করে আপনার অ্যাপটি রেজিস্টার করতে হবে। আপনি যদি অতিরিক্ত প্রোডাক্ট ব্যবহার করার সিদ্ধান্ত নেন, তাহলে “Add Firebase to your Android project”- এর সমস্ত ধাপ অবশ্যই সম্পন্ন করবেন।

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

   • গুগল প্লে-এর অ্যাপ এবং ফায়ারবেস অ্যান্ড্রয়েড অ্যাপ উভয়ই একই প্যাকেজ নাম ব্যবহার করে নিবন্ধিত।

   • গুগল প্লে-তে থাকা অ্যাপটি অ্যাপ ড্যাশবোর্ডে সেট আপ করা হয় এবং গুগল প্লে-র ট্র্যাকগুলোর (অভ্যন্তরীণ টেস্টিং, ক্লোজড টেস্টিং, ওপেন টেস্টিং, বা প্রোডাকশন) যেকোনো একটিতে বিতরণ করা হয়।

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

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

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

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

   3. App Distribution ইন্টিগ্রেশন চালু করতে এবং কোন ফায়ারবেস অ্যান্ড্রয়েড অ্যাপগুলোকে গুগল প্লে-এর সাথে লিঙ্ক করবেন তা নির্বাচন করতে স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন।

   গুগল প্লে-এর সাথে সংযোগ স্থাপন সম্পর্কে আরও জানুন।

ধাপ ১. ফাস্টলেন সেট আপ করুন

1. ফাস্টলেন ইনস্টল ও সেট আপ করুন ।

2. আপনার fastlane কনফিগারেশনে App Distribution যোগ করতে, আপনার অ্যান্ড্রয়েড প্রজেক্টের রুট থেকে নিম্নলিখিত কমান্ডটি চালান:

   fastlane add_plugin firebase_app_distribution

   যদি কমান্ডটি আপনাকে কোনো অপশন দেখায়, তাহলে Option 3: RubyGems.org নির্বাচন করুন।

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

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

ধাপ ৩. আপনার ফাস্টফাইল সেট আপ করুন এবং আপনার অ্যাপটি বিতরণ করুন।

1. ./fastlane/Fastfile লেনে একটি firebase_app_distribution ব্লক যোগ করুন। ডিস্ট্রিবিউশনটি কনফিগার করতে নিম্নলিখিত প্যারামিটারগুলো ব্যবহার করুন:

   firebase_app_distribution প্যারামিটার
   app	আবশ্যক : আপনার অ্যাপের ফায়ারবেস অ্যাপ আইডি। আপনি Firebase কনসোলের জেনারেল সেটিংস পৃষ্ঠায় অ্যাপ আইডিটি খুঁজে পাবেন। app: "1:1234567890:android:0a1b2c3d4e5f67890"
   firebase_cli_token	একটি রিফ্রেশ টোকেন যা ফায়ারবেস সিএলআই Firebase CLI) দিয়ে আপনার সিআই (CI) এনভায়রনমেন্ট প্রমাণীকরণের সময় প্রিন্ট করা হয় (আরও তথ্যের জন্য "সিআই সিস্টেমের সাথে সিএলআই ব্যবহার করুন" পড়ুন)।
   service_credentials_file	আপনার গুগল সার্ভিস অ্যাকাউন্ট json ফাইলের পাথ। সার্ভিস অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করে কীভাবে প্রমাণীকরণ করতে হয়, তা জানতে উপরে দেখুন।
   android_artifact_type	অ্যান্ড্রয়েড ফাইলের ধরণ (APK বা AAB) নির্দিষ্ট করে।
   android_artifact_path	apk_path (অপ্রচলিত)-এর পরিবর্তে ব্যবহৃত হয়। আপনি যে APK বা AAB ফাইলটি আপলোড করতে চান, তার অ্যাবসোলিউট পাথ। যদি এটি নির্দিষ্ট না করা হয়, তাহলে fastlane ফাইলটি যে লেনে তৈরি হয়েছে, সেখান থেকে এর অবস্থান নির্ধারণ করে।
   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"
   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	স্বয়ংক্রিয় পরীক্ষাগুলো অ্যাসিঙ্ক্রোনাসভাবে চালান। স্বয়ংক্রিয় পরীক্ষার ফলাফল জানতে ফায়ারবেস কনসোল দেখুন।
   debug	একটি বুলিয়ান ফ্ল্যাগ। বিস্তারিত ডিবাগ আউটপুট প্রিন্ট করার জন্য আপনি এটিকে ' true সেট করতে পারেন।

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        release = firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

fastlane <lane>

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

app: "1:1234567890:android:0a1b2c3d4e5f67890"