안드로이드 빌드

Google Play Store에 Android 앱을 빌드하고 제출하세요. Capgo의 전용 인프라를 사용하세요.

학습할 내용

• Capgo 네이티브 빌드를 통해 앱을 업로드하는 방법을 배웁니다.
• Capgo 네이티브 빌드에 대한 인증 정보를 구성하는 방법을 배웁니다.

필수 조건

• 구글 개발자 계정이 활성화되어 있어야 합니다.
• Android Studio가 설치되어 있어야 합니다.
• Android Studio로 앱을 빌드할 수 있어야 합니다.

주의

이 튜토리얼에서 사용할 앱은 다음과 같습니다: https://github.com/Cap-go/capgo-native-앱-빌드-튜토리얼

권장: 자동 온보딩

수동으로 할 필요가 없습니다. Capgo의 온보딩은 Android 서명 인증서(keystore + Google Play 서비스 계정)가 생성되고 구성되도록 해줍니다. — 이 경로는 권장하는 경로입니다:

bunx @capgo/cli@latest build init --platform android

수동 온보딩 walkthrough는 Capgo의 내부 동작을 이해하고자 하거나, 자체적으로 인증서를 설정하고 싶은 사람들만 읽으세요.

첫 번째 수동 빌드

Capgo을 사용하여 앱을 빌드하기 전에, 먼저 Capgo을 설정하고, 수동으로 Android 빌드를 해보세요. 수동 빌드를 하는 이유는 다음과 같습니다:

• 앞으로의 Capgo 빌드에 인증서를 준비합니다.
• Play Store Console에 기록을 생성합니다.

Android 스튜디오를 사용하여 앱을 수동으로 빌드합니다.

Capgo을 사용하여 앱을 빌드하기 전에, Android 스튜디오를 사용하여 앱을 수동으로 빌드해야 합니다.

1. Android 스튜디오 열기

   실행 bunx cap open android Android 스튜디오를 열고 앱을 빌드합니다.

2. 열기 Build -> Generate Signed App Bundles / APKs

3. 클릭 Android App Bundle Android 스튜디오에서 signed 앱 번들 / APK를 생성합니다. Next

클릭

현재, 앱을 서명하기 위해 사용하는 키 스토어 파일이 없습니다. 이 파일은 Google이 앱을 개발한 사람임을 알리기 위해 사용됩니다. Android Studio에서 제공하는 GUI 방법을 사용하여 생성하겠습니다. 명령줄을 사용하여 생성하는 방법도 있습니다. 그러나 이 튜토리얼에서는 그 방법을 다루지 않습니다.

1. 클릭하세요 Create new

2. 키 스토어 경로를 입력하세요

   주의

   This 키 스토어 비밀번호를 설정하세요 이것은 나중에 사용됩니다.

3. 키 스토어 비밀번호 설정

   주의

   키 스토어와 키 별칭의 비밀번호를 동일하게 사용하는 것을 추천합니다.

   주의

   This 이것은 나중에 사용될 것입니다. 폼의 나머지 부분을 채우세요.

4. 키 별칭은 그대로 유지하세요 (key0)

   1. 인증서 세부 정보를 채우세요. 나는 가짜 정보로 채웠지만, 당신은 자신의 정보로 채우세요.
   2. IS TO BE SAVED

   

5. 클릭하세요 OK

수동 빌드 완료

1. 키 스토어의 모든 세부 정보가 정확하게 입력되었는지 확인하고 클릭하세요 Next

2. 선택하세요 release 빌드 버전을 선택하고 클릭하세요 Create

3. 빌드가 성공하면 다음 화면을 볼 수 있습니다

   1. 이 팝업은 빌드가 성공적으로 완료되었다는 것을 나타냅니다.
   2. 버튼을 클릭하세요 - 이 버튼을 클릭하면 파일 탐색기를 열고 빌드를 확인할 수 있습니다. locate 파일 탐색기에 빌드가 보이도록 확인하세요.

4. Android Studio에서 파일 탐색기에 빌드가 보이도록 확인하세요.

Play Store 콘솔에서 앱을 생성하는 방법

1. Go to Google Play 콘솔에서 개발자 계정을 선택하세요.

