메인 콘텐츠로 건너뛰기
Capgo 로고
CI/CD

GitLab을 사용하여 자동화된 Capacitor Android 빌드

5분 내에 fastlane과 GitLab을 사용하여 Ionic Android 앱의 CI/CD PIPELINE을 설정하는 방법

아니크 다발 바부

아니크 다발 바부

콘텐츠 마케터
GitLab을 사용하여 자동화된 Capacitor Android 빌드

GitLab CI를 사용하여 자동화된 Android 빌드

Setting up CI/CD for Capacitor apps can be complex and time-consuming. Here’s what you need to know:

사전 조건

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

  • GitLab 계정에 관리자 권한
  • Google Play Store에 올려진 앱이 올바른 서명으로 올려져 있습니다.
  • Android 서명 키 및 키 스토어 파일
  • Google Cloud Console 프로젝트에 Play Store API이 활성화된 상태
  • 적절한 권한이 있는 서비스 계정
  • GitLab CI/CD 워크플로우 이해
  • Fastlane 구성에 대한 지식
  • pipeline 유지 및 디버깅에 소요되는 시간

Capgo CI/CD를 위해 Capgo 빌드

Fastlane, Gradle 런너, 키 스토어, 업로드 스크립트 유지 관리를 생략합니다. Capgo 빌드 __CAPGO_KEEP_0__ CI/CD pipeline에서 이미 존재하는 빌드:

  • pipeline과 함께 작동합니다.: GitLab CI, Capgo Actions, Jenkins, 또는 로컬 스크립트 후 웹 빌드 후 GitHub npx cap sync.
  • CI 비밀에서 서명: Android 키 스토어, 키 별명, 비밀번호, 및 Play Console 서비스 계정 JSON을 CI 비밀에서 유지합니다.
  • 자체 실행기 유지 관리가 필요하지 않습니다.: Capgo 빌드는 유지 관리 된 Android 빌드 환경을 제공하므로 SDK 이미지를 관리하거나 Gradle 캐시 문제 또는 Fastlane 레인 관리할 필요가 없습니다.
  • 아티팩트 및 제출: QA에 서명 된 아티팩트를 다운로드하거나 Capgo CLI를 통해 릴리스 빌드를 제출할 수 있습니다.

가격

  • Capgo 플랜은 $12/월부터 시작됩니다.
  • OTA 업데이트와 월 15회 정도의 네이티브 빌드가 포함됩니다.
  • 추가 빌드 분량은 분당 크레딧으로 청구됩니다.

설정하기 Capgo CI/CD에서 빌드

수동 설정 가이드

다음과 같은 작업을 수행해야 합니다:

게시물 후에 따르는 단계

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

1. Fastlane 파일 복사

Fastlane은 Ruby 라이브러리로 모바일 개발을 자동화하는 데 사용됩니다. Fastlane을 사용하면 Android Studio에서 수행하는 일반적인 작업을 자동화할 수 있습니다. 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 변수와 유사한 방법으로 저장할 수 있도록 해줍니다._sensitive 정보를 안전하게 저장하려면.

  1. GitLab 프로젝트의 설정으로 이동하세요.
  2. CI/CD > 변수로 이동하세요.
  3. 다음 변수를 추가하세요:
  • ANDROID_KEYSTORE_FILE: Android 빌드에 사용되는 base64 인코딩된 .jks 또는 .keystore Android 빌드에 사용되는 키 스토어 파일입니다. Play App Signing을 사용하는 경우 업로드 키와 관련된 키 스토어 파일 또는 앱 서명 키가 될 수 있습니다.
  • KEYSTORE_KEY_PASSWORD: 키 스토어 파일과 관련된 암호
  • KEYSTORE_KEY_ALIAS: 키 스토어 별칭
  • KEYSTORE_STORE_PASSWORD: 개인 키 암호
  • DEVELOPER_PACKAGE_NAME: Android 앱 ID와 유사한 com.example.app
  • PLAY_CONFIG_JSON: Google Play 서비스 계정 키 JSON을 base64로 인코딩합니다.

Google Play 서비스 계정 키를 생성합니다.

