程序开发与运维

DevEco Studio

Stone大约 7 分钟

DevEco Studio

简介

DevEco Studio （获取工具请单击链接下载open in new window）是基于 IntelliJ IDEA Community 开源版本打造，为运行在 HarmonyOS 系统上的应用和服务（以下简称应用/服务）提供一站式的开发平台。

作为一款开发工具，除了具有基本的代码开发、编译构建及调测等功能外，DevEco Studio 还具有如下特点：

  • 高效智能代码编辑：支持 ArkTS、JS、C/C++ 等语言的代码高亮、代码智能补齐、代码错误检查、代码自动跳转、代码格式化、代码查找等功能，提升代码编写效率。
  • 多端双向实时预览：支持 UI 界面代码的双向预览、实时预览、动态预览、组件预览以及多端设备预览，便于快速查看代码运行效果。
  • 多端设备模拟仿真：提供 HarmonyOS 本地模拟器，支持 Phone 等设备的模拟仿真，便捷获取调试环境。
  • DevEco Profiler 性能调优：提供实时监控能力和场景化调优模板，便于全方位的设备资源监测，采集数据覆盖多个维度，为开发者带来高效、直通代码行的调优体验。

开始

安装 DevEco Studio

为保证 DevEco Studio 正常运行，建议电脑配置满足如下要求：

  • 操作系统：Windows 10 64 位、Windows 11 64 位
  • 内存：16 GB 及以上
  • 硬盘：100 GB 及以上
  • 分辨率：1280*800 像素及以上

下载完成后，双击下载的 “devecostudio-xxxx.exe”，进入 DevEco Studio 安装向导。在如下界面选择安装路径，默认安装于 C:\Program Files 路径下，也可以单击 浏览（B）... 指定其他安装路径，然后单击 Next。

image-20241103202018024

在如下安装选项界面勾选 DevEco Studio 后，单击 Next，直至安装完成。

image-20241103202112839

安装完成后，单击 Finish 完成安装。

image-20241103202626421

说明

  • DevEco Studio 提供开箱即用的开发体验，将 HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化 DevEco Studio 安装配置流程。
  • HarmonyOS SDK 已嵌入 DevEco Studio 中，无需额外下载配置。HarmonyOS SDK可以在 DevEco Studio 安装位置下 DevEco Studio\sdk 目录中查看。如需进行 OpenHarmony 应用开发，可通过 Settings > OpenHarmony SDK 页签下载 OpenHarmony SDK。

安装完成后，启动 DevEco Studio，可以在欢迎页面单击 Diagnose 进行诊断，识别开发环境是否完备。如果已经打开了工程开发界面，也可以在菜单栏单击 Help > Diagnostic Tools > Diagnose Development Environment 进行诊断。

image-20241103202735513

DevEco Studio 开发环境诊断项包括电脑的配置、网络的连通情况、依赖的工具是否安装等。如果检测结果为未通过，请根据检查项的描述和修复建议进行处理。

构建第一个 ArkTS 应用

创建 ArkTS 工程

若首次打开 DevEco Studio，请点击 Create Project 创建工程。如果已经打开了一个工程，请在菜单栏选择 File > New > Create Project 来创建一个新工程。

image-20241103202839765

选择 Application 应用开发（本文以应用开发为例，Atomic Service 对应为元服务开发），选择模板 “Empty Ability”，点击 Next 进行下一步配置。

image-20241103202931830

进入配置工程界面，Compatible SDK 选择 “5.0.0(12)”，其他参数保持默认设置即可。

image-20241103203105361

点击 Finish，工具会自动生成示例代码和相关资源，等待工程创建完成。

工程创建完成后，点击右上角的 Project Structure，在 Signing Configs 页面点击 Sign In，进行自动签名配置：

image-20241103203256813

会跳转到浏览器进行登录，登录后进行确认，然后在 DevEco Studio 中点击 Agree：

image-20241103203413547

目录结构

