📱 RN/Expo 기능 구현 총정리

요약 테이블

기능	권장 라이브러리 / API (Expo 우선)	iOS/Android 권한 & 설정	주요 주의사항 / 한계	난이도*	오프라인/백그라운드
카메라 촬영	expo-camera	iOS: NSCameraUsageDescription / AOS: CAMERA	실시간 스캔/줌/플래시 등은 디바이스별 차이. QR스캔은 expo-barcode-scanner 또는 expo-camera 내 기능 사용	2	오프라인: ✅ / 백그라운드: ❌
갤러리(앨범) 접근/저장	expo-image-picker(선택) + expo-media-library(저장)	iOS: NSPhotoLibraryUsageDescription / AOS: READ/WRITE_EXTERNAL_STORAGE(Android 13+는 권한 체계 변경)	iOS 사진 “선택된 사진만 허용” 상태 대응 필요. 저장은 MediaLibrary 사용	2	오프라인: ✅ / 백그라운드: ❌
GPS(위치)	expo-location	iOS: NSLocationWhenInUseUsageDescription(필요 시 Always) / AOS: ACCESS_COARSE/ACCESS_FINE_LOCATION	백그라운드 트래킹은 추가 설정·배터리 이슈. 정확도/빈도 조절 필요	3	오프라인: ✅ / 백그라운드: ⚠️(설정 필요)
푸시 알림(원격)	expo-notifications (+ Expo Push, FCM/APNs 연동)	iOS: 알림 권한 / AOS: 채널 설정 필수	디바이스 토큰 발급/백엔드 연동 필요. AOS 채널(중요도/사운드) 사전 생성	4	오프라인: ❌ / 백그라운드: ✅
로컬 알림(스케줄)	expo-notifications	iOS/AOS 알림 권한	예약/반복 스케줄 지원. AOS 채널 준비. 앱 종료 상태에서도 표시	2	오프라인: ✅ / 백그라운드: ✅
파일(읽기/쓰기/다운로드)	expo-file-system / 선택: expo-document-picker	일반 권한 無, 특정 경로 접근은 제한. AOS 저장공간 스코프 주의	대용량 다운로드/진행률/중단 재개 등 구현 시 이벤트 처리 필요	3	오프라인: ✅ / 백그라운드: ⚠️(제약)
외부 링크 열기	Linking.openURL(url) / 인앱: expo-web-browser	별도 권한 無	인앱 탭은 WebBrowser.openBrowserAsync. 딥링크/커스텀스킴은 expo-linking	1	오프라인: ❌ / 백그라운드: ❌
공유하기(공유 시트)	RN 내장 Share / 파일 공유: expo-sharing	권한 無(파일 액세스는 별도)	파일은 로컬 경로/URI 필요. 일부 앱으로 공유 제한 존재	1-2	오프라인: ✅ / 백그라운드: ❌
설정 화면 열기	RN Linking.openSettings()	無	iOS는 앱 설정으로 이동, AOS는 기기·OS별 편차	1	—
스토어 열기(리뷰/설치)	Linking.openURL()로 스토어 스킴	無	iOS: itms-apps://itunes.apple.com/app/id{appId} / AOS: market://details?id={pkg}	1	—
링크를 브라우저로 실행	Linking.openURL(url) / 인앱: expo-web-browser	無	외부 브라우저 강제는 Linking. 인앱은 WebBrowser	1	—
전화 연결	Linking.openURL('tel:${number}')	無	iOS 일부에서 확인 팝업. 시뮬레이터 제한	1	—
클립보드 복사	expo-clipboard	無	대용량 텍스트/이미지 제약. 성공/실패 UX 제공	1	오프라인: ✅
로컬 스토리지	기본: @react-native-async-storage/async-storage / 민감정보: expo-secure-store	無	민감정보는 SecureStore(키체인/Keystore). 빈번 접근/성능은 MMKV(추후)	2	오프라인: ✅

