按 React Native 环境接入

本页说明 React Native 工程的依赖和原生环境配置。

添加依赖

在 React Native CLI 项目中安装

在项目根目录安装 OpenIM React Native SDK：

npm install @openim/rn-client-sdk
cd ios && pod install && cd ..

也可以使用项目现有的包管理器执行等价命令。安装后分别构建 Android 和 iOS 工程，确认原生模块已正确链接。

在 Expo 项目中安装

OpenIM React Native SDK 包含 Android 和 iOS 原生模块，Expo Go 未包含这些模块，因此不能直接在 Expo Go 中使用。Expo 项目应先安装 OpenIM React Native SDK，再使用 expo prebuild --clean 根据 Expo 配置生成或更新 android 和 ios 原生工程，最后在该原生工程中构建自定义开发客户端：

npm install @openim/rn-client-sdk
npx expo prebuild --clean
npx expo run:android
npx expo run:ios

修改 Expo 配置或新增需要原生支持的依赖后，应重新执行 expo prebuild --clean，再重新构建开发客户端。可以安装 expo-dev-client，获得适合 Expo 项目的开发客户端体验，但运行时仍使用自定义开发客户端，不要使用 Expo Go。

验证原生环境

完成安装和原生工程配置后，在 Android 和 iOS 工程中构建应用，确认 SDK 原生模块可以完成编译和加载。

下一步

• 认证与管理登录会话