Fastfile: সারমর্ম, কাঠামো এবং মোবাইল ডেভেলপমেন্টে অটোমেশন সেট আপ করা

Fastfile কী এবং কেন এটি প্রয়োজন

Fastfile হল Fastlane-এর প্রধান কনফিগারেশন ফাইল, যা Ruby তে লেখা এবং প্রকল্পের রুটে fastlane ডিরেক্টরিতে রাখা হয়। এটি অ্যাপ্লিকেশন বিল্ড, টেস্টিং, কোড সাইনিং এবং ডেলিভারির জন্য সমস্ত অটোমেশন পরিস্থিতি (lanes) নির্ধারণ করে। Fastfile ডজন ডজন bash স্ক্রিপ্ট, Makefile এবং ম্যানুয়াল নির্দেশকে একটি একক ঘোষণামূলক CI/CD পাইপলাইন বিবরণ দিয়ে প্রতিস্থাপন করে।

Fastfile-এর প্রয়োজনীয়তা দেখা দেয় যখন প্রকল্পের বিভিন্ন ডেভেলপার মেশিন এবং CI/CD সার্ভারে পুনরাবৃত্তিযোগ্য বিল্ড প্রয়োজন হয়। প্রতিটি ডেভেলপার ম্যানুয়ালি পরিবেশ সেট আপ করার পরিবর্তে, Fastfile সমস্ত ধাপ কোডে ক্যাপচার করে যা Git-এ সংস্করণ করা, পর্যালোচনা করা এবং প্রকল্পগুলির মধ্যে পুনরায় ব্যবহার করা যেতে পারে। একটি একক Fastfile নিশ্চিত করে যে ডেভেলপারের মেশিনে বিল্ড CI/CD সার্ভারে বিল্ডের মতোই।

Fastfile default_platform নির্দেশের মাধ্যমে প্ল্যাটফর্ম সমর্থন করে। একটি Fastfile-এ iOS, Android এবং macOS-এর জন্য পরিস্থিতি বর্ণনা করা যেতে পারে, সেগুলোকে platform :ios এবং platform :android ব্লকে গ্রুপ করে। এটি ক্রস-প্ল্যাটফর্ম প্রকল্পের জন্য বিশেষভাবে উপযোগী যেখানে iOS এবং Android বিল্ডের সাধারণ ডিপ্লয় যুক্তি আছে কিন্তু ভিন্ন বিল্ড টুল ব্যবহার করে।

Fastfile কাঠামো: lanes, actions এবং প্যারামিটার

Fastfile তিনটি প্রধান উপাদান নিয়ে গঠিত: প্ল্যাটফর্ম ঘোষণা (default_platform), lanes সংজ্ঞা এবং সহায়ক ফাংশন কনফিগারেশন। প্রতিটি lane কীওয়ার্ড lane দিয়ে শুরু হয়, তারপরে পরিস্থিতির নাম (Ruby সিম্বল), ক্রিয়ার ক্রম সহ বডি এবং ত্রুটি হ্যান্ডলিং ব্লক — error, success বা ensure।

Fastfile-এ Actions হল Hash আকারে প্যারামিটার সহ বিল্ট-ইন Fastlane ফাংশনে কল। উদাহরণস্বরূপ, gym(scheme: 'App', export_method: 'app-store') নির্দিষ্ট প্যারামিটার সহ iOS অ্যাপ বিল্ড শুরু করে। প্রতিটি action একটি ফলাফল ফেরত দেয় যা একটি ভেরিয়েবলে সংরক্ষণ করা যায় এবং পরবর্তী actions-এ ব্যবহার করা যায় — এটি একটি lane-এর ভিতরে শর্তসাপেক্ষ যুক্তি সক্ষম করে।

Fastfile Ruby-র মানক ENV প্রক্রিয়ার মাধ্যমে এনভায়রনমেন্ট ভেরিয়েবল সমর্থন করে। সংবেদনশীল ডেটা (পাসওয়ার্ড, টোকেন, কী) Fastfile-এ সংরক্ষণ করা উচিত নয় — CI/CD সিস্টেম এনভায়রনমেন্ট ভেরিয়েবল বা .gitignore-এ যোগ করা .env ফাইল ব্যবহার করুন। Fastlane স্টার্টআপে fastlane ডিরেক্টরি থেকে .env ফাইল স্বয়ংক্রিয়ভাবে লোড করে।

Appfile এবং Matchfile

