[Fastlane] Fastfile 에서 Ruby 파일(functions.rb) 공유하는 방법

Fastlane을 사용할 때, 반복적으로 사용하는 유틸리티 함수나 설정을 별도의 Ruby 파일(functions.rb)로 분리하면 유지보수성과 가독성이 좋아집니다. 아래는 그 2가지 방법입니다.

https://github.com/fastlane/fastlane

방법 1: require_relative를 사용하여 Fastfile에서 직접 불러오기

📌 프로젝트 구조

먼저, functions.rb 파일을 fastlane 디렉터리 안에 배치합니다.

project-root/
│── fastlane/
│   │── Fastfile
│   │── functions.rb
│── ios/
│── android/

📌 functions.rb 작성

# fastlane/functions.rb

def load_env(environment)
  puts "Loading environment: #{environment}"
  # 환경 변수 로드 로직 추가
end

def signing(type)
  puts "Setting up signing for #{type}"
  # 코드 서명 관련 처리 로직 추가
end

def build_ipa(type)
  puts "Building IPA for #{type}"
  # 빌드 관련 처리 로직 추가
end

def deploy_to_firebase_app_distribution
  puts "Deploying to Firebase App Distribution"
  # Firebase 업로드 관련 처리 로직 추가
end

📌 Fastfile에서 require_relative로 불러오기

# fastlane/Fastfile
require_relative 'functions'  # functions.rb 불러오기

platform :ios do
  desc "Build and upload app"
  lane :deploy do
    load_env("staging")  # .env 파일 로드
    signing("development")  # 코드 서명 동기화
    build_ipa("development")  # IPA 빌드
    deploy_to_firebase_app_distribution()  # Firebase에 업로드
  end
end

이제 Fastfile에서 functions.rb의 메서드를 직접 호출할 수 있습니다.

---

방법 2: Fastlane의 fastlane/actions 디렉터리를 활용하여 커스텀 액션으로 추가

Fastlane에서는 fastlane/actions 디렉터리에 사용자 정의 액션을 추가하면 자동으로 불러올 수 있습니다. 이 방식을 사용하면 Fastlane의 공식 액션처럼 일관되게 관리할 수 있습니다.

📌 프로젝트 구조

project-root/
│── fastlane/
│   │── Fastfile
│   │── actions/
│   │   │── print_hello.rb
│── ios/
│── android/

📌 간단한 Hello 메시지를 출력하는 액션 (print_hello.rb)

# fastlane/actions/print_hello.rb

module Fastlane
  module Actions
    class PrintHelloAction < Action
      # Fastlane 실행 시 실행되는 메서드
      def self.run(params)
        name = params[:name] || "Fastlane"  
        UI.message("👋 Hello, #{name}!")
      end

      # 액션에 대한 설명 (fastlane action print_hello 실행 시 표시됨)
      def self.description
        "간단한 Hello 메시지를 출력하는 액션"
      end

      # 사용 가능한 옵션 정의
      def self.available_options
        [
          FastlaneCore::ConfigItem.new(
          key: :name,               # 매개변수 키 (사용자가 전달할 값의 식별자)
          description: "출력할 이름", # 매개변수의 역할 설명 (Fastlane 문서에서 표시됨)
          optional: true,           # 선택적 매개변수 (입력하지 않아도 실행 가능)
          type: String              # 매개변수의 데이터 타입 (문자열)
          )
        ]
      end

      # 지원하는 플랫폼 정의 (true이면 모든 플랫폼에서 사용 가능)
      def self.is_supported?(platform)
        true
      end
    end
  end
end

📌 Fastfile에서 커스텀 액션 호출

# fastlane/Fastfile
platform :ios do
  lane :greet do
    print_hello(name: "Developer")  # "👋 Hello, Developer!" 출력
  end
end

이제 fastlane ios greet 명령을 실행하면 콘솔에 👋 Hello, Developer! 메시지가 출력됩니다.

---

📌 어떤 방법이 좋을까?

선택 기준	방법 1 (require_relative)	방법 2 (커스텀 액션)
설정 및 사용 편의성	✅ 간단하고 가벼움	❌ 초기 설정 필요
Fastlane 표준 방식	❌ 비표준 방식	✅ 공식적인 방식
재사용성	❌ 프로젝트 내에서만 사용	✅ 여러 프로젝트에서 활용 가능
Fastlane 문서화	❌ 별도 문서 필요	✅ 자동 문서 생성
팀 협업 및 유지보수	❌ 공유 어려움	✅ 관리 용이

📌 결론

• Fastfile에서 가볍게 유틸리티 함수를 호출하고 싶다면 → 방법 1 (require_relative) → 단일 프로젝트 내에서만 사용할 경우 간단한 방식이 적합함.

• 여러 프로젝트에서 재사용하거나 유지보수성을 높이고 싶다면 → 방법 2 (커스텀 액션) → 표준화된 방식으로 여러 프로젝트에서 사용 가능하며, 유지보수 및 확장성이 뛰어남.