[Fastlane] Fastlane을 통해 빌드를 자동화하자 1편

이채현

노션으로 보기

💡 필자는 React와 React Native를 이용해서 앱 개발 중인 6개월차 쌩 주니어 FE개발자이다. 실무에서 직접 하나하나 앱 빌드 작업이 아닌 fastlane을 통해 앱빌드를 자동화 하기위해 보았던 자료들과 겪었던 오류를 모아 내 입맛대로 다시보기와 공유 목적으로 작성한다. 프로젝트 구조, 코드 작성은 매우 주관적으로 적었기 때문에 피드백은 언제나 환영한다.

What is the Fastlane?

• ruby 코드로 만들어진 앱 배포 자동화 툴
• 커맨드라인으로 빌드 할 수 있음
• CI 시스템과의 통합 용이
• 여러 구성원이 App Store에 앱을 배포하거나 단일 장치에 앱을 설치할 때 별도의 코드 서명 ID가 필요하지만, fastlane의 match를 사용하여 하나의 중앙저장소를 만들 수 있음
  • 기존 배포 인증서는 팀원 각각 만들어야 하고, 만료 기한이 있었던 것과 달리 깃 저장소에 저장된 배포 인증서로 사용 가능
  • 단, 이중인증 필요하다는 한계 존재

Run Fastlane

01. setting

fastlane 설치 및 세팅

#1. Install the latest Xcode command line tools

xcode-select --install

#2. ruby 2.5.0이상 버전 다운로드 필요

• Homebrew를 이용한 설치

• macOS Sierra 기준으로, 맥에는 이미 ruby가 설치되어 있음

• 기본설치 되어 있는 Ruby가 오래된 버전이라면 rbenv를 다운로드 하여 버전관리를 하는 것이 좋음

  brew install rbenv ruby-build

• rbenv 초기화

• rbenv의 설치가 완료되었다면 아래에 명령어를 실행하여 rbenv을 초기화한다.

• 아래 명령어를 실행하면 다음과 같이 나온다

  rbenv init
  
  ---
  # Load rbenv automatically by appending
  # the following to ~/.bashrc_profile:*eval "$(rbenv init -)"`

• 위에 설명과 같이 .bashrc_profile 파일을 열고 아래와 같이 수정한다.

  eval "$(rbenv init -)" 또는
  eval "$(rbenv init - zsh)"
  
  # 그리고 아래 줄을 작성한다.
  export PATH=$HOME/bin:/usr/local/bin:$PATH

  source ~/.zshrc

• 루비 2.5.0 이상 설치

  rbenv install 3.1.2
  
  rbenv global 3.1.2 rbenv rehash
  
  ruby -v

#3. fastlane을 설치하는 두가지 방법

• Install fastlane using RubyGems

  sudo gem install fastlane -NV

• ✅ Alternatively using Homebrew

  brew install fastlane

  공식문서에서는 brew로 설치하는 방법을 권장

  이유: RubyGems로 설치할 경우 전역적으로 설치되어 rbenv를 사용하는 의미가 사라짐 → Homebrew로 설치하는 것을 권장

• 참고 링크

  https://jojoldu.tistory.com/288

  https://dev-yakuza.posstree.com/ko/ruby-on-rails/rails-on-mac/

02. Init Fastlane

fastlane을 위해 사용할 폴더 구조는 다양하다. 필자는 RN 프로젝트에서 다음과 같이 사용하고 있음.

#1. 프로젝트 최상위 루트에서 init 후 아래와 같은 폴더 구조 생성

bundle exec fastlane init

이후 4번 선택

root project |_ fastlane |_ android |Fastfile | ios |Fastfile | android |_ ios

#2. Fastfile설정

fastlane_require 'dotenv'

before_all do
end

import("./ios/Fastfile")
import("./android/Fastfile")

#3. env 설정

