질문 / 문제 해결
웹뷰(Vite + React + TS) 미니앱을 개발 중입니다.
[환경]
@apps-in-toss /web-framework: 2.9.2패키지 매니저: npm
npx ait build 성공 (RN 0.84.0 / 0.72.6 둘 다 빌드됨)
npx ait deploy 성공 (deploymentId 정상 발급)
안드로이드 샌드박스 앱: 최신 버전으로 재설치함 (빌드: 다운로드 화면에 적힌 날짜를 여기 적어주세요)
[증상]
[질문]
이 오류의 원인이 무엇인가요? (framework 2.9.2와 샌드박스 앱 버전 호환 문제일까요?)
framework 2.9.2와 호환되는 샌드박스 앱 빌드 버전을 알 수 있을까요?
해결 방법이 있을까요?
nae-palja
@hobum007 님 안녕하세요
가이드 안내드립니다
답변 감사합니다! adb 설정 완료했는데도 동일하게 실패해서 추가 정보 드립니다.
[완료한 것]
adb devices → device로 정상 인증됨
adb reverse tcp:8081 tcp:8081 / tcp:5173 tcp:5173 완료
npm run dev 로 localhost:5173 개발서버 정상 구동
framework 버전을 2.9.2 → 2.6.0(샌드박스 빌드 2026-05-21 시점 버전)으로 낮춤
ait build(새 deploymentId) + ait deploy 재배포까지 완료
[증상] 위 모든 걸 해도 스킴(intoss://nae-palja) 실행 시 “앱 실행 도중 문제가 발생했습니다” 동일하게 뜹니다.
[logcat] im.toss.rn.granite.core.GraniteActivity 가 실행되자마자 destroy되고 로그인 화면으로 돌아갑니다. FATAL/AndroidRuntime 크래시는 없고, 런타임이 스스로 종료하는 것으로 보입니다.
[환경]
웹뷰(Vite + React + TS), npm
안드로이드 갤럭시 S25+
샌드박스 앱 빌드: 2026-05-21
추가로 확인할 설정이나, 현재 샌드박스 빌드와 호환되는 정확한 framework 버전을 알려주실 수 있을까요?
Dylan
6월 22, 2026, 12:40오전
4
안녕하세요 nae-palja 가 맞으실까요 ? 검색해도 나오지 않습니다
안녕하세요, 답변 감사합니다!
네, appName은 nae-palja가 맞습니다.
워크스페이스: 울릉도호랭이 (ID 52397)
혹시 콘솔에서 앱 정보를 아직 "임시저장"만 하고 검토 요청 전 상태라
Dylan
6월 23, 2026, 2:09오전
6
adb 설정까지 해주셨다면 안될 이유가 없을 것 같은데 이상하네요 nae-palja 를 클릭하여 접근해주셨을까요 ?
네, 정확히 그 경로로 접근했습니다.
adb reverse(5173/8081) 설정 완료 상태
리스트 노출은 정상 → 클릭 시 실행 단계에서만 크래시
워크스페이스: 울릉도호랭이 (ID 52397)
GraniteActivity가 실행됐다가 바로 종료되는 형태인데,
Dylan
6월 24, 2026, 12:53오전
8
granite.config.ts 도 한번 공유주실 수 있을까요 ?가이드 기준으로 새로 앱을 생성했을때도 동일하신지 확인 부탁드립니다
granite.config.ts 공유드립니다.
import { defineConfig } from '@apps-in-toss/web-framework/config';
export default defineConfig({
appName: 'nae-palja',
brand: {
displayName: '내 팔자 알려줘',
primaryColor: '#5b3df5',
icon: 'src/assets/icon.png',
},
permissions: [],
web: {
host: 'localhost',
port: 5173,
commands: {
dev: 'npm run dev',
build: 'npm run build',
},
},
outdir: 'dist',
});
Dylan
6월 25, 2026, 3:25오전
10
가이드 기준으로 새로 스캐폴딩 했을때도 동일한 이슈가 있으신지 확인 부탁드려도 될까요 ?
granite.config.ts 공유드립니다. (위에 코드 첨부)
가이드대로 create-ait-app으로 새로 스캐폴딩해서 비교해봤는데,
새 앱을 샌드박스에서 실행했을 때 동일 이슈가 있는지는
Dylan님, 확인 결과 공유드립니다.
가이드대로 create-ait-app으로 새 앱을 스캐폴딩해서 비교한 뒤,
React 18 → 19 업그레이드
@apps-in-toss /web-framework 2.6.0 → 2.10.1build 커맨드 ‘tsc -b && vite build’ → ‘vite build’ (스캐폴딩과 동일)
granite.config 구조/import 경로 모두 새 스캐폴딩과 동일 확인
빌드 시 RN 0.84.0 + 0.72.6 두 버전으로 패키징됨
새 deploymentId로 재배포 완료
그런데도 샌드박스 미니앱 리스트에서 nae-palja 클릭 시
→ 미니앱 코드/버전 문제는 아닌 것으로 판단됩니다.
혹시 커뮤니티에 보고된 libpenguin.so 로딩 실패 /
(워크스페이스: 울릉도호랭이 / ID 52397)
Dylan
6월 29, 2026, 6:23오전
13
개발자센터에 올라가있는 샌드박스 apk 와 2.x 버전은 모두 호환됩니다.npx create-ait-app {appName} 으로 새로 스캐폴딩하여 안드로이드 시뮬레이터에서
adb 설정 이후, create-ait-app 으로 만들어진 새 앱을 시뮬레이터에서 접근했을때도 동일한가요 ?
답변 감사합니다! 시뮬레이터에서 정상 접근되셨다니 참고됩니다.
저는 실제 안드로이드 폰에서 테스트 중인데, 우선 nae-palja를
혹시 실기기(특정 기종/OS)에서만 발생하는 케이스가 있을까요?
