Lane — এটি কী, Fastlane-এ তৈরি এবং ব্যবহার

Fastlane-এ Lane কী

Lane হল Fastlane-এর মৌলিক বিল্ডিং ব্লক যা একটি নামকৃত অটোমেশন স্ক্রিপ্ট সংজ্ঞায়িত করে। প্রতিটি lane ক্রিয়াগুলির একটি ক্রম বর্ণনা করে যা একটি নির্দিষ্ট লক্ষ্য অর্জনের জন্য কার্যকর করা হয়: একটি অ্যাপ্লিকেশন বিল্ড করা, টেস্ট চালানো, স্টোরে বিল্ড আপলোড করা বা পরিবেশ সেট আপ করা। Lane Fastfile-এ ঘোষণা করা হয় এবং প্রকল্প রুট থেকে fastlane [lane_name] কমান্ড দিয়ে চালানো হয়।

Lane ধারণাটি Ruby DSL থেকে নেওয়া এবং স্ক্রিপ্টের পঠনযোগ্যতা নিশ্চিত করে। ডেভেলপার সম্পূর্ণ CI/CD প্রক্রিয়াটিকে স্পষ্ট নাম এবং প্যারামিটার সহ ক্রিয়া কলের একটি ক্রম হিসাবে দেখেন। Lane সরল (একটি কমান্ড) বা জটিল (শাখা, লুপ, অন্যান্য lanes কল করা) হতে পারে।

এক্সিকিউশনের পরে, প্রতিটি lane একটি ফলাফল ফেরত দেয় — একটি অবজেক্ট যাতে এক্সিকিউশন স্থিতি এবং ক্রিয়াগুলির ডেটা থাকে। ফলাফল অন্যান্য lanes-এ ব্যবহার করা যেতে পারে বা সিদ্ধান্ত নেওয়ার জন্য CI/CD সিস্টেমে পাঠানো যেতে পারে। যদি lane-এর কোনো ক্রিয়া ব্যর্থ হয়, lane-এর এক্সিকিউশন বন্ধ হয়ে যায় এবং error ব্লক কল করা হয়।

Lane সিনট্যাক্স: ঘোষণা এবং চালানো

Lane ঘোষণা সিনট্যাক্স একটি সরল Ruby DSL প্যাটার্ন অনুসরণ করে: lane কীওয়ার্ড, Ruby প্রতীক (symbol) হিসাবে স্ক্রিপ্টের নাম, এবং do ... end ব্লক স্ক্রিপ্টের মূল অংশ সহ। Lane-এর নাম প্ল্যাটফর্মের মধ্যে অনন্য হতে হবে এবং অক্ষর, সংখ্যা এবং আন্ডারস্কোর নিয়ে গঠিত হতে পারে।

একটি lane কমান্ড লাইনের মাধ্যমে চালানো হয়: fastlane build (:build নামের lane-এর জন্য) বা bundle exec fastlane build (যদি Fastlane Bundler-এর মাধ্যমে ইনস্টল করা হয়)। প্ল্যাটফর্ম-নির্দিষ্ট lanes-এর জন্য, fastlane ios build বা fastlane android build ব্যবহার করুন।

# একটি সরল lane ঘোষণা
lane :test do
  scan(scheme: 'App', devices: ['iPhone 15'])
end

lane :build_and_deploy do
  cocoapods
  test
  gym(scheme: 'App', export_method: 'app-store')
  pilot(skip_waiting_for_build_processing: true)
end

# চালান: fastlane build_and_deploy

একটি lane-এ প্যারামিটার বা পরিবেশ চলকের উপর ভিত্তি করে শর্তযুক্ত যুক্তি থাকতে পারে। নির্দিষ্ট শর্তে ধাপগুলি এড়াতে if/unless ব্যবহার করুন। অ্যারে প্রক্রিয়াকরণের জন্য লুপ (each) উপলব্ধ, যা একটি একক lane-এ একাধিক টার্গেট বা অ্যাপ স্কিম বিল্ড করার জন্য সুবিধাজনক।

Lane থেকে মান ফেরত দেওয়া

একটি lane একটি মান ফেরত দিতে পারে যা কলিং কোডের জন্য উপলব্ধ হবে। মান ফেরত দিতে স্ট্যান্ডার্ড Ruby return বা lane ব্লকের শেষ এক্সপ্রেশন ব্যবহার করুন। ফেরত দেওয়া মান একটি স্ট্রিং, সংখ্যা, হ্যাশ বা কোনো ক্রিয়ার ফলাফল হতে পারে। এটি সিদ্ধান্ত নেওয়ার জন্য একটি lane-এর ফলাফল অন্য lane-এ ব্যবহার করার অনুমতি দেয়।

