解决 React Native iOS 与 OpenHarmony 开发环境冲突问题

在多平台应用开发中，特别是同时进行 React Native iOS 和 OpenHarmony 开发时，环境变量和工具链的隔离尤为重要。本文分享一个真实案例，介绍如何解决 PATH 环境变量污染导致的 React Native iOS 编译失败问题。

问题现象

在配置了 OpenHarmony 开发环境后，使用 Xcode 构建 React Native iOS 项目时，glog 库编译失败，报错信息如下：

Unknown type name '_START_GOOGLE_NAMESPACE_'
Use of undeclared identifier 'GOOGLE_NAMESPACE'
Unknown type name 'int32'; did you mean 'google::int32'?
Need to implement mutex.h for your architecture, or #define NO_THREADS

根本原因

通过分析发现，问题出在 .zshrc 配置中：

export PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains:$PATH"
export HDC_SERVER_PORT=7035
export RNOH_C_API_ARCH=1

这些配置会导致：

1. OpenHarmony 的工具链（clang、ar、ranlib 等）被优先使用，覆盖了系统/Xcode 工具
2. pod install 和 Xcode 构建过程使用了错误的编译器
3. glog 编译时，预处理器宏（如 _START_GOOGLE_NAMESPACE_）未被正确展开

解决方案：环境隔离

为解决此问题，我实现了一个简洁优雅的环境切换方案：

# ------ OpenHarmony 环境控制函数 ------
ohos_on() {
  local OH_TC="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains"
  if [[ -d "$OH_TC" ]]; then
    path+="$OH_TC"
  fi
  export HDC_SERVER_PORT=7035
  launchctl setenv HDC_SERVER_PORT "$HDC_SERVER_PORT"
  export RNOH_C_API_ARCH=1
  hash -r
  echo "[ohos_on] OpenHarmony 环境已启用"
}

ohos_off() {
  local OH_TC="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains"
  path=(${path:#$OH_TC})
  unset RNOH_C_API_ARCH
  launchctl unsetenv HDC_SERVER_PORT 2>/dev/null || true
  unset HDC_SERVER_PORT
  hash -r
  echo "[ohos_off] OpenHarmony 环境已禁用"
}

# Xcode 干净环境启动别名
alias xcode-clean='env -u RNOH_C_API_ARCH -u HDC_SERVER_PORT PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin" open -a Xcode'

使用方法

1. Harmony 开发时 ：执行 ohos_on 启用 OpenHarmony 环境
2. iOS/React Native 开发时 ：执行 ohos_off 禁用 OpenHarmony 环境
3. 打开 Xcode ：使用 xcode-clean 命令确保干净环境

更多改进方案

1. direnv 自动切换：可以使用 direnv 工具，根据目录自动切换环境

   brew install direnv
   echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc

   然后在 Harmony 项目目录创建 .envrc 文件：

   export PATH="$PATH:/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains"
   export HDC_SERVER_PORT=7035
   export RNOH_C_API_ARCH=1

2. Pod 缓存清理：环境污染后，需要彻底清理 Pod：

   cd ios
   rm -rf Pods Podfile.lock
   pod cache clean --all
   pod install

总结

在多平台开发中，环境变量隔离是避免构建问题的关键。通过实现 ohos_on/off 函数和使用 xcode-clean 别名，我们可以轻松切换开发环境，确保 React Native iOS 和 OpenHarmony 项目的构建稳定性。

这种解决方案不仅适用于 OpenHarmony 与 iOS 的冲突，也可扩展到其他多平台开发场景，如 Flutter、Android NDK 等多工具链共存的情况。