Flutter Fastlane CI/CD(1) - iOS

1. Fastlane 설치

brew install fastlane
or
sudo gem install fastlane

homebrew 나 RubyGem 을 통해 Fastlane 을 설치할 수 있습니다. 공식문서 에 따르면, Gem 은 Ruby 환경에 의존하기 때문에 brew 로 설치하는 것을 추천한다고 합니다

 

2. Fastlane init

cd ios/
fastlane init

fastlane init 명령어를 입력하면 Setup 종류를 물어보는 콘솔창이 나옵니다. Manual Setup을 할 것이기에 4번을 입력합니다

3. Fastlane Match 설정 (선택적)

Fastlane Match 란, Fastlane 안에 있는 코드 사이닝 방법의 한 종류입니다.

간략히 말하자면, 인증서와 프로파일을 하나의 원격 저장소에 업로드 하고, 팀원들이 해당 인증서와 프로파일을 공유하여 코드 사이닝을 단순화 하는 방법입니다.

Provisioning Profile 에는 앱 ID, 앱 실행이 허용된 Device ID, 애플에서 발급한 인증서가 포함되어 있으며, 각 개발자의 환경이 다르기 때문에 서로 다른 Profile 이 생성됩니다. 따라서 Match 를 통해 인증서와 프로파일을 공유하면, 코드 사이닝 관리 측면에서 유용하게 사용될 수 있습니다.

인증서와 프로파일을 저장 할 원격 저장소를 생성해줍니다

 

3-2. Fastlane Match Init

 

match init 명령어를 입력하면 Storage mode 로 git 을 선택하고, git 주소를 입력합니다. 설정이 다 끝나면 Fastlane 폴더에 MatchFile이 생성됩니다.

3-3. MatchFile 수정

MatchFile 에서 Default Type 을 appstore 로 변경해줍시다.

 

3-4. 기존의 개발, 배포 인증서 파기

fastlane match nuke development
fastlane match nuke distribution

인증서 파기 명령어를 입력하면, passphase 를 등록하는 화면이 나올 수 있습니다.

3-5. 새로운 개발, 배포 인증서 생성

fastlane match development 
fastlane match appstore

팀원들이 공유 할 인증서를 생성합니다. 두 명령어를 모두 입력하면, Matchfile 에 등록된 원격 저장소에 인증서와 프로파일이 올라가게 됩니다.

 

3-6. Xcode Code Signing 확인

TARGETS/Signing&Capabilities/All/Signing/Provisioning Profile

Xcode에 들어가 Provisioning Profile 을 match [...] packageName 으로 변경해줍니다.

4. Fastlane Firebase Distribution 설정

Fastlane 을 이용하여 Firebase App Distribution 에 배포하려면 플러그인 설치, 인증 등을 해야 합니다.

 

4-1. Firebase Plugin 설치

 

fastlane add_plugin firebase_app_distribution

Firebase 플러그인을 설치할 때 Your user account isn't allowed... 라는 메세지가 나오면서 Password 를 입력하라고 할 수도 있는데, 그냥 Mac password 입력하고 넘어갑니다.

4-2. Firebase 로그인

 

fastlane run firebase_app_distribution_login​

CLI로 Firebase 에 로그인 하는 과정입니다. 커맨드 입력 시 접속할 수 있는 링크 URL 이 터미널에 보일텐데, 접속해서 Firebase 인증 해주시면 Refresh Token 이 날아옵니다. 해당 토큰은 잘 보관해주세요.

 

5. 환경변수[ENV] 설정

각 개발자 마다 AppleID, Firebase Refresh Token 등이 환경에 따라 달라질 수 있는데, Fastlane 에서는 .env 파일로 환경변수를 관리하여 서로 다른 환경에서도 동일한 Lane 을 사용할 수 있습니다.

 

# Appfile
app_identifier("com.test.test") 
apple_id(ENV["APPLE_ID"]) 

# .env 
APPLE_ID="..."

Fastlane 폴더 안의 Appfile 입니다. app_identifier 는 어느 환경에서나 동일하지만, apple_id 는 개발자 마다 다르기 때문에 환경변수로 치환합니다.

 

6. Xcode 수정

$(FLUTTER_BUILD_NAME)으로 되어있는 부분을 현재 버전(ex 1.0.4)로 하드코딩합니다(최초 1회)

7. Firebase Distribution Lane 생성

