Coucon SDK
설치 가이드
react-native-coucon-sdk 설치 및 네이티브 환경 설정
설치 가이드
요구 사항
| 항목 | 최소 버전 |
|---|---|
| React Native | 0.73+ |
| Expo SDK | 50+ |
| iOS | 13.0+ |
| Android | API 26+ |
| New Architecture | 권장 (TurboModule) |
패키지 설치
npm install @boostbrothers/react-native-coucon-sdk
네이티브 라이브러리 설정
Coucon SAS 엔진은 네이티브 라이브러리(.xcframework / .aar)를 포함합니다. 각 플랫폼별 설정이 필요합니다.
iOS pod 설치를 실행합니다.
cd ios && pod install && cd ..
CouconSdk.podspec이 네이티브 SAS 라이브러리를 자동으로 포함합니다. pod install 후 Xcode 프로젝트에서 빌드를 확인합니다.
New Architecture(TurboModule)를 활성화하려면 ios/Podfile에 다음을 확인합니다:
# New Architecture 활성화ENV['RCT_NEW_ARCH_ENABLED'] = '1'
Android는 별도의 수동 설정 없이 자동 링킹됩니다.
Gradle 빌드를 동기화합니다:
cd android && ./gradlew build && cd ..
New Architecture를 활성화하려면 android/gradle.properties에서 확인합니다:
# New Architecture 활성화newArchEnabled=true
Expo 프로젝트 설정
Expo 관리형 워크플로우를 사용하는 경우:
npx expo prebuildnpx expo run:ios # iOSnpx expo run:android # Android
설치 확인
import { initialize } from '@boostbrothers/react-native-coucon-sdk';async function verifyInstallation() {try {const result = await initialize(true); // true: 디버그 모드console.log('Coucon SDK 초기화 성공:', result);} catch (error) {console.error('Coucon SDK 초기화 실패:', error);}}verifyInstallation();
콘솔에 Coucon SDK 초기화 성공: true가 출력되면 설치가 완료된 것입니다.
New Architecture(TurboModule) 지원
이 SDK는 React Native의 New Architecture를 우선 지원합니다. TurboModuleRegistry.getEnforcing을 사용하여 모듈을 등록하므로, 모듈이 없는 경우 앱이 시작되지 않습니다.
TurboModuleRegistry.getEnforcing은 모듈을 찾지 못하면 즉시 오류를 발생시킵니다. 네이티브 빌드 없이 Expo Go에서 실행하면 오류가 발생합니다. 반드시 개발 빌드(expo run:ios 또는 expo run:android)를 사용하세요.