উদাহরণস্বরূপ, একটি :get_version lane Info.plist থেকে অ্যাপ্লিকেশনের বর্তমান সংস্করণ ফেরত দিতে পারে, এবং :deploy lane এটি একটি Slack বার্তা তৈরি করতে ব্যবহার করতে পারে। ফেরত দেওয়া মান বিশেষ করে private lanes-এ কার্যকর যেখানে কলিং lane-এ আরও প্রক্রিয়াকরণের জন্য ফলাফলের প্রয়োজন হয়।

Lanes-এর প্যারামিটার: পাস এবং প্রক্রিয়াকরণ

Lane প্যারামিটার স্ক্রিপ্টগুলিকে নমনীয় এবং পুনর্ব্যবহারযোগ্য করে তোলে। Lane options হ্যাশের মাধ্যমে প্যারামিটার গ্রহণ করে, যা কমান্ড লাইন থেকে চালানোর সময় পাস করা হয়: fastlane deploy scheme:AppStore version:2.1.0। Lane-এর ভিতরে, প্যারামিটার options[:scheme] এবং options[:version] হিসাবে উপলব্ধ।

বাধ্যতামূলক প্যারামিটার-এর জন্য, lane-এর শুরুতে মান পরীক্ষা করুন এবং একটি স্পষ্ট বার্তা সহ UI.user_error! কল করুন। ঐচ্ছিক প্যারামিটারের জন্য, || অপারেটরের মাধ্যমে ডিফল্ট মান সেট করুন। Fastlane প্রকার, ডিফল্ট মান এবং বিবরণ সহ options পদ্ধতির মাধ্যমে টাইপ করা প্যারামিটারও সমর্থন করে।

# প্যারামিটার পরিচালনা সহ Lane
lane :deploy do |options|
  scheme = options[:scheme]
  version = options[:version] || '1.0.0'
  beta = options[:beta] || false

  UI.user_error!("scheme নির্দিষ্ট করা হয়নি") unless scheme

  match(type: beta ? 'adhoc' : 'appstore')
  gym(scheme: scheme, export_method: beta ? 'ad-hoc' : 'app-store')

  if beta
    pilot(distribute_external: true)
  else
    deliver(submit_for_review: true)
  end
end

# চালান: fastlane deploy scheme:MyApp beta:true version:2.1.0

Lane-এর ভিতরে পরিবেশ চলক নিয়ে কাজ করতে, ENV['VARIABLE_NAME'] ব্যবহার করুন। Fastlane স্বয়ংক্রিয়ভাবে fastlane ডিরেক্টরি থেকে .env ফাইল লোড করে। এটি Fastfile-এ সংরক্ষণ না করে CI/CD পরিবেশে সংবেদনশীল ডেটা — API কী, পাসওয়ার্ড এবং টোকেন — পাস করার মানক উপায়।

প্যারামিটার বৈধকরণ

নির্ভরযোগ্য lane অপারেশনের জন্য, ইনপুটে প্যারামিটার বৈধকরণ প্রয়োজনীয়। যদি বাধ্যতামূলক প্যারামিটার অনুপস্থিত থাকে বা এর প্রকার ভুল হয়, তাহলে সমস্যা বিবরণ সহ UI.user_error! ব্যবহার করুন। Fastlane options পদ্ধতি প্রদান করে, যা প্রতিটি প্যারামিটারের জন্য প্রকার (String, Boolean, Integer, Array), ডিফল্ট মান এবং বিবরণ নির্দিষ্ট করার অনুমতি দেয় — lane শুরু হলে বৈধকরণ স্বয়ংক্রিয়ভাবে সম্পাদিত হয়।

অতিরিক্তভাবে, আপনি স্ট্রিং প্যারামিটারের জন্য verify ব্লকের মাধ্যমে পরীক্ষা ব্যবহার করতে পারেন: verify do |value| value.length > 0 end। যদি ফরম্যাট ভুল হয়, Fastlane প্রত্যাশিত ফরম্যাট এবং পাস করা মান নির্দেশ করে একটি স্পষ্ট বার্তা আউটপুট করে, যা CI/CD পরিবেশে ডিবাগিং সহজ করে।

Lanes একত্রিত করা: before_all, after_all এবং ত্রুটি পরিচালনা

Fastlane প্রতিটি lane-এর আগে এবং পরে কোড কার্যকর করার জন্য জীবনচক্র হুক প্রদান করে। before_all ব্লক একটি নির্দিষ্ট প্ল্যাটফর্মে বা বিশ্বব্যাপী প্রতিটি lane-এর আগে কার্যকর হয়। after_all ব্লক একটি lane সফলভাবে সম্পূর্ণ হওয়ার পরে কার্যকর হয়। error ব্লক lane-এর ভিতরে কোনো ত্রুটিতে কার্যকর হয়।

