鸿蒙开发工具 DevEco Studio 3.0 体验与项目介绍

2022-10-24
广东
本文字数：3460 字
阅读完需：约 11 分钟

开发工具介绍

HuaWei DevEco Studio 是基于 IntelliJ IDEA Community 开源版本打造，面向全场景多设备，提供一站式的应用/服务集成开发环境（IDE），支持分布式多端开发、分布式多端调测、多端模拟仿真，提供全方位的质量与安全保障。

DevEco Studio 3.0 支持 HarmonyOS 3.0 的应用及服务开发，提供了代码智能编辑、低代码开发、界面调试双向预览、全新构建工具、模拟器等功能，同时支持 OpenHarmony 应用及服务开发。

支持 Windows 和 Mac 版本，官网点此处。

创建新 HarmonyOS 项目

我们打开 DevEco Studio 3.0 开发工具，可以在界面左侧有四种创建项目的方式：

Create Project ：创建一个新的 HarmonyOS 项目
Open Project：打开一个本地的 HarmonyOS 项目，因为我们还没有建立项目，所以没有本地项目
Get from VCS : 使用版本控制工具导入项目，这种方式支持 Git、Subversion 等多种版本管理工具导入
Import Sample : 导入 HarmonyOS 的案例项目。

创建一个新的 HarmonyOS 项目，可以进入模板选择页面，此处 DevEco Studio 3.0 版本并没有像 2.0 版本那么多的模板，只有三个主选项卡：

Empty Ability：本模板支持 JavaScript、eTS、Java 语言进行开发，用于设备的 Feature Ability 模板。
Native C++：支持 Java、JavaScript、eTS 开发语言，用于 Phone、Car 设备的 Feature Ability 模板
[Lite] Empty Ability：只支持 JavaScript，用于 Lite Wearable、Smart Vision、Router 设备的 Feature Ability 模板

根据工程创建向导，在 HarmonyOS 页签，选择需要的 Ability 工程模板，选择第一个 Create Project：

点右下角的下一步 Next，就能看到如下界面：

Project name：工程的名称，可以自定义，就像变量的命名一样，支持大小写字母、数据和下划线
Project Type: 工程的类型，标识该工程是一个传统方式的需要安装的应用（Application，简称应用），或原子化服务（Atomic service，简称服务）。
Bundle name：软件包名称，默认情况下，应用/服务 ID 也会使用该名称，应用/服务发布时，应用/服务 ID 需要唯一。如果 “Project type” 选择了 Atomic service，则 Bundle name 的后缀名必须是 .hmservice 。
Save location：工程文件本地存储路径，就是你的文件保存到哪里，可以选择默认，文件路径由大小写字母、数字和下划线等组成，不能包含中文字符。
Compile SDK：应用/服务的目标 API Version，在编译构建时，DevEco Studio 会根据指定的 Compile API 版本进行编译打包。
Model：应用支持的模式，API Version 4~8 只支持 FA 模式。
Enable Super Visual：支持低代码开发模式，部分模板支持低代码开发，可选择打开该开关。
Language：开发语言。
Compatible SDK：兼容的最低 API Version。
Device type：该工程模板支持的设备类型。如果你没在这里配置 Device Type，那么可以手动在配置文件 config.json 中添加
Show in service center：是否在服务中心展示。如果 Project type 为 Atomic service，则会同步创建一个 22 宫格的服务卡片模板，同时还会创建入口卡片；如果 Project type 为 Application，则只会创建一个 22 宫格的服务卡片模板。这个选项用来创建在服务中心展示的原子化服务。

此处可以默认，然后点击完成，工具会自动生成示例代码和相关资源，等待工程创建完成。然后会得到如下的界面：

项目目录（API Version 8）

在之前的文章中，只是简单的运行然后看到一个 HelloWorld 的输出结果，这次我们在运行项目之前，先来介绍通常的 HarmonyOS 的项目目录，也就是先看看开发工具自动生成的左侧项目层级目录。

