00. 目录
01. DevEco Studio概述
HUAWEI DevEco Studio(获取工具请单击链接下载,以下简称DevEco Studio)是基于IntelliJ IDEA Community开源版本打造,为运行在HarmonyOS和OpenHarmony系统上的应用和服务(以下简称应用/服务)提供一站式的开发平台。
作为一款开发工具,除了具有基本的代码开发、编译构建及调测等功能外,DevEco Studio还具有如下特点:
- 高效智能代码编辑:支持ArkTS、JS、C/C++等语言的代码高亮、代码智能补齐、代码错误检查、代码自动跳转、代码格式化、代码查找等功能,提升代码编写效率。更多详细信息,请参考编辑器使用技巧。
- 低代码可视化开发:丰富的UI界面编辑能力,支持自由拖拽组件和可视化数据绑定,可快速预览效果,所见即所得;同时支持卡片的零代码开发,降低开发门槛和提升界面开发效率。更多详细信息,请参考使用低代码开发应用/服务。
- 多端双向实时预览:支持UI界面代码的双向预览、实时预览、动态预览、组件预览以及多端设备预览,便于快速查看代码运行效果。更多详细信息,请参考使用预览器预览应用/服务界面效果。
- 多端设备模拟仿真:提供HarmonyOS本地模拟器,支持手机等设备的模拟仿真,便捷获取调试环境。更多详细信息,请参考使用模拟器运行应用/服务。
02. DevEco Studio环境配置
2.1首次使用DevEco Studio,点击Agree。
2.2 首次使用DevEco Studio,请选择 Do not import settings,点击 OK。
2.3 选择 Install 按钮,选择下载源“from Huawei Mirrorv16.19.1”和存储路径后,进行在线下载,单击 Next 进入下一步。
2.4 在 SDK Setup 界面,点击文件按钮,设置 HarmonyOS SDK 存储路径(设置默认即可),单击 Next 进入下一步。
注意:
环境配置过程中会默认下载 HarmonyOS SDK。HarmonyOS SDK 路径中不能包含中文字符。
2.5 在弹出的 License Agreement 窗口,阅读 License 协议,需同意 License 协议后,单击Next。
2.6 确认设置项的信息,点击 Next 开始安装。
2.7 安装过程如下图所示,下载完成之后,点击Finish按钮
2.8 等待 Node.js、ohpm 和 SDK 下载完成后,单击 Finish,界面会进入到 DevEco Studio欢迎页。
2.9 点击Help->选择诊断环境,Result全部为绿色的勾表示OK。
03. KaihongOS SDK 配置
联系深开鸿技术工程师获取 KaihongOS 的 Public SDK。
为方便与 HarmonyOS SDK 区分,后文将 KaihongOS 的 Public SDK 简称为“KaihongOS SDK”。
3.1 在本地磁盘新建一个空文件夹,例如KaiHongSDK(具体路径及文件夹名可自行设定,但目录不要使用中文命名),用于存放 KaihongOS SDK,如下图所示。
3.2 解压缩 KaihongOS SDK 后,进入“windows”文件夹,获取如下图所示的 5 个压缩包文件,然后解压缩得到对应的文件夹。
解压缩过程中,如果弹出“确认文件替换”的提示,选择“全部选是”。
3.3 将解压缩获得的 ets、js、native、previewer 和 toolchains 文件夹全部拷贝到前面新建的KaiHongSDK文件夹下,如下图所示。
3.4 在上图的每个文件夹下的 oh-uni-package.json 文件中找到 version 字段,记录此版本号。然后,在每个文件夹下分别新建一个子文件夹,命名为版本号(比如 3.2.12.5),并将文件夹下的所有文件剪切到子文件夹中,如下图所示。
3.5 在上述目录中的“ets\3.2.11.9\build-tools\ets-loader”路径下打开命令提示符(cmd),执行 npm install 命令,安装 ets 的 SDK 包。
在指定目录打开cmd的方法
打开电脑之后在电脑中打开一个文件夹,在文件夹页面中先按住“shift”键,再右键单击文件夹页面,在菜单列表中点击“在此处打开Powershell窗口(S)”选项。
打开“在此处打开Powershell窗口(S)”选项之后,在弹框中输入“start cmd”,然后点击回车键。
说明
如果执行 npm install 命令报错,请检查系统变量“Path”中是否配置了 Node.js 的路径。检查和配置的操作如下:
- 使用鼠标右键点击“此电脑”,选择“属性 > 高级系统设置”,弹出“系统属性”窗口。
- 在“系统属性”窗口,选择“高级”页签,点击“环境变量”,弹出“环境变量”窗口。
- 双击“系统变量”中的“Path”变量,在弹出的“编辑环境变量”窗口查看是否配置了Node.js 的路径(比如:C:\Program Files\nodejs)。
- 如果没有配置,点击“新建”,添加 Node.js 的路径(比如:C:\Program Files\nodejs)后,点击“确定”,再依次点击“环境变量”窗口和“系统属性”窗口的“确定”。
3.6 在上述目录中的“js\3.2.11.9\build-tools\ace-loader”路径下打开命令提示符(cmd),执行 npm install 命令,安装 js 的 SDK 包。
3.7 在 DevEco Studio 中点击 Configure配置按钮
3.8 选择“Settings > SDKs >OpenHarmony”。如下图所示,点击“Location”后的“Edit”
3.9 选择 KaihongOS SDK 所在路径,然后点击“OK”。
3.10 界面显示报错“The SDK managementmode has changed.” 点击报错提示后的“Fix”,在弹出的“Migrate SDKs”窗口点击“OK”,开始迁移 SDK。
3.11点击Finish
3.12 在SDK Componets Setup界面点击Finish
3.13 显示如下图所示,表示已成功安装 KaihongOS SDK,再点击“OK”。
04. 运行OpenHarmony第一个程序
开发环境配置好后,可以通过运行 Hello World 工程来验证环境设置是否正确。
4.1 通过如下两种方式,打开工程创建向导界面。
如果当前未打开任何工程,可以在 DevEco Studio 的欢迎页,选择 Create Project开始创建一个新工程。
如果已经打开了工程,可以在菜单栏选择 File > New > Create Project 来创建一个新工程。
4.2 根据工程创建向导,选择创建 Application 应用服务或 Atomic Service 元服务。再选择需要的 Ability 工程模板,然后点击 Next。
4.3 在工程配置页面,需要根据向导配置工程的基本信息。 配置工程信息。根据需要修改 Project name 等信息后,点击 Finish。工具会自动生成示例代码和相关资源,等待工程创建完成。
填写工程相关信息,保持默认值即可,单击Finish。关于各个参数的详细介绍,请参考创建一个新的工程。
4.4 单击 Finish,工具会自动生成示例代码和相关资源,等待工程创建完成。
4.5 将模块级的 build-profile.json5 文件中 runtimeOS 字段修改为“OpenHarmony”,并点击“Sync Now”重新同步工程。
4.6 在Sync Check页面点击Yes按钮
4.7 将搭载 OpenHarmony 标准系统的开发板与安装 DevEco Studio 的 PC 机相连。(板子USB3.0和电脑USB连接)
4.8 选择 File > Project Structure > Project > Signing Configs,勾选“Automatically generate signature”,等待自动签名完成即可,点击“OK”。
4.9 在编辑窗口右上角的工具栏,点击绿色运行按钮,或使用默认快捷键 Shift+F10(Mac 为Control+R)运行工程,等待编译完成即可便运行在设备上。
4.10 此时板子屏幕上显示Hello World,表示环境已经搭建好了。
至此,验证了 DevEco Studio 工具已正确安装,接下来可以开始基于开发板正式的应用开发。
05. 附录
SDK下载:KaihongOS-Full-SDK 1.3.4.006(RT00E000).rar
参考教程:KaihongOS标准系统软件+1.3.3+北向应用开发指导书+01+(1).pdf
程序下载:鸿蒙HelloWorld程序.rar