React Native项目执行pod install时卡在安装hermes-engine (0.71.2)

问题详情 #

创建新React Native项目后，依次执行npm install、bundle install，进入iOS目录运行pod install时，进程卡在以下依赖安装环节：

Installing React-perflogger (0.71.2)
Installing React-runtimeexecutor (0.71.2)
Installing ReactCommon (0.71.2)
Installing SocketRocket (0.6.0)
Installing TOCropViewController (2.6.1)
Installing Yoga (1.14.0)
Installing YogaKit (1.18.1)
Installing boost (1.76.0)
Installing fmt (6.2.1)
Installing glog (0.3.5)
Installing hermes-engine (0.71.2)

项目package.json配置 #

{
  "name": "ApproverApp",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "android": "react-native run-android",
    "ios": "react-native run-ios",
    "lint": "eslint .",
    "start": "react-native start",
    "test": "jest"
  },
  "dependencies": {
    "@react-native-async-storage/async-storage": "^1.16.1",
    "@react-navigation/bottom-tabs": "^6.2.0",
    "@react-navigation/drawer": "^6.5.5",
    "@react-navigation/native": "^6.0.8",
    "@react-navigation/native-stack": "^6.5.0",
    "@reduxjs/toolkit": "^1.8.0",
    "axios": "^0.26.1",
    "css-to-react-native": "^3.0.0",
    "lodash": "^4.17.21",
    "mime": "^3.0.0",
    "moment": "^2.29.1",
    "native-base": "^3.3.7",
    "react": "18.2.0",
    "react-native": "0.71.2",
    "react-native-calendars": "^1.1279.0",
    "react-native-date-picker": "^4.2.0",
    "react-native-dialog": "^9.2.1",
    "react-native-document-picker": "^8.0.0",
    "react-native-gesture-handler": "^2.3.0",
    "react-native-image-crop-picker": "^0.37.3",
    "react-native-modal": "^13.0.1",
    "react-native-permissions": "^3.3.1",
    "react-native-popup-menu": "^0.15.12",
    "react-native-reanimated": "^2.4.1",
    "react-native-responsive-fontsize": "^0.5.1",
    "react-native-responsive-screen": "^1.4.2",
    "react-native-safe-area-context": "^4.1.2",
    "react-native-screens": "^3.13.1",
    "react-native-size-matters": "^0.4.0",
    "react-native-svg": "^12.3.0",
    "react-native-svg-transformer": "^1.0.0",
    "react-native-swipe-list-view": "^3.2.9",
    "react-native-vector-icons": "^9.1.0",
    "react-redux": "^7.2.6",
    "redux": "^4.1.2",
    "redux-persist": "^6.0.0",
    "redux-thunk": "^2.4.1"
  },
  "devDependencies": {
    "@babel/core": "^7.20.0",
    "@babel/preset-env": "^7.20.0",
    "@babel/runtime": "^7.20.0",
    "@react-native-community/eslint-config": "^3.2.0",
    "@tsconfig/react-native": "^2.0.2",
    "@types/jest": "^29.2.1",
    "@types/react": "^18.0.24",
    "@types/react-test-renderer": "^18.0.0",
    "babel-jest": "^29.2.1",
    "eslint": "^8.19.0",
    "jest": "^29.2.1",
    "metro-react-native-babel-preset": "0.73.7",
    "prettier": "^2.4.1",
    "react-test-renderer": "18.2.0",
    "typescript": "4.8.4"
  },
  "jest": {
    "preset": "react-native"
  }
}

可行解决步骤 #

• 清理缓存后重试：
  1. 终止当前pod install进程（快捷键Ctrl+C）
  2. 执行pod deintegrate移除现有Pods配置
  3. 删除iOS目录下的Podfile.lock文件和Pods文件夹
  4. 清除CocoaPods全局缓存：pod cache clean --all
  5. 重新执行pod install
• 排查网络问题：
  这些依赖包多从GitHub或官方源下载，网络波动会导致下载卡顿。切换到稳定网络环境，或根据情况配置代理加速下载。
• 定位具体卡顿点：
  执行pod install --verbose查看实时日志，确定是某个大体积包（如hermes-engine、boost）下载慢，还是存在依赖冲突。若是大体积包，可手动下载对应版本文件到本地，修改Podfile指定本地路径跳过在线下载。

内容的提问来源于stack exchange，提问作者Engr.Aftab Ufaq