test-on-device

test-on-device skill

목적

/ait:test-on-device는 지금 만들고 있는 미니앱을 실제 토스 앱에서 확인하는 정규 경로를 한 명령으로 밟는다: 번들 빌드 → 콘솔 업로드 → 컴파일 확인 → 토스 앱에서 열기.

"폰에서 보고 싶다"에 대응하는 경로는 셋이고, 목적이 다르다:

원하는 것	경로
브라우저에서 mock으로 개발	프로젝트의 dev 스크립트(package.json scripts) + /ait:debug 환경 1 (토스 앱 불필요)
실기기에서 동작 확인	이 skill — 번들을 콘솔에 올려 토스 앱에서 연다
실기기에서 CDP로 관측·디버깅	/ait:setup-debugger 배선 후 /ait:debug 환경 3(QR attach)

이 경로는 특정 스택 전용이 아니다 — 전제는 .ait 번들 하나뿐이라, web-framework 프로젝트, React Native, Unity·엔진 HTML5 빌드 모두 업로드부터는 같은 절차를 탄다. 스택마다 다른 것은 빌드 방법과 산출물 위치뿐이고, 이는 프로젝트를 읽어 정한다(3).

의존

• cwd가 미니앱 프로젝트 루트여야 한다. 웹·RN 프로젝트는 package.json과 번들 설정 파일이 있다. 정본 scaffold(create-ait-app 0.2.x, new-miniapp skill)는 apps-in-toss.config.ts를 쓰고, 구세대 --local 오프라인 폴백 템플릿 (new-miniapp L-5)은 granite.config.ts를 쓴다. Unity는 Packages/manifest.json 이나 Assets/에 SDK가 있다. 프로젝트 표지가 하나도 없으면 프로젝트 루트로 이동 안내 후 중단.
• 콘솔 MCP(ait-console) 인가가 1회 필요하다 — /mcp에서 승인한다. 인가되지 않았으면 그 안내만 하고 중단한다.
• 콘솔에 등록된 앱이 있어야 한다. 없으면 miniapp_create로 1회 등록한다 (아래 2 — 이미 있으면 절대 새로 만들지 않는다).
• 아이콘이 비어 있어도 ait build는 실패하지 않는다. 3.x (apps-in-toss.config.ts) 스키마에는 brand.icon이 아예 없고(CLI 3.x 마이그레이션이 brand에서 primaryColor 외 속성을 지운다), 2.x (granite.config.ts)도 스캐폴드 기본값이 icon: ''이라 빈 값으로 빌드가 통과한다 — CLI 2.10.8·3.0.5 소스 확인. 다만 2.x 폴백에서 빈 값으로 빌드한 번들이 콘솔 컴파일(CREATED)은 통과하고 앱 실행 시점에 "잠시 문제가 생겼어요"로 실패했다는 보고가 있다(harness#90 — 이 skill이 재현·확인한 것은 아니다). 등록용 자산 자체가 없으면 /ait:design을 먼저 안내한다.

입력

/ait:test-on-device는 인자를 받지 않는다. 대상 앱·워크스페이스는 콘솔 MCP 세션이 결정한다(아래 2).

실행 순서

1. 사전 확인 — appName 일치 가드

ls package.json apps-in-toss.config.ts granite.config.ts Packages/manifest.json 2>/dev/null

프로젝트 표지가 하나도 없으면 중단:

미니앱 프로젝트 파일(package.json과 apps-in-toss.config.ts·granite.config.ts, 또는
Unity의 Packages/manifest.json)을 찾을 수 없습니다. 미니앱 프로젝트 루트에서
다시 실행해주세요. 예: cd <project-root> && /ait:test-on-device

웹·RN은 발견된 번들 설정 파일(apps-in-toss.config.ts가 있으면 그것을, 없으면 granite.config.ts를 — 의존 절 참고)을 Read로 읽어 appName을 확인한다. Unity·엔진 프로젝트는 SDK의 설정 화면이나 패키지 문서에서 앱 이름을 정하는 곳을 찾아 읽고, 어디인지 모르면 사용자에게 묻는다. Deploy Key가 든 설정 파일은 열지 않는다. 이 값이 콘솔에 등록된 앱의 appName과 정확히 같아야 한다. 불일치 번들은 업로드 자체는 성공하지만 컴파일에서 BUILD_FAILED로 끝난다(에러 메시지: "콘솔에 등록된 앱 ID와 granite.config.ts의 appName이 일치하지 않아요" — 콘솔 쪽 메시지 문구는 설정 파일 종류와 무관하게 고정이다). 불일치를 발견하면 업로드 전에 멈추고 어느 쪽을 맞출지 사용자에게 묻는다 — 이름이 다르다는 이유로 콘솔에 앱을 새로 만들지 않는다.