前言
最近一年多以来,我开展了一些与鸿蒙相关的开发工作。
在开发过程中,我做了一些自用的效率工具,其中一个就是容器化的鸿蒙环境。
现在我把这个自用的工具开源了:github.com/hqzing/dock…
这个鸿蒙容器使我们能够使用 Linux 服务器来运行和测试我们的命令行程序,而不用依赖 OpenHarmony 物理设备。
基础用法
要使用这个鸿蒙容器,你首先要有一个 arm64 服务器(各大云厂商都有卖),然后服务器上要装好 Docker。
买服务器的时候建议选香港或国外的区域,因为容器托管在 GitHub 上,我下面提到的那一批工具也在 GitHub 上,中国大陆的服务器访问 GitHub 可能会网速慢或者访问不通。
环境就绪之后,只需要一条命令就能把容器拉起来:
docker run -itd --name=ohos ghcr.io/hqzing/docker-mini-openharmony:latest
(Docker 检测到本地没有这个镜像它会自动去拉取,所以 docker pull 的过程可以做,也可以不做)
然后再一条命令,就能进入容器中操作:
docker exec -it ohos sh
工具获取
这个容器里面只是一个最小系统,除了 toybox 提供的少量命令和我内置进去的 curl 以外,里面什么工具都没有。这是无法支撑开发工作的,所以我们要根据自己的实际需求,往里面装一些工具。
至于工具从哪来?你可以根据 README 文档的操作去 Alpine Linux 的软件仓库获取;也可以用我移植好的工具;或者去找别人移植好的工具。
这是我移植好的一批工具,使用方式已经写在各项目的 README 文档里面了
| 工具类别 | 名称 | 项目地址 |
|---|---|---|
| 实用工具 | coreutils | github.com/Harmonybrew… |
| 实用工具 | busybox | github.com/Harmonybrew… |
| 文本处理 | grep | github.com/Harmonybrew… |
| 文本处理 | gawk | github.com/Harmonybrew… |
| 构建工具 | make | github.com/Harmonybrew… |
| 构建工具 | ninja | github.com/Harmonybrew… |
| 构建工具 | cmake | github.com/Harmonybrew… |
| 构建工具 | m4 | github.com/Harmonybrew… |
| 构建工具 | autoconf | github.com/Harmonybrew… |
| 文本编辑器 | neovim | github.com/Harmonybrew… |
| 命令行解释器 | zsh | github.com/Harmonybrew… |
| 版本控制 | git | github.com/Harmonybrew… |
| 语言解释器 | perl | github.com/Harmonybrew… |
| 语言解释器 | ruby | github.com/Harmonybrew… |
实践案例
这个鸿蒙容器,搭配上面给出的这些工具一起使用,再加上 ohos-sdk,就可以胜任很多开发工作了。
比如这几个项目就是基于鸿蒙容器完成的构建:
你也可以尝试模仿里面的做法,去编你想编的软件。
另外我再介绍个比较黑科技的做法:你甚至可以把 llvm 软链接成 gcc 和 binutils,这样就不用每次编东西还要配一堆 CC、CXX 之类的环境变量了。
比如这样
cd /opt/ohos-sdk/ohos/native/llvm/bin
ln -s clang cc
ln -s clang gcc
ln -s clang++ c++
ln -s clang++ g++
ln -s ld.lld ld
ln -s llvm-ar ar
ln -s llvm-nm nm
ln -s llvm-objcopy objcopy
ln -s llvm-objdump objdump
ln -s llvm-ranlib ranlib
ln -s llvm-size size
ln -s llvm-strings strings
ln -s llvm-strip strip
cd -
export PATH=$PATH:/opt/ohos-sdk/ohos/native/llvm/bin
这个做法你也可以在 MacOS 里面看到。你可以去 MacOS 上看 gcc、ld、ar 等命令的实际路径在什么地方,你会看到实际上是软连接到 llvm 里面去了。
迭代过程
这个鸿蒙容器截止到现在已经经历了 3 个版本迭代,现在开源出来的是最后一个最成熟的版本。
第 1 个版本:早期最简版本
最开始做的时候,OpenHarmony 还是 4.0 版本。当时只要编一份 arm64 架构的 rk3568 镜像,把里面的 ramdisk.img 解压、打成 tar 包、导入到 Docker 中就能直接用。
因为当时我找到的官方 rk3568 镜像只有 32 位的,而我编的软件要在 64 位系统上进行测试,所以需要自己编 64 位的系统。
第 2 个版本:事情逐渐变得复杂
到了 OpenHarmony 5.1 版本的时候,我对环境进行了一次升级。这时候发现 OpenHarmony 官方社区的日构建流水线里面就有提供 dayu200-arm64_5.1.0-Release 的产物,不用我自己去编 64 位系统了。
但是这个新版本带来了一个新问题:单把 ramdisk.img 里面的内容导到 Docker 里面是跑不起来的,因为这里面的 toybox 被改造了,它依赖了一个 system.img 里面的 so。我不得不分别从两个镜像各取一部分内容,放在一起,导入到 Docker 中。
第 3 个版本:需要改造系统源码
升级完版本之后,发现它时不时会在各进程的 stderr 里面输出一些类似于 HiLogAdapter: Can't connect to server. 这样的报错。
定位之后发现是 OpenHarmony 社区把 musl libc 进行了改造,做了很多日志输出,而且日志是对接到 HiLog 里面的。我在容器里面没有启动 init 进程,也没把 HiLog 相关的东西带进来,容器中自然就不会有 HiLog 服务,于是 musl libc 没法通过 socket 跟 HiLog 服务进行通信,因此就时不时会有错误日志从各个进程的 stderr 里面冒出来,这会在一些情况下会导致业务异常。
为了处理这个问题,我只好放弃使用 OpenHarmony 官方编好的包,又换回了自己编包的方案。只有这样做,我才能通过改源码的方式去处理这个 musl libc 对 HiLog 的依赖问题。
演进计划
这个鸿蒙容器和 Harmonybrew 组织下面的那些 ohos-xxx 项目,它们以后都会变成 Harmonybrew 项目的基建的一部分。Harmonybrew 项目是一个把 Homebrew 移植到 OpenHarmony 平台的项目,我正在为了实现这个目标而开展一些工作。
鸿蒙容器在 Harmonybrew 项目中主要会用于流水线业务,用来把用户贡献的 formula 构建成 bottles。现在 OpenHarmony 官方并没有提供云化的环境,也没有第三方厂商提供这方面的解决方案,我们没法像 Windows、Linux、MacOS 那样很方便地在流水线上面进行本地编译和自动化测试。在这种情况下,除了用这个鸿蒙容器以外没有其他选择了。
至于那些 ohos-xxx 的软件包,它们要么是 Homebrew 所需的依赖,要么是编其他软件的时候需要用到的构建工具。
有了 git、curl、zsh、ruby,Homebrew 就能在 OpenHarmony 上运行了。在这基础上,把 make、cmake 等软件预置在 Harmonybrew 的流水线环境上,将它们作为外置工具链,就可以用来构建第一批 formula(我会选定一批最基础、最重要的软件作为第一批 formula)。当第一批 formula 都构建完成后,流水线环境就可以不用自备外置工具链了,我们就可以基于 Harmonybrew 仓库中的工具链自己“长”出一套完整的生态了。
Harmonybrew 相关的坑已经占好了(GitCode 链接、GitHub 链接),已经“新建文件夹”了。大家敬请期待,到时候做好了欢迎大家过来贡献 formula。