隐私合规（PIPL）

本库的公共契约采用 preInit → init 两段式,用于满足 PIPL(个人信息保护法)对「用户同意前不采集」的要求。本页讲清两段职责与时序。

验证边界

Android 与 iOS 都已实现本页边界。iOS simulator/XCTest/native contract 已验证授权前模块构造、Share/Analytics gate 与 bootstrap 顺序；Android CI 已通过 native contract、JVM 状态机测试、启用 minify 的 release 构建与 merged manifest 核对。真实 vendor 网络、平台回跳、Android 真机 R8 运行与数据后台仍需对应真机/测试账号验证。

---

两段式设计

阶段	调用时机	行为
Common.preInit(config)	App 启动后立刻,可在用户同意之前	仅 JS 校验、标准化并保存 config 快照,零 native 调用
Common.init()	用户点「同意《隐私协议》」之后	首次把快照交给 native，并在对应平台执行全部 vendor bootstrap

import { Common } from '@unif/react-native-umeng';

// 1) App 启动:preInit —— 不上报,所有 config 都在这里给
await Common.preInit({
  appkey: 'YOUR_UMENG_APPKEY',
  wechatAppId: 'wxXXXX',
  wechatAppSecret: 'XXXX',
  wechatUniversalLink: 'https://your.host/', // 微信 1.8.6+(iOS)要求
  dingtalkAppId: 'dingoaXXXX',
});

// 2) 用户同意《隐私协议》之后:开始采集
await Common.init();   // ⚠️ 无参 —— config 已给 preInit

相同 config 的 preInit 与成功后的 init 都可安全重复；并发 init 复用同一个 Promise。native 初始化开始后更换 config 会 reject E_INVALID_OPTIONS。

init 必须在用户同意之后

Common.init() 必须在用户明确同意《隐私协议》之后才能调用。隐私弹窗弹出前、或用户拒绝时,不可调 init()。违反将导致合规风险。

---

推荐接入时序

App 启动
  └─▶ Common.preInit(config)   // 立刻调,仅存 JS 快照,零 native 调用

用户进入隐私协议弹窗
  └─▶ 用户点「同意」
        └─▶ Common.init()      // 仅此刻调,开始采集

---

iOS / Android 差异

• Android —— JS Common.preInit() 不触达 native。用户同意后调 Common.init(),native 才在一次状态机事务中执行 UMConfigure.preInit、平台注册、FileProvider 与 UMConfigure.init,成功后动态启用已配置平台的 callback Activity。
• iOS —— JS Common.preInit() 同样不触达 native;用户同意后一次 initialize(config) 才在主线程按 Universal Link → 微信注册 → 钉钉注册 → UMConfigure.initWithAppkey 执行。

两个平台的 Share native 入口在 init 前 reject E_NOT_INITIALIZED;Analytics 的三个同步 void 入口在 init 前 no-op。回调 handler 在未初始化时不会自动初始化 vendor，React Native Linking 仍应独立收到事件。

---

易错点(Incorrect / Correct)

1. init 带参

配置只给 preInit,init() 无参:

// ❌ Incorrect:init 不接收 config
await Common.init({ appkey: '...' });

// ✅ Correct:config 给 preInit,init 无参
await Common.preInit({ appkey: '...', /* ... */ });
await Common.init();

2. 没先 preInit 就 init(或 init 早于同意)

init 前必须先 preInit,否则会 reject(E_NOT_INITIALIZED):

// ❌ Incorrect:没 preInit 直接 init —— reject;或在用户同意前就 init —— 违规
await Common.init();

// ✅ Correct:启动 preInit;用户同意后才 init
await Common.preInit({ appkey: '...' });  // App 启动
// …… 展示隐私弹窗,用户点「同意」……
await Common.init();                       // 同意后

---

相关

• 快速上手 —— preInit / init 在启动流程中的位置
• Common API —— preInit / init / isInited 完整参数