미니앱 출시하기
토스 앱에서 최종 테스트를 마쳤다면, 앱인토스 콘솔에서 검토를 요청하고 미니앱을 출시할 수 있어요.
1. 사전 점검하기
1-1) 게임, 비게임 출시 가이드
출시 전에 검수 가이드와 체크리스트를 꼭 확인하세요. 게임·비게임 출시 가이드를 모두 확인해 개발이 끝났는지 점검해 주세요. 가이드를 지키지 않으면 검토 단계에서 반려될 수 있어요.
1-2) 앱 번들 업로드 시 주의 사항
앱 번들은 압축 해제 기준 100MB 이하만 업로드할 수 있어요. 이미지·사운드·영상 같은 리소스를 모두 포함하면 용량을 넘길 수 있으니, 리소스 파일은 빌드와 분리해서 관리해 주세요.
리소스 관리는 이렇게 하는 걸 권장해요.
앱 실행에 꼭 필요한 최소 리소스만 번들에 포함하세요.
대용량 리소스는 외부 스토리지나 CDN에서 내려받도록 구성해 주세요.
추가 리소스는 단계적으로 내려받는 방식(Lazy Loading)을 적용하면 사용자 경험이 좋아져요.
2. 검토 요청하기
테스트를 마친 뒤 콘솔의 '검토 요청하기' 버튼을 누르면 검토가 시작돼요. 검토는 영업일 기준 최대 3일 걸리고, 앱 카테고리에 따라 7일 이상 걸릴 수 있어요.
테스트를 1번 이상 완료해야 검토 요청 버튼이 활성화돼요.
검토 요청은 한 번에 한 버전만 제출할 수 있어요.
검토를 요청한 뒤 수정할 버그를 발견했다면, '요청 취소하기' 버튼을 눌러 검토를 취소하세요. 그다음 수정한 새 번들(.ait)을 업로드하고 다시 검토를 요청하면 돼요.
검토가 반려된 경우
'반려 사유 보기' 버튼을 눌러 사유를 확인한 뒤, 문제를 해결한 새 번들을 업로드하고 다시 검토를 요청해 주세요. 반려 사유에 대해 더 궁금한 점이 있다면 채널톡으로 문의할 수 있어요.
3. 출시하기
번들이 승인되면 검수 결과를 이메일로 안내해드려요. 이후 콘솔에서 '출시하기' 버튼을 누르면 미니앱이 사용자에게 공개돼요.
출시하면 전체 사용자에게 즉시 반영돼요. 반드시 충분히 테스트한 뒤 출시해 주세요.
4. 출시 후 관리하기
출시한 뒤에는 앱인토스 콘솔에서 버전 관리와 업데이트를 할 수 있어요. 필요에 따라 새 번들을 올리거나, 기존 버전을 유지·관리할 수 있어요.
4-1. 새 버전(업데이트) 배포하기
새 기능을 추가하거나 오류를 수정했다면, 기존과 같은 방식으로 새 앱 번들(
.ait)을 업로드하세요.업로드한 번들은 다시 검토 요청 → 승인 → 출시 단계를 거쳐요.
승인된 뒤 '출시하기' 버튼을 누르면 새 버전이 기존 앱을 대체해요.
출시한 버전은 사용자에게 즉시 반영되니, 미리 충분히 테스트한 뒤 업로드해 주세요.
4-2. 롤백하기
'앱 출시' 메뉴에서 기존에 출시한 버전 목록을 확인할 수 있어요.
문제가 생기면 이전 버전으로 롤백할 수 있어요.
롤백할 버전을 선택한 뒤 '출시하기' 버튼을 누르세요.
롤백도 사용자에게 즉시 반영되니, 버전을 신중히 선택해 주세요.
4-3. 긴급 수정(핫픽스)
앱 실행에 심각한 오류가 생기면 채널톡으로 바로 문의해 주세요. 긴급 상황에서는 빠르게 대응해드려요.
4-4. 출시 후 모니터링
출시 직후에는 예상치 못한 오류나 성능 이슈가 생길 수 있어요. 아래 항목을 중심으로 모니터링하는 걸 권장해요.
주요 오류 로그와 크래시 로그
Sentry 설정을 통한 Sentry 모니터링
API 응답 지연·실패율
사용자 피드백과 사용성 문제
내비게이션 바의 '신고하기' 기능으로 사용자 의견을 받을 수 있어요.
접수된 피드백은 콘솔의 '신고 내역' 메뉴에서 확인할 수 있어요.
외부 리소스·CDN 로딩 지연이나 실패 이슈
4-5. 사후 검수
앱인토스는 사용자에게 높은 수준의 미니앱 경험을 제공하기 위해, 출시한 뒤에도 미니앱 검수를 진행해요. 사후 검수에서 개선이 필요한 점이 확인되면 개선을 요청드릴 수 있어요. 법·정책 위반 사항이 발견되면 운영 정책에 따라 긴급 운영 중단 조치가 먼저 진행될 수 있어요.