__CAPGO_KEEP_0__ Android 빌드와 GitLab CI

Capacitor 앱을 위한 CI/CD 설정은 복잡하고 시간이 많이 걸립니다. 필요한 정보는 다음과 같습니다.

사전 요구 사항

시작하기 전에 다음을 설정해야 합니다:

GitLab 계정에 관리자 권한이 있는 계정
__CAPGO_KEEP_0__에 이미 앱이 게시되어 있는 경우
Android signing key 및 keystore 파일
Google Cloud Console 프로젝트에 API이 활성화된 경우
서비스 계정에 적절한 권한
GitLab CI/CD 워크플로우에 대한 이해
Fastlane 구성에 대한 지식
pipeline 유지 및 디버깅에 소요되는 시간

Capgo를 사용하여 전문적인 CI/CD 설정

복잡성을 피하십시오. Capgo CI/CD pipeline을 직접 선호하는 플랫폼에서 구성합니다.:

플랫폼 독립성: Cloudflare Actions, GitLab CI, 또는 기타 GitHub와 함께 작동합니다.
무결합 통합: 현재 프로세스와 함께 플랫폼 switch가 필요하지 않습니다.
맞춤형 구성: 프로젝트 요구 사항에 맞춘 설정
전문가 지침: 50+ 앱에 CI/CD를 미리 설정했습니다.

가격

한 번의 설정 비용: $2,600
운영 비용: ~$300/년
다른 사설 솔루션과 비교: 연간 $6,000
5년 동안 $26,100을 절약하세요

CI/CD 설정하기

수동 설정 안내서

자신이 모든 것을 설정하고 싶다면, 다음을 수행해야 합니다:

게시물에서 따르는 단계

Fastlane 파일 복사하기
GitLab 암호화된 비밀을 저장하세요
Google Play 서비스 계정 키를 생성 및 저장하세요
Android 서명 키를 저장하세요
GitLab 워크플로우 .yml 파일을 설정하세요

1. Fastlane 파일 복사하기

Fastlane은 Ruby 라이브러리로, 모바일 개발 작업을 자동화하는 데 사용됩니다. Fastlane을 사용하면 Android Studio를 사용하여 수행하는 작업을 수행하는 일련의 '액션'을 포함하는 '레인'을 구성할 수 있습니다. Fastlane을 사용할 수 있는 많은 기능이 있지만, 이 튜토리얼의 목적을 위해, 우리는 핵심 액션만 사용할 것입니다.

프로젝트의 루트 폴더에 Fastlane 폴더를 만들고 다음 파일을 복사하세요: Fastlane

default_platform(:android)

KEYSTORE_KEY_ALIAS = ENV["KEYSTORE_KEY_ALIAS"]
KEYSTORE_KEY_PASSWORD = ENV["KEYSTORE_KEY_PASSWORD"]
KEYSTORE_STORE_PASSWORD = ENV["KEYSTORE_STORE_PASSWORD"]

platform :android do
    desc "Deploy a beta version to the Google Play"
    private_lane :verify_changelog_exists do |version_code: |
      changelog_path = "android/metadata/en-US/changelogs/#{version_code}.txt"
      UI.user_error!("Missing changelog file at #{changelog_path}") unless File.exist?(changelog_path)
      UI.message("Changelog exists for version code #{version_code}")
    end

    private_lane :verify_upload_to_staging do |version_name: |
      UI.message "Skipping staging verification step"
    end
    lane :beta do
				keystore_path = "#{Dir.tmpdir}/build_keystore.keystore"
				File.write(keystore_path, Base64.decode64(ENV['ANDROID_KEYSTORE_FILE']))
				json_key_data = Base64.decode64(ENV['PLAY_CONFIG_JSON'])
				previous_build_number = google_play_track_version_codes(
					package_name: ENV['DEVELOPER_PACKAGE_NAME'],
					track: "internal",
					json_key_data: json_key_data,
				)[0]

				current_build_number = previous_build_number + 1
				sh("export NEW_BUILD_NUMBER=#{current_build_number}")
        gradle(
          task: "clean bundleRelease",
          project_dir: 'android/',
          print_command: false,
          properties: {
            "android.injected.signing.store.file" => "#{keystore_path}",
            "android.injected.signing.store.password" => "#{KEYSTORE_STORE_PASSWORD}",
            "android.injected.signing.key.alias" => "#{KEYSTORE_KEY_ALIAS}",
            "android.injected.signing.key.password" => "#{KEYSTORE_KEY_PASSWORD}",
						'versionCode' => current_build_number
          })
        upload_to_play_store(
					package_name: ENV['DEVELOPER_PACKAGE_NAME'],
					json_key_data: json_key_data,
          track: 'internal',
          release_status: 'completed',
          skip_upload_metadata: true,
          skip_upload_changelogs: true,
          skip_upload_images: true,
          skip_upload_screenshots: true,
        )
    end
    lane :build do
      gradle(
        task: "clean bundleRelease",
        project_dir: 'android/',
        print_command: false,
        properties: {
          "android.injected.signing.store.file" => "#{keystore_path}",
          "android.injected.signing.store.password" => "#{KEYSTORE_STORE_PASSWORD}",
          "android.injected.signing.key.alias" => "#{KEYSTORE_KEY_ALIAS}",
          "android.injected.signing.key.password" => "#{KEYSTORE_KEY_PASSWORD}",
        })
    end
    lane :prod_release do
      build_gradle = File.read("../android/app/build.gradle")

      verify_changelog_exists(version_code: build_gradle.match(/versionCode (\d+)/)[1])
      verify_upload_to_staging(version_name: build_gradle.match(/versionName '([\d\.]+)'/)[1])

      supply(
        track_promote_to: 'beta',
        skip_upload_apk: true,
        skip_upload_aab: true,
        skip_upload_metadata: false,
        skip_upload_changelogs: false,
        skip_upload_images: false,
        skip_upload_screenshots: false
      )
    end
