Harmonybrew

将 Homebrew 强大的包管理能力带入 OpenHarmony。

设备支持情况

设备形态 代表产品 最低系统版本 命令行环境
鸿蒙 PC HUAWEI MateBook Pro 敬请期待 HiShell
鸿蒙开发板 dayu200 (rk3568) OpenHarmony 6.1 hdc shell
鸿蒙容器 DockerHarmony OpenHarmony 6.1 任意
※ 注:目前仅支持 arm64 架构。

01. 卸载冲突软件

如果 PC 中安装有 GitNext 和 DevBox 这两个应用,请将它们卸载。

02. 打开安全开关

进入“设置”-> “系统”->“开发者选项”,打开“开发者选项”开关。

进入“设置”->“隐私和安全”->“高级”,打开“运行来自非应用市场的扩展程序”开关。

03. 安装 Homebrew

在终端中执行这句命令进行安装

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

04. 配置环境变量

按照安装脚本的提示,执行以下命令,将 Homebrew 加入到 PATH 中

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

01. 配置所需目录

Homebrew 运行过程中需要使用 $HOME、/usr/bin、/storage/Users/currentUser 等目录,我们需要手动配置这些目录

mount -o remount,rw /
mkdir -p /usr
mkdir -p /data/storage/Users/currentUser
ln -s /bin /usr/bin

# /storage 目录在 tmpfs 上,数据无法持久化,每次重启设备后需要重新创建软链接
ln -s /data/storage/Users /storage/Users

# hdc shell 环境下 HOME 变量默认指向 / 目录,这个目录可用空间很少,需要将其指向一个大容量的目录
# 此配置仅在当前终端有效,每次进入 hdc shell 需要重新设置
export HOME=/storage/Users/currentUser

02. 安装 curl 和 zsh

在上位机(Windows 电脑)下载好 鸿蒙版 curl鸿蒙版 zsh ,并用 hdc 将 tar 包推到设备上。

在设备上解压,把里面的命令软链接到 /usr/bin 目录下

mount -o remount,rw /
tar -zxf curl-8.19.0-ohos-arm64.tar.gz -C /data
ln -s /data/curl-8.19.0-ohos-arm64/bin/curl /usr/bin/curl
tar -zxf zsh-5.9-ohos-arm64.tar.gz -C /data
ln -s /data/zsh-5.9-ohos-arm64/bin/zsh /usr/bin/zsh

03. 安装 Homebrew

在终端中执行这句命令进行安装(别忘了给开发板联网)

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

04. 配置环境变量

手动将 Homebrew 加入到 PATH 中

# 此配置仅在当前终端有效,每次进入 hdc shell 需要重新设置
export PATH=/storage/Users/currentUser/.harmonybrew/bin:$PATH

01. 安装 zsh

在容器内通过 curl 下载 zsh 环境:

curl -fLO https://github.com/Harmonybrew/ohos-zsh/releases/download/5.9/zsh-5.9-ohos-arm64.tar.gz
tar -zxf zsh-5.9-ohos-arm64.tar.gz -C /opt
ln -s /opt/zsh-5.9-ohos-arm64/bin/zsh /usr/bin/zsh

02. 安装 Homebrew

在终端中执行这句命令进行安装

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

03. 配置环境变量

按照安装脚本的提示,执行以下命令,将 Homebrew 加入到 PATH 中

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

常用命令速查

zsh -c "$(curl -fsSL https://harmonybrew.atomgit.com/install.sh)"
# 安装鸿蒙版 Homebrew
zsh -c "$(curl -fsSL https://harmonybrew.atomgit.com/uninstall.sh)"
# 卸载鸿蒙版 Homebrew
brew update
# 更新 Homebrew 包管理器和包索引
brew formulae
# 列出软件仓库中可用的软件包列表
brew search [keyword]
# 在软件仓库中通过关键词搜索软件包
brew install [formula]
# 安装软件包
brew uninstall [formula]
# 卸载软件包
brew list
# 查看已安装的软件包列表
rm -rf $(brew --cache)
# 清除缓存
rm -rf $(brew --prefix)
# 彻底删除 Homebrew 安装目录(比卸载脚本删得更干净)