docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거

Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
2026-07-05 00:33:48 +09:00
parent 1cfd3bbb56
commit 9148c358d0
6455 changed files with 1 additions and 86875 deletions
@@ -0,0 +1,140 @@
+---
+id: rn-native-module-bridging
+title: RN Native Module — TurboModule (New Arch)
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [react-native, native-module, turbomodule, vibe-coding]
+tech_stack: { language: "TS / Swift / Kotlin", applicable_to: ["React Native"] }
+applied_in: []
+aliases: [TurboModule, Codegen, JSI, native bridge]
+---
+
+# RN Native Module (TurboModule)
+
+> JS 가 native API 호출. **New Architecture 의 TurboModule + Codegen** 이 표준. 옛 NativeModule 보다 동기 호출 + 타입 안전. 단 native 코드 작성 필요.
+
+## 📖 핵심 개념
+- TS spec 정의 → Codegen 이 native interface 생성.
+- iOS Swift / Android Kotlin 구현체 등록.
+- JS 가 직접 호출 (JSI).
+
+## 💻 코드 패턴
+
+### 1. TS spec
+```ts
+// specs/NativeBattery.ts
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  getBatteryLevel(): number;                       // sync
+  getInfo(): Promise<{ level: number; charging: boolean }>;
+  setBrightness(value: number): void;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('NativeBattery');
+```
+
+### 2. iOS — Swift
+```swift
+import Foundation
+
+@objc(NativeBattery)
+class NativeBattery: NSObject {
+
+  @objc static func requiresMainQueueSetup() -> Bool { false }
+
+  @objc func getBatteryLevel() -> NSNumber {
+    UIDevice.current.isBatteryMonitoringEnabled = true
+    return NSNumber(value: UIDevice.current.batteryLevel)
+  }
+
+  @objc(getInfoWithResolver:rejecter:)
+  func getInfo(resolve: @escaping RCTPromiseResolveBlock,
+               reject: @escaping RCTPromiseRejectBlock) {
+    UIDevice.current.isBatteryMonitoringEnabled = true
+    resolve([
+      "level": UIDevice.current.batteryLevel,
+      "charging": UIDevice.current.batteryState == .charging,
+    ])
+  }
+}
+```
+
+### 3. Android — Kotlin
+```kotlin
+class NativeBatteryModule(reactContext: ReactApplicationContext) :
+    NativeBatterySpec(reactContext) {  // codegen 이 만든 abstract class
+
+    override fun getName() = "NativeBattery"
+
+    override fun getBatteryLevel(): Double {
+        val bm = reactApplicationContext.getSystemService(Context.BATTERY_SERVICE) as BatteryManager
+        return bm.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY) / 100.0
+    }
+
+    override fun getInfo(promise: Promise) {
+        val map = Arguments.createMap().apply {
+            putDouble("level", getBatteryLevel())
+            putBoolean("charging", isCharging())
+        }
+        promise.resolve(map)
+    }
+}
+```
+
+### 4. JS 사용
+```ts
+import NativeBattery from './specs/NativeBattery';
+
+const level = NativeBattery.getBatteryLevel(); // 동기!
+const info = await NativeBattery.getInfo();
+```
+
+### Event emitter (native → JS)
+```swift
+@objc(BatteryEvents)
+class BatteryEvents: RCTEventEmitter {
+  override func supportedEvents() -> [String] { ["levelChanged"] }
+  func notifyLevel(_ level: Float) {
+    sendEvent(withName: "levelChanged", body: ["level": level])
+  }
+}
+```
+
+```ts
+import { NativeEventEmitter, NativeModules } from 'react-native';
+
+const emitter = new NativeEventEmitter(NativeModules.BatteryEvents);
+const sub = emitter.addListener('levelChanged', e => console.log(e.level));
+return () => sub.remove();
+```
+
+## 🤔 의사결정 기준
+| 필요 | 도구 |
+|---|---|
+| 기존 native API 노출 | TurboModule |
+| 무거운 native 처리 (이미지, ML) | TurboModule + JSI direct |
+| 기존 RN 라이브러리로 충분 | 커뮤니티 라이브러리 우선 |
+| Expo 환경 | config plugin + Expo Modules |
+| 한 platform 만 | Platform-specific module |
+
+## ❌ 안티패턴
+- **bridge spam (per-frame native call)**: 큰 부하. batched API 권장.
+- **순환 참조 (RN ↔ Native)**: leak.
+- **callback 만 + Promise X**: 모던 코드는 Promise.
+- **Codegen 안 쓰고 NativeModuleSpec 수동 작성**: type safety 잃음.
+- **iOS / Android API 비대칭**: cross-platform JS 깨짐. spec 일관.
+- **에러를 generic Error 로**: 디버깅 어려움. 명시적 code + message.
+
+## 🤖 LLM 활용 힌트
+- New Architecture 가정. Codegen + TurboModule.
+- iOS Swift / Android Kotlin 양쪽 같이 작성.
+
+## 🔗 관련 문서
+- [[React_Native_Bridge_Performance]]
+- [[iOS_Swift_Concurrency_async_await]]