【OpenHarmony开发】大幅减小OH代码占用磁盘空间的几个小技巧

前言

随着版本的演进和更新，OpenHarmony 的代码量越来越大，非常消耗磁盘空间。以 v4.1-Release 版本为例，参考官方文档提供的以下四条命令获取的 OpenHarmony 代码已经接近 50G（包含//.repo/、//prebuilts/、checkout 到工作区的代码和通过 git lfs pull 下载的大文件）：

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release --no-repo-verify
$ repo sync -c
$ repo forall -c 'git lfs pull'
$ ./build/prebuilts_download.sh
​

如果完成了三类系统(轻量、小型、标准)的全编译，则会产生几十个 G 的 .ccache 和几十个 G 的 //out/ ，整体已经占用超过 150G 的磁盘空间了。

下面我们组合使用 repo 和 git 命令的一些参数，可以大幅减小 OpenHarmony 代码的磁盘占用空间。

repo sync -m 参数

在 repo sync 命令增加 -m 参数，指定只同步（下载或 clone）manifest 仓库中的某个 manifest 文件。

例如，不使用 -m 参数的官方命令：

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release --no-repo-verify
​

会在 //.repo/manifest.xml 中指定同步 //.repo/manifests/default.xml 文件，该文件中

  <include name="ohos/ohos.xml" />
  <include name="chipsets/all.xml" />
​

会指定下载全量的 OpenHarmony 代码，包括了开源出来的所有 chipsets 仓库代码，这样会包含我们并不需要的非常多的仓库。

而通过增加 -m 参数则可以只下载我们需要的 chipsets 仓库代码，例如：

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release -m chipsets/hispark_taurus.xml --no-repo-verify
​

上述命令增加 “-m chipsets/hispark_taurus.xml” 后，//.repo/manifest.xml 的描述则会指定同步 //.repo/manifests/chipsets/hispark_taurus.xml 文件：

  <include name="ohos/ohos.xml" />
  <include name="chipsets/hispark/hispark.xml" />
​

这样可以节省不少磁盘空间。

如果我们还需要其它的 chipsets 的 manifest，那我们可以直接手动修改 //.repo/manifest.xml 的描述，按规则增加对应的 chipsets 的 manifest 即可。

或者，不加 -m 参数，也可以直接修改 //.repo/manifests/default.xml 文件的描述，再去 repo sync，也可以达到同样的效果：

  <include name="ohos/ohos.xml" />
  <!-- include name="chipsets/all.xml" / -->
  <include name="chipsets/hispark/hispark.xml" />
  <include name="chipsets/dayu200/dayu200.xml" />
​

repo sync -g 参数

在 repo sync 命令增加 -g 参数，可以对各仓库的 groups 字段进行过滤，匹配 -g 参数的仓库才会同步（下载或 clone）到本地。例如：

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release -m chipsets/hispark_taurus.xml -g ohos:mini,ohos:small --no-repo-verify

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release -m chipsets/dayu200.xml -g ohos:standard --no-repo-verify
​

但是需要注意，这个 groups 标签，看上去维护得并不好，甚至有些混乱。

有些仓库只适用于标准系统，也添加了 ohos:mini,ohos:small 标签；有些仓库虽然没有 ohos:mini,ohos:small 标签，但是在执行 ./build/prebuilts_download.sh 时，则是需要依赖到的；有些仓库则没有 ohos:mini,ohos:small 标签，但会在编译过程中或者镜像打包阶段依赖到而导致编译错误；这些都需要根据实际情况自行修改 ohos.xml 中对应仓库的 groups 标签然后再同步和编译代码。

repo sync --depth 参数

ohos.xml 中对 Linux 内核仓库的描述：

<project name="kernel_linux_5.10" path="kernel/linux/linux-5.10" clone-depth="1" groups="..."/>
​

有一个 clone-depth="1" 的字段，该字段表示在同步（下载或 clone）远程仓库到本地时，只下载远程仓库默认分支的最新一次提交记录到本地，而不是将所有的历史记录都同步到本地，这样可以大幅减少仓库代码的磁盘占用空间。

如果只想对某些仓库（特别是历史记录特别长的仓库）做 clone-depth="num"的操作，可以像上面一样，在对应仓库的描述信息增加 clone-depth="num" 字段就行了；如果想对所有仓库进行一次性的操作，那就给 repo sync 命令增加一个 --depth 参数。例如：

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release -m chipsets/hispark_taurus.xml -g ohos:mini,ohos:small --no-repo-verify --depth=1 

$ repo init -u [email]git@gitee.com[/email]:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release -m chipsets/dayu200.xml -g ohos:standard --no-repo-verify --depth=1 
​

git --depth 参数

通过 repo sync --depth=1 参数拉取的 OpenHarmony 代码，默认只获取远程仓库默认分支的最新一次提交记录到本地，并不包含更多的历史提交记录和其他费默认分支的记录。

对某个具体仓库，可以通过 git 命令和参数进行一些操作，获取更多的历史提交记录和其他费默认分支的记录到本地。

git 的 --depth 参数：

--depth <depth>
  Create a shallow clone【浅克隆】 with a history truncated to the specified number【depth】 of commits. 
  Implies【隐含参数是】--single-branch【仅获取远程仓库默认分支的最新一次提交记录】unless【除非显式指定参数】--no-single-branch【通过这个参数指明获取远程仓库所有分支的最新一次提交记录】is given to fetch the histories near the tips of all branches. 
  If you want to clone submodules shallowly, also pass --shallow-submodules.
​

即在默认的 --single-branch 情况下，只获取默认分支到本地；如果要查看其他分支的代码和提交记录，可以按如下一些操作进行处理。

