앱 출시 가이드
웹으로 만든 서비스를 앱으로 올릴 때
회사가 준비해야 하는 것
App Store 와 Google Play 에 앱을 올리려면 코드보다 먼저 회사가 준비할 게 있어요.
개발자 계정 개설 · 비용 · 서류 · 등록 항목을 사람이 하는 일 기준으로 정리했어요. 개발 지식 없이 읽을 수 있고, 코드 이야기는 마지막 부록에만 모았어요.
2026년 9월 기준이에요. 스토어 정책은 자주 바뀌니 등록할 때 원문(부록 C)을 한 번 더 확인하세요.
- 누가 하나
- 대표님 = 계약 서명 권한이 있는 사람(애플 · 구글 모두 계정 소유자는 이 사람이어야 해요) · 담당자 = 운영 · 마케팅 담당 · 헤이제임스 = 앱 패키징 · 빌드를 맡은 개발자
- 어디서 확인했나
- 공식 = 애플 · 구글 공식 문서에서 확인 · 참고 = 2025~2026년 국내외 실무 후기(공식 수치가 없는 항목) · 미확인 = 원문을 못 찾은 것, 등록 화면에서 직접 확인하세요
- 상자 색
- 회색 상자 = 알아두면 좋은 설명 · 노란 상자 = 실수하기 쉬운 것 · 빨간 상자 = 놓치면 심사 거절이나 계정 문제로 이어지는 것
1. 한눈에 보기
애플 개발자 프로그램
₩129,000 / 년
US$99. 매년 자동 갱신, 환불 불가. 갱신을 끊으면 앱이 스토어에서 내려감
Google Play 개발자 등록
US$25 / 1회
한 번만 냄(환율에 따라 약 3만 3천~3만 6천 원). 환불 불가
D-U-N-S 번호 (사업자 식별번호)
무료
애플 신청 창구로 받으면 무료. 국내 대행(NICE디앤비)은 수수료 있음
애플 · 계정 개설부터 출시까지
3~6주
법인(조직) 계정 기준. D-U-N-S 대기 + 애플 조직 검증이 대부분. 개인 계정이면 1주 안팎
구글 · 계정 개설부터 출시까지
1~6주
D-U-N-S 가 이미 있으면 1~2주. 신규 개인 계정은 14일 비공개 테스트가 추가됨
심사 소요 (제출 후)
1일 / ~7일
애플은 90% 가 24시간 내 · 구글은 최대 7일, 신규 계정은 더 걸릴 수 있음
먼저 정해야 하는 것 세 가지
계정 유형
추천운영 주체가 법인이면 두 스토어 모두 조직(Organization) 계정. 개인사업자라면 애플은 개인, 구글은 개인 또는 조직(2장 참고)
이유조직 계정이어야 스토어에 회사 이름이 판매자로 표시돼요. 개인 계정은 대표 개인의 실명이 노출돼요. 구글 신규 개인 계정에는 “12명 × 14일 테스트” 의무도 붙어요.
앱 안의 결제
추천앱은 무료 · 앱 안에서는 요금제 · 결제 · 업그레이드 화면을 보여주지 않음. 구독 결제는 지금처럼 웹(토스페이먼츠)에서만
이유앱 안에서 구독을 팔면 애플 · 구글 결제(수수료 15~30%)를 반드시 써야 하고, 안 쓰면 심사에서 거절돼요. 앱을 “웹에서 산 것을 쓰는 앱”으로 두면 이 문제를 통째로 피해요(3장 · 4장 심사 주의점).
배포 국가
추천대한민국만
이유EU 에 배포하면 사업자 주소 · 전화가 공개되는 “트레이더” 등록이 더 필요해요(애플은 EU 미배포 시 불필요라고 명시). 유료 앱 계약 · 세금 서류도 무료 앱이면 필요 없어요.
준비물 체크리스트
회사 · 사람
- 사업자등록증 + 영문 사업자등록증명(홈택스, 3개월 이내) — D-U-N-S · 세금 서류용 · 담당자
- 대표(서명 권한자)의 신분증 — 애플은 여권 권장, 구글은 신분증/여권 · 대표님
- 2단계 인증이 켜진 Apple 계정(Apple ID)과 Google 계정 — 회사 도메인 이메일 권장 · 대표님
- 회사 공개 웹사이트 — 서비스 주소로 충분(애플이 도메인 · 내용을 확인) · 헤이제임스
- 회사 전화번호(문자 인증 받을 수 있는 것), 회사 이메일 · 담당자
- 해외 결제 가능한 신용카드(법인카드 또는 대표 카드) · 대표님
앱 · 문서
- 개인정보처리방침 URL — 서비스의 /privacy 페이지 · 헤이제임스
- 이용약관 URL — 서비스의 /terms 페이지 · 헤이제임스
- 지원(고객센터) URL — 연락처(이메일 · 전화 · 주소)가 보이는 페이지여야 함 · 헤이제임스
- 앱 아이콘 1024×1024 (애플) / 512×512 (구글), 구글용 피처 그래픽 1024×500 · 헤이제임스
- 스크린샷 — 아이폰 1320×2868 최소 1장(권장 3~5장), 안드로이드 1080×2400 최소 2장 · 헤이제임스
- 심사용 데모 계정(이메일 · 비밀번호) — 실제 데이터가 미리 채워진 것 · 헤이제임스
- 앱 이름 · 부제 · 설명 · 키워드 문안 — 5장 틀로 작성 · 담당자
가장 먼저 시작할 것
D-U-N-S 번호 신청이에요. 무료지만 발급에 1~2주(구글 안내상 최대 30일)가 걸리고, 조직 계정은 이 번호 없이는 한 발도 못 나가요. 오늘 신청해 두면 나머지를 준비하는 동안 나와요. 신청법은 2장에 있어요.
2. 두 스토어 공통 준비
2-1. 계정 유형 정하기 — 법인인지 개인사업자인지가 갈림길
두 스토어 모두 “개인”과 “조직” 두 종류 계정이 있어요. 기능은 같고, 스토어에 누가 판매자로 보이느냐와 검증 절차가 달라요.
| 항목 | 개인 계정 | 조직 계정 |
|---|---|---|
| 누가 만들 수 있나 | 성인 개인(개인사업자 포함) | 계약을 체결할 수 있는 법인. 애플은 상호·지점·DBA 불가 공식 |
| 스토어에 보이는 판매자 | 대표 개인의 법적 실명 | 법인명 |
| 애플 추가 요건 | 없음. 결제 즉시 개설 | D-U-N-S 번호 · 공개 웹사이트 · 서명 권한 확인(권한을 확인해 줄 직원 연락처) · 애플 검증 후 결제 |
| 구글 추가 요건 | 신분증 인증 · 실제 안드로이드 기기 인증 · 12명 × 14일 비공개 테스트 후 출시 심사 | D-U-N-S 번호 · 조직 서류(국가별) · 대표자 신분증. 14일 의무 없음 |
| 구글에 공개되는 정보 | 이름·국가·이메일(유료/인앱결제를 하면 주소까지) | 법인명·법인 주소·이메일·전화번호 |
나중에 바꿀 수 있나 — 애플 · 구글 모두 사실상 새 계정을 만들어 앱을 옮기는 절차예요. 처음에 제대로 고르는 게 훨씬 싸요.
개인사업자라면
애플은 D&B 에 “개인사업자(sole proprietorship)”로 잡히면 법인이 아니라며 조직 등록을 막고 개인 등록을 안내해요 공식. 이때 애플 스토어에는 대표 실명이 판매자로 떠요. 구글은 D-U-N-S 를 받으면 개인사업자도 조직으로 신청하는 사례가 있지만 최종 판정은 구글이 해요 참고. 회사명을 스토어에 내걸고 싶다면 법인 전환부터 검토하세요.
2-2. D-U-N-S 번호 받기 (조직 계정 필수, 무료)
D-U-N-S 는 던앤브래드스트리트(D&B)가 부여하는 9자리 사업자 식별번호예요. 애플 · 구글 모두 조직 계정을 만들 때 이 번호로 회사를 확인해요. 한 번 받으면 두 스토어에 같이 써요.
-
1
애플의 D-U-N-S 조회 페이지에서 먼저 검색
developer.apple.com/enroll/duns-lookup 에서 회사명(영문) · 주소로 조회해요. 이미 번호가 있으면 그대로 써요. 공식
-
2
없으면 같은 화면에서 무료 신청
영문 법인명(사업자등록증과 철자까지 일치) · 본사 주소 · 우편 주소 · 담당자 연락처를 입력해요. 애플 창구로 신청하면 무료예요. 국내 파트너 NICE디앤비로 신청하면 대행 수수료가 붙어요(금액 미확인). 공식
-
3
서류 요청이 오면 영문 사업자등록증명 제출
홈택스에서 발급한 3개월 이내 영문 증명이 표준이에요. 참고
-
4
발급 대기
D&B 발급 최대 5영업일 + 애플 시스템 반영 최대 2영업일(애플 안내) · 구글 안내는 “최대 30일” · 국내 후기는 1~2주. 급행 없음. 공식
-
5
이름 · 주소를 세 곳에서 똑같이 맞추기
사업자등록증 · D-U-N-S · 개발자 계정(구글은 결제 프로필)의 회사명 · 주소가 한 글자라도 다르면 검증이 막혀요. 구글은 불일치를 28일 안에 못 고치면 계정을 정리해요. 공식
2-3. 회사 정보 정리해 두기
| 항목 | 어디에 쓰이나 | 준비 메모 |
|---|---|---|
| 영문 법인명 · 영문 주소 | D-U-N-S, 애플 조직 등록, 구글 결제 프로필 | 사업자등록증 영문 표기와 통일 |
| 회사 대표 이메일 | 애플 계정 ID, 구글 개발자 이메일(스토어에 공개됨) | 개인 지메일보다 회사 도메인 권장 |
| 회사 전화번호 | 애플 검증 전화 · 구글 OTP 인증 · 구글 조직 계정은 스토어에 공개 | 문자·전화 받을 수 있는 번호 |
| 공개 웹사이트 | 애플 조직 등록 시 “조직과 연관된 실제 사이트” 확인 | 서비스 주소로 충분. SNS 페이지·빈 페이지는 거절 |
| 사업자등록번호 | 애플 한국 전자상거래법 정보(무료 앱도 필수) · 구글은 유료/인앱결제 시 | — |
| 서명 권한자(대표) | 애플 Account Holder · 구글 계정 소유자. 계약 동의·검증은 이 사람만 가능 | 대표가 직접 가입하는 것이 가장 빠름 |
2-4. 정책 페이지와 지원 페이지
- 개인정보처리방침 — 두 스토어 모두 URL 필수이고, 앱 안에서도 링크가 보여야 해요. 서비스에 이미 있는 /privacy 페이지를 그대로 써요. 수집 항목 · 제3자 제공(문자 발송 대행 등) · 보관/삭제 정책이 적혀 있는지 한 번 확인하세요. 공식
- 지원 URL — 애플은 “실제 연락처(주소 · 이메일 · 전화)로 이어지는 페이지”를 요구해요. 랜딩 하단에 문의 이메일이 있으면 랜딩 주소도 되지만, 별도 고객센터 페이지(예: /guide 또는 /support)를 두는 편이 안전해요. 공식
- 계정 삭제 안내 페이지 — 구글은 앱 안 탈퇴 기능과 별도로 “웹에서 삭제를 요청할 수 있는 링크”를 데이터 보안 양식에 적으라고 해요. 회원탈퇴 화면이 있으면, 로그인 없이 볼 수 있는 안내 페이지 하나만 더 있으면 돼요. 공식
2-5. 심사용 데모 계정
로그인해야 쓰는 앱이라면 두 스토어 모두 심사관이 들어가 볼 테스트 계정을 요구해요. 애플은 미해결 심사 문제의 40% 이상이 “앱을 제대로 볼 수 없었다”(2.1 완전성) 때문이라고 밝혀요. 공식
- 이메일 · 비밀번호 로그인 계정 1개. 핵심 데이터가 미리 채워진 상태로 준비해요(빈 화면만 보이면 “기능이 없다”로 오해해요).
- 외부 플랫폼 연동(예약 · 결제 · SNS 등)이 실제 계정 세션이 있어야 동작하면, 데모에서는 시드 데이터로 대신하고 심사 노트에 이유를 적어요(5장 틀).
- 심사 기간 내내 서버가 켜져 있어야 하고, 비밀번호를 바꾸면 안 돼요.
3. 애플 App Store
3-1. 개발자 계정 개설 — 조직(법인) 기준
-
1
Apple 계정 준비
대표님
회사 이메일로 Apple 계정을 만들고 2단계 인증을 켜요. 이 계정이 “Account Holder”(계정 소유자)가 되고, 계약 동의 · 검증 응답 · 결제는 이 사람만 할 수 있어요. 대표(서명 권한자)가 직접 하는 게 가장 빨라요. 공식
-
2
D-U-N-S 번호 확보
담당자
2장 절차대로 해요. 발급 뒤 애플 시스템 반영까지 2영업일 더 걸려요.
-
3
등록 경로 선택 — 웹 또는 “Apple Developer” 앱
대표님
웹(developer.apple.com/enroll) 또는 iPhone 의 Apple Developer 앱 둘 다 조직 등록이 돼요. 앱으로 하면 신분증(여권 권장)을 카메라로 촬영하고, 시작한 기기로 끝까지 진행해야 해요. 한국 App Store 의 Apple Developer 앱에 “Apple Developer Program ₩129,000” 인앱 구입이 표시돼 국내에서도 앱 등록이 되는 것으로 보이지만, 애플이 지원 국가 목록을 공개하지 않아요 미확인. 막히면 웹으로 하면 돼요.
-
4
조직 정보 입력
대표님
법인명 · D-U-N-S · 본사 주소 · 전화 · 공개 웹사이트 · 서명 권한 확인. 등록자가 대표/설립자가 아니면 권한을 확인해 줄 임직원 연락처를 내야 하고, 공증 서류를 요구받을 수 있어요. 한국어 이름은 로마자 표기도 함께 적어요. 공식
-
5
애플 검증 대기
대표님
애플이 이메일 · 전화로 확인해요(공식 문서에 전화 확인이 명시돼 있진 않지만 실무 후기 다수 참고). 순조로우면 3~5영업일, 길면 2~4주예요. 2026년 포럼에 조직 검증이 몇 주 걸린 사례가 여럿 있어요. 여유를 두세요.
-
6
승인 메일 후 결제 ₩129,000
대표님
조직은 검증이 끝나야 결제 단계가 열려요. 신용카드로 결제하고, 결제 뒤 24시간 안에 확인 메일이 와요(안 오면 Enrollment ID 로 문의). 공식
-
7
App Store Connect 첫 설정
대표님 · 헤이제임스
appstoreconnect.apple.com 에서 ① Account Holder 가 개발자 프로그램 계약에 동의(동의 전에는 앱을 만들 수 없음) ② 한국 전자상거래법 정보 입력(3-2) ③ 헤이제임스를 팀원으로 초대(Users and Access → 역할 Admin 또는 App Manager). 공식
3-2. 비용 · 계약 · 한국 필수 정보
| 항목 | 내용 |
|---|---|
| 연회비 | ₩129,000 / 년 (US$99). 앱 등록 시 자동갱신 구독, 환불 불가, 기프트카드·계정 잔액 결제 불가. 갱신하지 않으면 앱이 스토어에서 내려가요(참고). 면제는 비영리·교육·정부기관만이라 영리 SaaS 는 해당 없음. 공식 |
| 기본 계약 | Apple Developer Program License Agreement = 무료 앱 계약. 매년 또는 개정 때마다 Account Holder 가 다시 동의해야 하고, 동의가 밀리면 새 버전 제출이 막혀요. 공식 |
| 유료 앱 계약 | 무료 앱이면 필요 없음. 앱 안에서 유료 판매를 할 때만 Paid Applications Agreement + 은행 계좌 + 세금 서류(W-8BEN, 한국 사업자등록번호, 90일 이내 영문 사업자등록증명). 공식 |
| 한국 전자상거래법 정보 | 무료 앱이라도 한국 기반 개발자는 필수. App Store Connect → Business → Agreements → Compliance → Korean Law 에서 회사명·이메일·전화·사업자등록번호를 입력하고 전화·이메일 인증. 앱 상세 페이지에 판매자 정보로 표시돼요. 공식 |
| EU 트레이더 정보 | EU 에 배포할 때만. 배포 국가를 대한민국으로 한정하면 불필요(애플 명시). 공식 |
3-3. App Store Connect 에 입력하는 항목 — 전체 목록
앱을 만들 때 한 번 정하는 것(앱 정보)과 버전마다 다시 쓰는 것(버전 정보)으로 나뉘어요. 5장에 문안 틀이 있어요.
① 앱 만들 때 (New App) — 한 번 정하면 못 바꾸는 것이 있음
| 항목 | 규칙 | 메모 |
|---|---|---|
| 앱 이름 | 2~30자. 첫 심사 제출 전까지 수정 가능. 스토어에서 다른 앱과 겹치면 못 씀 | 서비스명 그대로 |
| 기본 언어 | 필수. 한국어 | ko |
| Bundle ID | 앱의 고유 식별자(예: com.회사명.서비스명). 첫 빌드 업로드 후 변경 불가 | 헤이제임스 가 정함 |
| SKU | 내부 관리용 코드. 생성 후 변경 불가 | 예: 서비스명-ios |
② 앱 정보 (App Information) — 앱 단위
| 항목 | 규칙 | 메모 |
|---|---|---|
| 부제 | 30자, 선택 | 서비스를 한 줄로(예: “예약·정산을 한 곳에서”) |
| 기본 카테고리 | 필수. 27개 중 택1. 업무용 도구는 Business, 생활 서비스는 Lifestyle 등 | 서비스 성격에 맞게. 보조 카테고리는 선택 |
| 콘텐츠 권리 | 제3자 콘텐츠 권리 보유 여부 | 대부분 “포함하지 않음” |
| 연령 등급 | 2025년 7월 개편 설문(4+/9+/13+/16+/18+). 앱 내 제어·기능·의료·폭력 등 질문 | 일반 업무·생활 서비스는 4+. “무제한 웹 접근”은 아니오(자사 화면만 보여줌) |
| 개인정보 처리방침 URL | 필수 | https://서비스도메인/privacy |
| 라이선스 계약(EULA) | 선택. 비우면 애플 표준 약관 | 비움 |
③ 버전 정보 (Version Information) — 버전마다
| 항목 | 규칙 | 메모 |
|---|---|---|
| 스크린샷 | iPhone 6.9” 1~10장 필수(3-4) | 3~5장 권장 |
| 프로모션 텍스트 | 170자, 선택. 심사 없이 수시 수정 가능 | 5장 틀 |
| 설명 | 4,000자, 필수, 일반 텍스트(HTML 불가) | 5장 틀 |
| 키워드 | 100바이트. 한글은 1글자 3바이트 → 약 30자. 쉼표 구분, 앱명·회사명·타사 이름 금지 | 5장 틀 |
| 지원 URL | 필수. 실제 연락처(주소·이메일·전화)가 보이는 페이지 | 고객센터 페이지 |
| 마케팅 URL | 선택 | 서비스 주소 |
| 버전 · 저작권 | 저작권은 “연도 회사명” 형식(© 는 자동) | “2026 (법인명)” |
| 새로운 기능 | 4,000자. 두 번째 버전부터 필수 | 1.0 은 없음 |
| App Review 정보 | 담당자 이름·이메일·전화 필수. 로그인 앱은 데모 계정 ID/비밀번호 필수. 노트 4,000바이트 | 5장 틀 |
| 출시 방식 | 심사 통과 후 수동 / 자동 / 지정일. 단계적 출시(7일) 선택 가능 | 첫 출시는 “수동” 권장 |
④ 그 밖의 필수 선언
| 항목 | 규칙 | 메모 |
|---|---|---|
| App Privacy (앱 개인정보) | 수집하는 데이터 종류별로 ① 사용자와 연결되는지 ② 추적에 쓰는지 ③ 목적. 스토어에 “영양성분표”처럼 표시 | 연락처 정보(이름·이메일·전화) · 사용자 콘텐츠 · 식별자(사용자 ID). 목적 “앱 기능”, 추적 없음 — 서비스에 맞게 조정 |
| 수출 규정(암호화) | HTTPS 만 쓰는 앱은 면제. 개발자가 설정값을 앱에 넣어 두면 매번 묻지 않음 | 헤이제임스 |
| 가격 · 배포 국가 | 무료 / 175개 국가 중 선택 | 무료 · 대한민국만 |
3-4. 스크린샷과 아이콘 규격
| 자산 | 규격 | 비고 |
|---|---|---|
| iPhone 스크린샷 (필수) | 1320 × 2868 px (세로), 6.9인치 기준. 1~10장, JPG/PNG, 투명 배경 불가 | 다른 크기 아이폰은 이 이미지에서 자동 축소. 1284×2778(6.5인치)로 대체 가능 |
| iPad 스크린샷 | 2064 × 2752 px, 13인치 기준 | 앱을 iPad 도 지원하게 빌드했을 때만 필수. 아이폰 전용으로 내면 불필요 — 헤이제임스와 결정 |
| 앱 아이콘 | 1024 × 1024 PNG, 투명·둥근 모서리 없음 | 스토어에 따로 올리지 않고 헤이제임스가 앱 빌드에 넣음 |
| 앱 미리보기 영상 | 선택, 기기별 최대 3개 | 첫 출시엔 생략 가능 |
스크린샷 내용 규칙
로그인 화면 · 스플래시가 아니라 실제로 쓰는 화면이어야 해요(가이드라인 2.3.3). 첫 화면 · 핵심 목록 · 상세 · 설정 순으로 3~5장이면 충분해요. 화면 위에 짧은 설명 문구를 얹은 “프레임 이미지” 형태가 흔하고, 제작 자동화는 부록 A-3 을 보세요.
3-5. 심사에서 걸리기 쉬운 것 — Hotwire Native 앱 특화
| 가이드라인 | 무엇을 보나 | 대응 |
|---|---|---|
| 4.2 최소 기능 — “웹사이트를 포장만 한 앱” 거절 | 웹사이트를 앱 껍데기에 넣기만 하면 거절. 앱만의 기능·UI 가 있어야 함. Hotwire Native 제작자도 “네이티브 탭바·푸시 알림 같은 요소를 한두 개는 넣으라”고 조언 참고 | 헤이제임스 하단 네이티브 탭바 · 푸시 알림 · 카메라 권한 화면 · 오프라인 안내 화면 등 앱에서만 되는 요소를 넣고, 심사 노트에 이 목록을 적음 |
| 5.1.1(v) 계정 삭제 | 회원가입이 있으면 앱 안에서 계정을 완전히 삭제할 수 있어야 함(2022년~). 웹 페이지로 넘겨 완료하는 것은 허용 공식 | 회원탈퇴 화면이 이미 있으면 앱 설정 메뉴에서 찾기 쉽게 노출만 하면 됨 |
| 3.1.1 인앱 결제 — 가장 위험한 항목 | 앱 안에서 구독·유료 기능을 팔면 애플 결제 필수. 웹 결제로 유도하는 버튼·문구도 금지. 3.1.3(f): 유료 웹 서비스의 무료 컴패니언 앱은 앱 안에 구매·구매 유도가 없으면 IAP 불필요 공식 | 헤이제임스 앱에서는 요금제·구독·결제 화면과 “업그레이드” 버튼을 숨김. 스토어 설명에도 가격·요금제 언급을 넣지 않음. 한국 대체결제 제도(수수료 26%)는 실익이 없어 비추천 |
| 2.1 완전성 · 데모 계정 | 심사관이 모든 화면을 볼 수 있어야 함. 데모 계정·백엔드 가동 필수 | 2-5 의 데모 계정 + 5장 심사 노트 |
| 4.8 Sign in with Apple | 구글·카카오 등 소셜 로그인을 넣으면 애플 로그인도 함께 필수. 자체 이메일 로그인만이면 불필요 공식 | 이메일 로그인만이면 해당 없음. 소셜 로그인을 넣는다면 애플 로그인도 같이 추가(2026년부터 한국 개발자는 서버 알림 엔드포인트도 필수) |
| 5.1.1(i) 개인정보 | 처리방침 링크가 스토어와 앱 안 양쪽에 | 설정 화면에 링크 |
3-6. 개발 환경 요건 · 테스트 · 심사 기간
- Mac 과 Xcode 26 필수 — 2026년 4월 28일부터 Xcode 26(iOS 26 SDK) 이상으로 빌드한 앱만 올라가요. 최신 Xcode 는 macOS Tahoe 26.2 이상이 필요해요. 공식 헤이제임스
- TestFlight(베타 테스트) — 내부 테스터 100명(심사 없이 바로), 외부 테스터 최대 1만 명(첫 빌드는 간단 심사 약 1일). 빌드는 90일 뒤 만료돼요. 출시 전에 회사 구성원이 실제 폰으로 써 보는 용도로 쓰세요. 공식
- App Review — 애플 공식: 제출의 90% 가 24시간 안에 처리돼요. 거절되면 사유가 오고 고쳐서 다시 제출해요(1~2회 거절이면 +2~5일). 공식
4. Google Play
4-1. 개발자 계정 개설 — 조직(법인) 기준
-
1
Google 계정 준비
대표님
회사 이메일로 Google 계정을 만들어요. 이 계정이 “계정 소유자”가 되고, 인증 절차는 소유자만 시작할 수 있어요. 공식
-
2
play.google.com/console 에서 가입 → “조직” 선택
대표님
개인/조직은 인증이 끝나면 바꿀 수 없어요. 법인명 · 법인 주소 · 조직 유형 · 규모 · 웹사이트를 입력하고 D-U-N-S 번호를 넣어요(입력 시도 횟수 제한 있음). D-U-N-S 의 법인명 · 주소와 여기 입력값이 정확히 같아야 해요. 공식
-
3
연락처 인증
대표님
구글 연락용 이메일 · 전화(비공개)와 스토어에 공개될 개발자 이메일 · 전화를 각각 문자/전화 OTP 로 인증해요. 조직 계정은 법인명 · 주소 · 이메일 · 전화가 앱 페이지에 공개돼요. 공식
-
4
Google 결제 프로필 만들기 + US$25 결제
대표님
법인 결제 프로필(법인명 · 주소는 D-U-N-S 와 일치, 국가는 나중에 변경 불가)을 만들어 연결해요. 한 번 연결하면 바꿀 수 없어요. 등록비는 신용카드(선불카드 불가)로 US$25, 환불 불가. 공식
-
5
신원 · 조직 서류 인증
대표님
대표자(또는 권한 있는 임직원) 신분증 + 조직 공식 문서를 올려요. 문서 목록은 국가별로 콘솔이 보여줘요. 한국에서 사업자등록증이 그대로 인정되는지는 미확인 — 콘솔의 안내 목록을 따르세요. “지원하지 않는 문서 제출”이 인증 실패의 1위 원인이에요. 소요 “며칠”. 공식
-
6
팀원 초대 · 한국 판매자 정보 입력
담당자
Users and permissions 에서 헤이제임스를 초대해요. 계정 세부정보의 업체 문의 연락처에 한국 개발자 필수 정보(4-2)를 넣어요.
-
7
앱 만들기 → 첫 빌드 올리기
헤이제임스
콘솔에서 앱을 만들고(앱 이름 · 언어 · 앱/게임 · 무료) 첫 AAB 파일을 내부 테스트 트랙에 올려요. 이 첫 업로드는 반드시 콘솔에서 손으로 해야 해요(부록 A).
신규 “개인” 계정이면 여기에 14일이 더 붙어요
2023년 11월 13일 이후 만든 개인 계정은 출시 전 비공개 테스트에 테스터 12명이 14일 연속 참여해야 해요. 그 뒤 “프로덕션 액세스 신청” 심사(최대 7일)를 거쳐요. 조직 계정은 이 의무가 없어요. 공식
4-2. 비용 · 한국 개발자 필수 정보 · 결제 정책
| 항목 | 내용 |
|---|---|
| 등록비 | US$25, 1회. 원화 청구액은 공식 안내 없고 환율·카드 수수료에 따라 약 3만 3천~3만 6천 원 참고. 환불 불가, 별도 영수증 발급 없음(결제 내역으로 대신). 공식 |
| 한국 개발자 전원 | 업체는 연락처 주소 + 문의 전화번호, 개인은 문의 전화번호. 계정 세부정보의 “업체 문의 연락처 세부정보” 란. 공식 |
| 유료 앱 · 인앱결제를 할 때만 | 사업자등록번호 · 통신판매업 신고번호 · 신고 기관명(시/군/구청)을 추가 입력 → 한국 사용자에게 앱 설명 하단에 표시. 무료 앱만 배포하면 이 항목은 필요 없음. (웹에서 구독을 파는 사업 자체의 통신판매업 신고는 별개 문제예요.) 공식 |
| 판매자 계정 · 세금 | 구글 결제로 팔 때만 판매자 결제 프로필·은행 계좌 인증·W-8BEN. 무료 앱은 불필요. 공식 |
| 한국 대체 결제 | 전기통신사업법에 따라 한국에서는 구글 결제 대신 자체 결제를 앱에 넣을 수 있으나 수수료 감면이 4%뿐이라(15%→11%) 실익이 적음. 앱에 결제를 두지 않는 편이 단순. 공식 |
| EU 트레이더 선언 | 애플 같은 별도 선언 화면이 콘솔에 있는지는 미확인. 배포 국가를 한국으로 한정하면 실무상 문제 없음. |
4-3. Play Console 에 입력하는 항목 — 전체 목록
① 스토어 등록정보 (Main store listing)
| 항목 | 규칙 | 메모 |
|---|---|---|
| 앱 이름 | 30자 | “서비스명 - 한 줄 설명” 형태 권장 |
| 간단한 설명 | 80자. 목록·검색 결과에 노출 | 5장 틀 |
| 자세한 설명 | 4,000자. 키워드 반복·무관한 키워드 금지 | 5장 틀 |
| 앱 아이콘 | 512 × 512 PNG(투명 가능), 1MB 이하 | 애플용 1024 아이콘을 축소 |
| 그래픽 이미지(피처 그래픽) | 1024 × 500 JPG/PNG(투명 불가). 필수 | 로고 + 한 줄 슬로건 배너 |
| 휴대전화 스크린샷 | 최소 2장, 최대 8장. 세로 9:16 권장, 한 변 320~3840px, 긴 변이 짧은 변의 2배 이내. 추천 노출을 받으려면 1080px 이상 4장 | 1080 × 2400 으로 4~5장 |
| 태블릿 스크린샷(7”/10”) | 선택. 큰 화면 추천 노출을 원할 때만 | 첫 출시엔 생략 |
| 프로모션 동영상 | 선택. YouTube 공개/미등록 영상 URL | 생략 |
| 카테고리 · 태그 | 앱 카테고리 32개 중 택1, 태그 최대 5개 | 서비스 성격에 맞게 |
| 연락처 | 이메일 필수, 전화·웹사이트 선택(웹사이트 강력 권장) | 회사 이메일 · 서비스 주소 |
② 앱 콘텐츠 선언 (Policy → App content) — 게시 전 전부 완료해야 함
| 항목 | 무엇을 묻나 | 메모(예시 답) |
|---|---|---|
| 개인정보처리방침 | URL 필수(모든 앱). 앱 안에도 링크 | https://서비스도메인/privacy |
| 앱 액세스 (App access) | 로그인이 필요하면 심사용 계정과 진입 방법 제공(최대 5세트) | 2-5 데모 계정 |
| 광고 | 광고 포함 여부 | 대부분 “없음” |
| 콘텐츠 등급 (IARC 설문) | 폭력·성·도박 등 설문 → 한국 GRAC 포함 각국 등급 자동 부여. 미작성 시 앱 삭제 가능 | 일반 서비스는 전체이용가 |
| 타겟층 및 콘텐츠 | 대상 연령대 선택 | 성인 대상 서비스면 18세 이상만 선택(아동 대상 아님) |
| 데이터 보안 (Data safety) | 수집·공유 데이터 종류, 전송 암호화, 삭제 요청 방법, 계정 삭제 웹 링크 | 이름·이메일·전화·사진·사용자 ID 등 서비스에 맞게. 암호화 전송, 삭제 가능. 발송 대행사(문자 등)는 “처리 위탁”이라 공유로 안 잡힘 |
| 뉴스 · 코로나 · 정부 앱 | 해당 앱만 | 모두 “해당 없음” |
| 금융 기능 · 건강 앱 | 모든 앱이 답해야 함 | 해당 없으면 “없음” |
| 권한 선언 | 문자·통화기록 같은 민감 권한을 쓸 때만 | 해당 없음(카메라·알림은 선언 불필요) |
③ 출시 설정
| 항목 | 규칙 | 메모 |
|---|---|---|
| 앱 서명 (Play App Signing) | 2021년 8월 이후 새 앱은 필수. 서명 키는 구글이 보관, 개발자는 “업로드 키”만 관리 | 헤이제임스 |
| 배포 국가 | 프로덕션 트랙에서 선택 | 대한민국 |
| 가격 | 무료로 낸 앱은 나중에 유료로 못 바꿈(유료→무료는 가능) | 무료 |
| 출시 트랙 | 내부 테스트(100명) → 비공개 테스트 → 공개 테스트 → 프로덕션 | 내부 테스트로 회사 구성원 확인 → 프로덕션 |
| 출시 노트 | 버전별 “새로운 기능”(500자 권장) | 5장 틀 |
4-4. 정책 · 기술 주의점 — Hotwire Native 앱 특화
| 항목 | 규칙 | 대응 |
|---|---|---|
| 최소 기능 · 웹뷰 스팸 | “기능이 거의 없는 앱”, “남의 사이트를 허락 없이 웹뷰로 감싼 앱” 금지. 자사 사이트를 자사가 감싸는 건 허용되지만, 순수 껍데기로 보이면 거절 사례 있음 공식 참고 | 애플과 같은 대응: 네이티브 탭바·푸시·오프라인 화면. 37signals 의 Basecamp·HEY 가 같은 기술로 게시돼 있음 |
| 계정 삭제 | 앱 안 삭제 경로 + 웹에서 삭제 요청하는 링크(데이터 보안 양식에 기재). 일시 비활성화는 인정 안 됨 공식 | 앱 메뉴에 회원탈퇴 노출 + 로그인 없이 볼 수 있는 안내 페이지 URL |
| 결제 | 앱 안에서 디지털 구독을 팔면 구글 결제 필수. 단 “소비 전용(consumption-only)” 앱은 허용 — 웹에서 산 서비스를 앱에서 쓰기만 하는 구조. 웹 구매 페이지로 가는 링크·버튼은 금지 공식 | 애플과 같은 대응: 앱에서 요금제·결제 화면과 업그레이드 버튼 숨김 |
| targetSdk 36 (Android 16) | 2026년 8월 31일부터 새 앱은 Android 16 을 대상으로 빌드해야 함 공식 | 헤이제임스 첫 빌드부터 36. Hotwire Native 최소 지원은 Android 9(API 28) |
| AAB · 16KB 페이지 | APK 가 아닌 AAB 형식 필수. 2025-11 부터 16KB 메모리 페이지 지원 필수(순수 Kotlin 앱은 자동 충족) | 헤이제임스 푸시·분석 SDK 에 네이티브 라이브러리가 있는지만 확인 |
| 2026-09-30 앱 등록 확인 | Android 개발자 검증 제도에 따라 Play Console 홈에서 앱이 “등록됨”인지 확인. 99% 는 자동 등록 공식 | 출시 후 콘솔 홈 확인 |
4-5. 심사 기간
- 구글 공식: 일부 계정은 철저히 검토하며 최대 7일, 예외적으로 그 이상. 업계 관측으로는 보통 1~3일, 신규 계정의 첫 앱은 7~14일, 4분기 성수기 지연. 공식 참고
- 흔한 거절 사유: 데모 계정 오류 · 데이터 보안 답변과 실제 동작 불일치 · 개인정보처리방침 URL 오류 · 설명과 기능 불일치 · 웹뷰 껍데기 · 계정 삭제 미구현 · 오래된 targetSdk. 참고
5. 스토어 문안 작성 틀 (괄호만 채우는 틀)
두 스토어에 같은 문안을 쓰되, 글자 수 제한이 다른 곳만 나눴어요. 요금제 · 가격 · “업그레이드” 언급은 일부러 빼요(3-5 · 4-4 결제 항목). 괄호 안을 서비스 정보로 채우세요. 헤이제임스가 서비스에 맞춰 초안을 드리고, 회사가 확정해요.
| 항목 | 작성 틀 | 길이 |
|---|---|---|
| 앱 이름 (애플, 30자) | (서비스명) | 서비스명 그대로 |
| 부제 (애플, 30자) | (핵심 기능 세 개를 한 줄로 · 예: “예약·정산을 한 곳에서”) | 15자 안팎 |
| 앱 이름 (구글, 30자) | (서비스명) - (한 줄 설명) | 20자 안팎 |
| 간단한 설명 (구글, 80자) | (누가) (무엇을) 한 화면에서 (어떻게) 하세요. | 50~70자 |
| 프로모션 텍스트 (애플, 170자) | (문제 상황)을 한 화면에서. (대상 고객)을 위한 (서비스 종류). | 60자 안팎 |
| 키워드 (애플, 100바이트) | 서비스 분야 단어 8~10개를 쉼표로. 서비스명·회사명·타사 이름 제외 | 한글 약 30자 |
| 카테고리 | 애플: 27개 중 택1(보조 선택) · 구글: 32개 중 택1 | — |
| 연령 등급 | 애플 4+ · 구글 전체이용가(IARC), 타겟층 18세 이상 — 일반 업무·생활 서비스 기준 | — |
| 출시 노트 (구글 500자 / 애플 2번째 버전부터) | (서비스명) 첫 출시입니다. (핵심 기능 4~5개)를 제공합니다. | 60~80자 |
키워드에 타사 이름을 넣지 마세요
애플은 키워드에 다른 회사 · 앱 이름을 금지해요. 연동하는 외부 서비스 이름은 키워드에서 빼고 본문 설명에서 연동 기능으로만 언급해요. 한글은 글자당 3바이트라 100바이트 = 약 30자예요.
자세한 설명 틀 (두 스토어 공용, 4,000자 이내 · 700~800자 권장)
(서비스명)은 (대상 고객)을 위한 (서비스 종류)입니다. (흩어져 있던 무엇)을 한 화면에 모으고, (첫 단계)부터 (마지막 단계)까지 한 흐름으로 관리합니다. ■ (핵심 기능 1) - (무엇을 어떻게) - (무엇을 어떻게) ■ (핵심 기능 2) - … ■ (핵심 기능 3) - … ■ (핵심 기능 4) - … 이런 분께 맞습니다 - (고객 유형 1) - (고객 유형 2) - (고객 유형 3) 문의: (회사 이메일) 이용약관 https://(서비스도메인)/terms 개인정보처리방침 https://(서비스도메인)/privacy
기능 블록은 3~5개예요. 블록마다 화면 하나에 맞춰 쓰면 스크린샷 순서와 맞출 수 있어요.
심사 노트 틀 (애플 App Review 정보 · 구글 앱 액세스 안내 공용)
[테스트 계정] 이메일: (데모 계정 이메일) / 비밀번호: (비밀번호) [앱 설명] (누가) (무엇을) 관리하는 (B2B/B2C) (서비스 종류) 앱입니다. (가입 주체)가 직접 가입해 사용합니다. [로그인이 필요한 이유] (어떤 민감 데이터)를 다루므로 계정별로 접근을 제한합니다. [외부 연동] (외부 서비스) 연동은 실제 계정 세션이 있어야 동작합니다. 테스트 계정에는 연동 대신 샘플 데이터를 미리 넣어 두었습니다. [네이티브 기능] 하단 탭바, 푸시 알림((어떤 알림)), 카메라((어떤 용도)), 오프라인 안내 화면. [결제] 앱 안에는 결제·구독 판매 기능이 없습니다. [계정 삭제] 설정 → 계정 → 회원탈퇴 에서 앱 안에서 즉시 삭제할 수 있습니다. [담당자] 이름 / 이메일 / 전화 (심사 기간 중 연락 가능)
6. 전체 일정표와 체크리스트
6-1. 권장 일정 (조직 계정, 두 스토어 동시 진행)
| 시기 | 회사가 할 일 대표 담당자 | 헤이제임스가 할 일 헤이제임스 |
|---|---|---|
| 1일차 | D-U-N-S 조회·신청(무료) · 영문 사업자등록증명 발급 · 회사 이메일/전화/카드 준비 · 계정 유형 결정(2-1) | 앱 패키징 · Bundle ID / 패키지명 확정 · 앱 아이콘 1024 제작 |
| 1주차 | Apple 계정·Google 계정 만들기(2단계 인증) · 구글 Play Console 가입 + US$25 + 서류 인증(D-U-N-S 나오면 즉시) · 지원 페이지·계정 삭제 안내 페이지 문안 | 앱에서 요금제·결제 화면 숨김 · 회원탈퇴 메뉴 노출 · 네이티브 탭바·푸시·카메라 권한·오프라인 화면 · targetSdk 36 · 스크린샷 자동 생성 준비(부록 A-3) |
| 2주차 | D-U-N-S 도착 → 애플 조직 등록 제출(대표) · 애플 검증 이메일/전화 응대 · 5장 문안 확정 · 데모 계정 데이터 채우기 | 구글 콘솔에 앱 생성 + 첫 AAB 내부 테스트 업로드 · 앱 콘텐츠 선언·데이터 보안 작성 보조 |
| 3~4주차 | 애플 승인 → ₩129,000 결제 → 계약 동의 → 한국 전자상거래법 정보 입력 → 헤이제임스 초대 · 구글 스토어 등록정보 입력 · 콘텐츠 등급 설문 | App Store Connect 앱 레코드 생성 · 메타데이터·스크린샷 업로드(자동화) · TestFlight 내부 테스트 · 구글 내부 테스트 배포 |
| 4~5주차 | 회사 구성원 실기기 테스트 · 심사 노트 최종 확인 · 심사 제출 승인 | 애플 심사 제출(수동 출시) · 구글 프로덕션 출시 검토 제출 |
| 5~6주차 | 심사 결과 대응(거절 시 사유 확인) · 출시 · 구글 콘솔 홈 “앱 등록” 확인 | 거절 사유 수정·재제출 · 출시 후 크래시/리뷰 모니터링 |
애플 조직 검증이 길어지면 3~4주차가 뒤로 밀려요. 개인 계정으로 가면 1~2주 줄지만 판매자명이 개인 실명으로 노출되고, 구글은 12명×14일 테스트가 추가돼요.
6-2. 회사(비개발자) 체크리스트
계정
- D-U-N-S 번호 발급 완료(법인명·주소가 사업자등록증과 일치)
- Apple 계정 2단계 인증 · 애플 개발자 프로그램 등록 · ₩129,000 결제
- App Store Connect 계약 동의(Account Holder)
- App Store Connect 한국 전자상거래법 정보 입력·인증
- Google Play Console 조직 계정 · US$25 · 신원/조직 서류 인증
- Play Console 한국 업체 연락처(주소·전화) 입력
- 두 콘솔에 헤이제임스 초대
자료 · 결정
- 앱 이름·부제·설명·키워드 확정(5장)
- 지원 URL(연락처 보이는 페이지) · 계정 삭제 안내 페이지 게시
- 개인정보처리방침에 수집 항목·위탁·삭제 정책 반영 확인
- 데모 계정 + 샘플 데이터 준비, 심사 기간 중 비밀번호 고정
- 배포 국가 = 대한민국, 가격 = 무료 확정
- 앱 안에 요금제·결제·업그레이드 노출 없음 확인(스크린샷 포함)
- 심사 담당자 연락처(이름·이메일·전화) 지정
7. 부록 A · 스토어 정보 자동 등록 (CLI · API · MCP)
비개발자용 3줄 요약
① 앱 설명 · 키워드 · 스크린샷 · 카테고리 같은 “스토어 정보”는 대부분 명령어 한 줄로 올릴 수 있어요(애플 · 구글 모두 공식 API 가 있고, fastlane 이라는 검증된 도구가 있어요). ② 그래도 손으로만 되는 것이 남아요 — 애플은 앱을 처음 만드는 것 · 개인정보 라벨 · 계약, 구글은 앱 생성과 첫 파일 업로드 · 카테고리 · 콘텐츠 등급 · 각종 선언. ③ AI 에이전트용 MCP 서버는 애플 · 구글 공식은 없고 커뮤니티 것만 있어서 보조 용도로만 권해요.
| 스토어 | 자동화 가능 (명령 한 번) | 손으로만 (콘솔) |
|---|---|---|
| 애플 | 이름·부제·설명·키워드·프로모션·새 기능·URL 3종·카테고리·저작권·심사 정보·연령 등급·스크린샷·가격·심사 제출 | 앱 레코드 생성(Bundle ID·SKU) · App Privacy 라벨 · 한국 전자상거래법 정보 · EU 트레이더 · 계약/세금/은행 |
| 구글 | 이름·간단/자세한 설명·동영상·출시 노트·아이콘·피처 그래픽·스크린샷·연락처·데이터 보안(CSV)·트랙 출시 | 앱 생성 + 첫 AAB 업로드 · 카테고리·태그 · 콘텐츠 등급 · 앱 액세스 · 광고/타겟층/금융/건강/정부/뉴스 선언 · 가격·국가 · 한국 업체 연락처 |
개발자용 · 도구별 상세와 명령 예시
A-1. 애플 App Store Connect
| 수단 | 할 수 있는 것 | 상태 (2026-09) |
|---|---|---|
| fastlane deliver | 이름·부제·설명·키워드·프로모션·출시 노트·지원/마케팅/개인정보 URL·카테고리·저작권·심사 정보(데모 계정·노트)·연령 등급(JSON)·스크린샷(픽셀 크기로 기기 자동 판별). 리포 안 텍스트 파일(fastlane/metadata/ko/*.txt)이 원본. deliver init 으로 기존 값 내려받기, --skip_binary_upload 로 메타데이터만 전송, precheck 로 거절 소지 검사 | 활발. 2.238.0(2026-08). 2025년 한때 정체됐다가 새 메인테이너가 복구. App Store Connect API 키로 무인 실행 |
| App Store Connect API (공식 REST) | appInfoLocalizations(이름·부제·개인정보 URL) · appStoreVersionLocalizations(설명·키워드·새 기능·프로모션·URL) · appInfos(카테고리) · appScreenshotSets/appScreenshots(예약→청크 업로드→MD5 확정) · ageRatingDeclarations · appStoreReviewDetails · 가격 스케줄 | 공식. 키는 Users and Access → Integrations → Team Key. JWT(ES256) 20분 |
| asc CLI (rorkai/App-Store-Connect-CLI) | asc metadata pull/apply, asc screenshots plan/apply, asc validate, asc review status, asc publish appstore --submit. asc install-skills 로 Claude Code 스킬 23개 설치 | 매우 활발(6.3k★, 4.11.0 2026-08-29). 텔레메트리 기본 켜짐 → asc telemetry disable |
| Codemagic app-store-connect CLI | 버전 로컬라이제이션(설명·키워드·새 기능·URL)만. 이름/부제·스크린샷·카테고리 없음 | 활발하지만 범위 좁음 |
| xcrun altool / Transporter | 앱 파일(빌드) 업로드 전용 | 메타데이터 불가 |
API 로 안 되는 것 (콘솔 전용) — 앱 레코드 최초 생성(애플 문서: “새 앱은 웹사이트에서 만들라”), App Privacy 영양성분표(공식 API 없음, fastlane 은 Apple ID 세션 필요), EU 트레이더 상태, 계약 · 세금 · 은행. 공식
애플 MCP 서버 — 애플 공식 MCP 는 없어요. Xcode 26.3/27 의 MCP(xcrun mcpbridge)는 빌드 · 테스트 · 문서 검색 · 프리뷰용이고 App Store Connect 는 다루지 않아요 공식. 커뮤니티: JoshuaRileyDev/app-store-connect-mcp-server 는 2026-02 아카이브. 메타데이터 · 스크린샷까지 되는 것은 mikusnuz/app-publish-mcp(애플+구글 통합)와 TrialAndErrorAI/appstore-connect-mcp(API 전체를 코드로 호출하는 “Code Mode”). pofky/asc-mcp 는 편집 기능이 유료($9/월). 모두 개인이 유지해서 파이프라인의 축으로 삼지 마세요.
A-2. Google Play
| 수단 | 할 수 있는 것 | 상태 (2026-09) |
|---|---|---|
| fastlane supply | 앱 이름·간단/자세한 설명·동영상·출시 노트·아이콘·피처 그래픽·폰/태블릿 스크린샷(fastlane/metadata/android/ko-KR/). supply init 으로 내려받기, --skip_upload_aab 로 정보만. Google Cloud 서비스 계정 JSON 으로 무인 실행. ⚠ 이미지는 덮어쓰기(폴더가 비면 스토어 이미지가 사라짐) | 활발(fastlane 동일) |
| Google Play Developer API (공식) | edits.listings(이름·설명·동영상) · edits.images(아이콘·피처·스크린샷) · edits.details(연락처) · tracks(출시) · applications.dataSafety(데이터 보안 양식 CSV) | 공식. “edit” 을 만들고 commit 해야 반영 |
| Gradle Play Publisher | publishListing 로 src/main/play/listings/ko-KR/ 업로드 | 유지보수 모드(4.1.1, 2026-08) |
API 로 안 되는 것 (콘솔 전용) — 앱 생성 + 첫 AAB 업로드(이후에야 API 사용 가능) · 카테고리 · 태그 · 콘텐츠 등급 설문 · 앱 액세스(데모 계정) · 광고 선언 · 타겟층 · 금융/건강/정부/뉴스 선언 · 가격 · 국가. 데이터 보안만 API/CSV 로 돼요. 공식
구글 MCP 서버 — 구글 공식 MCP 는 없어요. Firebase MCP · Developer Knowledge MCP 는 Play Console 을 다루지 않아요. 커뮤니티: lusky3/play-store-mcp(리스팅 조회 · 수정, 0.5.1 2026-08) · mikusnuz/app-publish-mcp(리스팅+이미지+릴리스). 그 밖(antoniolg, agimaulana 등)은 릴리스 · 분석 전용이라 스토어 정보를 못 써요.
A-3. 스크린샷 만들기
- Hotwire Native 앱은 화면이 곧 웹페이지라서 시뮬레이터 없이 Playwright(브라우저 자동화)로 서비스 화면을 스토어 픽셀 규격에 맞춰 바로 찍을 수 있어요. 규격 맞추기: 아이폰 6.9” = 뷰포트 440×956 @3배 → 1320×2868 · iPad 13” = 1032×1376 @2배 → 2064×2752 · 구글 폰 = 360×800 @3배 → 1080×2400.
- 찍은 화면에 기기 프레임과 한 줄 설명을 얹는 합성은 fastlane frameit(iPhone 16 프레임까지 확인, iPhone 17 프레임은 미확인) 또는 HTML/CSS 카드를 PNG 로 내보내는 방식. 온라인 툴은 AppMockUp · Previewed · AppLaunchpad 등.
- fastlane snapshot(iOS UI 테스트) · screengrab(Android)은 네이티브 탭바까지 실제로 찍고 싶을 때만 써요. 웹뷰 안 요소를 테스트 코드가 못 짚어 대기 로직을 직접 넣어야 하고, Hotwire Native 에서 실측한 사례는 찾지 못했어요 미확인.
- 애플 스크린샷은 API/fastlane 에 6.9” 전용 값이 없어서 APP_IPHONE_67 자리에 1320×2868 을 올려요. 2048×2732 는 12.9”/13” 이 겹쳐 파일명 힌트가 필요해요.
A-4. 추천 구성과 손으로 남는 일
추천
① 리포에 텍스트 파일로 스토어 정보를 두고 fastlane deliver / supply 로 밀기(Ruby 라 Rails Gemfile 에 그대로 얹힘, API 키 · 서비스 계정으로 2단계 인증 없이 무인 실행) → ② 애플 쪽 에이전트 작업은 asc CLI 를 곁들이기(Claude Code 스킬 제공) → ③ MCP 는 일회성 호출용 보조. 첫 값은 콘솔에서 손으로 넣고 deliver init / supply init 으로 내려받아 시작하면 형식을 틀릴 일이 없어요.
# 애플 — API 키(.p8)로 인증해 메타데이터·스크린샷만 올리기 bundle exec fastlane deliver --skip_binary_upload --overwrite_screenshots \ --api_key_path fastlane/asc_api_key.json # 구글 — 서비스 계정으로 스토어 정보만 올리기 (이미지는 덮어쓰기 주의) bundle exec fastlane supply --skip_upload_aab --json_key fastlane/play_service_account.json # asc CLI — 에이전트 친화 (설치: brew install asc) asc auth login --key-id KEY --issuer-id ISSUER --private-key ./AuthKey.p8 asc telemetry disable asc metadata pull --dir ./metadata --version 1.0.0 # 내려받기 asc metadata apply --dir ./metadata --version 1.0.0 # 올리기 asc screenshots plan --dir ./screenshots && asc screenshots apply # 커뮤니티 MCP 를 Claude Code 에 붙일 때 (보조 용도) claude mcp add appstore-connect -s user -- npx -y @trialanderror-ai/appstore-connect-mcp
함정
- fastlane 의 Apple ID 전용 기능(produce 앱 생성, App Privacy 업로드)을 자동화에 섞으면 2단계 인증 세션이 만료될 때마다 깨져요. API 키로 되는 것만 자동화하세요.
- 구글 API 는 “edit” 을 commit 하지 않으면 반영되지 않고, 실패하면 미커밋 상태로 남아요.
- 글자 제한 — 애플 키워드 100바이트 · 프로모션 170자 · 설명/새 기능 4,000자 · 심사 노트 4,000바이트 / 구글 이름 30 · 간단 설명 80 · 자세한 설명 4,000 · 출시 노트 500.
- fastlane 은 특정 버전을 Gemfile.lock 으로 고정하고, 올릴 때 릴리스 노트를 읽으세요(2025년 정체 → 2025-11 재개).
8. 부록 B · 용어집
- Hotwire Native
- 웹사이트를 iOS·Android 앱 껍데기에 담아 앱으로 배포하는 기술. 화면은 웹, 탭바·알림 같은 요소는 앱이 담당. 37signals(Basecamp·HEY)가 만들어 씀
- D-U-N-S 번호
- 던앤브래드스트리트가 부여하는 9자리 사업자 식별번호. 애플·구글이 법인을 확인하는 수단. 무료
- Account Holder / 계정 소유자
- 개발자 계정의 최고 권한자. 계약 동의·검증·결제를 담당. 대표(서명 권한자)여야 함
- App Store Connect / Play Console
- 애플·구글의 앱 관리 웹사이트. 스토어 정보 입력·빌드 업로드·심사 제출을 여기서 함
- Bundle ID / 패키지명
- 앱의 고유 주소(예: com.회사명.서비스명). 한번 정하면 못 바꿈
- SKU
- 애플 콘솔 내부 관리 코드. 못 바꿈
- TestFlight / 내부 테스트
- 출시 전 정해진 사람에게만 앱을 배포해 써 보게 하는 기능(애플 / 구글)
- AAB
- 구글에 올리는 앱 파일 형식(Android App Bundle). 예전 APK 대신 필수
- targetSdk
- 앱이 어느 안드로이드 버전을 기준으로 만들어졌는지. 2026-08-31 부터 새 앱은 Android 16(36)
- 인앱 결제(IAP)
- 앱 안에서 애플·구글을 거쳐 결제하는 방식. 수수료 15~30%. 앱 안에서 디지털 구독을 팔면 의무
- App Privacy / 데이터 보안
- 앱이 어떤 개인정보를 왜 수집하는지 스토어에 표로 보여주는 필수 선언(애플 / 구글)
- IARC / GRAC
- 구글 콘텐츠 등급 설문 체계 / 한국 게임물관리위원회 등급. 설문 한 번으로 각국 등급이 자동 부여
- EU DSA 트레이더
- EU 디지털서비스법에 따라 EU 배포 앱에 사업자 연락처를 공개하는 제도. 한국만 배포하면 무관
- CLI / API / MCP
- CLI = 명령어로 쓰는 도구, API = 프로그램끼리 통신하는 공식 창구, MCP = AI 에이전트(Claude 등)가 외부 도구를 쓰게 하는 연결 규격
- fastlane
- 앱 빌드·업로드·스토어 정보 등록을 자동화하는 오픈소스 도구. Ruby 로 만들어져 Rails 프로젝트와 궁합이 좋음
9. 부록 C · 출처
2026년 9월 2일 기준으로 확인했어요. 정책 페이지는 자주 바뀌니 등록할 때 다시 열어 보세요. 본문에 쓴 출처 중 핵심만 추렸어요.
애플 (공식) 25
- 프로그램 등록 요건 · 개인/조직 — https://developer.apple.com/kr/programs/enroll/
- D-U-N-S 번호 — https://developer.apple.com/support/D-U-N-S/
- Apple Developer 앱으로 등록 · 신분증 — https://developer.apple.com/help/account/membership/enrolling-in-the-app/
- 등록 절차(권한 확인) — https://developer.apple.com/help/account/membership/program-enrollment/
- 비용·결제·활성화 — https://developer.apple.com/support/purchase-activation/
- 회비 면제 조건 — https://developer.apple.com/support/membership-fee-waiver/
- 계약 상태 · 유료 앱 계약 — https://developer.apple.com/help/app-store-connect/manage-agreements/view-agreements-status/
- 세금 서류(한국 사업자등록번호) — https://developer.apple.com/help/app-store-connect/provide-tax-information/tax-forms-overview
- 한국 전자상거래법 정보 — https://developer.apple.com/help/app-store-connect/manage-compliance-information/manage-korea-compliance-information
- 앱 정보 필드 — https://developer.apple.com/help/app-store-connect/reference/app-information/
- 버전 정보 필드 — https://developer.apple.com/help/app-store-connect/reference/platform-version-information/
- 스크린샷 규격 — https://developer.apple.com/help/app-store-connect/reference/screenshot-specifications/
- 카테고리 정의 — https://developer.apple.com/app-store/categories/
- 연령 등급 개편(2025-07) — https://developer.apple.com/news/?id=ks775ehf
- App Privacy — https://developer.apple.com/app-store/app-privacy-details/
- 암호화 수출 규정 — https://developer.apple.com/help/app-store-connect/manage-app-information/overview-of-export-compliance/
- EU DSA 트레이더 — https://developer.apple.com/help/app-store-connect/manage-compliance-information/manage-european-union-digital-services-act-trader-requirements/
- App Review 가이드라인(2026-06-08 개정) — https://developer.apple.com/app-store/review/guidelines/
- 앱 안 계정 삭제 — https://developer.apple.com/support/offering-account-deletion-in-your-app/
- 한국 대체결제(External Purchase KR) — https://developer.apple.com/support/storekit-external-entitlement-kr/
- 심사 소요·통계 — https://developer.apple.com/distribute/app-review/
- TestFlight — https://developer.apple.com/help/app-store-connect/test-a-beta-version/testflight-overview/
- Xcode 26 필수(2026-04-28) — https://developer.apple.com/news/upcoming-requirements/
- App Store Connect API — 앱 메타데이터 — https://developer.apple.com/documentation/appstoreconnectapi/app-metadata
- Xcode 26.3 MCP(에이전틱 코딩) — https://www.apple.com/newsroom/2026/02/xcode-26-point-3-unlocks-the-power-of-agentic-coding/
구글 (공식) 21
- Play Console 시작 · US$25 — https://support.google.com/googleplay/android-developer/answer/6112435
- 계정 요구사항 · 공개 정보 · D-U-N-S — https://support.google.com/googleplay/android-developer/answer/13628312
- 계정 유형(개인/조직) — https://support.google.com/googleplay/android-developer/answer/13634885
- 조직 계정 인증 가이드(PDF) — https://play.google.com/console/about/static/pdf/Verifying_your_Play_Console_developer_account_for_organizations.pdf
- 신규 개인 계정 12명×14일 — https://support.google.com/googleplay/android-developer/answer/14151465
- 한국 개발자 추가 정보(주소·전화·통신판매업) — https://support.google.com/googleplay/android-developer/answer/3255733?hl=ko
- 한국 대체 결제 — https://support.google.com/googleplay/android-developer/answer/11222040
- 스토어 등록정보 — https://support.google.com/googleplay/android-developer/answer/9859152
- 그래픽 규격 — https://support.google.com/googleplay/android-developer/answer/9866151
- 앱 콘텐츠 선언 목록 — https://support.google.com/googleplay/android-developer/answer/9859455
- 데이터 보안 — https://support.google.com/googleplay/android-developer/answer/10787469
- 계정 삭제 요건 — https://support.google.com/googleplay/android-developer/answer/13327111
- 결제 정책 · 소비 전용 앱 — https://support.google.com/googleplay/android-developer/answer/9858738
- 최소 기능 · 웹뷰 스팸 — https://support.google.com/googleplay/android-developer/answer/9898783
- Play App Signing — https://support.google.com/googleplay/android-developer/answer/9842756
- 가격(무료→유료 불가) — https://support.google.com/googleplay/android-developer/answer/6334373
- Target API 36(2026-08-31) — https://support.google.com/googleplay/android-developer/answer/11926878
- 16KB 페이지 — https://developer.android.com/guide/practices/page-sizes
- 2026-09-30 앱 등록(개발자 검증) — https://support.google.com/googleplay/android-developer/answer/17125096
- 심사 기간 — https://support.google.com/googleplay/android-developer/answer/9859751
- Google Play Developer API — https://developers.google.com/android-publisher
도구 · 실무 참고 15
- fastlane deliver — https://docs.fastlane.tools/actions/deliver/
- fastlane supply — https://docs.fastlane.tools/actions/supply/
- fastlane frameit — https://docs.fastlane.tools/actions/frameit/
- fastlane App Store Connect API 키 인증 — https://docs.fastlane.tools/app-store-connect-api/
- asc CLI (rorkai/App-Store-Connect-CLI) — https://github.com/rorkai/App-Store-Connect-CLI
- Codemagic CLI — https://github.com/codemagic-ci-cd/cli-tools
- Gradle Play Publisher — https://github.com/Triple-T/gradle-play-publisher
- MCP — mikusnuz/app-publish-mcp — https://github.com/mikusnuz/app-publish-mcp
- MCP — TrialAndErrorAI/appstore-connect-mcp — https://github.com/TrialAndErrorAI/appstore-connect-mcp
- MCP — lusky3/play-store-mcp — https://github.com/lusky3/play-store-mcp
- Hotwire Native 심사 팁(Masilotti) — https://masilotti.com/hotwire-native-app-store-tips/
- Hotwire Native 공식 — https://native.hotwired.dev/
- Playwright 기기 에뮬레이션 — https://playwright.dev/docs/emulation
- 국내 D-U-N-S 발급 후기 — https://documentation.swing2app.co.kr/developer/duns
- 통신판매업 신고 — https://www.gov.kr/mw/AA020InfoCappView.do?CappBizCD=11300000006
이 가이드는 2026년 9월 2일 웹 조사로 썼어요. 법률 · 세무 판단(법인 전환, 통신판매업 신고 의무 등)은 전문가에게 확인하세요.
자주 묻는 것
개인사업자인데 스토어에 회사 이름으로 올릴 수 있나요?
애플은 법인만 조직 계정을 만들 수 있어요. 그래서 개인사업자는 개인 계정으로 가야 하고 판매자에 대표 실명이 떠요. 구글은 D-U-N-S 를 받으면 개인사업자도 조직으로 신청하는 사례가 있지만 최종 판정은 구글이 해요. 회사명을 내걸고 싶다면 법인 전환부터 검토하세요.
앱 안에서 구독 결제를 받을 수는 없나요?
받을 수는 있지만 애플 · 구글 결제를 써야 하고 수수료가 15~30% 예요. 대신 앱은 무료 컴패니언 앱으로 두고 결제는 웹에서만 받는 구성을 권해요. 앱 안에서 웹 결제로 유도하는 버튼 · 문구도 금지라, 헤이제임스가 앱에서는 요금제 · 결제 화면을 통째로 숨겨요.
개발자 계정은 누가 만들어야 하나요?
대표(서명 권한자)가 회사 이메일로 직접 만드는 게 가장 빨라요. 계약 동의 · 검증 · 결제가 그 계정으로만 되니 나중에도 문제가 없어요. 헤이제임스는 팀원(Admin 또는 App Manager)으로 초대받아 작업해요. 계정은 회사 자산이라 헤이제임스 명의로 만들지 않아요.
전체 기간은 얼마나 잡아야 하나요?
조직 계정 기준으로 애플 3~6주, 구글 1~6주예요. 두 스토어를 같이 진행하면 5~6주예요. 대부분이 D-U-N-S 발급과 애플 조직 검증 대기라, D-U-N-S 를 오늘 신청하는 게 기간을 줄이는 거의 유일한 방법이에요.
심사에서 떨어지면 어떻게 되나요?
거절 사유가 오면 고쳐서 다시 제출해요. 애플은 제출의 90% 를 24시간 안에 처리해서, 1~2회 거절이면 2~5일이 더 걸려요. 거절 사유 대응과 재제출은 헤이제임스가 해요.
스크린샷이나 문안도 헤이제임스가 만들어 주나요?
스크린샷은 서비스 화면을 스토어 규격에 맞춰 헤이제임스가 만들어요(부록 A-3). 문안은 5장 틀로 초안을 드리고 회사가 확정해요. 콘솔에 넣는 항목 대부분은 명령어로 자동 등록하고, 손으로만 되는 것(부록 A)만 함께 처리해요.
웹 서비스를 앱으로 낼 계획이라면
D-U-N-S 신청부터 같이 시작해요.