安装

装齐 @unif/react-native-umeng 的同伴包并完成 Android/iOS 原生接线。分享面板的 UI 依赖 @unif/react-native-design,peerDeps 缺失会在解析或运行时失败 —— 本页以当前 package.json#peerDependencies 为准逐项列出。

环境要求

要求	版本
React Native	需要新架构；当前仓库开发基线为 0.86.3
React	仓库开发基线为 19.2.3
iOS	采用当前 React Native 和依赖所要求的最低系统版本
Android	minSdk 24;Gradle SDK build 与真机矩阵须在具备 Android SDK 的环境验证

仅支持新架构

本库是 TurboModule 桥,仓库开发基线为 React Native 0.86.3 New Architecture。旧架构(Bridge)不在目标范围；支持范围以本页依赖清单和包声明为准。

1. 安装依赖

package.json 当前声明 10 个 peers。RN 工程已经提供 react / react-native;其余 8 个必须显式安装:

yarn add @unif/react-native-umeng \
  '@callstack/liquid-glass@0.8.2' \
  '@unif/react-native-design@>=1.0.0' \
  'react-native-gesture-handler@>=3.0.0 <4.0.0' \
  'react-native-reanimated@^4.6.0' \
  'react-native-reanimated-carousel@>=5.0.0 <6.0.0' \
  'react-native-safe-area-context@>=5' \
  'react-native-svg@>=15' \
  'react-native-worklets@^0.12.1'

1.1 起使用 Design 0.35 与 Liquid Glass。从 1.0 升级时，移除旧 @sbaiahmed1/react-native-blur，安装上述依赖并重新执行 iOS Pods 安装；初始化、分享和统计公共 API 保持不变。

各包的作用与版本约束:

包	版本约束	作用
`@callstack/liquid-glass`	`>=0.8.2 <0.9.0`	Design Liquid Glass 原生材质
`@unif/react-native-icons`	`>=0.1.0`	独立命名图标组件
`@unif/react-native-design`	`>=1.0.0`	分享面板 UI 与 `GlassLayer` 材质
`react`	`>=19.2.3 <20.0.0`	RN 工程已有
`react-native`	`>=0.86.0`	RN 工程已有;本仓当前验证基线为 RN 0.86.3
`react-native-gesture-handler`	`>=3.0.0 <4.0.0`	design 手势底层与 ShareSheet Modal 内部 root
`react-native-reanimated`	`>=4.5.3 <4.7.0`	design 根入口运行时依赖;当前验证 4.6.x
`react-native-reanimated-carousel`	`>=5.0.0 <6.0.0`	design 根入口静态依赖
`react-native-safe-area-context`	`>=5`	design 根入口静态依赖
`react-native-svg`	`>=15`	面板平台图标与 design 图标
`react-native-worklets`	`>=0.11.3 <0.13.0`	Reanimated / design 运行时与 Babel 转换;当前验证 0.12.x

范围以安装版本的 package.json#peerDependencies 为准。

RNGH 3 + Carousel 5 的窄 peer 例外

当前依赖组合使用 RNGH 3 与 Carousel 5。Carousel 5 发布 metadata 的 RNGH peer 为 >=2.9 <3,与当前组合没有交集,但仓库已通过 scoped override、窄 allowlist 与漂移检查管理该已验证例外。不要为了清掉 warning 降级 RNGH,也不要使用全局 override、--force 或 --legacy-peer-deps;Carousel 或 RNGH major 变化时再重新评估。

Worklets Babel plugin(React Native App 必配)

在宿主 React Native App 的 babel.config.js 中把 Worklets plugin 放在 plugins 最后:

module.exports = {
  presets: ['module:@react-native/babel-preset'],
  plugins: [
    // 其它 plugin ...
    'react-native-worklets/plugin',
  ],
};

Docusaurus website 不需要为此新增 Babel 配置;这一要求只针对 Metro 消费者。

@unif/react-native-design 是分享面板的 UI 壳,不能省

useShareSheet() 返回的宿主面板使用 design 的 Cell / Button / GlassLayer 渲染，因此 Host 应位于 design 的 ThemeProvider 内。默认的 RN Modal 呈现已在 Modal 内容内部创建 GestureHandlerRootView；App 外层的同名 root 不能跨越 Modal 的独立 native root，也不能替代这一内部边界。挂载约定见快速上手。

只用统计、不用分享?

即使如此,@unif/react-native-design 等仍是 peerDependencies(非可选),包管理器会要求安装齐全。统计接口本身不依赖 design,但建议按上表装齐以避免 peer 告警。

2. iOS:pod install

安装或升级依赖后执行 pod install:

cd ios && bundle exec pod install

iOS 已验证与待验边界

仓库已验证 ReactNativeUmeng module、三个 Codegen modulesProvider、simulator build 与 XCTest。消费者仍需在自己的 Pod 图和宿主 target 重新执行 build；真实微信 / 钉钉 App、URL Scheme 与 Universal Link/AASA 只能在带真实凭据的真机验收。

模拟器只能验编译与 JS/native 逻辑

模拟器没有真微信 / 钉钉,不能完成真实分享回跳;最终链路必须真机验收。模拟器 build/XCTest 仍是独立门禁,编译失败不能笼统归为“模拟器预期限制”。

3. Android

Android 端依赖随 Gradle 自动同步,无需手动 link。使用项目已有的 Yarn Android script 编译，例如 yarn android。

微信 / 钉钉的分享回调 Activity 需要落在宿主包名下,见下一步原生配置。

4. 原生回调配置(必做)

分享后能否跳回 App,完全取决于原生侧的 URL Scheme / 回调 Activity 注册。配置方法见对应平台文档,按对应平台文档逐项配置:

iOS 原生配置 —— Info.plist 的 LSApplicationQueriesSchemes / CFBundleURLTypes,AppDelegate 转发 handleOpen(_:options:),微信 Universal Link。
Android 原生配置 —— WXEntryActivity / DDShareActivity 必须在宿主包名下并直接继承 SDK 回调基类;Activity 不硬编码凭据。

友盟 appkey / appsecret / Universal Link 等都通过授权后的 initializeUmeng(config) 传,不写在 Info.plist / Gradle。

下一步

快速上手 —— 完成初始化 + 第一次分享
指南 → 初始化与用户同意 —— 真实同意后单次初始化
API 参考 → 初始化 —— initializeUmeng / isUmengInitialized 完整参数

官方参考

Reanimated 4 Getting started —— New Architecture、独立安装 Worklets、Community CLI plugin 与“必须最后”
Migrating from Reanimated 3.x to 4.x —— Reanimated 4 的 Worklets 依赖与 Babel plugin 迁移说明

环境要求​

1. 安装依赖​

Worklets Babel plugin(React Native App 必配)​

2. iOS:pod install​

3. Android​

4. 原生回调配置(必做)​

下一步​

官方参考​