Flutter Fastlane CI/CD(2) - Android

1. Fastlane init

 

cd android/
fastlane init​

Android 폴더로 이동하셔서, init 명령어를 입력합니다.

초기에 패키지 이름을 입력하라고 나옵니다. 패키지 이름(com.example.example)이 기억나지 않으신다면, app/build.gradle 파일 가셔서 applicationId 항목에 있는 패키지 이름을 가져옵니다.

 

2. Json Secret File

 

패키지 이름을 입력하면, json secret file 경로를 넣으라고 합니다. (json_secret_file? Fastlane Android 공식문서 Collect your Google credentials 섹션)

 

2-1. GCP 접속

 

Google Cloud Platform 사이트의 IAM 및 관리자 > 서비스 계정, 페이지 왼쪽 상단 위의 서비스 계정 만들기 버튼을 클릭합니다.

2-2. 서비스 계정 세부정보 입력

 

Fastlane 을 위해 만드는 서비스 계정이라, 이름은 fastlane 으로 설정했습니다.

 

2-3. 액세스 권한 부여

 

역할은 필수로 서비스 계정 사용자로 해주셔야 합니다.

 

3-3. 사용자 액세스 권한 부여

 

해당 필드들은 비워두고 생성합니다

 

3-4. 키 생성

 

서비스 계정쪽을 확인해보시면, 방금 만든 계정이 생성되어 있을겁니다. 계정을 누르고 들어간 뒤, 키 추가버튼을 눌러 키를 생성합니다. JSON 으로 선택하고 만듭니다.

 

3-5. 키 저장 및 json secret file 입력

이제 키를 저장하고, Google Play Console 로 돌아가셔서, 사용자 및 권한 을 보시면 생성한 서비스 계정이 추가 된 것을 볼 수 있습니다. 알맞은 권한을 부여해줍니다. 

부여한 뒤, 받은 JSON 키를 안전한 곳에 저장합니다. 현재는 json 키를 serviceAccount.json 으로 저장하였고, 경로는 android/app/ 에 저장하였습니다.
앱 코드 내에 키 파일을 저장한게 git 에 올라가면 안되니, gitignore 추가합니다.

metadata setup 할거냐고 물어보는데, 스토어에 올릴 때 필요한 data 이므로 y 해주고 다운받습니다.

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] 설정

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

# Appfile
json_key_file(ENV["JSON_KEY_FILE_PATH"]) # Path to the json secret file - Follow https://docs.fastlane.tools/actions/supply/#setup to get one
package_name("com.test.test") # e.g. com.krausefx.app

# .env
JSON_KEY_FILE_PATH="/Users/jangseung-gyun/Documents/GitHub/frontend/android/app/serviceAccount.json"

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

 

6. Firebase Distribution Lane 생성

default_platform(:android)

platform :android do  desc "Upload Debug APK to Firebase Distribution"  lane :firebase_debug do |options|
    gradle_build
    firebase_upload(release_note: options[:release_note])
  end  desc "Upload Release APK to Firebase Distribution"  lane :firebase_release do    gradle_build(release: true)
    firebase_upload(release: true)
  end  desc "Get Flutter version from pubspec.yaml"  private_lane :get_version_info do    yaml_file_path = "yaml_file_path입력"    data = YAML.load_file(yaml_file_path)
    version = data["version"]

    version_name = version.split("+")[0]
    version_code = version.split("+")[1].to_i

    {version_name: version_name, version_code: version_code}
  end  private_lane :gradle_build do |options|
    version = get_version_info
    version_name = version[:version_name]
    version_code = version[:version_code]

    gradle(
      task: "assemble",
      build_type: options[:release] ? "Release" : "Debug",
      properties: {
        "android.injected.version.name" => version_name,
        "android.injected.version.code" => version_code
      }
    )
  end  private_lane :firebase_upload do |options|
    firebase_app_distribution(
      app: "앱 id이며 Firebase의 프로젝트 설정 일반 탭에 있습니다",
      firebase_cli_token: '4-2에서 받은 Refresh Token',
      groups: "test",
      debug: options[:release],
      android_artifact_type: "APK",
      release_notes: options[:release] ? "firebase_upload release" : "firebase_upload debug",
      apk_path: options[:release] ? "app-release.apk를 저장할 파일 경로 /Users/jangseung-gyun/Documents/GitHub/frontend/build/app/outputs/flutter-apk/app-release.apk" : "app-debug.apk를 저장할 파일 경로 /Users/jangseung-gyun/Documents/GitHub/frontend/build/app/outputs/flutter-apk/app-debug.apk"    )
  end  desc "Lane for distribution"  lane :firebase_aos do      gradle(
          task: "assemble",
          build_type: "Debug",
      )

      firebase_app_distribution(
          app: "앱 id이며 Firebase의 프로젝트 설정 일반 탭에 있습니다",
          firebase_cli_token: '4-2에서 받은 Refresh Token',
          groups: "test",
          debug: true,
          android_artifact_type: "APK",
          release_notes: "fastlane test",
          apk_path: "app-debug.apk를 저장할 파일 경로 /Users/jangseung-gyun/Documents/GitHub/frontend/build/app/outputs/flutter-apk/app-debug.apk"      )
  endend

[lane 설명]

firebase_debug 레인은 debug모드로 Firebase에 배포합니다(Firebase에 firebase_upload debug로 표시됩니다)

firebase_release레인은 release모드로 Firebase에 배포합니다 (Firebase에 firebase_upload release로 표시됩니다)