Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

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

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

যদি আপনি ইতিমধ্যেই না করে থাকেন তাহলে আপনার Android প্রকল্পে Firebase যোগ করুন

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

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

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

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

    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

    একটি রিফ্রেশ টোকেন যা প্রিন্ট করা হয় যখন আপনি প্লাগইন এর লগইন অ্যাকশন চালান (উপরে একটি Google অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ দেখুন), অথবা যখন আপনি 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"
    debug

    একটি বুলিয়ান পতাকা। ভার্বোস ডিবাগ আউটপুট প্রিন্ট করতে আপনি এটি true সেট করতে পারেন।

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(...)
        # build_android_app is a built-in fastlane action.
        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!"
        )
    end
end

বিল্ডটি পরীক্ষকদের কাছে উপলব্ধ করতে, আপনার লেনটি চালান:

fastlane <lane>

আপনি আপনার বিল্ড বিতরণ করার পরে, এটি 150 দিনের জন্য Firebase কনসোলের অ্যাপ ডিস্ট্রিবিউশন ড্যাশবোর্ডে উপলব্ধ। বিল্ডের মেয়াদ শেষ হওয়ার 30 দিন হলে, কনসোলে এবং পরীক্ষকের তাদের টেস্ট ডিভাইসে বিল্ডের তালিকায় একটি মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি প্রদর্শিত হয়।

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

(ঐচ্ছিক) প্রতিবার আপনি অ্যাপ ডিস্ট্রিবিউশনে একটি নতুন রিলিজ তৈরি করার সময় আপনার বিল্ড নম্বর স্বয়ংক্রিয়ভাবে বৃদ্ধি করতে, আপনি firebase_app_distribution_get_latest_release অ্যাকশন এবং উদাহরণস্বরূপ, increment_version_code fastlane প্লাগইন ব্যবহার করতে পারেন। নিম্নলিখিত কোডটি কীভাবে আপনার বিল্ড নম্বর স্বয়ংক্রিয়ভাবে বৃদ্ধি করতে হয় তার একটি উদাহরণ প্রদান করে:

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

firebase_app_distribution_get_latest_release অ্যাকশন সম্পর্কে আরও জানতে, আপনার অ্যাপের সর্বশেষ রিলিজ সম্পর্কে তথ্য পান দেখুন।

ধাপ 4 (ঐচ্ছিক)। বিতরণের জন্য পরীক্ষকদের ব্যবস্থাপনা

আপনি আপনার Fastfile ফাইল ব্যবহার করে বা সরাসরি ফাস্টলেন অ্যাকশন চালিয়ে আপনার অ্যাপ রিলিজ থেকে পরীক্ষকদের যোগ করতে এবং সরাতে পারেন। রানিং অ্যাকশন সরাসরি আপনার Fastfile সেট করা মানগুলিকে ওভাররাইড করে।

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

Fastfile ব্যবহার করুন

# Use lanes to add or remove testers from an app release.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

ফাস্টলেন অ্যাকশন চালান

fastlane run firebase_app_distribution_add_testers emails:"foo@google.com,bar@google.com"

fastlane run firebase_app_distribution_remove_testers emails:"foo@google.com,bar@google.com"

আপনি --emails এর পরিবর্তে --emails --file="/path/to/testers.txt ব্যবহার করে পরীক্ষকদেরও নির্দিষ্ট করতে পারেন।

firebase_app_distribution_remove_testers firebase_app_distribution_add_testers নিম্নলিখিত আর্গুমেন্টগুলি গ্রহণ করে:

  • project_name : আপনার ফায়ারবেস প্রকল্প নম্বর।
  • service_credentials_file : আপনার Google পরিষেবা শংসাপত্র ফাইলের পথ।
  • firebase_cli_token : Firebase CLI-এর জন্য প্রমাণীকরণ টোকেন।

service_credentials_file এবং firebase_cli_token হল একই আর্গুমেন্ট যা আপলোড ক্রিয়া দ্বারা ব্যবহৃত হয়।

ধাপ 5 (ঐচ্ছিক)। আপনার অ্যাপের সর্বশেষ প্রকাশ সম্পর্কে তথ্য পান

আপনি firebase_app_distribution_get_latest_release অ্যাকশন ব্যবহার করতে পারেন অ্যাপ ডিস্ট্রিবিউশনে আপনার অ্যাপের সাম্প্রতিক রিলিজ সম্পর্কে তথ্য আনতে, অ্যাপ সংস্করণের তথ্য, রিলিজ নোট এবং তৈরির সময় সহ। ব্যবহারের ক্ষেত্রে স্বয়ংক্রিয়ভাবে সংস্করণ বৃদ্ধি করা এবং পূর্ববর্তী রিলিজ থেকে রিলিজ নোটগুলি বহন করা অন্তর্ভুক্ত।

কর্মের রিটার্ন মান হল একটি হ্যাশ যা সর্বশেষ রিলিজের প্রতিনিধিত্ব করে। এই হ্যাশটি lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE] ব্যবহার করেও উপলব্ধ। এই হ্যাশে উপলব্ধ ক্ষেত্রগুলি সম্পর্কে আরও তথ্যের জন্য, REST API ডকুমেন্টেশন দেখুন।

পরামিতি

firebase_app_distribution_get_latest_release প্যারামিটার
app

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

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

একটি রিফ্রেশ টোকেন যা প্রিন্ট করা হয় যখন আপনি প্লাগইন এর লগইন অ্যাকশন চালান (উপরে একটি Google অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ দেখুন), অথবা যখন আপনি Firebase CLI-এর সাথে আপনার CI পরিবেশকে প্রমাণীকরণ করেন (আরো তথ্যের জন্য CI সিস্টেমের সাথে CLI ব্যবহার করুন পড়ুন)।

service_credentials_file

আপনার Google পরিষেবা অ্যাকাউন্ট json ফাইলের পথ। পরিষেবা অ্যাকাউন্টের শংসাপত্রগুলি ব্যবহার করে কীভাবে প্রমাণীকরণ করা যায় তার জন্য উপরে দেখুন।

debug

একটি বুলিয়ান পতাকা। ভার্বোস ডিবাগ আউটপুট প্রিন্ট করতে আপনি এটি true সেট করতে পারেন।

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

CI/CD ব্যবহার করে QA পরীক্ষকদের কাছে অ্যান্ড্রয়েড অ্যাপ বিতরণের সর্বোত্তম অনুশীলন শিখুন।