হুকগুলি পুনরাবৃত্ত যুক্তিকে কেন্দ্রীভূত করার অনুমতি দেয়: before_all-এ নির্ভরতা সেটআপ, after_all-এ বিজ্ঞপ্তি পাঠানো, অস্থায়ী ফাইল পরিষ্কার করা এবং error ব্লকে ত্রুটি বিজ্ঞপ্তি। এটি কোড পুনরাবৃত্তি হ্রাস করে এবং lanes পরিষ্কার রাখে।

# Lanes-এর জীবনচক্র হুক
default_platform(:ios)

before_all do
  cocoapods(try_repo_update_on_error: true)
  ensure_git_status_clean
end

after_all do |lane|
  slack(message: "Lane #{lane} সফলভাবে সম্পন্ন হয়েছে")
end

error do |lane, exception|
  slack(
    message: "Lane #{lane} ত্রুটির সাথে ব্যর্থ হয়েছে: #{exception}",
    success: false
  )
end

lane :deploy do
  match(type: 'appstore')
  gym(export_method: 'app-store')
  deliver
end

Error ব্লক দুটি আর্গুমেন্ট গ্রহণ করে: lane-এর নাম (symbol) এবং ব্যতিক্রম অবজেক্ট। ব্লকের ভিতরে, আপনি একটি Slack বিজ্ঞপ্তি পাঠাতে পারেন, একটি ফাইলে লগ লিখতে পারেন বা একটি বিকল্প পুনরুদ্ধার স্ক্রিপ্ট চালাতে পারেন। যদি error ব্লক সফলভাবে সম্পূর্ণ হয়, Fastlane CI/CD স্তরে বিল্ডটি ব্যর্থ বলে বিবেচনা করে না।

Private lanes এবং পুনর্ব্যবহার

Private lane হল একটি lane যা lane-এর পরিবর্তে private_lake-এর মাধ্যমে ঘোষণা করা হয়, যা উপলব্ধ কমান্ডের তালিকায় প্রদর্শিত হয় না এবং সরাসরি টার্মিনাল থেকে চালানো যায় না। Private lanes একাধিক পাবলিক lanes থেকে কল করা পুনরাবৃত্ত পদক্ষেপগুলিকে এনক্যাপসুলেট করার জন্য ডিজাইন করা হয়েছে।

Private lanes বিশেষ করে ক্রিয়াগুলির জটিল ক্রম-এর জন্য কার্যকর যা কঠোরভাবে সংজ্ঞায়িত ক্রমে কার্যকর করা আবশ্যক। উদাহরণস্বরূপ, একটি private lane :setup_signing বিভিন্ন প্যারামিটার সহ lanes :build_dev, :build_staging এবং :build_production থেকে কল করা যেতে পারে, কিন্তু নিজে থেকে একটি পৃথক কমান্ড হিসাবে এর কোনো অর্থ নেই।

# পুনর্ব্যবহারের জন্য Private lanes
private_lane :setup_environment do |options|
  cocoapods(try_repo_update_on_error: true)
  match(type: options[:type], readonly: true)
  increment_build_number
end

lane :dev_build do
  setup_environment(type: 'development')
  gym(export_method: 'development')
end

lane :appstore_build do
  setup_environment(type: 'appstore')
  gym(export_method: 'app-store')
  deliver
end

Private lanes অন্যান্য private lanes কল করতে পারে, একটি অ্যাবস্ট্রাকশন শ্রেণিবিন্যাস গঠন করে। Fastfile-এর পঠনযোগ্যতা বজায় রাখতে নেস্টিং গভীরতা 2–3 স্তরে সীমাবদ্ধ করার পরামর্শ দেওয়া হয়। প্রতিটি private lane-কে তার উদ্দেশ্য এবং প্রত্যাশিত প্যারামিটার বর্ণনাকারী মন্তব্য সহ ডকুমেন্ট করুন।

iOS এবং Android-এর জন্য lanes-এর উদাহরণ

আসুন iOS এবং Android প্রকল্পের জন্য lanes-এর ব্যবহারিক উদাহরণ দেখি। iOS lanes সাধারণত পরীক্ষার জন্য scan, সার্টিফিকেটের জন্য match, বিল্ডের জন্য gym এবং বিতরণের জন্য pilot বা deliver ব্যবহার করে। Android lanes বিল্ডের জন্য gradle, প্রকাশনার জন্য supply এবং ক্লাউড পরীক্ষার জন্য firebase_test_lab ব্যবহার করে।