end

GitLab CI/CD 변수를 저장하는 방법

GitLab은 GitHub의 저장소 비밀과 유사한 형태로 암호화된 CI/CD 변수를 저장하는 방법을 제공합니다.

GitLab 프로젝트의 설정으로 이동하세요.
CI/CD > 변수로 이동하세요.
다음 변수를 추가하세요:

ANDROID_KEYSTORE_FILE: Android 빌드에 사용되는 base64-인코딩된 .jks 또는 .keystore keystore 파일입니다. 이 파일은 Play App Signing을 사용하는 경우 업로드 키와 관련된 keystore 파일이거나, 앱 서명 키가 될 수 있습니다.
KEYSTORE_KEY_PASSWORD: keystore 파일과 관련된 비밀번호입니다.
KEYSTORE_KEY_ALIAS: 키 스토어 별칭
KEYSTORE_STORE_PASSWORD: 개인 키 비밀번호
DEVELOPER_PACKAGE_NAME: Android 앱 ID (예: com.example.app)
PLAY_CONFIG_JSON: 서비스 계정 키 JSON을 base64로 인코딩한 값.

Google Play 서비스 계정 키 생성

서비스 계정 키를 생성하려면 다음 단계를 따르세요. PLAY_CONFIG_JSON Google Cloud Console로 이동하세요.

기존 프로젝트를 선택하거나 새로운 프로젝트를 생성하세요. Google Play Android Developer를 활성화하세요.
서비스 계정 생성:
Enable the Google Play Android Developer API
__CAPGO_KEEP_0__
- __CAPGO_KEEP_0__
- Click “Service 계정 만들기”
- 이름과 설명을 입력하세요
- Click “만들기 및 계속하기”
- 역할 assignment을 건너뛰고 “완료”를 클릭하세요
JSON 키를 생성하세요:
- 서비스 계정 목록에서 찾으세요
- 세 개의 점 메뉴 > “키 관리”를 클릭하세요
- “새 키 만들기” > “키 추가”를 클릭하세요
- JSON 형식 선택
- “만들기”를 클릭하세요
Play Console에서 앱에 서비스 계정 접근 권한을 부여하세요:
- 이동하세요 Play Console
- ‘사용자 및 권한’으로 이동하세요
- ‘새로운 사용자 초대’ 클릭
- __CAPGO_KEEP_0__ 이메일 (iam.gserviceaccount.com로 끝나야 함)
- ‘생산 환경에 출시’ 권한 부여
- ‘사용자 초대’ 클릭

JSON 키를 base64로 변환하세요:

base64 -i path/to/your/service-account-key.json | pbcopy

GitLab에 base64로 인코딩된 문자열을 추가하세요 PLAY_CONFIG_JSON GitLab CI/CD PIPELINE 설정

프로젝트의 루트 디렉토리에 .gitlab-ci.yml 파일을 생성하여 CI/CD PIPELINE을 정의하세요. 아래는 PIPELINE을 구조화하는 예시입니다.

PIPELINE을 트리거하세요


image: mingc/android-build-box:latest

stages:
  - build
  - upload_to_capgo
  - build_and_upload_android

build:
  stage: build
  tags:
    - saas-linux-xlarge-amd64
  cache:
    - key:
        files:
          - bun.lockb
      paths:
        - .node_modules/
  script:
    - npm install
    - npm run build
  artifacts:
    paths:
      - node_modules/
      - dist/
  only:
    - master

upload_to_capgo:
  stage: upload_to_capgo
  tags:
    - saas-linux-xlarge-amd64
  script:
    - npx @capgo/cli@latest bundle upload -a $CAPGO_TOKEN -c dev
  dependencies:
    - build
  when: manual
  only:
    - master

build_and_upload_android:
  tags:
    - saas-linux-xlarge-amd64
  stage:    build_and_upload_android
  cache:
    - key:
        files:
          - android/gradle/wrapper/gradle-wrapper.properties
      paths:
        - ~/.gradle/caches/
  script:
    - npx cap sync android
    - npx cap copy android
    - bundle exec fastlane android beta # We do create a tag for the build to trigger XCode cloud builds
  dependencies:
    - build
  when: manual
  only:
    - master

PIPELINE을 트리거하세요

__CAPGO_KEEP_0__

GitLab CI/CD가 GitLab 저장소에 새로운 태그를 푸시할 때마다 자동으로 정의된 pipeline을 트리거하고, Fastlane을 사용하여 Android 앱을 빌드하고 배포합니다.

GitLab CI/CD에 대한 프로젝트 구조와 요구 사항에 따라 경로와 의존성을 조정하십시오. 이 설정은 GitLab CI/CD에서 Android 앱을 자동으로 배포하는 데 도움이 됩니다.

결론

Capacitor을 위한 자동 Android 빌드와 GitLab

__CAPGO_KEEP_0__ Android 빌드와 GitLab CI

사전 요구 사항

Capgo를 사용하여 전문적인 CI/CD 설정

가격

수동 설정 안내서

1. Fastlane 파일 복사하기

GitLab CI/CD 변수를 저장하는 방법

Google Play 서비스 계정 키 생성

프로젝트의 루트 디렉토리에 .gitlab-ci.yml 파일을 생성하여 CI/CD PIPELINE을 정의하세요. 아래는 PIPELINE을 구조화하는 예시입니다.

PIPELINE을 트리거하세요

GitLab CI/CD에 대한 프로젝트 구조와 요구 사항에 따라 경로와 의존성을 조정하십시오. 이 설정은 GitLab CI/CD에서 Android 앱을 자동으로 배포하는 데 도움이 됩니다.