---
id: rn-ota-updates-codepush
title: RN OTA — Expo Updates / CodePush 후속
category: Coding
status: draft
source_trust_level: B
verification_status: conceptual
created_at: 2026-05-09
updated_at: 2026-05-09
tags: [react-native, ota, expo, vibe-coding]
tech_stack: { language: "TypeScript / Expo Updates", applicable_to: ["React Native"] }
applied_in: []
aliases: [over-the-air, hot update, CodePush, EAS Update, Expo Updates]
---

# RN OTA Updates

> JS 번들만 변경하면 store review 없이 즉시 사용자에게 배포. **Expo Updates** (CodePush 종료 후 표준) + 채널 + rollback. 단 native code 변경은 OTA 불가.

## 📖 핵심 개념
- OTA: JS bundle + assets만 교체. native 코드, infoplist, AndroidManifest 변경은 store 빌드.
- 채널: production / staging / canary.
- Rollback: 새 버전 문제 시 이전 만료 / 강제.

## 💻 코드 패턴

### Expo Updates 셋업
```bash
npm install expo-updates
npx expo install expo-updates
```

```json
// app.json
{
  "expo": {
    "runtimeVersion": "1.0.0",
    "updates": {
      "url": "https://u.expo.dev/<project-id>",
      "fallbackToCacheTimeout": 0,
      "checkAutomatically": "ON_LOAD"
    }
  }
}
```

### EAS Update publish
```bash
eas update --branch production --message "v1.0.1: bug fix"
```

### 클라이언트 — manual check
```ts
import * as Updates from 'expo-updates';

async function checkForUpdate() {
  try {
    const update = await Updates.checkForUpdateAsync();
    if (update.isAvailable) {
      await Updates.fetchUpdateAsync();
      // 사용자에게 안내 후 reload
      await Updates.reloadAsync();
    }
  } catch (e) { /* ignore */ }
}
```

### Runtime version 호환성
- runtimeVersion 같으면 OTA OK.
- native 변경 시 runtimeVersion bump → 새 store 빌드 필수, 옛 OTA 받지 않음.

### 채널 / 환경 분리
```bash
eas update --branch staging
# staging 빌드만 staging 채널 받음
```

```ts
const channel = Updates.channel; // 'production' / 'staging'
```

## 🤔 의사결정 기준
| 변경 | OTA |
|---|---|
| JS 비즈니스 로직 / UI | ✅ |
| 새 npm package (JS only) | ✅ |
| Native module 추가 | ❌ store 필요 |
| Asset (이미지) | ✅ |
| app icon / splash | ❌ |
| Push 인증서 / 권한 | ❌ |
| 큰 변경 (UX 전면 개편) | OTA 가능하지만 staged rollout 권장 |

## ❌ 안티패턴
- **runtimeVersion bump 안 하고 native 변경**: 옛 binary 가 새 JS 받음 → crash.
- **production 채널 직접 publish**: 검증 없음. staging → production 단계.
- **rollback 절차 없음**: 사고 시 모두 영향.
- **거대 update (수 MB)**: 사용자 모바일 데이터 부담. 변경 부분만.
- **store 빌드와 OTA 버전 mismatch 모니터링 X**: 어떤 사용자 어떤 버전 모름.
- **OTA 로 보안 패치만 의존**: 사용자가 OTA 받기 전 노출. 진짜 보안 = store 빌드.

## 🤖 LLM 활용 힌트
- "JS only 변경 = OTA, native 변경 = runtimeVersion bump + store" 명시.
- 채널 분리 (production / staging).

## 🔗 관련 문서
- [[DevOps_Deployment_Strategies]]
- [[Feature_Flags_in_Practice]]