2. 버튼을 클릭하세요.

3. 버튼을 클릭하세요. Create app

4. 앱 이름과 언어를 선택하세요

5. 앱 카테고리와 앱이 유료인지 무료인지 선택하세요

6. 약관과 조건을 수락하세요

   주의

   약관과 조건을 읽고 수락하기 전에 주의하세요

7. 클릭 Create

애플리케이션을 만들었습니다.

애플리케이션을 만들었습니다. 내부 테스트 그룹을 만들 수 있습니다. 내부 테스트 그룹을 만들 이유는 Play Store에 애플리케이션을 공개하지 않기 때문입니다.

주의

내부 테스트는 실제 출시 전에 Play-distributed 빌드를 빠르게 테스트하는 가장 빠른 방법입니다.

개발자 계정이 2023년 11월 13일 이후에 개인 계정으로 생성된 경우, 내부 테스트는 아니오 생산 액세스에 대한 폐쇄 테스트 요구 사항을 대체하지 않습니다. 최소 12명의 옵티드인 테스터가 14일 연속으로 폐쇄 테스트에 참여해야 합니다.

1. 가장 internal testing 클릭하세요 Test and release -> Testing -> Internal testing

   

2. Click on Testers

3. Click on Create email list

4. 이메일 목록 이름

5. 테스터의 이메일 주소 추가

6. 클릭 Enter Google Play Console에 Save

7. Click on Create group

8. 새 목록이 선택되어 있는지 확인하고 Save

내부 테스트 그룹에 앱 업로드

내부 테스트 그룹을 만들었습니다. 이제 내부 테스트 그룹에 앱을 업로드할 수 있습니다.

1. 로 이동하세요 Test and release -> Testing -> Internal testing

2. 버튼 Releases button

3. 저장하기 Create new release

4. 클릭하세요 Upload

5. AAB 파일을 선택하세요

   주의

   Android Studio에서 수동으로 빌드한 AAB 파일을 선택하십시오. 만약 이 파일이 Capgo 빌드에 사용할 키스토어와 동일하지 않다면 Capgo 네이티브 빌드는 실패할 것입니다.

6. AAB 파일 업로드를 기다리세요

7. 클릭하세요 Next

8. 오류를 수정하세요

   개인적으로, 이 단계에서 나는 이 오류를 보지 못한다.

   

   이는 아직 휴대폰 번호를 인증하지 않았기 때문입니다. 인증을 하여 튜토리얼을 계속 진행하겠습니다.

9. 클릭하세요 Save and publish 이것은 앱을 내부 테스트 그룹에 배포합니다.

10. 배포를 확인하세요

11. 앱이 배포되었는지 확인하세요

12. 임시 앱 이름을 가져오세요

내부 테스트 그룹에 대한 초대 수락

앱을 내부 테스트 그룹에 업로드한 후 내부 테스트 그룹에 대한 초대 수락이 가능합니다.

1. 가기 Test and release -> Testing -> Internal testing

2. 클릭 Testers

3. 클릭 Copy link

4. 휴대폰으로 링크를 보내고 브라우저에서 열어 Accept

5. 초대 수락이 완료되었는지 확인하고 "Play Store에서 다운로드"를 클릭

6. 앱을 설치하세요.

   1. Android Studio를 사용하기 전에 이미 앱을 설치한 경우 Android Studio에서 uninstall 버튼을 클릭하세요.
   2. Google Play Console에서 install 버튼을 클릭하세요.
   3. 앱을 열고 다운로드가 성공적으로 완료되었는지 확인하세요.

   주의

   플레이 스토어에서 앱을 찾을 수 없다면, 플레이 스토어에서 올바른 계정을 선택했는지 확인하세요.

Capgo 안드로이드 네이티브 빌드 설정

Capgo 네이티브 빌드 설정을 시작할 준비가 되었습니다. 축하합니다!