Fastfile-এর পাশাপাশি fastlane ডিরেক্টরিতে অতিরিক্ত কনফিগারেশন ফাইল অবস্থিত। Appfile-এ অ্যাপ্লিকেশন আইডেন্টিফায়ার (app_identifier), Apple ID এবং Team ID থাকে — এই ডেটা স্বয়ংক্রিয়ভাবে সমস্ত actions-এ প্রতিস্থাপিত হয়, প্রতিটি lane-এ পুনরাবৃত্তি দূর করে। Matchfile match-এর জন্য সেটিংস সংরক্ষণ করে: Git রিপোজিটরি URL, প্রোফাইল টাইপ এবং এনক্রিপশন কী।

কনফিগারেশন একাধিক ফাইলে বিভক্ত করা ভিন্ন পরিবেশের প্রকল্প রক্ষণাবেক্ষণ সহজ করে। উদাহরণস্বরূপ, staging এবং production-এর জন্য, Matchfile রিপোজিটরিতে আলাদা শাখা তৈরি করা যেতে পারে বা CI/CD সিস্টেমে এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে প্যারামিটার ওভাররাইড করা যেতে পারে।

# Fastfile-এর মৌলিক কাঠামো
default_platform(:ios)

lane :build_and_test do
  cocoapods
  scan(scheme: 'App', devices: ['iPhone 15'])
  gym(scheme: 'App')
end

lane :deploy do
  match(type: 'appstore')
  build_and_test
  pilot(skip_waiting_for_build_processing: true)
end

Fastfile সিনট্যাক্স: lanes লেখা

Fastfile সিনট্যাক্স Ruby DSL (ডোমেইন-স্পেসিফিক ল্যাঙ্গুয়েজ) এর উপর ভিত্তি করে, যা বিশেষভাবে অটোমেশন পরিস্থিতির পঠনযোগ্যতার জন্য ডিজাইন করা হয়েছে। Lane ঘোষণা করা হয় lane :name do ... end নির্মাণের মাধ্যমে, যেখানে name হল একটি Ruby সিম্বল যা টার্মিনাল বা CI/CD সিস্টেম থেকে চালানোর জন্য fastlane name কমান্ড হয়ে যায়।

একটি lane-এর ভিতরে যুক্তির শাখার জন্য Ruby শর্তসাপেক্ষ অপারেটর: if, unless, case ব্যবহার করা যেতে পারে। মানের অ্যারে প্রক্রিয়াকরণের জন্য লুপ each এবং while-ও উপলব্ধ। Fastlane lane জীবনচক্র ইভেন্ট হ্যান্ডলিংয়ের জন্য বিশেষ পদ্ধতি before_all, after_all এবং error ব্লক সরবরাহ করে।

Lane প্যারামিটার options হ্যাশের মাধ্যমে পাস করা হয়। fastlane build --option_name value চালানোর সময়, মান lane-এর ভিতরে options[:option_name]-এ যায়। পাস করা প্যারামিটারের ধরন নিয়ন্ত্রণের জন্য optional: true এবং টাইপ ভ্যালিডেশনের মাধ্যমে ডিফল্ট মান সেট করা যেতে পারে।

# প্যারামিটার এবং শর্তসাপেক্ষ যুক্তি সহ Lane
lane :build do |options|
  scheme = options[:scheme] || 'App'
  export_method = options[:export_method] || 'development'

  match(type: export_method)

  if export_method == 'appstore'
    gym(scheme: scheme, export_method: 'app-store')
    pilot(skip_waiting_for_build_processing: true)
  else
    gym(scheme: scheme, export_method: export_method)
  end
end

iOS ডেলিভারির জন্য Fastfile উদাহরণ

একটি iOS প্রকল্পের জন্য সম্পূর্ণ Fastfile-এ নির্ভরতা ইনস্টলেশন, টেস্টিং, বিল্ড এবং TestFlight ও App Store-এ ডিপ্লয়ের জন্য lanes অন্তর্ভুক্ত থাকে। আসুন একটি উদাহরণ দেখি যা কমিট থেকে অভ্যন্তরীণ টেস্টিংয়ের জন্য TestFlight-এ প্রকাশনা পর্যন্ত সাধারণ CI/CD প্রক্রিয়া কভার করে।

# iOS CI/CD ডেলিভারির জন্য Fastfile
default_platform(:ios)

before_all do
  cocoapods(try_repo_update_on_error: true)
  setup_travis if ENV['TRAVIS']
end

lane :tests do
  scan(
    scheme: 'App',
    devices: ['iPhone 15', 'iPad Pro 12.9'],
    output_directory: './test_reports'
  )
end

lane :build_appstore do
  match(type: 'appstore', readonly: true)
  gym(
    scheme: 'App',
    export_method: 'app-store',
    include_bitcode: true
  )
end

