앱 출시 가이드

웹으로 만든 서비스를 앱으로 올릴 때 회사가 준비해야 하는 것

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. 1

    애플의 D-U-N-S 조회 페이지에서 먼저 검색

    developer.apple.com/enroll/duns-lookup 에서 회사명(영문) · 주소로 조회해요. 이미 번호가 있으면 그대로 써요. 공식

  2. 2

    없으면 같은 화면에서 무료 신청

    영문 법인명(사업자등록증과 철자까지 일치) · 본사 주소 · 우편 주소 · 담당자 연락처를 입력해요. 애플 창구로 신청하면 무료예요. 국내 파트너 NICE디앤비로 신청하면 대행 수수료가 붙어요(금액 미확인). 공식

  3. 3

    서류 요청이 오면 영문 사업자등록증명 제출

    홈택스에서 발급한 3개월 이내 영문 증명이 표준이에요. 참고

  4. 4

    발급 대기

    D&B 발급 최대 5영업일 + 애플 시스템 반영 최대 2영업일(애플 안내) · 구글 안내는 “최대 30일” · 국내 후기는 1~2주. 급행 없음. 공식

  5. 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. 1

    Apple 계정 준비

    대표님

    회사 이메일로 Apple 계정을 만들고 2단계 인증을 켜요. 이 계정이 “Account Holder”(계정 소유자)가 되고, 계약 동의 · 검증 응답 · 결제는 이 사람만 할 수 있어요. 대표(서명 권한자)가 직접 하는 게 가장 빨라요. 공식

  2. 2

    D-U-N-S 번호 확보

    담당자

    2장 절차대로 해요. 발급 뒤 애플 시스템 반영까지 2영업일 더 걸려요.

  3. 3

    등록 경로 선택 — 웹 또는 “Apple Developer” 앱

    대표님

    웹(developer.apple.com/enroll) 또는 iPhone 의 Apple Developer 앱 둘 다 조직 등록이 돼요. 앱으로 하면 신분증(여권 권장)을 카메라로 촬영하고, 시작한 기기로 끝까지 진행해야 해요. 한국 App Store 의 Apple Developer 앱에 “Apple Developer Program ₩129,000” 인앱 구입이 표시돼 국내에서도 앱 등록이 되는 것으로 보이지만, 애플이 지원 국가 목록을 공개하지 않아요 미확인. 막히면 웹으로 하면 돼요.

  4. 4

    조직 정보 입력

    대표님

    법인명 · D-U-N-S · 본사 주소 · 전화 · 공개 웹사이트 · 서명 권한 확인. 등록자가 대표/설립자가 아니면 권한을 확인해 줄 임직원 연락처를 내야 하고, 공증 서류를 요구받을 수 있어요. 한국어 이름은 로마자 표기도 함께 적어요. 공식

  5. 5

    애플 검증 대기

    대표님

    애플이 이메일 · 전화로 확인해요(공식 문서에 전화 확인이 명시돼 있진 않지만 실무 후기 다수 참고). 순조로우면 3~5영업일, 길면 2~4주예요. 2026년 포럼에 조직 검증이 몇 주 걸린 사례가 여럿 있어요. 여유를 두세요.

  6. 6

    승인 메일 후 결제 ₩129,000

    대표님

    조직은 검증이 끝나야 결제 단계가 열려요. 신용카드로 결제하고, 결제 뒤 24시간 안에 확인 메일이 와요(안 오면 Enrollment ID 로 문의). 공식

  7. 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. 1

    Google 계정 준비

    대표님

    회사 이메일로 Google 계정을 만들어요. 이 계정이 “계정 소유자”가 되고, 인증 절차는 소유자만 시작할 수 있어요. 공식

  2. 2

    play.google.com/console 에서 가입 → “조직” 선택

    대표님

    개인/조직은 인증이 끝나면 바꿀 수 없어요. 법인명 · 법인 주소 · 조직 유형 · 규모 · 웹사이트를 입력하고 D-U-N-S 번호를 넣어요(입력 시도 횟수 제한 있음). D-U-N-S 의 법인명 · 주소와 여기 입력값이 정확히 같아야 해요. 공식

  3. 3

    연락처 인증

    대표님

    구글 연락용 이메일 · 전화(비공개)와 스토어에 공개될 개발자 이메일 · 전화를 각각 문자/전화 OTP 로 인증해요. 조직 계정은 법인명 · 주소 · 이메일 · 전화가 앱 페이지에 공개돼요. 공식

  4. 4

    Google 결제 프로필 만들기 + US$25 결제

    대표님

    법인 결제 프로필(법인명 · 주소는 D-U-N-S 와 일치, 국가는 나중에 변경 불가)을 만들어 연결해요. 한 번 연결하면 바꿀 수 없어요. 등록비는 신용카드(선불카드 불가)로 US$25, 환불 불가. 공식

  5. 5

    신원 · 조직 서류 인증

    대표님

    대표자(또는 권한 있는 임직원) 신분증 + 조직 공식 문서를 올려요. 문서 목록은 국가별로 콘솔이 보여줘요. 한국에서 사업자등록증이 그대로 인정되는지는 미확인 — 콘솔의 안내 목록을 따르세요. “지원하지 않는 문서 제출”이 인증 실패의 1위 원인이에요. 소요 “며칠”. 공식

  6. 6

    팀원 초대 · 한국 판매자 정보 입력

    담당자

    Users and permissions 에서 헤이제임스를 초대해요. 계정 세부정보의 업체 문의 연락처에 한국 개발자 필수 정보(4-2)를 넣어요.

  7. 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
구글 (공식) 21
도구 · 실무 참고 15

이 가이드는 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 신청부터 같이 시작해요.