*난이도(체감): 1(매우 쉬움) ~ 5(어렵고 인프라 필요)

---

구현 팁 & 체크리스트

권한/프롬프트

• iOS: app.json/app.config.ts의 infoPlist에 용도 설명(예: NSCameraUsageDescription) 반드시 추가.
• Android: android.permissions에 필요한 권한 선언, Android 13+는 미디어 접근 권한이 세분화(이미지/비디오/오디오)되었음.

푸시/알림

• 채널(AOS): Notifications.setNotificationChannelAsync('default', { importance: Notifications.AndroidImportance.HIGH, ... }) 선행.
• 토큰: getExpoPushTokenAsync() 또는 FCM/APNs 직접 통합. 서버에서 토큰 저장/타겟팅 발송 필요.
• 로컬 알림: 예약/반복, 배지/사운드 설정 가능. 권한 거부 시 대체 UX 준비.

파일/갤러리

• 다운로드 경로: 앱 샌드박스 내 URI 사용. 갤러리에 저장하려면 expo-media-library.
• 문서 선택: 사용자 파일 피커는 expo-document-picker(MIME 필터).

위치

• 정확도/배터리: accuracy 옵션을 시나리오별 구분(지도 즉시 위치 vs. 트래킹).
• 백그라운드: 실제 상시 트래킹은 정책/배터리 이슈 큼 → 사용자 가치/설정 토글 제공 필수.

링크/스토어/전화

• 스토어 링크 포맷
  • iOS: itms-apps://itunes.apple.com/app/id<APP_ID>
  • Android: market://details?id=<PACKAGE_NAME>
• 딥링크: expo-linking으로 스킴/유니버설 링크 정의. 외부 앱 호출 시 실패 핸들링(try/catch) 필수.

로컬 스토리지

• 일반 데이터: AsyncStorage(키-값).
• 민감 데이터(토큰 등): expo-secure-store(암호화 저장).
• 성능 최적화: 매우 빈번/대용량이면 react-native-mmkv(Expo Dev Client 필요할 수 있음)를 차기 단계로 고려.

---

최소 예시(스니펫 모음)

푸시 채널/권한/토큰

import * as Notifications from 'expo-notifications';
import { Platform } from 'react-native';

export async function initNotifications() {
  if (Platform.OS === 'android') {
    await Notifications.setNotificationChannelAsync('default', {
      name: 'default',
      importance: Notifications.AndroidImportance.HIGH,
    });
  }
  const { status } = await Notifications.requestPermissionsAsync();
  if (status !== 'granted') return null;
  const token = await Notifications.getExpoPushTokenAsync();
  return token.data; // 서버로 전송
}

로컬 알림 스케줄

await Notifications.scheduleNotificationAsync({
  content: { title: '리마인더', body: '지금 확인하세요' },
  trigger: { seconds: 10, repeats: false },
});

카메라/이미지 선택

import * as ImagePicker from 'expo-image-picker';
const res = await ImagePicker.launchImageLibraryAsync({ mediaTypes: ImagePicker.MediaTypeOptions.Images });
if (!res.canceled) {
  const uri = res.assets[0].uri; // 업로드/표시
}

외부 링크/인앱 브라우저/전화

import { Linking } from 'react-native';
import * as WebBrowser from 'expo-web-browser';

await Linking.openURL('tel:01012345678');
await Linking.openURL('market://details?id=com.example');
await WebBrowser.openBrowserAsync('https://example.com'); // 인앱 탭

클립보드/스토리지

import * as Clipboard from 'expo-clipboard';
import AsyncStorage from '@react-native-async-storage/async-storage';
import * as SecureStore from 'expo-secure-store';

await Clipboard.setStringAsync('복사할 텍스트');
await AsyncStorage.setItem('key', JSON.stringify({ v: 1 }));
await SecureStore.setItemAsync('token', 'SECRET'); // 민감정보