使用仓颉开发鸿蒙应用需要安装DevEco Studio集成开发环境以及与之配套的仓颉语言插件(plugin)。至本文发布时止,DevEco Studio及仓颉插件尚处于内测状态,开发者需要登录华为开发者官网申请内测资格,方能下载安装。

版权声明

作者:重庆大学 陈波

本文可以在互联网上自由转载,但必须注明出处(作者:海洋饼干叔叔)并包含指向本页面的链接。本文不可以以纸质出版为目的进行改编、摘抄。

1. 安装包下载

  打开华为开发者官方网站,登录

image-20250427110449188

  登录后选择鸿蒙开发者。如果读者尚未申请内测权限,请依提示进行申请。

image-20250427110712933

  在顶部选择开发,然后点击右侧的下载按钮。

image-20250427110902666

  在呈现的下载清单中找到DevEco Studio,点击下图红框中的链接,下载其Windows版本。读者下载时,版本可能不同。

image-20250427111338970

  将右侧滚动条下拉,找于是DevEco Studio-Cangjie Plugin(仓颉插件),点击下图红框中的链接,下载其Windows版本。读者下载时,版本可能不同。

image-20250427111724123

  两个文件尺寸都比较大,其下载需要耗时几分钟至1小时不等。点击浏览器的按钮,可以查看下载进度。

image-20250427111950527

  下载完成后,得到下述两个压缩文件。

image-20250427112756281

2. 安装DevEco Studio

  选中DevEco的安装压缩文件(参见上图),然后点击全部解压缩,得下图所示的对话框,点击提取

image-20250427112819150

  稍等一等儿,解压完成后,便得到如下图所示的可执行DevEco可执行安装文件。

image-20250427113354327

  用鼠标双击运行该文件启动安装过程。由于文件较长,启动过程较慢,请保持耐心,避免重复点击和启动。待下述对话框出现后,点击下一步

image-20250427122835129

  通常,使用默认的安装位置即可。点击下一步

image-20250427122914387

  在安装选项对话框中,勾选全部3个选项,然后点击下一步

image-20250427123015783

  待下述对话框出现后,点击安装

image-20250427123057846

  然后,等待安装完成。

image-20250427123141358

  待安装结束后,点击完成

image-20250427123402578

  然后重新启动计算机。

3. 运行DevEco Studio

  安装结束后,桌面上应可见DevEco Studio图标。双击该图标,即可运行DevEco Studio。

  如果在前述安装过程中忘记勾选创建桌面快捷方式,则请按下键盘上的Windows徽标键,输入deveco进行搜索,找到DevEco Studio,然后运行。请参考下图。

image-20250427123832818

  首次运行时,会得到下述对话框,直接选OK

image-20250427124044582

  勾选I agree…,然后点击Agree按钮。

image-20250427124130705

  待下述对话框出现后,来到Customize对话框,将Color theme(配色方案)修改为IntelliJ Light(浅色)。

image-20250427124249299

4. 安装仓颉插件

  在前图Customize页,点击All settings….(所有设置),然后选择Plugins(插件)页,再点击右上方的齿轮按钮,从弹出菜单中选择Install Plugin from Disk…(从磁盘安装插件)。

image-20250427124544819

  定位到之前下载好的仓颉插件安装文件(注意文件格式为.zip压缩文件),然后点击OK按钮。

image-20250427124752310

  稍作等待后,系统提示是否接受第三方插件的安装,点击Accept(接受)按钮。

image-20250427124907887

  接下来便可在Plugins列表中看到安装好的Cangjie Support Plugin。依提示点击Restart IDE重启集成开发环境,使其生效。

image-20250427125017413

  在下述对话框中,再次点击Restart

image-20250427125208008

5. 创建第1个鸿蒙应用程序

  DevEco Studio重启后,点击Create Project(创建项目)按钮。

image-20250427125341048

  选择Ability Template(能力模板),拖动右侧滚动条,找到并选中[Cangjie] Empty Ability([仓颉]空能力),然后点击Next(下一步)。

image-20250427204320103

  录入项目名称(Project name),其余保持不变,然后点击Finish(结束)。

image-20250427204609611

  稍作等待后,可见名为HelloWorld的项目创建完成,并在DevEco中被打开。

image-20250427204842067

  点击左侧Project栏中的HelloWord可以展开项目的目录结构,如下图所示。

image-20250427205009078

6. 创建并运行虚拟手机

  上述仓颉应用预期在运行鸿蒙系统的Phone(手机)上运行。我们需要在计算机上创建一个虚拟的运行鸿蒙系统的手机。

  在DevEco中下拉设备列表(因无设备,当前显示No Devices),在菜单中选择Device Manager(设备管理器)。

image-20250427205249762

  待下图对话框出现后,点击Agree(同意)。

image-20250427205448649

  如显示下述对话框,选择Yes

image-20250427205552949

  如果上述对话框未显示,则点击右下角New Emulator(新建仿真器)按钮。

image-20250427205657458

  选中下述对话框中的第一行,它是一款6.82英寸屏幕,520像素每英寸,屏幕分辨率1260x2720像素的手机,其上运行HarmonyOS 5.04(16)。然后点击Actions列的下载按钮。

image-20250427210049719

  下载过程需要持续几分种。

image-20250427210107163

  下载完成后,点击Finish(完成)。

image-20250427210407803

  在下图的列表中,可见第1行最后一列的图标变成了垃圾桶,说明该虚拟机已下载完成。保持第1行被选中,然后点击Next

image-20250427210450968

  设置虚拟机的名称,内存及存储空间尺寸。我们保持默认参数不变,直接点击IFinish

image-20250427210655502

  正常的话,将出现下述对话框。点击OK

image-20250427210929645

  点击绿色的三角形运行按钮,启动虚拟手机。

image-20250427211019136

  然后,可见一个虚拟的鸿蒙手机出现在屏幕上,其操作系统正在启动。

image-20250427211102917

  下图是它启动完成的样子。图中右侧有一个工具条,将鼠标放置在工具条上的按钮上,系统会显示提示信息说明按钮的功能。

image-20250427211147663

  此时,可以关闭Device Manager(设备管理器)对话框。

7. 运行第1个鸿蒙应用程序

  保持虚拟手机呈运行状态,再次回到DevEco Studio,可见设备列表中自动显示了正在运行中的虚拟手机,点击其右侧的三角形运行按钮,将当前项目HelloWorld部署至虚拟手机并运行。

image-20250427212058837

  然后可见DevEco Studio忙碌了好大一阵,最后给出了下述错误信息:应用部署和运行失败。

image-20250427212305179

  打开HelloWorld/entry/src目录下的build-profile.json5文件,添加下图中高亮的第6行(注意位置和内容均要正确)。

image-20250427212639311

  使用快捷键Ctrl + S,或者菜单项File –> Save All保存文件,然后再次点击DevEco Studio中虚拟手机Huawei_Phone右侧的绿色三角形启动按钮。

image-20250427213245624

  稍作等待后,可见虚拟手机上出现Hello Cangjie字样,说明第1个鸿蒙应用程序成功部署至虚拟手机并运行成功了。

image-20250427214034624

  此时,可以点击虚拟手机右侧工具栏顶端的小叉,关闭虚拟手机。

8. DevEco Studio的简单操作

  • File –> Close Project可关闭当前已经打开的项目。
  • File –> Settings可进入设置界面。
  • File –> Open可以打开计算机上已存在的项目。

image-20250427214356865

  在代码编辑页面,左手按住Ctrl键不放,然后滚动鼠标滚轮,可以增大或者减小字体。

image-20250427214512748