• Android와 iOS의 빌드를 위해 env를 분리시킨다.

  • 프로젝트 최상위 루트에 .env.FLAndroid, .env.FLIos 파일을 생성한다.

  env파일

  • .env.FAndroid

  # 개발
  
  APPCENTER_API_TOKEN={앱센터 토큰}
  APPCENTER_OWNER_NAME={"앱센터 사용자 이름"}
  APPCENTER_APP_NAME={"앱센터 앱 이름"}
  APPCENTER_DISTRIBUTE_APK="./android/app/build/outputs/apk/development/release/app-development-release.apk"
  
  # 상용
  
  JSON_KEY={"플레이스토어 API 액세스 키"}
  STORE_DISTRIBUTE_AAB="./android/app/build/outputs/bundle/productionRelease/app-production-release.aab"
  PACKAGE_NAME="앱 패키지 이름"

  • .env.FLIos

  IOS_PROJECT_PATH="./ios/project.xcodeproj"
  
  SIGNING_IDENTITY_DEBUG="Apple Development: "
  SIGNING_IDENTITY_RELEASE="Apple Distribution: "
  
  # 개발
  MATCH_ENV_PREFIX_DEVELOPMENT="sigh_io.project.dev_development"
  MATCH_ENV_PREFIX_DEVELOPMENT_EXT="sigh_io.project.dev.OneSignalNotificationServiceExtension-Dev_development"
  
  MATCH_ENV_PREFIX_ADHOC="sigh_io.project.dev_adhoc"
  MATCH_ENV_PREFIX_ADHOC_EXT="sigh_io.project.dev.OneSignalNotificationServiceExtension-Dev_adhoc"
  
  APPCENTER_API_TOKEN=앱센터 토큰
  APPCENTER_OWNER_NAME="앱센터 사용자 이름"
  APPCENTER_APP_NAME="앱센터 앱 이름"
  APPCENTER_DISTRIBUTE_IPA="./projectDev.ipa"
  
  # 상용
  MATCH_ENV_PREFIX_APPSTORE="sigh_io..project.app_appstore"
  MATCH_ENV_PREFIX_APPSTORE_EXT="sigh_io.project.app.OneSignalNotificationServiceExtension-Prod_appstore"
  
  STORE_DISTRIBUTE_IPA="./project.ipa"

#4. env 로드

platform :android do
    before_all do
        Dotenv.overload '../.env.FLAndroid'
				...
    end
		...
en

----------------------------------------------

platform :ios do
    before_all do
        Dotenv.overload '../.env.FLIos'
				...
    end
		...
en

#5. Appfile 셋팅 (환경변수 파일)

• 필요에 따라 작성하면 된다.

# app_identifier('io.project') # The bundle identifier of your app
apple_id('[email protected]') # Your Apple email address

# itc_team_id('####') # App Store Connect Team ID
# team_id("ABCDE") # Developer Portal Team ID

03. How to Run Fastlane

local에 설치 된 ruby 버전이 아닌 프로젝트에서 지정한 ruby버전을 사용하기 위해 bundle exec 명령어를 이용

bundle update --bunder
bundle exec fastane ....

Install Plugin

bundle exec fastlane add_plugin appcenter
bundle exec fastlane add_plugin load_json
bundle exec fastlane add_plugin yarn

# ... 등등 필요한 플러그인을 추가한다.

• add plugin 이후, fastlane 폴더 내 Pluginfile이 생성

  # Autogenerated by fastlane
  #
  # Ensure this file is checked in to source control!
  
  gem 'fastlane-plugin-appcenter'
  gem 'fastlane-plugin-load_json'
  gem 'fastlane-plugin-yarn'

• Pluginfile 생성 체크 후, 프로젝트 루트 디렉토리에 Gemfile 내에 생성된 경로와 일치한지 확인하기

  ...
  
  plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
  eval_gemfile(plugins_path) if File.exist?(plugins_path)

• 마무리

  bundle install
  # 이후, Gemfile.lock에 추가한 플러그인이 생겼는지 확인