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

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

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

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

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

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

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

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

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

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

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

আপনি শুরু করার আগে

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

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

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

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

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

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

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

   fastlane add_plugin firebase_app_distribution

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

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

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

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

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

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