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

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

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 আপলোড করার ক্ষেত্রে প্রযোজ্য।

শুরু করার আগে

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

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

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

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

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

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

3. আপনার Firebase Android অ্যাপটি আপনার Google Play ডেভেলপার অ্যাকাউন্টের সাথে লিঙ্ক করুন:

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

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

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

   গুগল প্লেতে লিঙ্ক করা সম্পর্কে আরও জানুন।

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

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

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

   fastlane add_plugin firebase_app_distribution

   যদি কমান্ডটি আপনাকে একটি বিকল্পের জন্য অনুরোধ করে, Option 3: RubyGems.org ।

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

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

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

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

   firebase_app_distribution প্যারামিটার
   app	প্রয়োজনীয় : আপনার অ্যাপের Firebase অ্যাপ আইডি। আপনি Firebase কনসোলে, জেনারেল সেটিংস পৃষ্ঠায় অ্যাপ আইডিটি খুঁজে পেতে পারেন। app: "1:1234567890:android:0a1b2c3d4e5f67890"
   firebase_cli_token	Firebase সিএলআই দিয়ে আপনার সিআই পরিবেশ প্রমাণীকরণের সময় একটি রিফ্রেশ টোকেন মুদ্রিত হয় (আরও তথ্যের জন্য সিআই সিস্টেমের সাথে সিআই সিস্টেম ব্যবহার করুন পড়ুন)।
   service_credentials_file	আপনার Google পরিষেবা অ্যাকাউন্ট 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	নিম্নলিখিত বিতরণ প্রকারগুলি অটোমেটেড টেস্টার বিটা বৈশিষ্ট্যের অংশ। আপনি যে পরীক্ষামূলক ডিভাইসগুলিতে বিল্ড বিতরণ করতে চান ( 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 কনসোলটি দেখুন।
   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"