# 안드로이드 샌드박스에서 미니앱 실행 시 "앱 실행 도중 문제가 발생했습니다" 발생

**URL:** <https://techchat-apps-in-toss.toss.im/t/topic/4156>\
**Category:** 개발\
**Tags:** sdk\
**Created:** [6월 20, 2026, 2:15오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156 "2026-06-20T14:15:27Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 20, 2026, 2:15오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/1 "2026-06-20T14:15:27Z")

</div>

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

질문 / 문제 해결

### 내용을 설명해주세요

웹뷰(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 정상 발급)
- 안드로이드 샌드박스 앱: 최신 버전으로 재설치함 (빌드: 다운로드 화면에 적힌 날짜를 여기 적어주세요)

[증상]  
샌드박스 앱에서 개발자 로그인 → 앱 목록에서 내 앱 선택 → 토스 계정 본인인증까지 정상입니다.  
이후 스킴(intoss://nae-palja)으로 실행하면  
“앱 실행 도중 문제가 발생했습니다. 앱인토스 개발자 커뮤니티로 문의해주세요” 화면이 뜹니다.

[질문]

1. 이 오류의 원인이 무엇인가요? (framework 2.9.2와 샌드박스 앱 버전 호환 문제일까요?)
2. framework 2.9.2와 호환되는 샌드박스 앱 빌드 버전을 알 수 있을까요?
3. 해결 방법이 있을까요?

### appName (선택)

nae-palja

### 이미지 첨부

 ![KakaoTalk_20260620_231455400.jpg](https://canada1.discourse-cdn.com/flex007/uploads/toss/original/2X/b/b1edacc911632bd538af64b032ddb69c71651e16.jpeg)

---

<div class="post-metadata">

**Author:** ![seonjeong](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/seonjeong/32/594_2.png) [@seonjeong](https://techchat-apps-in-toss.toss.im/u/seonjeong)\
**Post date:** [6월 21, 2026, 5:06오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/2 "2026-06-21T05:06:56Z")

</div>

@hobum007 님 안녕하세요  
adb 설정 되었을까요?

> **[Android 에뮬레이터 또는 실기기에서 실행하기 ​ - 앱인토스 개발자센터](https://developers-apps-in-toss.toss.im/development/test/sandbox.html#android-%E1%84%8B%E1%85%A6%E1%84%86%E1%85%B2%E1%86%AF%E1%84%85%E1%85%A6%E1%84%8B%E1%85%B5%E1%84%90%E1%85%A5-%E1%84%84%E1%85%A9%E1%84%82%E1%85%B3%E1%86%AB-%E1%84%89%E1%85%B5%E1%86%AF%E1%84%80%E1%85%B5%E1%84%80%E1%85%B5%E1%84%8B%E1%85%A6%E1%84%89%E1%85%A5-%E1%84%89%E1%85%B5%E1%86%AF%E1%84%92%E1%85%A2%E1%86%BC%E1%84%92%E1%85%A1%E1%84%80%E1%85%B5)**
>
> 앱인토스는 개발용 토스앱을 별도로 제공하지 않아요. 대신 전용 샌드박스 앱을 통해 개발·테스트 환경을 구성할 수 있어요. | 앱인토스 샌드박스 앱으로 미니앱을 테스트하는 방법을 안내해요. 환경 설정부터 설치, 로그인, 미니앱 실행까지 전체 과정을 다뤄요.

가이드 안내드립니다

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 21, 2026, 2:20오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/3 "2026-06-21T14:20:12Z")

</div>

답변 감사합니다! 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 버전을 알려주실 수 있을까요?

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [6월 22, 2026, 12:40오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/4 "2026-06-22T00:40:19Z")

</div>

안녕하세요 🙂  
framework 2.x 버전은 현 샌드박스 빌드와 모두 호환됩니다.  
appName이 `nae-palja` 가 맞으실까요 ? 검색해도 나오지 않습니다 🥲

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 22, 2026, 3:34오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/5 "2026-06-22T15:34:56Z")

</div>

안녕하세요, 답변 감사합니다!

네, appName은 nae-palja가 맞습니다.  
콘솔 앱 정보에 appName: nae-palja 로 표시되고, granite.config.ts와 ait deploy도  
동일하게 nae-palja로 맞춰 배포(deploymentId 발급)까지 완료했습니다.

- 워크스페이스: 울릉도호랭이 (ID 52397)

혹시 콘솔에서 앱 정보를 아직 "임시저장"만 하고 검토 요청 전 상태라  
검색에 안 잡히는 걸까요? 앱을 찾으시는 데 추가로 필요한 정보가 있으면 알려주세요!

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [6월 23, 2026, 2:09오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/6 "2026-06-23T02:09:43Z")

</div>

adb 설정까지 해주셨다면 안될 이유가 없을 것 같은데 이상하네요 🤔  
혹시 adb 이후, 샌드박스 앱 로그인 \> 미니앱 리스트에서 `nae-palja` 를 클릭하여 접근해주셨을까요 ?

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 23, 2026, 11:00오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/7 "2026-06-23T23:00:17Z")

</div>

네, 정확히 그 경로로 접근했습니다.  
샌드박스 앱 로그인 → 미니앱 리스트에 nae-palja가 정상으로 보이고,  
그걸 클릭하면 바로 “앱 실행 도중 문제가 발생했습니다” 팝업이 뜹니다.  
(미니앱 리스트 화면 + 에러 팝업 스크린샷 첨부합니다)

- adb reverse(5173/8081) 설정 완료 상태
- 리스트 노출은 정상 → 클릭 시 실행 단계에서만 크래시
- 워크스페이스: 울릉도호랭이 (ID 52397)

GraniteActivity가 실행됐다가 바로 종료되는 형태인데,  
실행 단계에서 어떤 점을 더 확인하면 될지 안내 부탁드립니다.  
혹시 logcat 로그가 필요하면 다시 캡처해서 올리겠습니다.

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [6월 24, 2026, 12:53오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/8 "2026-06-24T00:53:32Z")

</div>

`granite.config.ts` 도 한번 공유주실 수 있을까요 ?  
[가이드](https://developers-apps-in-toss.toss.im/tutorials/ai-vibe-coding.html) 기준으로 새로 앱을 생성했을때도 동일하신지 확인 부탁드립니다 🙇‍♂️

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 24, 2026, 10:25오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/9 "2026-06-24T22:25:56Z")

</div>

granite.config.ts 공유드립니다.

```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',
});

```

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [6월 25, 2026, 3:25오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/10 "2026-06-25T03:25:52Z")

</div>

[가이드](https://developers-apps-in-toss.toss.im/tutorials/ai-vibe-coding.html) 기준으로 새로 스캐폴딩 했을때도 동일한 이슈가 있으신지 확인 부탁드려도 될까요 ?

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 25, 2026, 11:58오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/11 "2026-06-25T11:58:51Z")

</div>

granite.config.ts 공유드립니다. (위에 코드 첨부)

가이드대로 create-ait-app으로 새로 스캐폴딩해서 비교해봤는데,  
config 구조·import 경로·필드 모두 동일했습니다.  
유일한 차이는 web.commands의 dev/build가  
저는 ‘npm run dev’ / ‘npm run build’, 새 스캐폴딩은 ‘vite dev’ / 'vite build’인 점입니다.

새 앱을 샌드박스에서 실행했을 때 동일 이슈가 있는지는  
지금 폰 연결해서 테스트 중이며, 결과 나오면 다시 공유드리겠습니다.

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 28, 2026, 8:58오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/12 "2026-06-28T08:58:14Z")

</div>

Dylan님, 확인 결과 공유드립니다.

가이드대로 create-ait-app으로 새 앱을 스캐폴딩해서 비교한 뒤,  
nae-palja를 새 스캐폴딩과 동일하게 맞춰 재배포했습니다:

- React 18 → 19 업그레이드
- @apps-in-toss/web-framework 2.6.0 → 2.10.1
- build 커맨드 ‘tsc -b && vite build’ → ‘vite build’ (스캐폴딩과 동일)
- granite.config 구조/import 경로 모두 새 스캐폴딩과 동일 확인
- 빌드 시 RN 0.84.0 + 0.72.6 두 버전으로 패키징됨
- 새 deploymentId로 재배포 완료

그런데도 샌드박스 미니앱 리스트에서 nae-palja 클릭 시  
동일하게 "앱 실행 도중 문제가 발생했습니다"가 뜹니다  
(GraniteActivity가 실행 직후 종료, 동일 증상).

→ 미니앱 코드/버전 문제는 아닌 것으로 판단됩니다.

혹시 커뮤니티에 보고된 libpenguin.so 로딩 실패 /  
샌드박스 APK ↔ SDK 호환 이슈와 같은 건가요?  
제가 설치해야 할 정확한 샌드박스 APK 버전이나  
다운로드 위치를 알려주시면 그걸로 재설치해보겠습니다.

(워크스페이스: 울릉도호랭이 / ID 52397)

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [6월 29, 2026, 6:23오전 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/13 "2026-06-29T06:23:31Z")

</div>

개발자센터에 올라가있는 샌드박스 apk 와 2.x 버전은 모두 호환됩니다.  
방금 `npx create-ait-app {appName}` 으로 새로 스캐폴딩하여 안드로이드 시뮬레이터에서  
테스트하니, 정상 접근 되었는데요 🥲

adb 설정 이후, create-ait-app 으로 만들어진 새 앱을 시뮬레이터에서 접근했을때도 동일한가요 ?

---

<div class="post-metadata">

**Author:** ![hobum007](https://avatars.discourse-cdn.com/v4/letter/h/dec6dc/32.png) [@hobum007](https://techchat-apps-in-toss.toss.im/u/hobum007)\
**Post date:** [6월 29, 2026, 12:56오후 UTC](https://techchat-apps-in-toss.toss.im/t/topic/4156/14 "2026-06-29T12:56:44Z")

</div>

답변 감사합니다! 시뮬레이터에서 정상 접근되셨다니 참고됩니다.

저는 실제 안드로이드 폰에서 테스트 중인데, 우선 nae-palja를  
새 스캐폴딩과 동일하게 맞춰 재배포했습니다  
(React 19, framework 2.10.1, vite build, RN 0.84+0.72 듀얼).  
그래도 실기기 미니앱 리스트 클릭 시 동일하게  
"앱 실행 도중 문제가 발생했습니다"가 뜹니다.

혹시 실기기(특정 기종/OS)에서만 발생하는 케이스가 있을까요?  
create-ait-app 순정 앱도 곧 테스트해서 결과 공유드리겠습니다.  
(참고: 현재 제 데스크탑은 USB 데이터 연결이 안 되는 상황이라  
adb dev서버 라이브 실행은 어렵고, 배포본을 리스트에서 클릭해 테스트 중입니다.)