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

Posted 2022-10-26

开发工具介绍

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 的案例项目。

1. 创建一个新的 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 模板

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

3. 点右下角的下一步​​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 宫格的服务卡片模板。这个选项用来创建在服务中心展示的原子化服务。

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

项目目录（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
@Component
struct 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，这里就可以选择运行对应的模块。

总结

到了本文的总结时刻了，一番体验下来，发现 DevEco Studio 3 和 2 在界面上还是有一点区别，但是整体的结构差不多。此文，本文还比较项目的介绍了经典 HarmonyOS 应用的目录结构，最后非常容易的在远程模拟器处运行了 HelloWorld 项目。

希望本文能对你有所帮助，如果喜欢本文，可以点个关注。这里是宇宙之一粟，下一篇文章见！ 宇宙古今无有穷期，一生不过须臾，当思奋争。

参考链接：

• ​​DevEco文档​​