필수 조건	플래그	설명	필수
Keystore 파일	--keystore <path>	APK/AAB을 서명하기 위한 파일의 경로 .jks/.keystore __CAPGO_KEEP_0__	Yes
키 저장소 별칭	--keystore-alias <alias>	키 저장소 내 키의 별칭입니다.	Yes
키 저장소 키 비밀번호	--keystore-key-password <password>	키 비밀번호입니다. 키와 저장소 비밀번호가 일치하면 하나만 제공할 수 있습니다.	아래의 주의사항을 참조하세요.
키 저장소 저장소 비밀번호	--keystore-store-password <password>	키와 저장소 비밀번호가 일치하면 하나만 제공할 수 있습니다.	아래의 주의사항을 참조하세요.
키 저장소 저장소 비밀번호입니다.	--play-config <path>	Google Play 서비스 계정	네

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

주의

또는 --keystore-key-password 터미널 창 --keystore-store-password.

클립보드에 복사

만약 키와 저장소 암호가 동일하다면 또는키스토어, 키스토어 암호, 키스토어 키 암호, 키스토어 별칭

Google Play 서비스 계정

Google Play 서비스 계정을 생성하는 것은 수동적이고 복잡한 과정입니다. 그럼에도 불구하고, 앱을 Google Play에 업로드하려면 필수적입니다. 다음 사항을 참고하세요:

• 당신 context be 필요합니다당신
• 개발자 계정의

소유자여야 합니다. 그렇지 않으면 서비스 계정을 설정할 수 없습니다.

1. 가기 시작해 보세요.

2. 프로젝트 선택 버튼을 클릭하세요.

3. 프로젝트가 이미 있으면 선택하세요. 없으면 새로운 프로젝트를 생성하세요:

   주의

   아래의 스크린샷은 예시입니다. 실제 프로젝트 이름을 사용하세요.

   1. 클릭하세요. New project
   2. 프로젝트 이름을 입력하고 클릭하세요. Create
   3. 정확한 프로젝트를 선택했는지 확인하세요.

4. 클릭하면 검색바가 나타납니다. service accounts 그리고 클릭하세요.

5. 클릭하세요. Create service account

6. 서비스 계정에 대한 양식을 작성하고 클릭하세요. Done

   1. 서비스 계정 이름을 설정하는 것을 추천합니다. Capgo Native Build Service Account
   2. 서비스 계정 ID를 설정하는 것을 추천합니다. capgo-native-build-service-acc
   3. 설명란은 작성하지 않아도 되지만, 작성하는 것을 추천합니다. Allows Capgo Native Build to build and submit the app to the Play Store

   

7. 새로 생성한 서비스 계정 클릭하세요. 리스트에서 새로 생성한 서비스 계정을 확인하세요. 클릭하세요.

   주의

   이 이메일 주소를 복사하여 나중에 필요할 때 사용하세요.

8. Google Console에서 Keys 탭

9. Google Console에서 Add Key 및 Create new key

10. Google Console에서 JSON 및 Create

    주의

    클릭하면 Create 새 키가 생성되고 JSON 파일이 로컬 머신으로 다운로드됩니다.

    JSON 파일을 안전한 곳에 저장해야 합니다. WILL JSON 파일 다운로드 JSON 파일은 자동으로 다운로드되어야 합니다. 창을 닫으려면

11. Google Console 다운로드 키 close __CAPGO_KEEP_0__ 서비스 계정에 Play Store 접근 권한 부여

API

새로 생성된 서비스 계정은 아직 Play Store에 접근할 수 없습니다 API. 이를 허용하려면 Play Store 콘솔로 이동하세요.

1. 가장자리 구글 플레이 콘솔
2. 정확한 개발자 계정을 선택하세요
3. 클릭하여 Users and permissions
4. 클릭하여 Invite new users
5. 서비스 계정의 이메일 주소를 복사하세요
6. 가장자리 Account permissions 그리고 최소 권한을 부여하십시오:
   • In App permissions, 앱에 대한 접근 권한을 부여하십시오.
   • In Releases, 사용을 활성화하십시오. Create, edit, and roll out releases.
   • 플레이 앱 서명이 사용되는 워크플로우가 있는 경우 관련 서명 권한을 활성화하십시오.
   • 분명하지 않은 경우에는 Admin 설정 중에만 사용하고 나중에 권한을 줄이십시오.
7. 클릭하십시오. Invite user
8. 초대 확인하십시오.
9. 사용자가 초대받았는지 확인하세요