lane :deploy_testflight do
  build_appstore
  pilot(
    skip_waiting_for_build_processing: true,
    distribute_external: false
  )
  slack(
    message: 'অভ্যন্তরীণ টেস্টিংয়ের জন্য TestFlight-এ বিল্ড আপলোড করা হয়েছে'
  )
end

এই উদাহরণে, before_all ব্লক প্রতিটি lane-এর আগে সম্পাদিত হয় এবং নির্ভরতা ইনস্টল করে। tests lane দুটি ডিভাইসে UI এবং ইউনিট টেস্ট চালায়। build_appstore lane match-এর মাধ্যমে কোড সাইন করে এবং bitcode সহ IPA বিল্ড করে। deploy_testflight lane সম্পূর্ণ ডেলিভারির জন্য সমস্ত ধাপ একত্রিত করে।

একাধিক টার্গেট সহ ডিপ্লয়মেন্ট

একাধিক টার্গেট (মূল অ্যাপ, watchOS, widget, Notification Service Extension) সহ প্রকল্পগুলির প্রতিটি টার্গেটের জন্য আলাদা lanes প্রয়োজন। Fastfile-এ একটি সার্বজনীন lane :deploy_target তৈরি করা যেতে পারে যা স্কিমা নাম এবং বিল্ড পাথ প্যারামিটার হিসাবে গ্রহণ করে। এটি fastlane deploy_target scheme:Widget-এর মাধ্যমে সমস্ত এক্সটেনশনের জন্য ডিপ্লয় চালানোর অনুমতি দেয়।

একাধিক টার্গেট সংগঠিত করতে, স্কিমার একটি অ্যারে এবং lane-এর ভিতরে each লুপ ব্যবহার করুন। Fastlane parallel: true ফ্ল্যাগের মাধ্যমে একাধিক স্কিমার সমান্তরাল বিল্ড সমর্থন করে, যা এক্সটেনশন সহ অ্যাপের জন্য মোট CI/CD পাইপলাইন সময় হ্রাস করে।

Android বিল্ডের জন্য Fastfile উদাহরণ

Android প্রকল্পের জন্য Fastfile Gradle টাস্ক চালানোর জন্য gradle action এবং Google Play-তে প্রকাশনার জন্য supply action ব্যবহার করে। iOS-এর বিপরীতে, Android-এর match প্রয়োজন হয় না, তবে এটি সাইনিংয়ের জন্য Keystore ব্যবহার করে, যা রিপোজিটরির বাইরে সংরক্ষিত এবং এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে পাস করা হয়।

# Android CI/CD বিল্ডের জন্য Fastfile
default_platform(:android)

lane :build_release do
  gradle(task: 'clean')
  gradle(task: 'bundleRelease')
  gradle(task: 'assembleRelease')
end

lane :deploy_internal do
  build_release
  supply(
    track: 'internal',
    aab: 'app/build/outputs/bundle/release/app-release.aab',
    release_status: 'completed'
  )
end

Android অ্যাপ্লিকেশন সাইনিং-এর জন্য, build.gradle-এ signingConfigs কনফিগার করুন এবং এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে Keystore প্যারামিটার পাস করুন: ANDROID_KEYSTORE_PATH, ANDROID_KEYSTORE_PASSWORD, ANDROID_KEY_ALIAS এবং ANDROID_KEY_PASSWORD। Fastlane স্বয়ংক্রিয়ভাবে বিল্ড করা AAB বা APK সাইন করতে সিস্টেম apksigner ব্যবহার করে।

Fastfile-এ Android সাইনিং

Fastfile-এ Android সাইনিং কনফিগার করতে, sign_android action ব্যবহার করুন বা build.gradle-এ signingConfigs-এর উপর নির্ভর করুন। Fastlane Gradle-এর মাধ্যমে apksigner-এর সাথে সংহত হয় — gradle টাস্কে SIGNING_CONFIG ফ্ল্যাগ পাস করলে এনভায়রনমেন্ট ভেরিয়েবল থেকে প্যারামিটার সহ সাইনিং সক্রিয় হয়। এটি Google Play Console-এ আপলোড করার আগে AAB ফাইল সাইন করার অনুমতি দেয়।

CI/CD-তে Keystore-এর নিরাপদ স্টোরেজের জন্য, Base64 এনকোডিং এবং এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন। Fastlane setup_keystore action সমর্থন করে, যা একটি ভেরিয়েবল থেকে Keystore ডিকোড করে এবং before_all পর্যায়ে একটি অস্থায়ী ফাইলে সংরক্ষণ করে। Lane সম্পূর্ণ হওয়ার পরে, সার্টিফিকেট ফাঁস রোধ করতে অস্থায়ী ফাইল স্বয়ংক্রিয়ভাবে মুছে ফেলা হয়।

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

