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

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

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

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

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

    fastlane add_plugin firebase_app_distribution

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

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

আপনি ফাস্টলেন প্লাগইন ব্যবহার করার আগে, আপনাকে প্রথমে আপনার ফায়ারবেস প্রকল্পের সাথে প্রমাণীকরণ করতে হবে। এটি অর্জন করার তিনটি উপায় রয়েছে:

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

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

    আপনার অ্যাপে ফায়ারবেস কনফিগারেশন ফাইল ( GoogleService-Info.plist ) না থাকলেই প্রয়োজন : আপনার অ্যাপের Firebase অ্যাপ আইডি। আপনি সাধারণ সেটিংস পৃষ্ঠায় Firebase কনসোলে অ্যাপ আইডি খুঁজে পেতে পারেন।

    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    আপনার GoogleService-Info.plist ফাইলের পাথ, আর্কাইভ করা প্রোডাক্ট পাথের সাপেক্ষে। ডিফল্টরূপে GoogleService-Info.plist সেট করুন।

    app প্যারামিটার অনির্দিষ্ট থাকলে ফাইলটি আপনার অ্যাপের Firebase অ্যাপ আইডি পেতে ব্যবহার করা হয়।

    firebase_cli_token

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

    service_credentials_file

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

    ipa_path

    apk_path প্রতিস্থাপন করে (অপ্রচলিত)। আপনি যে IPA ফাইলটি আপলোড করতে চান তার সম্পূর্ণ পথ। অনির্দিষ্ট থাকলে, ফাস্টলেন ফাইলের অবস্থান নির্ধারণ করে যে লেন থেকে ফাইলটি তৈরি করা হয়েছিল।

    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 :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_app is a built-in fastlane action.

        firebase_app_distribution(
            app: "1:123456789:ios: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_build_number অ্যাকশন ব্যবহার করতে পারেন। নিম্নলিখিত কোডটি কীভাবে আপনার বিল্ড নম্বর স্বয়ংক্রিয়ভাবে বৃদ্ধি করতে হয় তার একটি উদাহরণ প্রদান করে:

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

এই ফাস্টলেন প্লাগইন বৈশিষ্ট্য সম্পর্কে আরও জানতে, আপনার অ্যাপের সর্বশেষ প্রকাশ সম্পর্কে তথ্য পান দেখুন।

ধাপ 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

আপনার অ্যাপে ফায়ারবেস কনফিগারেশন ফাইল ( GoogleService-Info.plist ) না থাকলেই প্রয়োজন : আপনার অ্যাপের Firebase অ্যাপ আইডি। আপনি সাধারণ সেটিংস পৃষ্ঠায় Firebase কনসোলে অ্যাপ আইডি খুঁজে পেতে পারেন।

app: "1:1234567890:ios:0a1b2c3d4e5f67890"
googleservice_info_plist_path

আপনার GoogleService-Info.plist ফাইলের পাথ, আর্কাইভ করা প্রোডাক্ট পাথের সাপেক্ষে। ডিফল্টরূপে GoogleService-Info.plist সেট করুন।

app প্যারামিটার অনির্দিষ্ট থাকলে ফাইলটি আপনার অ্যাপের Firebase অ্যাপ আইডি পেতে ব্যবহার করা হয়।

firebase_cli_token

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

service_credentials_file

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

debug

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

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