原生iOS集成react-native (react-native 0.65+)

news2025/3/12 16:50:41

由于官方文档比较老，很多配置都不能用，集成的时候遇到很多坑，简单的整理一下
时间节点:2021年9月1日
本文主要提供一些配置信息以及错误信息解决方案，具体步骤可以参照官方文档
原版文档：https://reactnative.dev/docs/integration-with-existing-apps
中文文档：https://reactnative.cn/docs/integration-with-existing-apps

PS：官方文档黄色提示部分作用非常大，一定要仔细看，很多报错看了黄色提示都能解决

1. 配置项目目录结构

首先创建一个空目录用于存放 React Native 项目，然后在其中创建一个/ios子目录，把你现有的 iOS 项目拷贝到/ios子目录中。

2. 安装 JavaScript 依赖包

在项目根目录下创建一个名为package.json的空文本文件，然后填入以下内容：

{
  "name": "MyReactNativeApp",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "yarn react-native start"
  }
}

接下来我们使用 yarn 或 npm（两者都是 node 的包管理器）来安装 React 和 React Native 模块。请打开一个终端/命令提示行，进入到项目目录中（即包含有 package.json 文件的目录），然后运行下列命令来安装：

$ yarn add react-native

这样默认会安装最新版本的 React Native，同时会打印出类似下面的警告信息（你可能需要滚动屏幕才能注意到）：

warning " > react-native@0.65.1" has unmet peer dependency "react@17.0.2".
这是正常现象，意味着我们还需要安装指定版本的 React：

$ yarn add react@17.0.2

注意必须严格匹配警告信息中所列出的版本，高了或者低了都不可以。

3. 安装 CocoaPods

安装方式参照官方文档，不做赘述
此处提供下Podfile的内容，当时因为Podfile的问题遇到很多坑

require_relative '../node_modules/react-native/scripts/react_native_pods'
require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'

platform :ios, '11.0'
//use_frameworks!是否使用依照原生项目
use_frameworks!
target 'RNTest' do
//这里放置原生使用的pods
pod 'SVProgressHUD'
pod 'Masonry'

//这里是react-native使用的pods（react-native 0.64+）
  config = use_native_modules!

  use_react_native!(
    :path => config[:reactNativePath],
    # to enable hermes on iOS, change `false` to `true` and then install pods
    :hermes_enabled => false
  )

  target 'RNTestTests' do
    inherit! :complete
    # Pods for testing
  end

  # Enables Flipper.
  #
  # Note that if you have use_frameworks! enabled, Flipper will not work and
  # you should disable the next line.
#   use_flipper!()

  post_install do |installer|
    react_native_post_install(installer)
  end
  //如果使用use_frameworks!需要添加这一部分，如果不使用则不需要（非常重要）
  pre_install do |installer|
    Pod::Installer::Xcode::TargetValidator.send(:define_method,
     :verify_no_static_framework_transitive_dependencies) {}
  end
end

安装完成后到ios文件夹下

$ pod install

如果出现以下错误

The following build commands failed:
    PhaseScriptExecution [CP-User]\ Generate\ Specs /Users/goodwe/Library/Developer/Xcode/DerivedData/PVMaster-fmlxwaebkuhxpwfecwezdewdswsi/Build/Intermediates.noindex/Pods.build/Debug-iphonesimulator/FBReactNativeSpec.build/Script-85194FC3D0122935CF3BE54D1926EC14.sh
(1 failure)

info Run CLI with --verbose flag for more details.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

并且用Xcode运行项目会出现以下错误：

Error: Could not determine react-native-codegen location. Try running 'yarn install' or 'npm install' in your project root.
Command /bin/sh failed with exit code 1

解决方法：
在项目根目录 yarn add react-native-codegen

接下来的代码集成参照官方文档，不做赘述