img

  • AppScope > app.json5：应用的全局配置信息，详见 app.json5 配置文件open in new window。
  • entry：HarmonyOS 工程模块，编译构建生成一个 HAP 包。
    • src > main > ets：用于存放 ArkTS 源码。
    • src > main > ets > entryability：应用/服务的入口。
    • src > main > ets > entrybackupability：应用提供扩展的备份恢复能力。
    • src > main > ets > pages：应用/服务包含的页面。
    • src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见资源分类与访问open in new window。
    • src > main > module.json5：模块配置文件。主要包含 HAP 包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见 module.json5 配置文件open in new window。
    • build-profile.json5：当前的模块信息 、编译信息配置项，包括 buildOption、targets 配置等。
    • hvigorfile.ts：模块级编译构建任务脚本。
    • obfuscation-rules.txt：混淆规则文件。混淆开启后，在使用 Release 模式进行编译时，会对代码进行编译、混淆及压缩处理，保护代码资产。详见开启代码混淆open in new window。
    • oh-package.json5：用来描述包名、版本、入口文件（类型声明文件）和依赖项等信息。
  • oh_modules：用于存放三方库依赖信息。
  • build-profile.json5：工程级配置信息，包括签名 signingConfigs、产品配置 products 等。其中 products 中可配置当前运行环境，默认为 HarmonyOS。
  • hvigorfile.ts：工程级编译构建任务脚本。
  • oh-package.json5：主要用来描述全局配置，如：依赖覆盖（overrides）、依赖关系重写（overrideDependencyMap）和参数化配置（parameterFile）等。

构建第一个页面

使用文本组件。在 “Project” 窗口，点击 “entry > src > main > ets > pages”，打开 “Index.ets” 文件，进行页面的编写。

// 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%')
  }
}

添加按钮。在默认页面基础上，添加一个 Button 组件，作为按钮响应用户点击，从而实现跳转到另一个页面。

// Index.ets
@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        // 添加按钮，以响应用户点击
        Button() {
          Text('Next')
            .fontSize(30)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
          top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
      }
      .width('100%')
    }
    .height('100%')
  }
}

在编辑窗口右上角的侧边工具栏，点击 Previewer，打开预览器。第一个页面效果如下图所示：

image-20241103203642956

构建第二个页面

新建第二个页面文件。在 “Project” 窗口，打开 “entry > src > main > ets”，右键点击 “pages” 文件夹，选择 “New > Page > Empty Page”，Page Name 为 “Second”，点击 “Finish” 完成第二个页面的创建。

image-20241103203757808

会自动在 “entry > src > main > resources > base > profile” 的 main_pages.json 文件中的 “src” 下配置第二个页面的路由 “pages/Second”：

{
  "src": [
    "pages/Index",
    "pages/Second"
  ]
}

可以看到文件目录结构如下：

img

参照第一个页面，在第二个页面添加 Text 组件、Button 组件等，并设置其样式。

// Second.ets
@Entry
@Component
struct Second {
  @State message: string = 'Hi there'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        Button() {
          Text('Back')
            .fontSize(25)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
          top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
      }
      .width('100%')
    }
    .height('100%')
  }
}

实现页面间的跳转

在第一个页面中，跳转按钮绑定 onClick 事件，点击按钮时跳转到第二页。“Index.ets” 文件的示例如下：

// Index.ets
// 导入页面路由模块
import { router } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        // 添加按钮，以响应用户点击
        Button() {
          Text('Next')
            .fontSize(30)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
          top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
        // 跳转按钮绑定onClick事件，点击时跳转到第二页
        .onClick(() => {
          console.info(`Succeeded in clicking the 'Next' button.`)
          // 跳转到第二页
          router.pushUrl({ url: 'pages/Second' }).then(() => {
            console.info('Succeeded in jumping to the second page.')

          }).catch((err: BusinessError) => {
            console.error(`Failed to jump to the second page. Code is ${err.code}, message is ${err.message}`)
          })
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

在第二个页面中，返回按钮绑定 onClick 事件，点击按钮时返回到第一页。“Second.ets” 文件的示例如下：

// Second.ets
// 导入页面路由模块
import { router } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Second {
  @State message: string = 'Hi there'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        Button() {
          Text('Back')
            .fontSize(25)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
          top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
        // 返回按钮绑定onClick事件，点击按钮时返回到第一页
        .onClick(() => {
          console.info(`Succeeded in clicking the 'Back' button.`)
          try {
            // 返回第一页
            router.back()
            console.info('Succeeded in returning to the first page.')
          } catch (err) {
            let code = (err as BusinessError).code; 
            let message = (err as BusinessError).message; 
            console.error(`Failed to return to the first page. Code is ${code}, message is ${message}`)
          }
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

打开 Index.ets 文件，点击预览器中的 img 按钮进行刷新。效果如下图所示：

img

上次编辑于:
贡献者: stonebox