[G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00
parent f0befc887a
commit 93ec7e9056
363 changed files with 68333 additions and 64 deletions
@@ -0,0 +1,112 @@
+---
+id: rn-hermes-optimization
+title: RN Hermes — Startup / Memory 최적화
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [react-native, hermes, performance, vibe-coding]
+tech_stack: { language: "Hermes / RN 0.70+", applicable_to: ["React Native"] }
+applied_in: []
+aliases: [bytecode, AOT, source map, sampling profiler]
+---
+
+# RN Hermes 최적화
+
+> Hermes = RN 의 JS engine (JSC 대체). **Bytecode precompile + small heap = 빠른 startup**. 0.70+ default. profiler 사용 + 큰 deps 분할 + Hermes-friendly JS 작성이 핵심.
+
+## 📖 핵심 개념
+- Bytecode (.hbc): build 시 미리 컴파일. 사용자 디바이스 parse 시간 0.
+- Sampling profiler: 무거운 함수 식별.
+- Source map: minified stack → 원본.
+
+## 💻 코드 패턴
+
+### Hermes 활성화 (보통 디폴트)
+```js
+// android/app/build.gradle (디폴트 enabled)
+project.ext.react = [ enableHermes: true ]
+// iOS Podfile
+use_react_native!(:path => config[:reactNativePath], :hermes_enabled => true)
+```
+
+### Sampling profiler
+```ts
+import { Hermes } from 'react-native-hermes';
+// dev menu → "Hermes: Enable Sampling Profiler" → 작업 → "Disable" → .cpuprofile 다운로드
+// Chrome devtools 또는 React Native debugger 에서 분석
+```
+
+### Source map upload (Sentry)
+```bash
+sentry-cli react-native gradle \
+  --build-script android/app/build.gradle \
+  --release "myapp@1.0.0+1"
+```
+
+### Build-time bytecode precompile
+RN 0.70+ Hermes 가 release build 에서 자동 .hbc 생성.
+
+### 무거운 lib 회피
+```ts
+// ❌ moment.js (수백 KB, locale)
+import moment from 'moment';
+
+// ✅ date-fns (tree-shake 가능, 작은 import)
+import { format } from 'date-fns';
+
+// ✅ 또는 native Intl
+new Intl.DateTimeFormat('ko-KR').format(date);
+```
+
+### Splash screen 동안 critical asset 만 로드
+```ts
+import * as SplashScreen from 'expo-splash-screen';
+
+SplashScreen.preventAutoHideAsync();
+
+useEffect(() => {
+  (async () => {
+    await Promise.all([loadFonts(), loadAuthState()]);
+    await SplashScreen.hideAsync();
+  })();
+}, []);
+```
+
+### InteractionManager — 무거운 작업 지연
+```ts
+useEffect(() => {
+  const handle = InteractionManager.runAfterInteractions(() => {
+    // 애니메이션 끝난 후 실행
+    heavyWork();
+  });
+  return () => handle.cancel();
+}, []);
+```
+
+## 🤔 의사결정 기준
+| 측정 | 도구 |
+|---|---|
+| Startup time | Flipper Hermes profiler |
+| JS frame drop | Flipper Performance Monitor |
+| Memory leak | Xcode Instruments (iOS), Profiler (Android Studio) |
+| Bundle size | source-map-explorer (release bundle) |
+| Native UI thread | Systrace / Perfetto |
+
+## ❌ 안티패턴
+- **moment.js / lodash 통째 import**: 번들 폭증. tree-shake / 대체.
+- **JIT 가정 (eval, new Function)**: Hermes 는 JIT 없음 — 런타임 컴파일 X. 디자인 회피.
+- **production 에 console.log 남김**: bridge 부하. babel plugin 으로 제거.
+- **번들 분석 없이 추측**: source-map-explorer.
+- **Hermes off + 옛 JSC 유지**: startup 느림. 마이그레이션 가능한 한.
+- **`require` 동적 호출 무절제**: dead code elim 깨짐.
+
+## 🤖 LLM 활용 힌트
+- "Hermes 가정. moment 대신 date-fns 또는 Intl. console.log production 제거."
+- profiler 측정 후 최적화.
+
+## 🔗 관련 문서
+- [[React_Native_Bridge_Performance]]
+- [[DevOps_Build_Performance]]