.idea : 这个目录用于存储项目的配置信息，包括历史记录、版本控制信息等，由开发工具自动生成，一般情况下不需要进行修改。
entry: 这个目录是程序中最重要的目录，是应用的主模块，一个应用程序只有一个 Entry 模块。应用程序的代码和资源文件都保存在这个目录下。HarmonyOS 工程模块，编译构建生成一个 Hap 包，entry 目录还包括若干子目录。
.gitignore : 该文件用于在 git 版本控制中选择将哪些文件或目录忽略，使其不用被 git 管理，比如 IDE 自身的配置信息等。
build-profile.json5：应用级配置信息，包括签名、产品配置等。
hvigorfile.js：应用级编译构建任务脚本。

entry 中的子目录 src 中包括 main、ohosTest 目录：

src > main > ets：用于存放 ets 源码
src > main > ets > MainAbility：应用/服务的入口。
src > main > ets > MainAbility > pages：MainAbility 包含的页面。默认创建了一个 index.ets :

@Entry@Componentstruct Index {  @State message: string = 'Hello World'
  build() {    Row() {      Column() {        Text(this.message)          .fontSize(50)          .fontWeight(FontWeight.Bold)      }      .width('100%')    }    .height('100%')  }}

复制代码

src > main > ets > MainAbility > app.ets：承载 Ability 生命周期。
src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。
src > main > config.json：模块配置文件，主要包含 HAP 包的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。

{  "app": {    "bundleName": "com.example.myapplication",    "vendor": "example",    "version": {      "code": 1000000,      "name": "1.0.0"    }  },  "deviceConfig": {},  "module": {    "package": "com.example.myapplication_test",    "name": ".entry_test",    "mainAbility": ".TestAbility",    "deviceType": [      "phone"    ],    "distro": {      "deliveryWithInstall": true,      "moduleName": "entry_test",      "moduleType": "feature",      "installationFree": false    },    "abilities": [      {        "skills": [          {            "entities": [              "entity.system.home"            ],            "actions": [              "action.system.home"            ]          }        ],        "orientation": "unspecified",        "visible": true,        "srcPath": "TestAbility",        "name": ".TestAbility",        "srcLanguage": "ets",        "icon": "$media:icon",        "description": "$string:description_TestAbility",        "formsEnabled": false,        "label": "$string:entry_TestAbility",        "type": "page",        "launchType": "standard"      }    ],    "js": [      {        "mode": {          "syntax": "ets",          "type": "pageAbility"        },        "pages": [          "pages/index"        ],        "name": ".TestAbility",        "window": {          "designWidth": 720,          "autoDesignWidth": false        }      }    ]  }}

复制代码

entry >build-profile.json5：当前的模块信息、编译信息配置项，包括 buildOption、targets 配置等。
entry >hvigorfile.js：模块级编译构建任务脚本。

运行项目

最后介绍如何将 HarmonyOS 程序运行到模拟器上。目前，华为为开发者提供了远程模拟器，可以供开发者在线调试运行程序。远程模拟器为华为后台服务器使用虚拟化技术运行的 HarmonyOS。应用在模拟器中运行不需要签名，可直接运行。

在 DevEco Studio 的菜单栏中选择 “Tools”→“Device Manager” 选项，页面会跳转到华为账号，点击“允许”，然后按照相应的浏览器打开界面进行操作，最后就能回到 DevEco Studio 卡纳都相应的设备模拟器，然后我们选择 P50，点击右上角的运行：

点击后面的绿色三角按钮运行模拟器，就可以看到项目运行成功：

在模拟器启动后，可以直接运行刚才创建的 HarmonyOS 项目到模拟器上。在 DevEco Studio 页面的右上方位置有与运行程序相关的操作区域，如下图所示。最左侧的模块为要运行的模块，新创建的项目中默认生成了 Entry 模块，目录名称为entry ，这里暂时只有这一个模块可选，如果项目中新建了其他 module，这里就可以选择运行对应的模块。