目录

1. 开发环境安装教程

1.1 下载编辑器

1.2 安装

1.3 创建项目

1.4 迁移项目（可选）

1.5 安装中文插件

1.6 安装模拟器

2. 熟悉编辑器的使用

2.1 代码格式化配置

2.2 认识工作区

2.3 预览器

2.4 如何排错

2.5 真机投屏

3.工程目录结构

---

1. 开发环境安装教程

1.1 下载编辑器

DevEcoStudio编辑器下载链接

下载中心 | 华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态

下载对应的版本

• windows
• mac英特尔
• mac Arm

1.2 安装

安装地址

文档中心

1. 参考官方文档安装即可

注意：

1. 安装到非中文目录
2. 安装路径中不要有空格
3. 建议安装到 C 盘以外的盘符（占空间较大）

1.3 创建项目

创建项目教学地址

文档中心

1.4 迁移项目（可选）

链接教学地址

文档中心

• 如果有老项目想要迁移可以参考这个
• 如果是新建的项目不需要

1.5 安装中文插件

1、单击File > Settings > Plugins，选择Installed页签，在搜索框输入“Chinese”，搜索结果里将出现Chinese(Simplified)，在右侧单击Enable，单击OK。

2、在弹窗中单击Restart，重启DevEco Studio后即可生效。

3、重启之后新界面

1.6 安装模拟器

文档中心

注意：

• 确定好路径再安装(比较占空间)
• 模拟器的配置根据实际情况选择

2. 熟悉编辑器的使用

2.1 代码格式化配置

1. 确保安装完毕之后
2. 创建完项目之后建议开个【设置】：

1. 1. 保存自动格式化代码【重新格式化代码】

2.2 认识工作区

• 通过左侧目录找到对应的应用文件，在编辑区进行代码编写，在右侧看预览效果
• 连按【两下shift】，可以快速寻找文件

2.3 预览器

预览器主要用户快速查看应用的界面布局和UI设计效果，它可以再开发过程中即时反映代码修改带来的界面变化，无需编译和安装过程，大大提升了开发的效率

注意：只能预览携带@Entry的注解或者@Preview注解的文件

写完代码我们点击保存会自动更新我们预览器当前界面

预览器是有热更新的

• 原则上写完右侧自动更新
• 如果不自动刷新- 语法错了，编辑器卡住了，可以展开折叠预览器一次，这样代码就会进行编译

也可以点击刷新按钮

关闭热更新

直接修改布局和样式

多端预览

2.4 如何排错

代码时，我们会经常遇到这种情况，右侧出现不能够开启预览器的提示，让我们打开预览器日志看错误

• 解决该问题的思路 1. 按照编辑器提示的，打开预览器日志

• 如果是明确的语法错误或者api错误，编辑器会指出我们代码的行数，我们可以点击提示的代码行，直接跳到对应位置，直接检查代码的问题

• 跳到对应的位置

2.5 真机投屏

DevEco Testing 华为官方推出的应用质检员

1. 可以检测应用（测试用）
2. 提供了一些工具（开发用）

DevEco Testing-应用测试服务平台-华为开发者联盟

3.工程目录结构

ArkTS Stage模型支持API Version 10及以上版本，其工程目录结构如下图所示：

• AppScope > app.json5：应用的全局配置信息。
• entry：应用/元服务模块，编译构建生成一个HAP。

• • src > main > ets：用于存放ArkTS源码。
  • src > main > ets > entryability：应用/元服务的入口。
  • src > main > ets > pages：应用/元服务包含的页面。
  • src > main > resources：用于存放应用/元服务模块所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件的详细说明请参考资源分类与访问。

资源目录	资源文件说明
base>element	包括字符串、整型数、颜色、样式等资源的json文件。每个资源均由json格式进行定义，例如： boolean.json：布尔型 color.json：颜色 float.json：浮点型 intarray.json：整型数组 integer.json：整型 pattern.json：样式 plural.json：复数形式 strarray.json：字符串数组 string.json：字符串值
base>media	多媒体文件，如图形、视频、音频等文件，支持的文件格式包括：.png、.gif、.mp3、.mp4等。
rawfile	用于存储任意格式的原始资源文件。rawfile不会根据设备的状态去匹配不同的资源，需要指定文件路径和文件名进行引用。

• • src > main > module.json5：Stage模型模块配置文件，主要包含HAP的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。具体请参考module.json5配置文件。
  • build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。
  • hvigorfile.ts：模块级编译构建任务脚本。
  • oh-package.json5：描述三方包的包名、版本、入口文件（类型声明文件）和依赖项等信息。

• oh_modules：用于存放三方库依赖信息，包含应用/元服务所依赖的第三方库文件。
• build-profile.json5：应用级配置信息，包括签名、产品配置等。
• hvigorfile.ts：应用级编译构建任务脚本。
• oh-package.json5：描述全局配置，如：依赖覆盖（overrides）、依赖关系重写（overrideDependencyMap）和参数化配置（parameterFile）等。