HarmonyOS起步开发入门 原创

1.起步鸿蒙

HarmonyOS 是新一代的智能终端操作系统，为不同设备的智能化、互联与协同提供了统一的语言。带来简洁，流畅，连续，安全可靠的全场景交互体验。

2.  起步-DevEco Studio开发工具

华为官方编辑器地址：​​https://developer.huawei.com/consumer/cn/download/​​

Windows版本需要注意环境要求,保证DevEco Studio正常运行，建议电脑配置满足如下要求。

①操作系统：Windows10 64位、Windows11 64位

②内存：16GB及以上

③硬盘：100GB及以上

④分辨率：1280*800像素及以上

2.1下载DevEco Studio工具

①进入鸿蒙应用开发官网界面，如图所示。（说明:鸿蒙应用开发官网网址是：​​https://developer.huawei.com/consumer/cn/​​）

②进入DevEco Studio下载界面，如图所示。（说明：鸿蒙应用开发官网下载界面网址是：​​https://developer.huawei.com/consumer/cn/deveco-studio​​/）

③点击立即下载,页面跳转后，如图所示，点击下载。（说明:读者也可根据实际情况选择对应版本下载）。

2.2 执行安装步骤

①下载完成后，双击“deveco-studio-xxxx.exe”，进入DevEco Studio安装向导，如图所示。

②在如下界面选择安装路径，默认安装于C:\Program Files路径下，也可以单击“浏览... ”指定其他安装路径，然后单击“下一步”，如图所示。（注：建议DevEco Studio以及SDK文件安装路径不要包含中文或空格）。

③在如下安装选项界面勾选DevEco Studio后，单击“下一步”，直至安装完成。如图所示。

④安装完成后，单击“完成”按钮完成安装，如图所示。

2.3 DevEco Studio工具的配置

2.3. 1. 诊断开发功能

为了开发者更好的开发应用，DevEco Studio提供了开发环境诊断的功能，帮助开发者识别开发环境是否完备。在欢迎页面单击Diagnose进行诊断。如果打开了工程开发界面，也可以在菜单栏单击Help —> Diagnostic Tools —> Diagnose Development Environment进行诊断，如图所示。

如果诊断后的结果显示“√”，说明开发环境正确。

2.3. 2. 设置主题

为了适配开发者的开发习惯，DevEco Studio提供了主题风格的设置，帮助开发者更好的使用DevEco Studio工具。在欢迎页面单击Customize—>All settings进入到设置页面。如果打开了工程开发界面，也可以在菜单栏单击File —> Settings进入到设置页面，选择“Appearance & Behavior”中的“Appearance”选项，通过“Theme”选择，如图所示。

2.3. 3. 设置字体

DevEco Studio可以设置编写代码的字体的样式、大小和行高，在菜单栏单击File —> Settings进入到设置页面，选择“Editor”中的“Font”选项，如图所示。

在这里也可以下载其它API版本。至此DevEco Studio工具配置完成！

3.起步-认识工作区

打开DevEco Studio工具，使用Empty Ability创建工程，如图所示。

创建工程MyApplication，如图所示。

默认创建Index.ets界面，开发工具可分为“左侧目录结构”、“代码区”和“预览区”。

· 通过左侧目录找到对应的应用文件，在编辑区进行代码编写，在右侧看预览效果

· 连按两下shift，可以快速寻找文件

4.起步-如何排错

写代码过程中，出现错误，代码区和预览区都会给出提示，如图所示。

写代码时，我们会经常遇到这种情况，右侧出现不能够开启预览器的提示，让我们打开预览器日志看错误。

解决该问题的思路 1.：

按照编辑器提示的，打开预览器日志，如图所示。

如果是明确的语法错误或者api错误，编辑器会指出我们代码的行数，我们可以点击提示的代码行，直接跳到对应位置，直接检查代码的问题，如图所示。

跳到对应的位置，如图所示。

解决该问题的思路2：

如果当前文件不多，可以点开你创建的所有文件，查看文件中是否有报错的地方，文件报错，在右侧以及代码区会有明显的报错提示，如图所示。

解决该问题的思路3：

通过统一构建，暴露哪些文件及代码无法编译通过，如图所示。

在Build控制台上提示错误，如图所示。

点击该处位置，直接跳转到错误的代码行。

5.起步-刷新看效果

预览器是有热更新的，原则上写完右侧自动更新，如果不自动刷新- 语法错了，编辑器卡住了。

可以展开折叠预览器一次，这样代码就会进行编译，如图所示。

直接点击刷新按钮，如图所示。

6.起步-审查和多设备预览

效果预览方法：

l Preview(预览器)

l 本地模拟器

l 本地真机(Meta60-Meta60Pro X5或者是装载OpenHarmony的工程机(价格较低，但是依然存在一些问题))

只有装了Next预览版系统的手机才可以进行真机调试和预览，目前Next预览器系统装机量有限，需要申请和审核

1.预览器的多设备预览，如图所示。

2in1的意思是 平板电脑二合一的状态，如图所示。

2.预览器的审查元素，如图所示。

支持双向通信，这里改数据，会自动同步到编辑器，如图所示。

7.起步-工程目录结构

工程结构目录，如图所示。

详解目录结构：

AppScope > app.json5：应用的全局配置信息。

entry：应用/服务模块，编译构建生成一个HAP。

src > main > ets：用于存放ArkTS源码。

src > main > ets > entryability：应用/服务的入口。

src > main > ets > entrybackupability：主要用于提供应用的扩展备份恢复能力。‌

src > main > ets > pages：应用/服务包含的页面。

src > main > resources：用于存放应用/服务模块所用到的资源文件，如图形、多媒体、字符串、布局文件等。

src > main > module.json5：Stage模型模块配置文件，主要包含HAP的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。

entry > build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。

entry > hvigorfile.ts：模块级编译构建任务脚本。

entry >oh-package.json5：配置三方包声明文件的入口及包名。

oh_modules：用于存放三方库依赖信息，包含应用/服务所依赖的第三方库文件。关于原npm工程适配ohpm操作，请参考​​历史工程适配OHPM包管理​​。

build-profile.json5：应用级配置信息，包括签名、产品配置等。

hvigorfile.ts：应用级编译构建任务脚本。