## Why

SDK 现基于 RN 0.85.0 纯新架构开发，`peerDependencies` 为 `react-native >=0.76.0`。客户（鲁班到家）为 **RN 0.72.5 / Paper**，当前**无法集成**。

**上线约束（2026-06-17）**：**Android 与 iOS 必须同时完成双架构**，支持 **0.72.x ↔ 0.85.x**，方可发版。未完成兼容方案不可上线。

参照蓝本：`AppLovin-MAX-React-Native`（0.76.2 双架构已跑通）。机制经源码实证。

## What Changes

### 上线门禁（Release Gate）

1. 双端（Android + iOS）0.72.5 旧架构 + 0.85 新架构联调通过
2. `peerDependencies` 对齐 MAX：`react` / `react-native` 均为 `"*"`（实际支持 0.72.x↔0.85 由双架构实现保证）
3. `yarn verify:arch-parity` 92 方法对账通过
4. 验收/实施规范与「仅 New Arch」表述同步修订

### Android

- **build.gradle**：条件 codegen + `sourceSets` + `IS_NEW_ARCHITECTURE_ENABLED`
- **双源码集**：`newarch` Spec 壳 / `oldarch` `@ReactMethod`+`@ReactProp` 壳 + `main/` Impl
- **Package**：**`TurboReactPackage`**（非 `BaseReactPackage`，0.72 必需）+ 动态 `isTurboModule`
- **Bridge**：92 方法 oldarch 壳；**ViewManager**：Banner/Native oldarch 壳
- **EventEmitter**：零改动

### iOS（与 Android 同版发布，非「仅调研」）

- Bridge：`#ifdef` + 92×`RCT_EXPORT_METHOD` + `RCT_EXPORT_MODULE`
- 视图：参考库范式 — **新增 RCTViewManager** + 视图 `#ifdef` 基类 + **保留 Fabric**
- podspec：条件 `install_modules_dependencies` + `RCT_NEW_ARCH_ENABLED` 分支
- 事件：默认保留 `ATReactNativeEventEmitter` 双通路

### JS / 元数据

- JS `src/` 零改动（RN fallback；Phase 0 验证 0.72.5）
- 交付时 peerDep、`verify:arch-parity`、客户 maven 集成说明

## Capabilities

- **old-arch-compat**：0.72.x Paper 与 0.76+~0.85 New Arch API 等价；构建自动分流；JS 零改动；**双端同时交付**。

## Impact

- 改 `android/`、`ios/`、`ATReactNativeBridge.podspec`；交付时 `package.json` peerDep；`src/` 不动
- 风险：Phase 0 三点未验；`ReactModuleInfo` 0.72/0.85 签名差异 → Package 分目录；客户 maven 仓库配置
- iOS 自渲染与 Android 完全对齐为**独立后续**，不进上线门禁
