iOS fastlane 설정하는 법

 

✅ 1. 사전 준비

필수 설치 항목

  • macOS

  • Xcode (App Store 또는 Apple Developer에서 설치)

  • Cocoapods (sudo gem install cocoapods)

  • Ruby (macOS에 기본 탑재되어 있음)

  • Node.js / npm

React Native CLI (npm install -g react-native-cli 또는 npx react-native 사용 가능)


✅ 2. Fastlane 설치

1. Fastlane 설치


sudo gem install fastlane -NV
  • -NV는 설치 로그를 자세히 보여주는 옵션입니다.

  • 문제가 발생하면 brew install fastlane으로 설치해도 됩니다 (권장: brew 방식은 시스템 격리 가능).

📌 참고: brew install fastlane 시, Fastlane이 시스템 Ruby 대신 Homebrew Ruby를 사용합니다.

2. Fastlane 초기화

프로젝트 루트 또는 ios/ 디렉토리로 이동하여 실행합니다.

cd ios fastlane init

3. init 옵션 선택

Fastlane은 아래와 같은 질문을 합니다:

  1. "What would you like to use fastlane for?"

    • 선택지:

      • 📦 Automate beta distribution to TestFlight

      • 🚀 Automate App Store distribution

      • 🧪 Manual setup

    일반적으로 TestFlight 배포 또는 App Store 배포를 선택합니다.

  2. Apple ID 입력

    • Apple Developer 계정 정보 입력.

  3. 앱 식별자 입력

    • ex) com.mycompany.myapp

Fastlane은 ios/fastlane/ 디렉토리 안에 다음 파일들을 생성합니다:

  • Fastfile: 작업(예: 배포, 테스트)을 정의

Appfile: 앱 및 계정 정보 저장

✅ 3. Fastlane 기본 설정

Appfile 예시

app_identifier("com.mycompany.myapp") apple_id("your@email.com") team_id("XXXXXXXXXX") # Apple Developer 팀 ID

Fastfile 기본 배포 lane 예시

default_platform(:ios) platform :ios do desc "Deploy to TestFlight" lane :beta do build_app(scheme: "MyApp") upload_to_testflight end end

✅ 4. 인증서 및 프로비저닝 프로파일 설정

1. match (공식 인증서 관리 도구) 설정

fastlane match init

2. 인증서/프로파일을 저장할 Git 저장소 설정

fastlane match development fastlane match appstore

참고: match 사용 시 인증서/프로파일이 Git 저장소에 암호화되어 저장됩니다.


✅ 5. 실제 배포 예시

TestFlight에 배포

fastlane beta

App Store에 배포 (심사 제출 포함)

lane :release do capture_screenshots build_app(scheme: "MyApp") upload_to_app_store( skip_screenshots: true, skip_metadata: true ) end

fastlane release 

댓글

이 블로그의 인기 게시물

비주얼 스튜디오 코드에서 깃허브에 프로젝트 올리는 법

Git rebase Github에 다시 프로젝트 올리기

React Native 앱에서 ProGuard 난독화 설정