미니앱 테스트하기
앱 번들(.ait) 파일을 업로드하고 생성된 테스트용 앱스킴으로 토스 앱에서 최종 테스트를 할 수 있어요.
콘솔에서 테스트하기
콘솔에서 테스트하는 방법은 가이드를 참고해주세요.
CI/CD 명령어 사용하기
콘솔에 접속하지 않고 CLI로 앱 번들을 업로드할 수 있어요.
CI/CD 명령어로 자동 업로드하려면 SDK v1.4.0 이상이 필요해요. 이전 버전을 쓰고 있다면 먼저 SDK를 업그레이드해 주세요.
먼저 콘솔에서 API 키를 발급해 주세요. 전체 앱 또는 특정 앱 단위로 접근 권한을 설정할 수 있어요.
접속 경로: 워크스페이스 선택 → 왼쪽 메뉴에서 '키'
아래 명령어를 실행해 앱 번들을 업로드하세요. 정상적으로 업로드되면 테스트용 앱스킴을 확인할 수 있어요.
API 키를 등록해 두면 반복해서 입력하지 않아도 돼요.
-m 옵션으로 번들을 업로드할 때 메모를 함께 남길 수 있어요.
필요에 따라 아래 명령어를 사용해 보세요.
npx ait token --help
도움말 보기
npx ait token add [워크스페이스명] [API 키]
토큰 등록하기
npx ait token remove [워크스페이스명]
등록된 토큰 삭제하기
npx ait deploy [워크스페이스명] [API 키]
번들 업로드하기
npx ait deploy [워크스페이스명] [API 키] --timeout [초]
배포 상태 확인 최대 대기 시간 설정하기 (10초 이상 300초 이하)
기능 테스트하기
intoss:// 스킴은 앱이 정식 출시된 뒤에만 접근할 수 있어요. 출시 전 기능 테스트는 업로드할 때 생성된 테스트 스킴(QR 코드)으로 해야 해요.
QR 코드에서 deploymentId 확인하기
앱 번들을 업로드할 때마다 새로운 deploymentId가 발급돼요. 테스트 스킴에서 _deploymentId는 필수 파라미터예요.
스킴에 path·query 적용해 테스트하기
하위 path를 적용한 경우:
쿼리 파라미터를 적용한 경우 (queryParams는 반드시 URL 인코딩해야 해요):
웹 디버그 툴즈로 문제 확인하기
로컬 브라우저나 샌드박스 앱에서 정상 동작했더라도, 토스 앱 환경에서는 문제가 발생할 수 있어요. 웹 디버그 툴즈를 사용하면 실제 토스 앱에서 실행 중인 미니앱의 로그, 네트워크 요청, 페이지 구조를 확인할 수 있어요.
웹 디버그 툴즈는 앱 번들을 업로드한 뒤 QR 코드나 테스트 스킴(intoss-private://)으로 실행한 미니앱에서 사용할 수 있어요.
왜 필요한가요?
토스 앱 WebView는 로컬 브라우저나 샌드박스 앱과 실행 환경이 달라요. 그래서 로컬에서는 발견하기 어려운 문제를 토스 앱 테스트 환경에서 직접 확인해야 할 때가 있어요.
예를 들어 아래와 같은 상황에서 웹 디버그 툴즈를 사용할 수 있어요.
토스 앱에서만 흰 화면이 보여요.
API 요청이 실패하거나 응답을 확인하기 어려워요.
특정 기기에서 화면이 다르게 보여요.
개발 중 남긴
console.log값을 실제 테스트 환경에서 확인하고 싶어요.
사용 방법
확인하고 싶은 값이나 실행 흐름이 있다면 먼저 코드에 로그를 남겨 주세요.
로그를 추가한 뒤 앱 번들을 다시 생성하고 콘솔에 업로드하세요.
업로드가 끝나면 QR 코드나 테스트 스킴(intoss-private://)으로 토스 앱에서 미니앱을 실행해 주세요.
미니앱 화면 오른쪽 위 내비게이션바에서 더보기 버튼을 누르고 웹 디버그 툴즈를 선택하세요.
웹 디버그 툴즈가 열리면 Log 탭에서 콘솔 로그를 확인할 수 있어요. API 요청과 응답을 확인하려면 Network 탭을 확인해 주세요.
확인할 수 있는 정보
Log
console.log, console.warn, console.error로 출력한 로그
System
WebView 실행 환경 정보
Network
API 요청과 응답, 실패한 네트워크 요청
Element
화면의 페이지 구조