Android 출시
마치면 앱이 Google Play 에 게시됨 상태가 돼요. Play 검토는 며칠 걸려요. 2023-11-13 이후 만든 개인 계정이면 비공개 테스트 14일이 더 걸리니 테스터를 일찍 모아요. 하나만 빠져도(개인정보 처리방침 URL, 데이터 보안, 그래픽 이미지) 출시가 막혀요.
- 패키지 이름다음: Play Console 앱
- 비공개 테스트 12명·14일 — 개인 계정만다음: 프로덕션 액세스 신청
- Play Console 앱다음: 업로드 키 · 내부 테스터 · 등록정보·그래픽 · 앱 콘텐츠 설문 — 법 문서 먼저
- 프로덕션 액세스 신청다음: 프로덕션
- 업로드 키다음: 빌드·내부 테스트
- 내부 테스터다음: 프로덕션
- 등록정보·그래픽다음: 프로덕션
- 앱 콘텐츠 설문 — 법 문서 먼저다음: 프로덕션
- 빌드·내부 테스트다음: 프로덕션
- 프로덕션
시작하기 전에
- Google Play 개발자 계정과 Play 연결 — 계정 종류에 따라 출시 길이 달라요(Google Play 개발자 계정).
- 2023-11-13 이후 만든 개인 계정: 내부 테스트 → 비공개 테스트 12명·14일 → 프로덕션 액세스 신청 → 프로덕션
- 그 전에 만든 개인 계정, 조직 계정: 내부 테스트 → 프로덕션
- 개인정보 처리방침 주소 — 등록정보와 앱 콘텐츠 설문에 들어가요(법 문서).
- 인앱 결제·광고로 벌면 Google 돈 받기 — 결제 프로필과 한국 개발자 정보(Google 돈 받기).
- 한국에서 팔면 — Play "한국 개발자 정보"를 넣어요(Google 돈 받기). 게임이면 콘텐츠 등급(IARC) 설문이 등급분류를 대신해요(Play 가 자체등급분류 사업자). 스토어 밖에서도 게임을 유통하면 따로 판단해요 — 확인 필요.
allob 스토어 연동이 되면 allob 이 하고, 그 전까지는 에이전트가 해요. 운영자는 Play Console 로그인만 하면 돼요.
코딩 에이전트에게 붙여 넣기
이 allob 사업 가이드를 읽고, 내 사업에 해당하는 할 일만 골라 진행해 줘: https://allob.app/docs/journey-android.md
1. allob business view 와 allob path view --business 로 내 사업 모양(사업자 형태·돈 버는 방식·파는 나라)을 먼저 확인해.
2. 해당하지 않는 할 일은 왜 아닌지 한 줄로 알려 주고 allob step skip <id> --reason "…" 으로 넘겨.
3. 해당하는 할 일은 allob step view <id> 의 안내대로 하고, 끝나면 allob step done <id> --note "끝났다는 증거" 를 불러.
4. 본인 인증·서명·결제·약관 동의처럼 사람만 하는 곳에서는 멈추고 무엇을 누르면 되는지 알려 줘.
5. 되돌리기 어려운 답(과세 유형·계정 유형 등)은 내 폰으로 확인 요청이 와 — 명령이 보여 준 승인 링크를 알려 주고, 기다리는 동안 다른 할 일로 넘어가.패키지 이름 정하기
앱의 고유 이름인 패키지 이름(applicationId)을 정해 코드에 넣어요.
- 도메인을 거꾸로 쓴 모양으로 정해요(예:
com.example.diary). iOS 번들 id 와 같게 두면 관리가 쉬워요. - Play 에 따로 등록하지 않아요. 첫 AAB 를 올리는 순간 정해져요.
⚠ 첫 AAB 를 올린 뒤엔 바꿀 수 없어요. 다른 앱이 쓴 이름도 못 써요.
에이전트가 끝까지 해요. 정한 이름은 이 할 일의 메모에서 봐요.
Play Console 에 앱 만들기
Play Console 에 이 앱을 만들어요.
- 앱 이름, 기본 언어, 앱/게임, 무료/유료를 정해 앱을 만들어요. 인앱 구매나 광고로 벌어도 앱 자체가 무료면 "무료"예요.
- 대시보드에 생기는 "앱 설정" 목록은 등록정보·앱 콘텐츠 할 일에서 채워요.
- Play Console 로그인.
- 선언 체크(개발자 프로그램 정책·미국 수출 법) — 앱이 Play 정책에 맞고 수출 규제 대상(암호화 등)에 걸리지 않는지 보고 체크해요. 만들기는 에이전트가 눌러요.
업로드 키 만들기
AAB 에 서명할 업로드 키(keystore)를 한 번 만들고, 바로 안전한 곳에 사본을 둬요.
- Play App Signing 을 써요. Play 가 실제 앱 서명 키를 갖고, 에이전트가 업로드 키로 서명해 올려요.
- 업로드 키를 만들어요. 앱마다 하나예요.
- 키 파일과 비밀번호는 만들자마자 allob 금고의 "Android 업로드 키"에 넣어요. 이 할 일 화면의 "필요한 것"에서 바로 넣을 수 있어요. 빌드할 때마다 화면에서 확인하고 꺼내 써요. 키·서류를 안 쓰면 비밀번호 관리자처럼 안전한 곳에 사본을 둬요.
- 어디서 빌드하든(내 컴퓨터·클라우드 빌드·CI) 같은 키로 서명해요. 다른 키로 서명하면 Play 가 거부해요.
⚠ 업로드 키를 잃으면 Play 에 재설정을 요청해야 하고, 그동안 새 빌드를 못 올려요.
- 키를 금고에 넣을 때 PIN(또는 패스키)만 확인해 주세요.
- 빌드할 때마다 확인 요청이 오면, 이 앱의 빌드가 맞는지 보고 승인해요.
내부 테스터 넣기
운영자와 가까운 사람을 내부 테스트 테스터로 넣어, 올린 빌드를 바로 받아 보게 해요.
- Play Console → 테스트 → 내부 테스트 → 테스터에서 메일 목록을 만들고 운영자 메일을 넣어요.
- 테스터는 참여 링크를 열고 "테스터 되기"를 눌러야 받을 수 있어요.
- 인앱 결제를 시험하려면 라이선스 테스터에도 넣어요(Google Play 개발자 계정).
에이전트가 끝까지 해요. 받은 참여 링크를 폰에서 열고 "테스터 되기"를 눌러요.
빌드 올리기
업로드 키로 서명한 AAB 를 만들어 내부 테스트 트랙에 올려요.
- versionCode 를 1 올려요. 같은 번호는 다시 못 올려요.
- 출시 빌드 검사 — 테스트 광고가 섞였거나 OTA 가 시험 채널을 보는 빌드는 올리지 않아요.
- 서명한 AAB 를 내부 테스트 트랙에 올려요.
- 올린 뒤 릴리스 빌드를 한 번 켜서 결제·광고와 아이콘을 확인해요.
인앱 상품은 첫 AAB 를 올린 뒤에 만들 수 있어요.
에이전트가 끝까지 해요. 업로드 키를 꺼낼 때 오는 확인 요청만 승인하고, 참여 링크로 설치해 결제·광고·아이콘을 봐요.
등록정보 쓰기
Play 스토어 페이지에 보일 글과 연락처를 넣어요.
- 앱 이름, 간단한 설명, 자세한 설명을 언어마다 써요. 설명엔 앱 소개만 써요.
- 연락처 메일과 개인정보 처리방침 URL 을 넣어요.
- 카테고리·태그를 골라요.
에이전트가 끝까지 해요. 결과는 Play Console 의 기본 스토어 등록정보에서 봐요.
그래픽 올리기
Play 스토어 페이지에 보일 아이콘·그래픽 이미지·스크린샷을 올려요.
- 앱 아이콘, 그래픽 이미지(맨 위 가로 그림), 폰 스크린샷을 만들어요. 크기는 Play 규격에 맞춰요.
- iOS 와 같은 장면을 써도 되지만 Android 기기 모양으로 만들어요.
- 언어마다 따로 올리고 화면 속 글도 그 언어로 써요.
에이전트가 끝까지 해요. 결과는 Play Console 의 스토어 등록정보 그래픽에서 봐요.
앱 콘텐츠 설문 답하기
Play Console "앱 콘텐츠"의 신고 설문에 모두 답해요.
앱이 실제로 모으는 데이터만 답해요. 코드·개인정보 처리방침·결제·광고·로그인 설정을 보고, SDK 공식 데이터 안내에 있는 것까지 넣어요(데이터 보안 안내).
- 개인정보 처리방침 — URL 을 넣어요.
- 앱 액세스 — 로그인 없이 다 되면 "제한 없음", 아니면 심사용 계정을 넣어요.
- 광고 — 광고가 있는지 답해요.
- 콘텐츠 등급 — IARC 설문에 답해요.
- 타겟층 — 광고가 있고 13세 미만이 포함되면 가족 정책이 붙어요.
- 데이터 보안 — 데이터 유형마다 수집/공유·필수/선택·목적을 답하고, 계정이 있으면 계정 삭제 URL 을 넣어요.
- 광고 ID — 쓰는지 답해요.
- 정부·금융·건강 앱 — 해당하는지 답해요.
로그인·광고·결제를 바꾸면 다시 답해요.
에이전트가 끝까지 해요. 답 표는 이 할 일의 메모에서, 결과는 Play Console 의 앱 콘텐츠에서 봐요.
비공개 테스트 12명·14일 돌리기
2023-11-13 이후 만든 개인 계정이면, 프로덕션 전에 비공개 테스트에 12명 이상이 14일 연속 참여하게 해요.
- 비공개 테스트 트랙에 빌드를 올리고 테스터 목록(구글 그룹 또는 메일 목록)을 붙여요. 내부 테스트는 세지 않아요.
- 테스터가 참여 링크에서 "테스터 되기"를 누르고 앱을 설치해요. 14일 동안 빠지지 않게 해요.
- 명단은 운영자가 정해요(Google Play 개발자 계정 할 일에서 미리 모아요). 기다리는 시간이 길어 다른 일보다 먼저 시작해요.
조건은 테스트 요건에서 확인해요. 앱마다 다시 하는지는 확인 필요예요.
에이전트가 트랙과 참여 링크를 만들어요. 운영자는 테스터에게 링크를 보내 주면 돼요. 남은 날·인원은 Play Console 대시보드에서 봐요.
프로덕션 액세스 신청하기
비공개 테스트가 끝나면 대시보드에서 프로덕션 액세스를 신청하고 승인을 기다려요.
- 대시보드에서 "프로덕션 액세스 신청"을 열어요.
- 테스트를 어떻게 했는지, 의견으로 무엇을 고쳤는지, 출시 준비가 됐는지 답하고 제출해요.
- 거절되면 사유대로 테스트를 더 하고 다시 신청해요. 조건을 채워도 승인이 보장되진 않아요.
검토는 며칠 걸려요(보통 일주일 안 — 확인 필요).
에이전트가 신청하고, 승인되면 끝내요.
프로덕션에 출시하기
프로덕션 트랙에 빌드를 올려 Google Play 에 공개해요.
- 프로덕션 → 새 버전 만들기에서 내부 테스트로 확인한 빌드를 골라요.
- 출시 노트를 쓰고 국가/지역을 골라요.
- 검토로 보내요. 검토 중에 새 빌드로 바꾸면 검토가 처음부터 다시 시작되니 꼭 필요할 때만 바꿔요.
"심사 제출·출시까지 맡기기"가 꺼져 있으면 검토로 보내기 앞에서 확인 요청이 오고, 운영자가 승인할 때까지 기다려요.
맡기기가 꺼져 있으면 제품 › 스토어(또는 연결)의 승인 요청에서 \"출시\" 한 번만 누르면 돼요.
자주 걸리는 함정
| 증상 | 원인·해결 |
|---|---|
| 프로덕션 버튼이 막혀 있음 | 2023-11-13 이후 개인 계정 → 비공개 테스트 12명·14일 뒤 프로덕션 액세스 신청 |
| AAB 업로드가 "다른 키로 서명됨"으로 거부 | 업로드 키를 새로 만들었어요 → 처음 키를 찾거나 Play 에 재설정 요청 |
| 스토어에서 받은 앱만 Google 로그인 실패 | Play 앱 서명 키의 SHA-1 로 만든 OAuth 클라이언트가 없어요 |
| 테스터가 앱을 못 찾음 | 참여 링크에서 "테스터 되기"를 안 눌렀거나 다른 Google 계정으로 로그인했어요 |
| 14일이 지났는데 조건이 안 채워짐 | 중간에 12명 아래로 떨어진 날이 있었어요 → 처음부터 넉넉히 모아요(세는 방식은 확인 필요) |
| 스토어 앱에 실제 광고 대신 테스트 광고(또는 반대) | 출시 빌드 검사를 건너뛰었어요 |
나라·상황별로 달라지는 것
- EU — DSA 거래자 정보가 있어야 해요. 없으면 EU 에서 내려가요(Google Play 개발자 계정).
- 일본 — 일본어 등록정보를 따로 쓰고, 일본어로 팔면 特商法 표기 페이지가 필요해요(법 문서).
- 팔지 않을 나라 — 프로덕션의 국가/지역에서 빼요. 판매 국가와 처리방침이 다루는 나라를 맞춰요.
- 언어별 등록정보 — 언어마다 이름·설명·그래픽을 만들고, 번역만 하지 말고 그 나라 검색어로 써요.
출처
공식 안내와 마지막으로 맞춰 본 날: 2026-10-18