트러블 슈팅 - 엑스포 SDK

​

문제 현상

• Xcode 27에서 빌드한 앱이 실행되지 않고 즉시 종료됩니다.
• Scene 생명주기를 채택하기 위해 UIApplicationSceneManifest를 추가하면, 이번에는 앱이 흰 화면으로 표시되고 화면이 그려지지 않습니다.
• 스킴 딥링크(Scheme Deeplink) 또는 유니버설 링크(Universal Links)로 앱에 진입해도 Airbridge 딥링크 이벤트가 수집되지 않습니다.
• 개발자 가이드대로 app.json에 Airbridge config plugin을 설정했는데도 동작하지 않습니다.

​

발생 원인

​

해결 방법

​

1. Expo SDK 58로 업그레이드

npx expo install expo@next
npx expo install --fix

​

2. Airbridge SDK 최신 버전 설치

npm install --save airbridge-expo-sdk@latest
npm install --save airbridge-react-native-sdk@latest

​

3. 네이티브 프로젝트 재생성

npx expo prebuild --clean

​

4. 딥링크 설정 확인

​

5. 동작 확인

​

문제 현상

​

발생 원인

​

해결 방법

1. 암호를 저장하는 도메인을 준비해주세요.
2. 아래 JSON을 https://YOUR_DOMAIN/.well-known/apple-app-site-association에 Content-Type: application/json으로 호스팅합니다. 준비한 도메인이 YOUR_DOMAIN입니다.

{
    "webcredentials": {
        "apps": ["YOUR_APP_ID_PREFIX.YOUR_BUNDLE_ID"]
    }
}

3. Xcode의 [YOUR_PROJECT]>[Signing & Capabilities]로 이동합니다.
4. ’+ Capability’를 클릭해 Associated Domains를 추가합니다. Associated Domains에 webcredentials:YOUR_DOMAIN을 입력합니다.

​

문제 현상

​

발생 원인

​

해결 방법

​

문제 현상

​

발생 원인

​

해결 방법

import { Airbridge } from 'airbridge-react-native-sdk';
import * as Router from 'expo-router';

const router = Router.useRouter();

Airbridge.setOnDeeplinkReceived((result) => {
  // route deeplink
  router.push(...);
});