写给初学者的 HarmonyOS 教程 -- 熟悉 DevEco Studio_harmonyos 开发教程

一、下载与安装 DevEco Studio

要进行 HarmonyOS 开发，必须要切换开发工具了，菊花厂基于 IntelliJ IDEA Community 开源版本打造新打造了一个面向华为终端全场景多设备的一站式集成开发环境（IDE）：DevEco Studio。

进入 DevEco Studio 官网下载。

DevEco Studio提供了 Windows 版本和 Mac 版本选择，可以根据操作系统选择对应的版本进行下载。关于安装的方法以及配套环境设置等，就不在文章里面输出了，大家去官网查看。

根据官方指导创建好第一个应用后，还是要仔细研究一下它的整个工程目录架构，有助于我们后续的开发工作。

二、基本工程目录

2.1 工程级目录

跟传统的 Android 项目目录对比，还是有很大区别的（起码名字上改的面目全非）。

我们详细看一下：

在 AppScope，其中有 resources 文件夹和配置文件 app.json5。

# AppScope > resources

AppScope>resources>base中包含 element 和 media 两个文件夹。

# AppScope > app.json5

app.json5 是应用的全局的配置文件，用于存放应用公共的配置信息，你可以把它理解为类似项目级别的 build.gradle。

{
  "app": {
    "bundleName": "com.example.firstharmonyproject",    // 包名
    "vendor": "example",                                // 应用程序供应商
    "versionCode": 1000000,                             // 用于区分应用版本
    "versionName": "1.0.0",                             // 版本号
    "icon": "$media:app_icon",                          // 对应于应用的显示图标
    "label": "$string:app_name"                         // 应用名
  }
}
1
2
3
4
5
6
7
8
9
10

2.2 模块级目录

# entry > module.json5

module.json5 是模块的配置文件，包含当前模块的配置信息，你可以把它理解为类似应用级别的 build.gradle。

{
  // module对应的是模块的配置信息，一个模块对应一个打包后的 hap 包 ( HarmonyOS Ability Package )，
  // 其中包含了 ability、第三方库、资源和配置文件。
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "deliveryWithInstall": true,
    "installationFree": false,
    "pages": "$profile:main_pages",
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home"
            ]
          }
        ]
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

我们看下 module.json5 的默认配置属性：

# entry > main_pages.json

src/main/resources/base/profile/main_pages.json 文件保存的是页面 page 的路径配置信息，所有需要进行路由跳转的 page 页面都要在这里进行配置。

{
  "src": [
    "pages/Index",
    "pages/Second"
  ]
}
1
2
3
4
5
6