샌드박스 앱 실행 시 바로 "앱 실행도중 문제가 발생했습니다" 에러가 떠요

개발
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

안녕하세요, create-ait-app으로 처음 앱을 만들어보고 있는 초보 개발자입니다. 로컬 개발 서버를 켜고 안드로이드 샌드박스 앱으로 테스트하려는데, 샌드박스 앱을 열자마자 바로 에러가 떠서 문의드립니다.

현재 한 작업

  1. npx create-ait-app으로 프로젝트 생성 (React, TypeScript, Oxlint, 인앱광고 예제 포함)
  2. npm run dev 실행 → 정상적으로 http://localhost:5173/에서 서버 실행 확인
  3. 샌드박스 앱(rn-miniapp-real-release-protected.apk, static.toss.im에서 다운로드) 설치
    adb install -r -t rn-miniapp-real-release-protected.apk → Success
  4. 포트 연결
    adb reverse tcp:8081 tcp:8081 → 성공
    adb reverse tcp:5173 tcp:5173 → 성공
  5. 핸드폰에서 샌드박스 앱 아이콘 실행 → 로그인 화면이나 intoss:// 입력 화면까지 가지도 못하고, 바로 아래 에러 화면이 뜸

에러 메시지:
앱 실행도중 문제가 발생했습니다.
앱인토스 개발자 커뮤니티로 문의해주세요.

기기: [SM-S928N]
안드로이드 버전: [안드로이드 16]
Node.js: v24.20.0
adb: 1.0.41
앱인토스 콘솔에 앱 등록 완료 (appName: big-yein)

이미지 첨부

KakaoTalk_20260921_145357882.jpg
KakaoTalk_20260921_145357882.jpg1080×2340 87.3 KB

2

안녕하세요 :slight_smile:
아마 @apps-in-toss/web-framework SDK 3.x 버전을 사용하고 계실 것 같은데, 3.x 버전은 샌드박스앱을 이용하실 수 없습니다.
샌드박스앱은 2.x 버전까지 지원하고있고, 3.x 버전부터는 함께 설치된 패키지(devtools) - 브라우저를 통한 확인 부탁드립니다.