7-1. Firebase 설정이 끝났으니, 이제 Firebase App Distribution 에 Upload 하는 Lane 을 생성합니다.

  # Firebase Distribution
  desc "Push a new beta build with Firebase App Distribution"
  lane :firebase do
    match(type:"adhoc")

    increment_build_number(
        build_number: latest_testflight_build_number + 1
    )

    build_app(
      workspace: "Runner.xcworkspace",
      scheme: "Runner",
    )

    firebase_app_distribution(
      app: ENV["IOS_FIREBASE_APP_DISTRIBUTION_APP"],
      firebase_cli_token: "4-2. Firebase 로그인에서 받은 Refresh Token",
      groups: "test",
      release_notes: "test"
    )
  end

firebase_cli_token: 4-2. Firebase 로그인에서 받은 Refresh Token

groups: Firebase App Distribution에 있는 “테스트 및 그룹”항목의 테스트 그룹 이름

 

7-2 Firebase 에 배포

fastlane firebase 를 터미널에 입력합니다.(fastlane + lane이름)

 

8. TestFlight Ditribution Lane 생성

8-1. FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD 설정

appleid.apple.com/account/manage 에 들어가서 보안 쪽에 앱 암호 생성을 눌러 암호를 생성 후 복붙하여 보관해주세요.

8-2. dotenv 설정

아래 명령어로 dotenv를 설치해주세요 

sudo gem install dotenv

아래 명령어로 env파일을 만들어주세요

touch .env

생성된 env파일을 열어주세요

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD = "chkl-jpdl-xutb-bqmw"이렇게 작성해줍니다.

 

8-3. TestFlight 에 배포

  # TestFlight
  desc "build app and upload to testflight"
  lane :beta do
    match(type: "appstore")

    increment_build_number(
        build_number: latest_testflight_build_number + 1
    )
    build_app(
      configuration: "Release"
    )
    upload_to_testflight
  end

fastlane beta 를 터미널에 입력합니다.(fastlane + lane이름)

 

---

iOS 버전 및 빌드번호 자동 수정 배포

 

[lane설명]

firebase_release : private_lane :set_version을 통해 버전 빌드 번호를 1씩 올린 후 Firebase에 배포합니다

firebase : increment_build_number(xcodeproj: "Runner.xcodeproj")를 통해 빌드 번호만 1올린 후 Firebase에 배포합니다

beta : increment_build_number(xcodeproj: "Runner.xcodeproj")를 통해 빌드 번호를 1 올린 후 Testflight에 업로드합니다

private_lane :set_version : increment_version_number(xcodeproj: "Runner.xcodeproj"), increment_build_number(xcodeproj: "Runner.xcodeproj")를 통해 버전 및 빌드 번호를 1씩 올려줍니다.

default_platform(:ios)

platform :ios do

  desc "Upload Release IPA fo Firebase Distribution"
  lane :firebase_release do
    match(type:"adhoc")
    set_version
    build
    firebase_upload(release: true)
  end

  desc "Version Setting"
  private_lane :set_version do

    increment_version_number(xcodeproj: "Runner.xcodeproj")
    increment_build_number(xcodeproj: "Runner.xcodeproj")

  end

  desc "Build"
  private_lane :build do |options|
    build_app(
      workspace: "Runner.xcworkspace",
      scheme: "Runner",
      configuration: "Release"
    )
  end

  desc "Upload Firebase"
  private_lane :firebase_upload do |options|
    firebase_app_distribution(
      app: ENV["IOS_FIREBASE_APP_DISTRIBUTION_APP"],
      firebase_cli_token: "4-2. Firebase 로그인에서 받은 Refresh Token",
      groups: "test",
      release_notes: "test"
    )
  end

  desc "Description of what the lane does"
  lane :custom_lane do
    # add actions here: https://docs.fastlane.tools/actions
  end
  # Firebase Distribution
  desc "Push a new beta build with Firebase App Distribution"
  lane :firebase do
    match(type:"adhoc")

    increment_build_number(xcodeproj: "Runner.xcodeproj")

    build_app(
      workspace: "Runner.xcworkspace",
      scheme: "Runner",
    )

    firebase_app_distribution(
      app: ENV["IOS_FIREBASE_APP_DISTRIBUTION_APP"],
      firebase_cli_token: "4-2. Firebase 로그인에서 받은 Refresh Token",
      groups: "test",
      release_notes: "test"
    )
  end

  # TestFlight
  desc "build app and upload to testflight"
  lane :beta do
    match(type: "appstore")

    increment_build_number(xcodeproj: "Runner.xcodeproj")

    build_app(
      configuration: "Release"
    )
    upload_to_testflight
  end
end

 

 

 

 

---

iOS는 배포완료 후 appstore connect에서 수출 규정 정보 설정을 해줘야 합니다

하단의 “위에 언급된 알고리즘에 모두 해당하지 않음”을 선택해줍니다.