Private lanes (ব্যক্তিগত পরিস্থিতি) হল lanes যা সরাসরি কমান্ড লাইন থেকে কল করা যায় না, কিন্তু Fastfile-এর ভিতরে অন্যান্য lanes থেকে কলের জন্য উপলব্ধ। Private lane ঘোষণা করা হয় private_lane :name do ... end নির্মাণের মাধ্যমে এবং পুনরাবৃত্তিমূলক ধাপগুলো এনক্যাপসুলেট করতে ব্যবহৃত হয় যা স্বাধীন পরিস্থিতি হিসাবে অর্থপূর্ণ নয়।

Private lanes পুনরাবৃত্তিমূলক যুক্তি গ্রুপ করার জন্য আদর্শ: নির্ভরতা ইনস্টলেশন, পরিবেশ সেটআপ, বিজ্ঞপ্তি পাঠানো। উদাহরণস্বরূপ, একটি private lane :setup_signing তৈরি করা যেতে পারে যা একাধিক ডিপ্লয় lanes থেকে কল করা হয়, কিন্তু ত্রুটি এড়াতে ডেভেলপার দ্বারা সরাসরি সম্পাদনের জন্য উপলব্ধ হওয়া উচিত নয়।

# Private lane এবং গ্রুপিং
default_platform(:ios)

private_lane :setup_signing do |options|
  match(
    type: options[:type],
    readonly: true,
    verbose: false
  )
end

lane :beta do
  setup_signing(type: 'adhoc')
  gym(export_method: 'ad-hoc')
  pilot(distribute_external: true)
end

lane :release do
  setup_signing(type: 'appstore')
  gym(export_method: 'app-store')
  deliver(
    force: true,
    submit_for_review: true
  )
end

platform ব্লকের মাধ্যমে lanes গ্রুপিং একটি Fastfile-এ iOS এবং Android পরিস্থিতি আলাদা করার অনুমতি দেয়। platform :ios do ... end এবং platform :android do ... end নির্মাণ সংশ্লিষ্ট প্ল্যাটফর্মের lanes আলাদা করে, যখন সাধারণ private lanes পুনরায় ব্যবহারের জন্য প্ল্যাটফর্ম ব্লকের বাইরে রাখা যেতে পারে।

Lanes এ প্যারামিটার পাস করা

Fastfile-এর প্যারামিটার প্রক্রিয়া lanes কে নমনীয় এবং পুনরায় ব্যবহারযোগ্য করতে দেয়। প্যারামিটার রানটাইমে কমান্ড লাইনের মাধ্যমে পাস করা হয়: fastlane build scheme:App export_method:appstore। Lane-এর ভিতরে, মান options হ্যাশের মাধ্যমে অ্যাক্সেসযোগ্য, যা lane ব্লকে একটি আর্গুমেন্ট হিসাবে পাস করা হয়।

Fastlane OptionalHash-এর মাধ্যমে ভ্যালিডেশন সহ টাইপকৃত প্যারামিটার সমর্থন করে। মানের ধরন (String, Boolean, Integer), একটি ডিফল্ট মান এবং ডকুমেন্টেশন স্বয়ংক্রিয়ভাবে তৈরি করার জন্য একটি বিবরণ নির্দিষ্ট করা যেতে পারে। এনভায়রনমেন্ট ভেরিয়েবলও প্যারামিটার পাস করার বিকল্প উপায় হিসাবে উপলব্ধ, যা CI/CD সিস্টেমের জন্য সুবিধাজনক।

# টাইপ ভ্যালিডেশন সহ প্যারামিটার
lane :build do |options|
  gym(
    scheme: options[:scheme],
    export_method: options[:export_method] || 'development',
    include_bitcode: options[:include_bitcode] || false,
    output_name: options[:output_name]
  )
  slack(message: "বিল্ড #{options[:scheme]} সম্পন্ন হয়েছে")
end

# চালান: fastlane build scheme:MyApp export_method:appstore

সমস্ত ঐচ্ছিক প্যারামিটারের জন্য ডিফল্ট মান ব্যবহার করার পরামর্শ দেওয়া হয়, যাতে lane প্রতিটি আর্গুমেন্ট স্পষ্টভাবে নির্দিষ্ট না করেই চালানো যায়। প্রয়োজনীয় প্যারামিটারের জন্য, lane-এর শুরুতে তাদের উপস্থিতি পরীক্ষা করুন এবং UI.user_error!-এর মাধ্যমে স্পষ্ট ত্রুটি বার্তা দিয়ে সম্পাদন বন্ধ করুন।