// সম্পূর্ণ CI/CD iOS অ্যাপের জন্য Lane
lane :ci_full_ios do
  scan(scheme: 'App', code_coverage: true)
  gym(scheme: 'App', export_method: 'app-store')
  pilot(distribute_external: true)
  slack(message: 'iOS CI/CD সফলভাবে সম্পূর্ণ হয়েছে')
end

/* সম্পূর্ণ CI/CD Android অ্যাপের জন্য Lane */
lane :ci_full_android do
  gradle(task: 'testReleaseUnitTest')
  gradle(task: 'bundleRelease')
  supply(track: 'internal')
end

iOS এবং Android-এর জন্য lanes একত্রিত করে, আপনি একটি ক্রস-প্ল্যাটফর্ম অ্যাপ্লিকেশনের জন্য একটি একীভূত CI/CD প্রক্রিয়া তৈরি করতে পারেন। প্ল্যাটফর্ম-নির্দিষ্ট lanes গ্রুপ করতে প্ল্যাটফর্ম ব্লক platform :ios এবং platform :android ব্যবহার করুন এবং সেগুলিকে একটি সাধারণ অর্কেস্ট্রেটর lane থেকে কল করুন যা এক্সিকিউশন ক্রম পরিচালনা করে।

Lanes লেখার সেরা অনুশীলন

Lanes লেখার সময়, অনুশীলনের একটি সেট অনুসরণ করার পরামর্শ দেওয়া হয় যা স্ক্রিপ্টের পঠনযোগ্যতা, রক্ষণাবেক্ষণযোগ্যতা এবং নির্ভরযোগ্যতা নিশ্চিত করে। প্রথম নিয়ম হল প্রতিটি lane-এর একটি কাজ করা উচিত। যদি কোনো lane খুব বেশি করে, তবে এটিকে একাধিক lanes এবং private lanes-এ ভাগ করুন।

দ্বিতীয় নিয়ম হল lane-এর নামকরণ একটি ক্রিয়া বা ক্রিয়া বাক্যাংশ হওয়া উচিত: build, deploy, test, upload_screenshots। process বা do_all-এর মতো বিমূর্ত নাম এড়িয়ে চলুন। Lane-এর নামে শব্দ আলাদা করতে আন্ডারস্কোর ব্যবহার করুন।

তৃতীয় নিয়ম হল স্পষ্টভাবে ত্রুটিগুলি পরিচালনা করা। স্পষ্ট সমস্যা বার্তার জন্য UI.user_error! ব্যবহার করুন। Fastlane-এর ডিফল্ট ত্রুটি বার্তার উপর নির্ভর করবেন না — ডেভেলপারকে প্রসঙ্গ দিন: “GoogleService-Info.plist ফাইল পাওয়া যায়নি — এটি প্রকল্পে যোগ করুন” “ফাইল পাওয়া যায়নি”-এর পরিবর্তে।

চতুর্থ নিয়ম হল CI/CD-তে চালানোর আগে স্থানীয়ভাবে lanes পরীক্ষা করা। Fastlane --dry-run ফ্ল্যাগের মাধ্যমে ড্রাই-রান মোড সমর্থন করে, যা প্রকৃতপক্ষে চালানো ছাড়াই দেখায় কোন ক্রিয়াগুলি কার্যকর হবে। ইন্টিগ্রেশনের আগে পৃথক lanes-এর বিচ্ছিন্ন পরীক্ষার জন্য fastlane run_test ব্যবহার করুন।

Lanes-এর ডকুমেন্টেশন

প্রতিটি lane-এর ডকুমেন্টেশন টিম ডেভেলপমেন্টের জন্য একটি গুরুত্বপূর্ণ অনুশীলন। Fastlane lane ঘোষণার আগে রাখা desc ব্লক থেকে স্বয়ংক্রিয় ডকুমেন্টেশন জেনারেশন সমর্থন করে। fastlane lanes এবং fastlane list চালানোর সময় desc টেক্সট প্রদর্শিত হয়, যা ডেভেলপারদের Fastfile-এর সোর্স কোড না পড়েই প্রতিটি স্ক্রিপ্টের উদ্দেশ্য বুঝতে সাহায্য করে।

প্যারামিটার ডকুমেন্ট করতে, প্রত্যাশিত মান বর্ণনাকারী Ruby মন্তব্য ব্যবহার করুন। Fastlane fastlane generate_docs কমান্ডের মাধ্যমে lanes এবং তাদের বিবরণের সম্পূর্ণ তালিকা সহ README.md জেনারেট করতে পারে, যা প্রকল্পের CI/CD প্রক্রিয়ায় নতুন টিম সদস্যদের অন্তর্ভুক্ত করার জন্য সুবিধাজনক।