Docs/fix appdelegate objc bridge

[qq382724935]

User description

变更概述

类型

• feat 新功能(会触发 minor 发版)
• fix Bug 修复(会触发 patch 发版)
• refactor / chore / docs / test / ci(不发版)
• 包含 BREAKING CHANGE(会触发 major 发版,在 commit body 写 BREAKING CHANGE: ...)

验证

• yarn lint
• yarn typecheck
• yarn test
• (若改了 native module)在 example/ 跑过微信/钉钉分享、PIPL Common.init() 流程
• (若改了 ShareSheet UI)在亮 + 暗主题下都看了
• (若改了原生依赖)yarn turbo run build:android / build:ios 通过

影响范围 / 注意点

---

PR Type

Enhancement, Documentation

---

Description

• 将友盟初始化从 Info.plist/AndroidManifest 配置改为 JS 传 config + preInit/init 两步

• 自动合并 Android 权限/Proguard 规则，减少宿主集成配置项

• 自动接管 onActivityResult 回调，简化宿主 MainActivity

• 更新 README 文档，修正 Swift 调用 ObjC 示例

---

Diagram Walkthrough

flowchart LR
  JS["JS: Common.preInit(config)"] --> Native["Native: 缓存 config + 注册平台"]
  JS2["JS: Common.init()"] --> Native2["Native: UMConfigure.init 开始上报"]
  Native --> Native2

Loading

File Walkthrough

	Relevant files
Enhancement	11 files App.tsx 添加 preInit 示例按钮                                                                                    +19/-1    NativeUmengCommon.ts 添加 preInit 接口定义                                                                                    +28/-0    common.ts 实现 preInit 函数                                                                                        +35/-2    index.ts 导出 UmengInitConfig 类型                                                                        +1/-0      types.ts 定义 UmengInitConfig 接口                                                                        +19/-0    UmengAnalyticsModule.kt 移除 Module 构造期 preInit                                                                        +4/-3      UmengBootstrap.kt 改为两步初始化 + JS 传配置                                                                                  +66/-55  UmengCommonModule.kt 实现 preInit 桥接方法                                                                                    +21/-5    UmengShareModule.kt 自动接管 onActivityResult                                                                        +30/-2    UmengBootstrap.mm 改为两步初始化 + JS 传配置                                                                                  +47/-22  UmengCommon.mm 实现 preInit 桥接方法                                                                                    +16/-1
Tests	1 files common.test.ts 添加 preInit 单元测试                                                                                    +55/-15
Documentation	2 files README.md 更新文档：JS 传配置 + 简化集成步骤                                                                          +40/-79  UmengBootstrap.h 更新头文件注释和接口                                                                                              +28/-12
Configuration changes	2 files consumer-rules.pro 添加自动合并的 Proguard 规则                                                                            +38/-0    AndroidManifest.xml 声明权限和包可见性                                                                                                +13/-0

---

[github-actions]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 3 🔵🔵🔵⚪⚪

🧪 PR contains tests

🔒 No security concerns identified

⚡ Recommended focus areas for review 错误码未使用枚举 UmengInitConfig 接口中 channel 字段注释写 "默认 iOS = 'App Store',Android = 'default'"，但 UmengBootstrap.kt 第 47 行 Android 侧默认值硬编码为 "default"，而 UmengBootstrap.mm 第 52 行 iOS 侧默认值硬编码为 "App Store"。这符合预期，但 preInit 方法在 src/common.ts 第 17 行 reject 时使用了 UmengError 并传入了 'E_INVALID_OPTIONS'，而 src/types.ts 中已有的 ErrorCode 枚举（如 E_PLATFORM_NOT_INSTALLED、E_USER_CANCEL、E_SHARE_FAILED）并未包含 E_INVALID_OPTIONS。根据仓库规则，新错误码必须同时改类型 + README 错误码表。当前 E_INVALID_OPTIONS 未在 ErrorCode 枚举中定义，也未在 README 错误码表中列出，会导致使用者无法通过类型系统感知该错误码。 export type ShareSheetPayload = | { type: 'text'; text: string } | { type: 'image'; image: string; thumb?: string } | { type: 'link'; title: string; url: string; description?: string; thumb?: string; }; /** 友盟初始化配置。`Common.init(config)` 接收。 * * PIPL 合规:user 同意《隐私协议》之后才调 `Common.init(config)`, * 在那之前 native 完全不持有 appkey,不会调任何友盟 API。 */ export interface UmengInitConfig { /** 友盟 appkey,必填 */ appkey: string; /** 渠道标识。默认 iOS = 'App Store',Android = 'default' */ channel?: string; /** 微信平台 appid;不传则不注册微信分享 */ wechatAppId?: string; /** 微信平台 appsecret;有 wechatAppId 才生效 */ wechatAppSecret?: string; /** 微信 Universal Link (1.8.6+ 强制);iOS 才用,有 wechatAppId 才生效 */ wechatUniversalLink?: string; /** 钉钉平台 appid;不传则不注册钉钉分享 */ dingtalkAppId?: string; } Activity 生命周期泄漏 UmengShareModule 在 init 中调用 reactContext.addActivityEventListener(this) 注册了 ActivityEventListener，但在 invalidate() 中调用 reactApplicationContext.removeActivityEventListener(this) 并 release() UMShareAPI。然而 invalidate() 在 React Native 的 TurboModule 生命周期中可能不会被调用（例如宿主 Activity 被销毁但 JS 引擎未重启时），导致 ActivityEventListener 泄漏，进而可能持有已销毁的 Activity 引用，引发内存泄漏或 ActivityNotFoundException。建议在 onHostDestroy 回调中同步清理。 init { // 自动接管宿主 Activity 的 onActivityResult 回调,转发给 UMShareAPI。 // 避免宿主 MainActivity 自己 override onActivityResult 手动转发。 reactContext.addActivityEventListener(this) } override fun invalidate() { super.invalidate() reactApplicationContext.removeActivityEventListener(this) currentActivity?.let { UMShareAPI.get(it).release() } } 线程安全问题 ensurePreInit:config:error: 和 ensureInit:error: 方法使用 NSLock 进行同步，但 _preInited 和 _inited 是实例变量，而 shared 方法返回单例。在 ensurePreInit 中，第 33-34 行先检查 _preInited 再加锁，这是正确的双重检查锁定模式。但第 56-57 行在加锁后直接赋值 _appkey 和 _channel，而 ensureInit 第 112 行读取这些变量时也在锁内，因此线程安全。然而，ensurePreInit 第 67-68 行在锁外检查 wxId 和 wxSecret 的 isKindOfClass，这些检查是只读的，不会导致问题。但第 69-70 行调用 setPlaform: 时仍在锁内，而 setPlaform: 内部可能调用其他线程的回调，存在潜在死锁风险。建议将 setPlaform: 调用移出锁范围。 if ([wxId isKindOfClass:[NSString class]] && wxId.length > 0 && [wxSecret isKindOfClass:[NSString class]] && wxSecret.length > 0) { // 友盟 SDK 拼写遵循原始错误: setPlaform 少一个 t [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession