HarmonyOS Developer DevEco Studio使用指南
DevEco Studio使用指南必读
HUAWEI DevEco Studio是基于IntelliJ IDEA Community开源版本打造,面向全场景多设备,提供一站式的应用/服务集成开发环境(IDE),支持分布式多端开发、分布式多端调测、多端模拟仿真,提供全方位的质量与安全保障。
DevEco Studio同时支持HarmonyOS和OpenHarmony应用/服务开发,但在部分功能(如编程语言、模拟器、签名等)的使用上存在差别,具体请参考表1。
表1 HarmonyOS和OpenHarmony开发主要功能区别
功能 | HarmonyOS | OpenHarmony |
支持的编程语言 | ArkTS、JS、C/C++和Java | ArkTS、JS和C/C++ |
支持的设备类型 | 搭载HarmonyOS系统的终端设备,如Phone(手机)、Tablet(平板)、TV(智慧屏)、Wearable(智能穿戴)、Lite Wearable(轻量级智能穿戴)、Smart Vision(智慧视觉)和Router(路由器) | 搭载OpenHarmony系统的开发板,如RK3568、Hi3516DV300等 |
工程结构 |
| 采用Hvigor编译构建体系,其配置文件为build-profile.json5、package.json |
模拟器 | 支持Local Emulator和Remote Emulator,包括Phone、Tablet、TV等设备 | - |
远程真机 | 支持Phone、Tablet、TV等设备 | - |
编译构建 |
| 使用Hvigor编译构建工具 |
签名 | 使用DevEco Studio自动化签名功能,或通过AppGallery Connect申请签名文件 | 使用DevEco Studio自动化签名功能,或使用SDK包中携带的签名工具进行签名 |
调试 | 支持跨语言、跨设备的分布式调试 | 支持ArkTS/JS与C/C++跨语言调试 |
性能分析 | 支持CPU、内存、网络活动、能耗分析 说明 DevEco Studio 3.1 Beta1版本暂不支持对HarmonyOS设备中运行的应用进行性能分析,如当前需使用该功能,请下载DevEco Studio 3.0 Release版本。我们将在后续版本提供全新支持API 9的性能分析工具,敬请期待。 | 支持CPU、内存分析 |
发布 | 支持发布到AppGallery Connect | 支持OpenHarmony应用/服务发布到应用市场 |
为了避免开发者在使用DevEco Studio的过程中混淆HarmonyOS和OpenHarmony的相关功能,我们将DevEco Studio使用指南分为《DevEco Studio使用指南( HarmonyOS)》和《DevEco Studio使用指南(OpenHarmony)》,请在查阅过程中注意区分。
工具简介
概述
HUAWEI DevEco Studio(获取工具请单击链接下载,以下简称DevEco Studio)是基于IntelliJ IDEA Community开源版本打造,面向全场景多设备,提供一站式的分布式应用开发平台,支持分布式多端开发、分布式多端调测、多端模拟仿真,全方位的质量与安全保障。
作为一款开发工具,除了具有基本的代码开发、编译构建及调测等功能外,DevEco Studio还具有如下特点:
- 高效智能代码编辑:支持ArkTS、JS、C/C++等语言的代码高亮、代码智能补齐、代码错误检查、代码自动跳转、代码格式化、代码查找等功能,提升代码编写效率。更多详细信息,请参考编辑器使用技巧。
- 低代码可视化开发:丰富的UI界面编辑能力,支持自由拖拽组件和可视化数据绑定,可快速预览效果,所见即所得;同时支持卡片的零代码开发,降低开发门槛和提升界面开发效率。更多详细信息,请参考使用低代码开发应用/服务。
- 多端双向实时预览:支持UI界面代码的双向预览、实时预览、动态预览、组件预览以及多端设备预览,便于快速查看代码运行效果。更多详细信息,请参考使用预览器预览应用/服务界面效果。
- 多端设备模拟仿真:提供HarmonyOS本地模拟器、远程模拟器、超级终端模拟器,支持手机、智慧屏、智能穿戴等多端设备的模拟仿真,便捷获取调试环境。更多详细信息,请参考使用模拟器运行应用/服务。
HarmonyOS应用/服务开发流程
使用DevEco Studio,只需要按照如下几步,即可轻松开发并上架一个HarmonyOS应用/服务到华为应用市场。
一、开发准备
下载HUAWEI DevEco Studio,完成开发工具的安装。开发工具安装完成后,还需要设置开发环境,对于绝大多数开发者来说,直接下载SDK即可启动开发;只有少部分开发者,如在企业内部访问Internet受限,需要设置对应的代理服务器才能下载SDK。具体操作请参考配置开发环境。
二、开发应用/服务
DevEco Studio集成了手机、智慧屏、智能穿戴等设备的典型场景模板,可以通过工程向导轻松的创建一个新的工程。
接下来还需要定义应用/服务的UI、开发业务功能等编码工作,可以根据HarmonyOS应用开发概述来查看具体的开发过程,通过查看API接口文档查阅需要调用的API接口。
在开发代码的过程中,可以使用预览器查看应用/服务效果,支持实时预览、动态预览、双向预览等功能,使编码的过程更高效。
三、运行、调试和测试应用/服务
应用/服务开发完成后,可以使用真机进行调试(需要申请调测证书进行签名)或者使用模拟器进行调试,支持单步调试、跨设备调试、跨语言调试、变量可视化等调试手段,使得应用/服务调试更加高效。
HarmonyOS应用/服务开发完成后,在发布到应用/服务市场前,还需要对应用进行测试,主要包括漏洞、隐私、兼容性、稳定性、性能等进行测试,确保HarmonyOS应用/服务纯净、安全,给用户带来更好的使用体验。
四、发布应用/服务
HarmonyOS应用/服务开发、测试完成后,需要将应用/服务发布至应用市场,以便应用市场对应用/服务进行分发,普通消费者可以通过应用市场或服务中心获取到对应的HarmonyOS应用/服务。需要注意的是,发布到华为应用市场或服务中心的HarmonyOS应用/服务,必须使用应用市场颁发的发布证书进行签名。
文档声明
HUAWEI DevEco Studio使用指南配套DevEco Studio 3.1 Beta1最新版本。如使用DevEco Studio其它版本,可能存在文档与产品功能界面、操作不一致的情况,请以实际功能界面为准。
搭建开发环境流程
DevEco Studio支持Windows系统和macOS系统,在开发HarmonyOS应用/服务前,需要配置HarmonyOS应用/服务的开发环境。环境配置流程如下所示:
如上图所示,搭建HarmonyOS应用/服务开发的环境包括软件安装、配置开发环境和运行HelloWorld三个环节,详细的指导请参考:
步骤 | 操作步骤 | 操作指导 | 说明 |
1 | 软件安装 | 安装DevEco Studio。 | |
2 | 配置开发环境 | 网络不能直接访问Internet,可通过设置代理服务器进行访问。 如果无需代理即可访问Internet,可跳过该步骤。 | |
3 | |||
4 | |||
5 | 指定本地已安装的Node.js或在线下载。 | ||
6 | - | ||
7 | 运行HelloWorld | 使用模拟器运行Demo工程,验证环境是否已经配置完成。 | |
8 |
下载与安装软件
DevEco Studio支持Windows和macOS系统,下面将针对两种操作系统的软件安装方式分别进行介绍。
Windows环境
运行环境要求
为保证DevEco Studio正常运行,建议电脑配置满足如下要求:
- 操作系统:Windows10 64位、Windows11 64位
- 内存:8GB及以上
- 硬盘:100GB及以上
- 分辨率:1280*800像素及以上
下载和安装DevEco Studio
- 进入HUAWEI DevEco Studio产品页,单击下载列表右侧的
钮,下载DevEco Studio。
- 下载完成后,双击下载的“deveco-studio-xxxx.exe”,进入DevEco Studio安装向导。在如下界面选择安装路径,默认安装于C:\Program Files路径下,也可以单击Browse...指定其他安装路径,然后单击Next。
- 在如下安装选项界面勾选DevEco Studio后,单击Next,直至安装完成。
- 安装完成后,单击Finish完成安装。
macOS环境
运行环境要求
为保证DevEco Studio正常运行,建议电脑配置满足如下要求:
- 操作系统:macOS 10.15/11.x/12.x/13.x
- 芯片类型:X86、ARM
- 内存:8GB及以上
- 硬盘:100GB及以上
- 分辨率:1280*800像素及以上
说明
ARM架构芯片系列处理器的Mac仅支持创建API 9及以上版本的工程。
下载和安装DevEco Studio
- 进入HUAWEI DevEco Studio产品页,单击下载列表后的
按钮,下载DevEco Studio。
- 下载完成后,双击下载的“deveco-studio-xxxx.dmg”软件包。
- 在安装界面中,将“DevEco-Studio.app”拖拽到“Applications”中,等待安装完成。
- 安装完成后,接下来请根据配置开发环境,检查和配置开发环境。
创建和运行Hello World
DevEco Studio配置开发环境完成后,可以通过运行Hello World工程来验证环境设置是否正确。接下来以创建一个Phone设备的工程为例进行介绍。
创建一个新工程
- 打开DevEco Studio,在欢迎页单击Create Project,创建一个新工程。
- 根据工程创建向导,在HarmonyOS页签,选择“Empty Ability”模板,然后单击Next。关于工程模板的介绍和支持的设备类型,请参考工程模板和开发语言介绍。
- 填写工程相关信息,保持默认值即可,单击Finish。关于各个参数的详细介绍,请参考创建一个新的工程。
说明
默认情况下,新建工程的Compile SDK为9,在设备中运行该工程时,请选择API 9及以上的设备才能运行该工程。
工程创建完成后,DevEco Studio会自动进行工程的同步,同步成功如下图所示:
运行Hello World
Hello World工程可以运行在模拟器中,或者运行在真机设备中。本示例以选择将Hello World工程运行在模拟器中进行说明,如果选择运行在真机设备中,需要先对工程进行签名,然后才能运行在真机设备中,详细指导请参考在Phone设备中运行应用/服务。
DevEco Studio提供远程模拟器和本地模拟器,本示例以远程模拟器为例进行说明。关于本地模拟器的使用请参考使用Local Emulator运行应用/服务。
- 在DevEco Studio菜单栏,单击Tools > Device Manager。
- 在Remote Emulator页签中单击Sign In,在浏览器中弹出华为开发者联盟帐号登录界面,请输入已实名认证的华为开发者联盟帐号的用户名和密码进行登录。
说明
- 推荐使用最新版本Chrome浏览器,如果使用Safari、360等其他浏览器,要取消阻止跨站跟踪和阻止所有Cookie功能。
- 点击Sign in之后,如果DevEco Studio一直显示进度条等待弹框,并未有浏览器弹出并打开开发者联盟登录界面,此时您可以主动切换到浏览器查看相应的界面。更多问题可以查看远程模拟器登录常见问题。
- 登录后,请单击界面的允许按钮进行授权,授权完成后,切换回Device Manager界面。
- 在设备列表中,选择Phone设备P50,并单击
按钮,运行模拟器。
- 单击DevEco Studio工具栏中的
按钮运行工程,或使用默认快捷键Shift+F10(macOS为Control+R)运行工程。
- DevEco Studio会启动应用/服务的编译构建,完成后应用/服务即可运行在模拟器上。
至此,您已成功运行了第一个HarmonyOS应用/服务,接下来,可以通过一个简单的DEMO工程示例,来详细了解HarmonyOS应用/服务的开发过程,具体请参见HarmonyOS应用开发快速入门。