EAS를 사용해 Google Play Store에 비공개 테스트로 앱 제출하기

✨ EAS를 사용해 Google Play Store에 비공개 테스트로 앱 제출하기

React Native/Expo 프로젝트를 Google Play Store에 비공개 테스트(Closed Testing)로 제출하는 과정을 EAS(Expo Application Services)를 사용해 진행하는 방법을 정리했습니다. EAS를 활용하면 클라우드에서 빌드를 생성하고 Google Play Store에 쉽게 제출할 수 있습니다. Free 티어 사용 시 빌드 시간이 다소 걸릴 수 있으니 참고하세요.

1. EAS CLI 설치 및 로그인

EAS CLI를 설치하고 Expo 계정으로 로그인합니다.

npm install -g eas-cli
eas login
eas whoami

최신 버전으로 유지하기 위해 npm install -g eas-cli를 주기적으로 실행하세요.

2. eas.json 설정

EAS 설정 파일인 eas.json을 프로젝트 루트에 생성하고, 빌드 및 제출 프로필을 정의합니다. 비공개 테스트를 위해 closed-test 프로필을 추가했습니다.

{
  "cli": {
    "version": ">= 16.0.1",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      }
    },
    "preview": {
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      }
    },
    "closed-test": {
      "distribution": "internal",
      "autoIncrement": true,
      "android": {
        "buildType": "app-bundle"
      }
    },
    "production": {
      "autoIncrement": true,
      "android": {
        "buildType": "app-bundle"
      }
    },
    "production-apk": {
      "autoIncrement": true,
      "android": {
        "buildType": "apk"
      }
    }
  },
  "submit": {
    "production": {
      "android": {
        "track": "production",
        "releaseStatus": "completed"
      }
    },
    "preview": {
      "android": {
        "track": "internal"
      }
    },
    "closed-test": {
      "android": {
        "track": "alpha",
        "releaseStatus": "completed"
      }
    }
  }
}

주요 설정:

• build.closed-test: 비공개 테스트용 AAB 빌드 (app-bundle).
• submit.closed-test: Google Play Store의 alpha 트랙으로 제출.

3. EAS Credentials 설정

Google Play Store 제출을 위해 EAS Credentials를 설정합니다.

3.1. Google Service Account Key 생성

1. Google Cloud 프로젝트 생성 (필요 시): Google Cloud Console에서 새 프로젝트를 생성합니다.
2. 서비스 계정 생성: "IAM 및 관리" → "서비스 계정" → "서비스 계정 만들기"에서 서비스 계정 생성 후 JSON 키 파일 다운로드.
3. Google Play Android Developer API 활성화: Google Cloud Console에서 "Google Play Android Developer API"를 사용 설정.
4. Google Play Console에서 서비스 계정 초대: "사용자 및 권한" → "새 사용자 초대" → 서비스 계정 이메일 추가 → "릴리스 관리자" 권한 부여.

3.2. EAS CLI에서 Google Service Account Key 업로드

eas credentials

1. Google Service Account 선택.
2. Upload a Google Service Account Key 선택.
3. 다운로드한 JSON 키 파일 경로 입력 (예: ./service-account.json).
4. Manage your Google Service Account Key for Play Store Submissions 선택 후 업로드한 키 설정.

4. EAS Build 실행

EAS Build를 통해 클라우드에서 AAB 파일을 생성합니다. Free 티어를 사용하는 경우 빌드 시간이 다소 걸릴 수 있습니다.

eas build --platform android --profile closed-test

Free 티어에서는 빌드 대기열에 따라 시간이 걸릴 수 있습니다. 빌드가 완료되면 Expo 대시보드에서 확인 가능합니다.

5. EAS Submit으로 Google Play Store에 제출

EAS Build로 생성한 AAB 파일을 Google Play Store의 비공개 테스트(alpha 트랙)로 제출합니다.

eas submit --platform android --profile closed-test --release-notes "Closed testing release for beta testers."

1. Select a build from EAS 옵션 선택.
2. 최근 생성한 closed-test 프로필의 빌드 선택.

제출이 완료되면 Google Play Store의 alpha 트랙에 업로드됩니다.

6. Google Play Console에서 비공개 테스트 설정

1. 비공개 테스트 트랙 설정: Google Play Console → "테스트" → "비공개 테스트" → alpha 트랙 선택.
2. 테스터 추가: 테스터 이메일 목록 또는 Google 그룹 추가.
3. 테스트 링크 생성: 테스트 링크를 생성해 테스터에게 공유.
4. 검토 및 배포: Google Play Store의 검토 과정(보통 1~3일 소요) 후 테스터가 앱을 다운로드 가능.

7. 요약

EAS를 사용해 Google Play Store에 비공개 테스트로 앱을 제출하는 전체 과정은 다음과 같습니다:

1. EAS CLI 설치 및 로그인: npm install -g eas-cli, eas login.
2. eas.json 설정: closed-test 프로필 추가.
3. EAS Credentials 설정: Google Service Account Key 업로드 및 설정.
4. EAS Build 실행: eas build --platform android --profile closed-test.
5. EAS Submit 실행: eas submit --platform android --profile closed-test --release-notes "...".
6. Google Play Console에서 비공개 테스트 설정: 테스터 추가 및 테스트 링크 생성.

Free 티어 사용 시 EAS Build가 다소 시간이 걸릴 수 있으니, 빌드 상태를 Expo 대시보드에서 주기적으로 확인하세요.