鸿蒙前端开发之DevEco Studio创建和运行项目

举报
tea_year 发表于 2025/05/27 14:33:19 2025/05/27
【摘要】 “工欲善其事,必先利其器”。在对harmonyOS有了一个初步认知之后,我们使用DevEco Studio来创建一个项目,把项目运行起来,先从整体上来了解一下harmonyOS项目的整体结构以及开发工具的基本使用。作为一名鸿蒙系统开发者,你可能会遇到这样一个问题:如何通过DevEco Studio快速创建并配置一个ArkTS项目?本文将详细解答这个问题,帮助你从零开始,一步步创建并运行一个简...

“工欲善其事,必先利其器”。在对harmonyOS有了一个初步认知之后,我们使用DevEco Studio来创建一个项目,把项目运行起来,先从整体上来了解一下harmonyOS项目的整体结构以及开发工具的基本使用。

作为一名鸿蒙系统开发者,你可能会遇到这样一个问题:如何通过DevEco Studio快速创建并配置一个ArkTS项目?本文将详细解答这个问题,帮助你从零开始,一步步创建并运行一个简单的ArkTS项目。

使用DevEco Studio创建项目操作步骤

1.1 配置开发环境

在开发之前我们需要做一些准备工作

  • 成为开发者之前,我们需要先注册账号,并实名(使用远程模拟器需要),实名分为“个人实名”和“企业实名”。个人开发者做个人实名人证即可。注册地址:https://developer.harmonyos.com/cn/home,该页面右上角点击注册,完成实名即可。
  • 下载开发工具,下载地址:https://developer.harmonyos.com/cn/develop/deveco-studio,DevEco Studio内置了OpenJDK,版本为1.8
  • 下载nodejs,如果你是使用js的方式进行开发,需要下载nodejs,如果你仅用Java开发,可以先不装nodejs

在实名完成并且下载了开发工具后,安装DevEco Studio,一路next即可。完成安装先不要打开。由于harmonyOS的应用基于gradle进行构建,因此请自行下载gradle并配置环境变量。

1.2 下载SDK

配置完成后,打开DevEco Studio,会提示下载harmonySDK,如下图:

如果不需要更改SDK的路径,直接Next即可。如果想更改SDK的路径点击Cancel,点击Cancel后自己配置SDK路径的方式如下:

  1. 在菜单栏点击Configure > Settings(Mac系统为Configure > Preferences,快捷键Command+,),打开Settings配置界面。
  2. 进入Appearance & Behavior > System Settings > HarmonyOS SDK菜单界面,点击Edit按钮,设置HarmonyOS SDK存储路径。

红框中的地址选择你想要保存SDK的路径,下边的SDK Platforms列出了可用的SDK版本,可以根据需要下载。其中native通常是用来写C++或者设备开发需要的,js和Java则对应了应用开发的两种形式,如果你使用Java开发,可以只下载Java的,使用js开发同理。也可以两个都安装。选择完点击Apply,然后OK即可,入下图:

1.1 新建项目

  • 双击桌面上的图标,启动DevEco Studio
  • 首次打开会出现下面的弹窗,保持默认选项
  • 保持默认勾选,单击"Agree"(同意)按钮
  • 单击【Create Project】(创建项目)
  • 选择【Empty Ability】(空应用), 之后单击【Next】

如果不是首次打开DevEco Studio, 则【文件】【新建】【新建项目】
项目名称一定要以字母开头,包含字母、数字、下划线
保存的地址路径中不能出现中文,最后字母,可以结合数字,下划线
单击【Finish】按钮后,项目创建成功

1.2 启用中文化插件

【File】【Settings...】
【Plugins】【Installed】
单击"Enable"启用中文化插件,之后单击"Apply"应用, "ok"关闭窗口
单击【Restart】重启,

1.3 打开入口文件

【项目目录】->【entry】->【src】->【main】->【ets】->【pages】->【Index.ets】
@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  
  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
    }
    .height('100%')
    .width('100%')
  }
}

1.4 在预览器中预览

  • 确认Index.ets是当前文件
  • 单击右侧标签【预览器】

1.5 设置代码换行

【文件】【设置】【编辑器】【常规】

1.6 设置VSCode风格的快捷键

  • 【文件菜单】【设置】
安装插件【VSCode Keymap】
选择VSCode风格的快捷键
  1. 如果初始化项目报错

错误类型:

在创建项目时报以下错误 ,或者在创建项目时无反应

解决方案

修改idea.properties文件即可
  1. 理解入口文件基础代码

!!!!注意:
以下概念不需要现在完全明白,只要会用,随着知识体系的深入,就会深刻理解

  • 以@开头的标识符为装饰器,标识不同的功能
  • @Entry 标识当前文件为入口文件,只能有一个入口文件
  • @Component标识当前文件是一个组件
  • struct 定义组件的结构 Index为组件名
  • @State 定义组件的状态,当状态改变时,会触发视图更新
  • build(){} 构建组件, build内部只能有一个唯一的根组件
@Entry
@Component
struct Index {
  @State message: string = 'Hello World';

  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
    }
    .height('100%')
    .width('100%')
  }
}

至此,您已成功运行了第一个应用,接下来可以通过一个简单的DEMO工程示例,来详细了解应用的开发过程。

总结

在开发过程中,你可能会遇到一些常见问题,如编译错误、运行时错误等。以下是一些解决这些问题的建议:

  • 编译错误:检查代码中的语法错误和类型错误。确保所有变量和方法的声明和使用都符合ArkTS的规范。
  • 运行时错误:使用DevEco Studio的调试工具,设置断点并逐步执行代码,查看变量的值和程序的执行流程。这有助于定位和解决问题。
  • 性能优化:利用ArkTS的性能优化特性,如异步编程、装饰器和泛型等,提高应用的运行效率。

总之,通过DevEco Studio创建和开发ArkTS项目是一个相对简单且高效的过程。希望本文的详细解答能帮助你在鸿蒙系统开发的道路上更进一步。如果你有任何疑问或需要进一步的帮助,欢迎随时提问。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。