비밀 키를 생성하려면 다음 단계를 따르십시오. PLAY_CONFIG_JSON Google Cloud 콘솔로 이동하십시오.

  1. 새 프로젝트를 생성하거나 기존 프로젝트를 선택하십시오. Google Play Android Developer를 활성화하십시오.
  2. 서비스 계정 생성:
  3. Enable the Google Play Android Developer API
  4. ‘서비스 계정 생성’ 버튼을 클릭하십시오.
    • 이름과 설명을 입력하십시오.
    • Google Play 서비스 계정 키를 생성하려면 다음 단계를 따르십시오.
    • Google Cloud Console로 이동하십시오.
    • Click “Create and Continue”
    • Skip role assignment and click “Done”
  5. JSON 키를 생성하세요:
    • 서비스 계정 목록에서 계정을 찾으세요
    • 세로 세로 세로 세로 메뉴 > “Manage keys”
    • 키 추가 > “Create new key”
    • JSON 형식 선택
    • 생성
  6. Play 콘솔에서 앱에 서비스 계정에 대한 접근 권한을 부여하세요:
    • Play Console로 이동하세요 사용자 및 권한
    • Navigate to “Users and permissions”
    • Click “새로운 사용자 초대”
    • 서비스 계정 이메일을 입력하세요 (iam.gserviceaccount.com으로 끝나야 함)
    • ‘제품 출시’ 권한을 부여하십시오
    • Click “사용자 초대”
  7. JSON 키를 base64로 변환하세요: 
    base64 -i path/to/your/service-account-key.json | pbcopy
  8. GitLab에 base64로 인코딩된 문자열을 추가하세요 PLAY_CONFIG_JSON GitLab CI/CD Pipeline 설정

CI/CD Pipeline을 설정하려면 프로젝트의 루트 디렉토리에 .gitlab-ci.yml 파일을 생성하세요. 아래는 CI/CD 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

GitLab CI/CD에서 새로운 태그가 푸시될 때마다 정의된 pipeline이 자동으로 트리거되어 Android 앱을 빌드하고 배포합니다.

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

Create a .gitlab-ci.yml file at the root of your project to define your CI/CD pipeline. Below is an example of how you can structure your pipeline:

결론

GitLab CI/CD를 mingc/android-build-box Docker 이미지를 사용하여 구성하면 Android 앱 빌드 프로세스를 자동화할 수 있습니다. 이 자동화는 개발 워크플로우를 더 효율적이고 신뢰할 수 있도록 만들며, 앱 개발의 핵심 측면에 집중할 수 있도록 시간을 절약합니다. 결국, 더 효율적으로 고품질 Android 앱을 출시할 수 있습니다.

GitLab를 사용하여 자동화된 Capacitor Android 빌드에서 계속 진행하세요.

GitLab를 사용 중이시면 GitLab를 사용하여 자동화된 Capacitor Android 빌드를 사용하여 CI/CD 자동화를 계획하는 경우 __CAPGO_KEEP_0__ CI/CD와 연결하세요. CI/CD 자동화에서 Capgo CI/CD의 제품 워크플로우를 사용하세요. CI/CD 자동화에서 Capgo Native Builds의 제품 워크플로우를 사용하세요. CI/CD 자동화에서 Capgo Integrations의 제품 워크플로우를 사용하세요. CI/CD 자동화에서 Capgo Native Builds의 제품 워크플로우를 사용하세요. CI/CD 자동화에서 Capgo Integrations의 제품 워크플로우를 사용하세요. CI/CD 자동화에서 Capgo Integrations의 제품 워크플로우를 사용하세요. CI/CD 통합 CI/CD 통합 구현 세부 정보에 대해, 그리고 GitHub 액션 통합 GitHub 액션 통합 구현 세부 정보에 대해.

Capacitor 앱에 실시간 업데이트

Capgo를 통해 웹-layer 버그가 생긴 경우, 앱 스토어 승인까지 며칠 기다리지 않고 바로 픽스를 배포할 수 있습니다. 사용자는 배경에서 업데이트를 받으면서 네이티브 변경 사항은 일반적인 검토 경로를 유지합니다.

시작하기

최신 블로그 글

Capgo은 전문적인 모바일 앱을 만들기 위해 필요한 최고의洞察력을 제공합니다.

Capacitor 앱에서 2방향 통신
개발 모바일 +1
2025년 4월 26일

Capacitor 앱에서 2방향 통신

OTA 업데이트를 피해야 하는 5가지 일반적인 실수
개발 보안 +1
2025년 4월 13일

5가지 OTA 업데이트 실수를 피하는 방법

모바일 앱 실시간 업데이트에 대한 5가지 보안 권장 사항
개발 모바일 +1
2025년 1월 14일

모바일 앱 실시간 업데이트에 대한 5가지 보안 권장 사항

블로그에서 모두 보기