App Store Release
App Store Connect API를 통해 iOS App Store 제출 전체 과정을 자동화합니다. 설계 목표: 사용자가 자격 증명 + config.json을 한 번 제공하면, 에이전트가 자동화 가능한 모든 작업을 수행하고 Apple이 진정으로 API로 제공하지 않는 몇 가지 작업에 대해서만 사용자에게 알립니다. 이미 설정 파일에 있거나 합리적인 기본값이 있는 항목을 사용자에게 다시 확인하도록 요청하지 마십시오.
작동 원칙 (먼저 읽으십시오)
- 프롬프트 기반이 아닌 설정 기반입니다. 모든 앱 콘텐츠는
config.json에 저장됩니다. 명령어를 실행하세요. 사용자에게 인터뷰하지 마십시오. - UI로만 가능한 작업은 두 가지뿐입니다 (Apple에 API 없음): 앱 개인정보 데이터 수집과 첫 번째 구독 연결 및 제출입니다. 도구가 이를 감지하고 정확한 클릭 위치를 알려줍니다. 나머지는 모두 스크립트로 처리됩니다.
- 다음 경우에만 사용자에게 질문하십시오: 설정 파일에 필수 필드가 누락된 경우(정확히 어떤 필드인지 알려줌), 설정 파일에 없는 비즈니스 결정(구독 가격, 릴리스 타이밍)이 필요한 경우, 또는 되돌릴 수 없는 최종 작업(제출) 직전. 그 외에는 계속 진행하십시오.
- 멱등성(idempotent): 모든 명령어는 다시 실행해도 안전합니다.
node cli.mjs release는 반복 실행할 수 있습니다.
아키텍처 (SOLID, 확장 가능)
scripts/
cli.mjs 단일 진입점 / 디스패처 (node cli.mjs <command>)
lib/ 주입된 서비스, 각각 하나의 책임
env.mjs 환경 변수 파싱 + 검증 (자격 증명, 앱 ID)
jwt.mjs ES256 토큰 제공자
client.mjs AscClient — 인증 + HTTP + 일관된 오류 처리
discovery.mjs 자연 키로 ASC 리소스 찾기 (하드코딩된 ID 없음)
assets.mjs 예약→업로드→커밋 바이너리 업로더
config.mjs 설정 파일 로드 + 검증, 누락된 항목 나열
log.mjs 구조화된 결과 + 기계 판독 가능 요약
context.mjs 구성 루트 (의존성 주입)
commands/ 작업당 하나의 파일; 균일한 계약 (_contract.md 참조)
기능 추가 = commands/x.mjs (meta + run(ctx))를 추가하고 cli.mjs에 등록하십시오.
설정 (최초 1회) — references/setup.md 참조
- ASC API 키 (App Manager):
AuthKey_XXXX.p8다운로드, Key ID + Issuer ID 기록. - ASC에 앱 레코드가 존재해야 함 (번들 ID 등록됨).
ASC_APP_ID= 앱 ASC URL의 숫자 ID. - EAS 프로젝트가 설정되고
eas login이 완료되어야 함. references/config-template.json에서config.json을 채우십시오. 언제든지 검증: 모든 명령어가 정확히 어떤 필드가 누락되었는지 출력합니다.
환경 변수
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # gitignore the .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # 그런 다음: node cli.mjs <command>
실행 가이드
1. 상태 확인
node cli.mjs status # 전체 읽기 전용 개요
node cli.mjs check # 준비 상태 + 아직 완료되지 않은 UI 전용 단계
2. 바이너리 빌드 (EAS)
eas build가 만료된 자격 증명으로 실패하는 경우 ("프로비저닝 프로필 만료 / 일련 번호가 있는 인증서 없음…"):그런 다음 eas.json 프로덕션 프로필에node cli.mjs credentials # 새 배포 인증서 + 프로필 → credentials.json"credentialsSource":"local"을 설정하십시오.- 바이너리 빌드 + 제출 (비대화형을 위해
EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID+EXPO_APPLE_TEAM_ID+EXPO_APPLE_TEAM_TYPE내보내기):빌드가 VALID 상태가 될 때까지 기다리십시오 (eas build -p ios --profile production --non-interactive --no-wait eas submit -p ios --profile production --id <buildId>node cli.mjs status).
3. 한 번에 전체 리스팅 작성
node cli.mjs release # 빌드 연결 → 메타데이터 → 가격 → 콘텐츠 권한 →
# 연령 등급 → 카테고리 → 리뷰 정보 → 스크린샷 →
# 구독 → 검증
release는 전체 파이프라인을 실행하고(멱등적) check로 끝나며, 남은 UI 전용 단계를 출력합니다. 스크린샷은 먼저 존재해야 합니다 (config.screenshots.dir) — 생성 방법은 references/screenshots.md를 참조하십시오.
4. 두 가지 UI 전용 단계 (정확한 클릭 위치 전달)
check는 해당되는 경우 이를 나열합니다:
- 앱 개인정보 → 데이터 수집: 앱의 개인정보 매니페스트와 일치하는 데이터 유형을 선언한 다음 게시하십시오. ⚠️ 바이너리에
NSUserTrackingUsageDescription이 포함되어 있지만 추적을 선언하지 않으면 게시가 차단됩니다 → 키를 제거하고 다시 빌드하십시오 (references/gotchas.md). - 첫 번째 구독: 버전 페이지 → 인앱 구매 및 구독 → 선택 → <제품> → 저장 → 리뷰에 추가 → 제출. (API는 첫 번째 구독을 연결할 수 없습니다.)
5. 제출
node cli.mjs check # 누락된 항목이 없는지 확인
node cli.mjs submit --submit # 앱 전용 / 업데이트 (첫 번째 IAP 제외)
첫 번째 구독의 경우 사용자가 UI에서 제출합니다 (4.2단계). status로 확인: 버전과 구독 모두 WAITING_FOR_REVIEW여야 합니다.
거부 처리
거부 시 버전이 다시 편집 가능해집니다 (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). 해결 센터 메시지를 읽고 수정한 후(메타데이터는 release 사용, 바이너리 문제는 재빌드) 다시 제출하십시오.
참고 자료
references/setup.md— 키 생성, 앱 레코드, EAS, 시크릿 관리.references/gotchas.md— 모든 실제 문제점 (첫 실행 전에 읽으십시오).references/screenshots.md— 정확한 크기의 PNG 생성 (HTML → 헤드리스 Chrome).references/config-template.json— 앱별 설정 (lib/config.mjs에서 검증됨).