인증서 저장

인증서를 저장하고 첫 번째 빌드를 실행할 준비가 되었습니다. 인증서를 저장하려면 다음 명령어를 사용하세요:

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

CI/CD 설정 (GitHub Actions)

이미 완료한 경우 Keystore, Keystore 비밀번호, Keystore 키 비밀번호, Keystore 별칭 및 구글 플레이 서비스 계정CI/CD를 위한 모든 필요한 항목이 이미 있습니다. 이 섹션에서는 GitHub Actions 비밀과 환경 변수로 해당 값을 전달하는 방법에 대해 설명합니다.

1) 인증 파일을 단일 줄 base64로 변환

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

팁

GitHub 비밀은 단일 줄 값이어야 합니다. tr -d '\n' base64 출력에서 줄을 제거합니다.

2) 저장소 비밀 생성

In GitHub > Repository > Settings > Secrets and variables > Actions, add:

Secret name	Value
CAPGO_TOKEN	Capgo Capgo API 토큰
APP_ID	Your Capgo 앱 ID (예시:) com.example.app)
ANDROID_KEYSTORE_FILE	내용 keystore_base64.txt
KEYSTORE_KEY_ALIAS	Keystore alias from __CAPGO_KEEP_0__ Keystore, Keystore Password, Keystore Key Password, Keystore Alias
KEYSTORE_KEY_PASSWORD	Android Keystore 키 암호
KEYSTORE_STORE_PASSWORD	Keystore 저장용 암호
PLAY_CONFIG_JSON	Android play_config_base64.txt

주의

키와 저장소 비밀번호가 같다면, 하나만 제공할 수 있습니다. KEYSTORE_KEY_PASSWORD 또는 KEYSTORE_STORE_PASSWORD.

3) GitHub 작업 흐름에서 환경 변수를 사용하세요

github/workflows/android-build.yml

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

팁

이 설정으로 CI는 환경 변수를 통해만 자격 증명을 전송합니다. 서명 파일을 커밋하거나 워크플로우 아티팩트로 업로드할 필요가 없습니다.

빌드 실행

축하합니다! 첫 번째 빌드를 실행할 준비가 되었습니다.

실행:

bunx @capgo/cli@latest build request com.example.app --platform android

이제 빌드 프로세스가 시작됩니다.

Play 릴리스 제출

Google Play로 Android 릴리스 빌드가 기본적으로 업로드되며, Play 콘솔에서 릴리스를 완료할 때까지 비활성화됩니다. CI 릴리스에서 Play 릴리스를 자동으로 제출하려면 --submit-to-store-review 릴리스 빌드와 함께

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --android-track production \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

주의

안드로이드에서 --submit-to-store-review 기본값은 프로덕션 트래킹 release_status: completed 트래킹을 설정하지 않으면 --android-track internal 100%의 사용자에게 alpha / beta(또는 PLAY_STORE_TRACK CI에서 --android-release-status / PLAY_STORE_RELEASE_STATUS 완료된 릴리스를 비프로덕션 트래킹에 유지하려면 completed.

이것은 일반 업로드 경로 (PLAY_CONFIG_JSON CI 또는 Android 인증 정보를 로컬에 저장합니다. --store-release-name Google Play version_name. --store-release-notes Google Play --store-release-notes-locale "locale=notes" entry는 해당 지역의 Play 변경 로그를 지역화하여 기록합니다. Capgo은 Play 릴리스를 전송합니다. completed 로컬 Play 변경 로그를 작성합니다. --android-release-status__CAPGO_KEEP_0__은 Play 릴리스를

이것은

Android Builds에서 계속 제목: Android Builds에서 계속 Android Builds를 사용하여 CI/CD 자동화 계획을 만든 경우에만 Capgo CI/CD Capgo 제품 워크플로우를 위한 CI/CD Capgo 네이티브 빌드 Capgo 제품 워크플로우를 위한 네이티브 빌드 Capgo 통합 Capgo 제품 워크플로우를 위한 통합 CI/CD 통합 __CAPGO_KEEP_0__ 액션 통합 GitHub 액션 통합 구현 세부 정보 GitHub 액션 통합 구현 세부 정보