상세 컨텐츠

본문 제목

앱인토스 미니앱 배포하기: 스프레드시트로 관리하는 QA, 샌드박스 앱으로 테스트하기

앱인토스_카공지도

by Drawer 2026. 4. 23. 02:10

본문

이제 디자인 단계는 얼추 끝나서 테스트를 진행 중이다.

 

테스트 프로세스

1. 스프레드 시트에 오류 및 수정사항 기록

2. 수정사항 반영

3. 앱인토스 샌드박스 앱 다운하고 로컬서버 연동

4. 폰으로 앱 확인하며 수정사항 계속 캐치

 

스프레드시트는 아래와 같이 정리했다.

 

크게 피드백 넘버 | 페이지명 | 반영여부 | 수정사항 | 코멘트 로 구성했다.

- 페이지명은 큰 카테고리 / 페이지명 으로 기재한다.

- 반영여부는 반영됨 | 반영안됨 | 논의필요 로 구성하고, 반영과 논의여부에 따라 상태를 변경한다.

- 수정사항에는 말그대로 고쳐야할 부분, 코멘트에는 수정사항에 대해 덧붙일 말들을 써둔다.

- 피드백 중 이미지 참고가 필요하다면, 두번째 시트에 이미지를 첨부한 뒤, 해당 셀의 링크를 페이지명에 걸어둔다.

 

원래는 피그마 파일에서 'Annotation' 기능을 활용해, 수정할 부분을 체크해뒀었는데. 페이지가 흩어져있다보니 일일이 확인하기가 번거롭고, 반영했을 때 표시하는 방식이 마땅찮기도 해서 스프레드 시트에 작성하는 방식을 제안했다. 퍼포마로 근무할 때 브랜드 공식몰 런칭을 서포트한 적이 있었는데 선배님들이 이렇게 시트로 개발 수정사항을 정리해서 외주 개발사와 커뮤니케이션하는 걸 보고 기억해뒀던 덕분이다. 

 

앱인토스 샌드박스앱으로 테스트하기

1. 앱인토스 개발자 콘솔에서 '새 앱 만들기' 클릭

 

2. 앱 정보를 입력한 뒤 제출

(심사까지는 영업일 2일 정도 걸린다고 하는데, 심사 승인되기 전에도 샌드박스 앱에서 테스트할 수 있다!) 

 

3. granite.config.ts 설정 -> 클로드에 요청

(이때, 'appName' 이 본인이 '앱 정보'에 입력한 appName과 동일한지 꼭 확인해야함)

 

4. PC의 터미널(terminal)에서 서버를 시작하기 위해 아래 코드 입력

cd [클로드와 연동된 파일의 경로 삽입 ex. Users/kildong/Desktop/appintoss]
npm run dev

 

5. 성공했다면 터미널에 아래 'GRANITE' 라는 문자가 뜨면서 정상 실행

 

6. 앱인토스 콘솔 앱(샌드박스) 설치 (▼ 아래 사이트에서 다운 가능)

 

앱인토스 개발자센터

샌드박스앱은 수시로 업데이트돼요. 오류가 보이면 최신 버전으로 업데이트해 주세요.

developers-apps-in-toss.toss.im

 

7. 콘솔 앱 로그인 후 [설정] 에서 'Metro 서버' 입력

-> Metro 서버 예시: 192.168.00.000

(*만약 클로드가 'http://192.168.00.000' 로 알려줘서 고대로 입력했는데 연결이 안 된다? 'http://' 를 떼고 입력)

 

*서버 찾는 방법

macOS: 터미널에 아래 코드 입력

ipconfig getifaddr en0

 

Windows: 

설정 → 네트워크 및 인터넷 → Wi-Fi → 속성 → IPv4 주소

 

8. 휴대폰과 PC는 반드시 같은 WIFI에 연결되어있어야 함 (모바일 핫스팟 가능)

 

9. URL 입력

-> intoss://[내 앱의 appName]

 

10. URL 입력 후 '스키마 열기' 를 누르거나, 앱 메인 화면에서 'appName' 을 클릭하면 앱이 열린다!

 

제가 비전공자이고, 사실 위 프로세스도 클로드 잡도리해가며 겨우 진행한 것이기 때문에 만약 저대로 했는데 안된다? 하면 본인의 클로드를 잡도리해보시길...

 

여기서 잠깐!

한 번 콘솔앱과 로컬서버를 연동했다고, 다음 번에도 자동으로 연결되지 않는다. 

터미널을 열어서 4번의 코드를 입력한 다음에 앱을 실행할 수 있으니 주의!

 

그리고 샌드박스 앱에서 테스트할 수 있는 기능은 제한적이다. 아래 리스트를 잘 확인해서 앱에 오류가 났다고 오해하지 마시길.

출처: 앱인토스 개발자센터

 

앱을 켜놓고 클로드에 수정을 요청하면 반영되는 게 바로바로 보여서 신기하다. 핸드폰과 연동하니, PC화면에서 봤던 화면이랑은 또 사뭇 다른 느낌이고 직접 손으로 조작해가며 앱을 사용해보니 수정사항도 더 잘 보인다. 단점이 있다면 수정사항이 너무 잘 보여 일이 또 이따만큼 늘어났다는 것...? 

 

아 그리고 앱인토스에 심사 요청했던 앱정보도 오늘 승인이 났다! 영업일 이틀 내로 심사결과 메일로 알려주신댔는데, 딱 2일차인 오늘 밤에도 메일이 안 와서 날 밝으면 독촉메일(?) 보내려했는데... 밤 10:59에 승인 메일이 도착했다. 대체 토스에선 무슨일이 벌어지고 있나요? 

 

이제 배포가 눈앞이다! 조금만 더 열심히~~...

관련글 더보기