# 例如本地只有OpenHarmony-v4.1-Release的记录，想要使用远程的OpenHarmony-v3.2-Release分支，
# 这样操作就可以把远程的OpenHarmony-v3.2-Release分支拉取到本地进行切换和使用

$ git remote set-branches origin OpenHarmony-v3.2-Release 
$ git fetch --depth=1 origin OpenHarmony-v3.2-Release:OpenHarmony-v3.2-Release 
$ git checkout OpenHarmony-v3.2-Release
​

git-sparse-checkout 参数

对于特定的仓库，git 还有一个稀疏检出的操作可以稍微减少 checkout 的代码量，更重要的是这个参数可以让工作区的代码目录更清爽。

例如，对于 //vendor/hisilicon/ 仓库，默认是：

ohos@ohos:~/Lite/A41Rel/vendor/hisilicon$ ls -l
drwxrwxr-x 13 ohos ohos  4096  5月 30 15:26 ./
drwxrwxr-x  7 ohos ohos  4096  4月 29 17:48 ../
drwxrwxr-x  3 ohos ohos  4096  5月 30 15:26 .git/
drwxrwxr-x  2 ohos ohos  4096  5月 30 15:26 .gitee/
-rw-rw-r--  1 ohos ohos    84  5月 30 15:26 .gitignore
drwxrwxr-x  6 ohos ohos  4096  5月 30 15:26 hispark_aries/
drwxrwxr-x  4 ohos ohos  4096  4月 14 11:50 hispark_pegasus/
drwxrwxr-x  3 ohos ohos  4096  5月 30 15:26 hispark_pegasus_mini_system/
drwxrwxr-x  7 ohos ohos  4096  5月 30 15:26 hispark_phoenix/
drwxrwxr-x  6 ohos ohos  4096  4月 14 00:21 hispark_taurus/
drwxrwxr-x  5 ohos ohos  4096  5月 10 09:18 hispark_taurus_linux/
drwxrwxr-x  6 ohos ohos  4096  5月 30 15:26 hispark_taurus_mini_system/
drwxrwxr-x  7 ohos ohos  4096  5月 30 15:26 hispark_taurus_standard/
-rw-rw-r--  1 ohos ohos 10347  5月 30 15:26 LICENSE
-rw-rw-r--  1 ohos ohos  6854  5月 30 15:26 OAT.xml
-rw-rw-r--  1 ohos ohos  1345  5月 30 15:26 README_zh.md
drwxrwxr-x  6 ohos ohos  4096  5月 30 15:26 watchos/
​

这里面有很多项目是我们平常基本上用不到也改不到的，放在这里很碍眼，通过 hb set 选择项目时，也会出现太多的选项，因此，可以使用 git-sparse-checkout 的配置来只 checkout 我们想要的文件夹(项目)。

可以在这个仓库目录下执行：

git config core.sparsecheckout true
# true 或 1，enable sparsecheckout
# false 或 0，disable sparsecheckout
​

该命令会在 //vendor/hisilicon/.git/config 文件的 [core] 段新增一个 sparsecheckout = true 的配置，enable 了 sparsecheckout 功能，然后再执行：

git sparse-checkout set hispark_pegasus hispark_taurus hispark_taurus_linux
或者
echo "hispark_pegasus hispark_taurus hispark_taurus_linux" > .git/info/sparse-checkout
​

作用都是将需要 checkout 的目录和文件列表写入到 //vendor/hisilicon/.git/info/sparse-checkout 文件中去，而不在该文件中的目录和文件则不会 checkout 出来（但这些文件的 objects 对象，还是在本地仓库中的，只是没有解压到工作区而已），而我们的修改和提交，也不会影响到未 checkout 的目录和文件。

ohos@ohos:~/Lite/A41Rel/vendor/hisilicon$ ll
drwxrwxr-x 6 ohos ohos 4096  5月 30 15:46 ./
drwxrwxr-x 7 ohos ohos 4096  4月 29 17:48 ../
drwxrwxr-x 3 ohos ohos 4096  5月 30 15:46 .git/
drwxrwxr-x 4 ohos ohos 4096  4月 14 11:50 hispark_pegasus/
drwxrwxr-x 6 ohos ohos 4096  4月 14 00:21 hispark_taurus/
drwxrwxr-x 5 ohos ohos 4096  5月 10 09:18 hispark_taurus_linux/
​

当我们需要把全部的目录和文件列表全部 checkout 出来的时候，可以直接执行：

git sparse-checkout set *
或者
echo "*" > .git/info/sparse-checkout
​

然后重新 checkout 一下当前的分支即可。

注意：

实测发现，是否执行 “git config core.sparsecheckout” 命令来 enable 或 disable sparsecheckout 都没关系（不知道是 git 版本问题还是 bug），只要有 .git/info/sparse-checkout 文件，都可以通过改写该文件达到稀疏检出的目的。

补充

经过上述命令和参数的组合使用，可以大幅减少 OpenHarmony 仓库和代码所占用的磁盘空间，但是三大巨头（//prebuilts/、//out/、.ccache）仍然是占用着非常大的磁盘空间。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

鸿蒙HarmonyOS Next全套学习资料←点击领取！（安全链接，放心点击）

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

鸿蒙（HarmonyOS NEXT）最新学习路线

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

HarmonyOS Next 最新全套视频教程

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……

《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

大厂面试必问面试题

鸿蒙南向开发技术

鸿蒙APP开发必备

鸿蒙生态应用开发白皮书V2.0PDF

获取以上完整鸿蒙HarmonyOS学习资料，请点击→

纯血版全套鸿蒙HarmonyOS学习资料

总结
总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。