iOS에서 실행시 검은 빈(+흰색) 화면으로 멈추는 현상

[loom]

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

질문 / 문제 해결

내용을 설명해주세요

안녕하세요.

현재 일부 iOS 사용자에게서만 미니앱(비게임)이 실행되지 않고,
검은 빈 화면 혹은 흰색 화면(“잠시 문제가 생겼어요”) 으로 멈추는 문제가 발생하고 있어 문의드립니다.

환경

@apps-in-toss/framework: 2.4.7
react-native: 0.84.0
react: 19.2.3
ait build 사용

현재 상황

Android
    샌드박스 / QR / 배포 빌드 모두 정상 동작
iOS
    일부 사용자에서 앱 진입 시 검은 빈 화면 또는 흰/검은 화면만 보이고 멈춤
    이 경우 토스 상단 네비게이션 바도 보이지 않는 수준
    오래 기다려도 다음 화면으로 넘어가지 않음

저희가 확인한 내용

Sentry를 연동했고 startup-probe-v1 이벤트를 심어서 확인 중입니다.
현재는 Android 쪽 startup probe만 수집되고 있고, 문제가 발생하는 iOS 쪽에서는 Sentry JS 이벤트가 잡히지 않습니다.
일부 사용자는 백엔드 로그도 거의 남지 않아, 미니앱이 본격적으로 시작되기 전 단계에서 막히는 것처럼 보입니다.

현재 추정

iOS 토스앱 런타임 / 컨테이너 레벨에서 앱이 시작되기 전에 막히는 문제일 가능성을 의심하고 있습니다.
한번 확인해주실 수 있을까요?
감사합니다.

appName (선택)

goosebumps-lotto

이미지 첨부

[Dylan]

안녕하세요
한번 확인해보겠습니다.

[loom]

안녕하세요,
넵 감사합니다

[Dylan]

기다려주셔서 감사해요.
granite.config.ts에서 appsInToss 플러그인에 target을 설정하셨을까요?
혹시 설정하셨다면 target 필드를 지우시고 .granite 폴더를 지운 이후 ait build > 배포 해봐주실 수 있을까요 ?

[loom]

안녕하세요, @Dylan 님

안내 주신 대로 아래와 같이 다시 확인해보았습니다.

• granite.config.ts에서 appsInToss 플러그인의 target 설정 제거
• .granite, .swc, node_modules, package-lock.json 삭제
• 이후 npm install → ait build로 완전 새로 빌드 진행

빌드는 정상적으로 완료되었지만,
해당 상태의 빌드를 QR로 실행하면 Android에서도 앱이 정상 진입하지 않고 튕기는 현상이 확인되었습니다.

추가로 확인해봐야 할 설정이나 점검 항목이 있을지 확인 부탁드립니다.

감사합니다.

[Dylan]

@loom 혹시 granite.config.ts 를 공유해주실 수 있을까요 ?

[loom]

윈도우 path 이슈였네요

리눅스에서 빌드하는걸로 해결했습니다. 도움주셔서 정말 감사합니다.

[Dylan]

혹시 채널톡 확인 가능하실까요 ?!

[loom]

@dylan 채널톡에 따로 보이는게 없습니다.

이메일로만 받은게 있는데 요거 말씀하신 걸까요?

[Dylan]

아 재현 경로를 여쭤보려고 했는데, 메시지로 보내주셨네요 감사합니다!