Device Data
설치 가이드
react-native-device-data-module 설치 및 설정 방법
설치 가이드
패키지 설치
npm install
이 패키지는 Expo 네이티브 모듈 시스템(expo-modules-core)을 기반으로 합니다. Expo SDK 50 이상 또는 React Native 0.73 이상이 필요합니다.
네이티브 설정
iOS 설정
패키지 설치 후 iOS 디렉토리에서 CocoaPods를 실행합니다.
cd ios && pod install
별도의 Info.plist 수정이나 권한 설정은 필요하지 않습니다. iOS UserDefaults는 앱 샌드박스 내에서 자동으로 동작합니다.
Android 설정
Android는 별도의 네이티브 설정 없이 자동으로 동작합니다. Gradle이 패키지를 자동으로 감지하고 연결합니다.
Android SharedPreferences는 앱의 기본 SharedPreferences를 사용합니다.
Expo 프로젝트 설정
Expo 프로젝트의 경우 Development Build가 필요합니다. Expo Go에서는 네이티브 모듈이 동작하지 않습니다.
# EAS Build 사용eas build --profile development --platform all# 또는 로컬 빌드npx expo run:iosnpx expo run:android
설치 확인
아래 코드로 모듈이 올바르게 설치되었는지 확인합니다.
import UnifiedDeviceDataModule from '@boostbrothers/react-native-device-data-module';// 테스트 값 저장 및 조회async function verifyInstallation() {await UnifiedDeviceDataModule.setItem('accessToken', 'test-token');const value = await UnifiedDeviceDataModule.getItem({unifiedKey: 'accessToken',});console.log('설치 확인:', value === 'test-token' ? '성공' : '실패');// 테스트 값 삭제await UnifiedDeviceDataModule.removeItem('accessToken');}verifyInstallation();
네이티브 모듈이 포함된 패키지이므로 Metro 번들러 재시작이 필요할 수 있습니다. npx react-native start --reset-cache 명령으로 캐시를 초기화하세요.
요구사항
| 항목 | 최소 버전 |
|---|---|
| React Native | 0.73 이상 |
| Expo SDK | 50 이상 |
| iOS | 13.0 이상 |
| Android | API 23 (Android 6.0) 이상 |
| Node.js | 18.0 이상 |