鸿蒙CodeArts IDE C/C++ 环境搭建

1. 下载 Harmonybrew

1.1 什么是 Harmonybrew

Harmonybrew(简称 brew)是面向鸿蒙生态的包管理器,与 macOS 的 Homebrew 形态类似,提供统一的 brewinstall / brew upgrade / brew search 等命令,用于管理 ohos-sdk、llvm-gcc-compat 等工具链。Harmonybrew 官方仓库地址:

https://atomgit.com/Harmonybrew/docs/blob/main/README.md

1.2 安装 Harmonybrew

在 CodeArts IDE 的内置终端(mksh)中执行以下命令,从官方脚本安装:

# 拉取安装脚本并执行

zsh -c "$(curl-fsSL https://harmonybrew.atomgit.com/install.sh)"

 

1.3 重要:CodeArts 中的 brew 调用为 mksh,与 hishell 的 zsh 不同

CodeArts IDE 内置终端默认调用的是 mksh(MirBSD Korn Shell),而非 hishell 默认的 zsh。这两套 shell 的环境变量加载机制不同,直接拷贝 zsh 下的配置会导致 brew 找不到 ohos-sdk 路径。

差异点速查:

项目	mksh(CodeArts 默认)	zsh(hishell 默认)
环境变量文件	~/.mkshrc 或 profile	~/.zshrc
登录/非登录	需区分 LOGIN vs 非 LOGIN	统一加载 .zshrc
PATH 生效时机	新开终端时加载	source 即时生效
brew 调用方式	在 CodeArts 中直接输入 brew	需先 hishell → brew

1.4 单独配置 mksh 环境变量

为避免 zsh 与 mksh 的环境变量互相覆盖,推荐在 mksh 专属配置文件中单独声明 ohos-sdk 与 brew 路径。操作步骤:

1.      打开(或创建) ~/.mkshrc:

echo>> ~/.mkshrc

echo'eval "$(/storage/Users/currentUser/.harmonybrew/bin/brew shellenv)"'>> ~/.mkshrc

官方 FAQ 提供了更详细的故障排查清单(尤其是 mksh 找不到 brew /ohos-sdk 的场景),请参考:

https://atomgit.com/Harmonybrew/docs/blob/main/zh-CN/user/FAQ.md#not-work-in-codearts

1.5 验证 Harmonybrew 可用

【bash】

brew --version

# 期望输出形如: Harmonybrew1.x.x

 

brew doctor

# 应无 'command not found'或 'broken linkage' 错误

2. 下载特色包:llvm-gcc-compat

2.1 什么是 llvm-gcc-compat

llvm-gcc-compat 是 Harmonybrew 提供的一个特色兼容包,核心作用是:在系统中创建一组软链接 cc、gcc、g++、ld、ar 等,让它们全部指向 ohos-sdk 自带的 LLVM 工具链(clang、clang++、lld、llvm-ar 等)。

2.2 安装方法

【bash】

# 搜索特色包,确认仓库中确实存在

brew search llvm-gcc-compat

 

# 安装(全局可用)

brew install llvm-gcc-compat

2.3 设计理念:模仿 macOS

这一做法直接借鉴了 macOS 的设计惯例。在 macOS 上,系统自带的 cc、gcc、ld 同样是 clang/lld 的软链接,目的是让 Unix 生态的源码在不开源 GCC 的前提下仍能直接编译。Harmonybrew 通过 llvm-gcc-compat 复刻了这一思路,使鸿蒙 C/C++ 开发者可以无缝复用大量上游开源项目,无需修改其构建脚本。

3. 在 CodeArts IDE 中创建并构建 C/C++ 工程

3.1 创建 C/C++ 工程

1.      在 CodeArts IDE 中,点击「文件」→「新建」→「工程」。

2.      工程模板列表中,选择「C/C++ 工程」。

3.      IDE 会自动生成 CMakeLists.txt、src/main.c 或 main.cpp、以及 .vscode/ 下的构建配置。

3.2 清理工程

在 CodeArts IDE 顶部菜单栏,点击「构建」→「清理工程」(CleanProject),将删除 build/ 目录与所有中间产物,确保下次构建从零开始。清理常用于:

•        切换工具链(如从系统 GCC 切到 LLVM)后,旧产物不兼容;

•        CMakeLists.txt 发生结构变化(如新增/删除 source);

•        上一次构建因中断产生了不完整缓存。

3.3 重新构建工程

清理完成后,点击「构建」→「重新构建工程」(Rebuild Project)。CodeArts IDE 会自动调用 cmake 配置+ make/ninja 编译,并在「输出」面板实时显示编译日志。

3.4 构建成功标志

构建成功后,IDE 会在 build/ 目录下生成可执行文件或 .so/.so 动态库,并在底部状态栏显示「构建完成:0错误,0 警告」。同时,「运行」按钮会变为可点击状态,可直接调试运行。