获取源码
HarmonyOS的开源版项目名为OpenHarmony,由华为捐赠给开放原子开源基金会(OpenAtom Foundation)开源。第一个开源版本支持在128KB~128MB设备上运行。
代码仓库地址: https://openharmony.gitee.com
1. 从镜像站点下载压缩文件(推荐)
OpenHarmony提供了以下站点的镜像库,您可以根据自己的需求选择源码或者对应的解决方案站点进行下载:
下载内容 | 版本信息 | 下载站点 | SHA256校验码 |
---|---|---|---|
全量代码 | 1.0 | 站点 | SHA256 校验码 |
Hi3861解决方案(二进制) | 1.0 | 站点 | SHA256 校验码 |
Hi3518解决方案(二进制) | 1.0 | 站点 | SHA256 校验码 |
Hi3516解决方案(二进制) | 1.0 | 站点 | SHA256 校验码 |
RELEASE-NOTES | 1.0 | 站点 | - |
2. 从hpm网站组件式获取
对于刚接触HarmonyOS的新用户,希望能够参考一些示例解决方案从而进行快速开发。可以在HPM获取推荐的解决方案,以此为基础,增加或裁剪部分组件,快速定制系统。
操作步骤如下
- 查找合适的解决方案组件包
- 打开包管理页面HPM,设定搜索的对象为“解决方案”,如下图所示。
- 自搜索框输入关键字搜索,如"WLAN"(这里严格区分大小写)。
- 结果中显示匹配的解决方案,可以进一步根据组件类别等过滤条件(如:适配的开发板,内核)精确筛选。
- 查找合适的解决方案,点击查看解决方案详情介绍。
- 定制解决方案组件包
- 仔细阅读解决方案的说明,以了解该解决方案的使用场景、特性、使用方法以及如何进行定制化,如下图所示。
- 点击「直接下载」,将解决方案下载到本地。
- 点击「定制组件」,将对解决方案包含的组件进行定制。
- 定制组件
- 进入解决方案定制页面,如下图所示。
- 通过关闭开关移除可选组件,或者通过“添加组件”增加新的组件。
- 在右边填写您的项目基本信息,包括名称、版本、描述等信息。
- 点击“下载”,系统会根据您的选择,生成相应的HarmonyOS代码结构文件(如name.zip),保存至本地文件。
- 下载的压缩文件并未包含源代码的原始文件,可以在IDE中导入下载的压缩包,解压后执行hpm的安装指令(hpm install),才会将所需要的组件全部下载下来。
- 下载的组件存在工程目录下的ohos_bundles文件夹中。
3. 用包管理器命令行工具获取
这种模式获取源码主要适用场景:
- 用户已通过组件式获取的方式获取源码,需要对源码中的某个或某几个组件进行独立升级。
- 用户已经比较熟悉HarmonyOS系统的开发并且熟练掌握命令行工具的使用。
环境准备:
通过命令行获取,需要先安装Node.js和hpm命令行工具,安装步骤如下:
- 安装Node.js。
官网下载并在本地安装Node.js.
推荐安装 Node.js 12.x (包含 npm 6.14.4)或更高版本 (推荐 12.13.0+)。
- 通过Node.js自带的npm安装hpm命令行工具。
打开CMD,执行以下命令:
npm install -g @ohos/hpm-cli
- 1
- 安装完成后执行如下命令,显示hpm版本,即安装成功。
hpm -V 或 hpm --version
- 1
- 如果升级hpm的版本,请执行如下命令:
npm update -g @ohos/hpm-cli
- 1
操作步骤:
接下来将组件添加到开发项目中,假定要获取的组件名为@ohos/demo,具体操作如下:
- 进入开发目录,执行如下命令,采用默认模板创建一个开发项目。
hpm init -t default
- 1
- 执行如下命令,安装组件@ohos/demo
hpm install @ohos/demo
- 1
- 工具会自动从服务器下载所有依赖的组件,下载成功则显示Install successfully!
$ hpm install @ohos/demo Requesting: https://url.foo.bar/hpm/registry/api/bundles/@ohos/demo downloading @ohos/demoRequesting: https://lfcontentcenterdev....../bMAlLrYISLqdUTFFFCdgzA.tgz extract D:\demo\ohos_bundles\@ohos\demo\@ohos-demo-1.0.7.tgz Install successfully!
- 1
- 2
- 3
- 4
- 5
4. 从代码仓库获取
适用场景:
- 基于HarmonyOS的稳定分支建立自己的基线,分发下游客户。
- 已经完成自身软件与HarmonyOS的对接,需要进行HarmonyOS官方认证。
- 芯片/模组/app通过HarmonyOS官方认证后,贡献代码到HarmonyOS生态。
- 修复HarmonyOS的问题。
- 学习HarmonyOS的源码。
环境准备:
- 注册码云gitee账号。
- 注册码云SSH公钥,请参考码云帮助中心的公钥管理:https://gitee.com/help/articles/4181
- 安装git客户端并配置用户信息。
git config --global user.name "yourname" git config --global user.email "your-email-address" git config --global credential.helper store
- 1
- 2
- 3
- 安装码云repo工具,可以执行如下命令。
curl https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo chmod a+x /usr/local/bin/repopip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
- 1
- 2
- 3
操作:
方式一(推荐):通过repo下载
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c
- 1
- 2
方式二:通过git clone单个代码仓库
进入代码仓库主页:https://gitee.com/openharmony,选择需要克隆的代码仓库,执行命令,如:
git clone https://gitee.com/openharmony/manifest.git -b master
- 1
源码目录简介
下表是HarmonyOS源码的目录及简单说明:
目录名 | 描述 |
---|---|
applications | 应用程序样例,包括wifi-iot,camera等 |
base | 基础软件服务子系统集&硬件服务子系统集 |
build | 组件化编译、构建和配置脚本 |
domains | 增强软件服务子系统集 |
drivers | 驱动子系统 |
foundation | 系统基础能力子系统集 |
kernel | 内核子系统 |
prebuilts | 编译器及工具链子系统 |
test | 测试子系统 |
third_party | 开源第三方组件 |
utils | 常用的工具集 |
vendor | 厂商提供的软件 |
build.py | 编译脚本文件 |
获取工具
获取编译工具链、设备开发工具(HUAWEI DevEco Device Tool)、应用开发工具(HUAWEI DevEco Studio)以及对应的工具使用指南
编译工具链获取路径
编译工具链从镜像站点下载,具体见下表。编译工具链的安装,请参考“快速入门”具体开发板的“环境搭建”部分。
下载内容 | 版本信息 | 下载站点 | SHA256校验码 |
---|---|---|---|
llvm | 9.0.0-34042 | 站点 | 64a518b50422b6f1ba8f6f56a5e303fb8448a311211ba10c385ad307a1d2546f |
gcc_riscv32 | 7.3.0 | 站点 | 614ee086ead1a4fd7384332b85dd62707801f323de60dfdb61503f473d470a24 |
gn | 1523 | 站点 | 50a5a5ba5877dd0ec8afcb23d3dd4d966a16403c29cd80a4002230241d32ef34 |
ninja | 1.9.0 | 站点 | b4a4ba21e94ff77634e1f88697a00b6f498fdbc0b40d7649df1b246b285874f9 |
hc-gen | 0.65 | 站点 | fcfee489371947a464fe41a4b45a897b9a44155891a957f15bad2e157c750162 |
下载时,可以检查编译链工具是否从官方渠道获取
- 在Ubuntu 环境下,使用命令行生成sha256摘要。
sha256sum 文件名
- 1
如果没有sha256sum工具,请参考Ubuntu命令提示安装。
- 生成的摘要与官方提供的对比。
如果一致,则说明下载的工具包没有被篡改过。否则,就要注意下载包的安全。
获取设备开发工具
设备开发工具(HUAWEI DevEco Device Tool)是HarmonyOS面向智能设备开发者提供的一站式集成开发环境,支持HarmonyOS的组件按需定制,支持代码编辑、编译、烧录、调试等功能,支持C/C++语言,以插件的形式部署在Visual Studio Code上。
工具获取路径:https://device.harmonyos.com/cn/ide
工具使用指南:https://device.harmonyos.com/cn/docs/ide/user-guides/service_introduction-0000001050166905
获取应用开发工具
应用开发工具(HUAWEI DevEco Studio) 简称DevEco Studio是面向华为终端全场景多设备的一站式集成开发环境(IDE),为开发者提供工程模板创建、开发、编译、调试、发布等E2E的HarmonyOS应用开发服务。通过使用DevEco Studio,开发者可以更高效的开发具备HarmonyOS分布式能力的应用,进而提升创新效率
工具获取路径:https://developer.harmonyos.com/cn/develop/deveco-studio
工具使用指南:https://developer.harmonyos.com/cn/docs/documentation/doc-guides/tools_overview-0000001053582387
转载请注明:xuhss » HarmonyOS(二) 鸿蒙开发学习科普,源码及开发工具获取