03 应用开发快速上手

1 目的

本文档适用于OpenHarmony应用开发的初学者。通过构建一个简单的具有页面跳转/返回功能的应用，快速了解应用开发工程目录的主要文件，熟悉OpenHarmony应用开发流程。

提示

本文档仅为快速开发教程，如需详细的应用开发教程，请移步应用开发栏查看更多关于应用开发的内容。

2 应用开发工具准备

2.1 安装 DevEco Studio

下载安装包的方式共有两种，一种是官网下载，另一种为百度网盘下载

推荐安装版本：DevEco Studio 5.1.0 Release 1.1）官网下载链接：下载中心 - DevEco Studio

注意

进入上述链接下载 DevEco Studio 需登录华为账户才可进去下载，如未登录点击链接将自动跳转至登录界面。

1.2）百度网盘下载安装包：百度网盘提供的 DevEco Studio 版本为 5.1.0.828

备注

DevEco Studio 安装包路径：
ShimetaPi开源鸿蒙资料>M4-R1>02-软件工具>OpenHarmony>DevEco Studio>devecostudio-windows-5.1.0.828SP1.zip

2）解压 devecostudio-windows-5.1.0.828SP1.zip 打开 devecostudio-windows-5.1.0.828SP1 -> devecostudio-windows-5.1.0.828 目录 建议存放路径短一些，防止后续操作可能会存在路径1024字符异常

3）运行 deveco-studio-5.1.0.828SP1.exe，等跳出来安装提示，点击【下一步】

4）选择安装的位置，哪个盘剩余容量大就放哪个盘，示例放置在 E 盘，注意要有一个空文件夹，一般会自动补充，如果没有补充，需要重新新建一个空文件夹，不然会报错。选择完成后，点击【下一步】

5）安装选项，全部勾选便于后期开发，然后点击【下一步】

6）点击【安装】，等待安装完成

7）有如下显示则表示安装完成

8）这时可以在桌面看到 DevEco Studio 的快捷方式。

3 DevEco Studio 创建工程

1）双击打开桌面的 DevEco Studio 快捷方式图标 2）我们能看到他的一些声明，这里直接点击【Agree】代表我同意即可

3）然后就会进入下图界面，创建一个工程，进入工程界面

4）选择 Application 应用开发（本文以应用开发为例，Atomic Service 对应为原子化服务开发），选择模板 "Empty Ability"，点击 Next 进行下一步配置

5）进入配置工程界面，修改一下工程存放路径，工程名字，和兼容 SDK 版本，其他参数保持默认设置即可，点击 Finish 创建工程注意：M4-R1 开发板的板端 API 版本为 API 12，故 Compatible SDK 选择 5.0.0(12)

6）工程初始化界面如下，等到下方Build状态栏中输出红框内语句，即表示初始化结束：

4 DevEco Studio 配置 SDK

1）在菜单栏选择 File -> Settings

2）进入 Settings 窗口，选择 OpenHarmony SDK，选择 SDK 安装位置，然后勾选 API Version 12，下载关于 API Version 12 的所有相关内容，再点击【Apply】进行下载。

因为我们已经下载过 API Version 12 所以用 API Version 11为例

3）点击【Apply】后会跳出 Confirm Change 弹窗，点击【OK】

4）等待 SDK 下载完成

5）当【Finish】变亮时，证明下载完成，点击【Finish】

5 DevEco Studio 配置中文插件

1）在菜单栏选择 File -> Settings

2）选择 Plugins，然后在 Plugins 中选择 Installed

3）在搜索框输入 "Chinese"，然后勾选 Chinese(Simplified)，然后点击【OK】

4）弹出 DevEco Studio and Plugin Updates 弹窗，点击【Restart】，重启应用，即可看到工程界面变为中文

6 将程序烧录到板卡中

6.1 默认程序功能介绍

工程同步完成后，在 "Project" 窗口，点击 "entry > src > main > ets > pages" ，打开 "Index.ets" 文件，可以看到应用工程的默认程序页面由 Text 组件组成。该应用实现的功能为：点击 Hello World 文本组件就会切换为 Welcome。 "Index.ets" 文件的示例如下：

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

  build() {
    RelativeContainer() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(() => {
          this.message = 'Welcome';
        })
    }
    .height('100%')
    .width('100%')
  }
}

6.2 签名文件配置

1）将搭载 OpenHarmony 系统的真机 M4-R1 与电脑通过 USB 转 Type-C 线与 OTG 口连接（设备默认为调试模式）查看工具界面会显示连接设备 M4-R1 的序列号，如下图所示：

2）打开工程级 build-profile.json5，修改里面的 products 为以下代码：

"products": [
	{
		"name": "default",
		"signingConfig": "default",
		"compileSdkVersion": 12,
		"compatibleSdkVersion": 12,
		"targetSdkVersion": 12,
		"runtimeOS": "OpenHarmony",
		"buildOption": {
			"strictMode": {
				"caseSensitiveCheck": true,
				"useNormalizedOHMUrl": true
			}
		}
	}
]