从0到1：在HarmonyOS上构建你的首个ArkTS应用

从 2019 年 HarmonyOS 1.0 的首次亮相，到如今 HarmonyOS NEXT 的不断演进，HarmonyOS 的每一次更新都带来了全新的特性和功能，其发展历程见证了华为在操作系统领域的持续创新与突破。它不仅实现了设备之间的无缝协同，还为开发者提供了统一的开发平台，大大降低了多端开发的门槛，为构建全场景智慧生活奠定了坚实基础。

而 ArkTS（Ark Tsinghua），作为 HarmonyOS 应用开发的关键编程语言，更是为开发者们打开了一扇通往新世界的大门。它基于 TypeScript 扩展而来，融合了声明式 UI 编程范式，让开发者能够以更加简洁、高效的方式构建出富有交互性和流畅性的应用程序。其强大的类型系统、响应式编程模型以及对分布式能力的原生支持，使得开发者能够充分发挥 HarmonyOS 的优势，打造出独具特色的应用体验。

你是否曾好奇，如何才能踏入 HarmonyOS 开发的奇妙世界？如何用 ArkTS 构建出第一个属于自己的应用呢？接下来，就让我们一起揭开这层神秘的面纱，手把手教你构建第一个 ArkTS 应用，带你迈出 HarmonyOS 开发的第一步。无论你是经验丰富的开发老手，还是刚刚入门的编程小白，都能在这个过程中收获满满的乐趣与知识，准备好了吗？让我们即刻启程！

二、开发前的准备

在正式开启 HarmonyOS 应用开发之旅前，我们首先得把开发环境搭建好。这就好比建造房子，得先准备好各种工具和材料。而对于 HarmonyOS 应用开发来说，最重要的工具就是 DevEco Studio。

2.1 下载 DevEco Studio

你可以前往华为开发者联盟官网（https://developer.ha rmony os.co m/cn/devel op/de veco-studi o/ ），这里就像是一个开发者的宝库，提供了 DevEco Studio 的下载资源。官网会根据你的操作系统，贴心地提供对应的版本，不管你用的是 Windows 还是 macOS，都能轻松找到合适的安装包。就像在超市里挑选商品，只要按照分类指引，就能找到自己需要的那一款。

2.2 安装 DevEco Studio

下载完成后，得到的可能是一个压缩包，解压之后就能找到安装文件。以 Windows 系统为例，双击安装文件，安装向导就会像一个热情的向导，引导你完成后续步骤。在安装过程中，它会询问你安装路径，你可以选择默认路径，直接安装在 C 盘；也可以根据自己的喜好，比如安装在 D 盘某个新建的文件夹下，就像给新家具找一个合适的摆放位置。接着，勾选创建桌面快捷方式，这样安装完成后，你就能在桌面上轻松找到它，方便随时启动，就像把常用的物品放在触手可及的地方。之后点击 “Install”，就可以静静等待安装完成啦。

2.3 DevEco Studio 基础设置

安装完成，初次打开 DevEco Studio 时，会弹出一些声明，这就像是一份使用协议，你需要仔细阅读后点击 “Agree” 表示同意。然后会让你选择是否导入设置，因为是第一次使用，没有已有的设置文件，所以直接选择 “不导入配置” ，点击 “ok” 即可。

这时候，它还会检查你的电脑上是否安装了 Node.js 和 ohpm 。Node.js 就像是一个运行 JavaScript 的 “发动机”，而 ohpm 则是 HarmonyOS 应用开发中的包管理工具，它们对于开发来说非常重要。如果你的电脑上还没有安装，也不用担心，DevEco Studio 会提供安装选项，你直接选择 “Install”，并设置好安装位置就行。一般建议将它们安装在和 DevEco Studio 同一个目录下，这样方便管理，就像把相关的物品放在同一个收纳盒里。

接下来是设置 HarmonyOS SDK 存储路径。在 SDK Setup 界面，点击相应按钮，选择一个你觉得合适的存储路径，比如之前安装 DevEco Studio 的文件夹下新建一个专门存放 SDK 的子文件夹。然后一路点击 “Next”，并在弹出的 License Agreement 窗口，阅读 License 协议，同意协议后继续点击 “Next”，确认设置项信息无误后，就可以开始安装了。安装过程可能需要一些时间，你可以喝杯咖啡，耐心等待，就像等待快递包裹送达一样。

2.4 环境变量配置

除了上述步骤，还需要配置一些环境变量。环境变量就像是电脑系统的 “导航地图”，能帮助系统快速找到相关程序和文件。以配置 ohpm 环境变量为例，如果你在安装 DevEco Studio 时，忘记了 ohpm 的安装位置，可以打开 “File -> Settings” 配置界面，在搜索框中输入 “ohpm”，就能查看到安装目录地址。

然后进行系统变量配置，对于 Windows 系统，操作步骤如下：先找到 “我的电脑”，右击选择 “属性”，进入系统界面；接着点击 “高级系统设置”，进入系统属性界面；再点击 “环境变量” 按钮，进入环境变量界面。在这个界面里，首先点击 “新建”，创建 OHPM_HOME 变量，并将 ohpm 程序安装目录地址添加进去；然后选择 Path 变量，点击 “编辑” 按钮，将新建的 OHPM_HOME 变量添加进去，并且后面追加 bin 目录。完成这些操作后，需要重新打开 CMD 命令窗口或者重启 DevEco Studio，这样系统就能识别 ohpm 命令了。

当你完成了以上所有步骤，就意味着你的开发环境已经搭建成功啦！就像准备好了所有的建筑材料和工具，可以正式开始建造你的 HarmonyOS 应用这座 “大厦” 了。

三、创建第一个 ArkTS 工程

当我们把开发环境搭建好之后，就可以着手创建第一个 ArkTS 工程啦。这一步就像是为我们的应用打下基石，只有基础打得牢固，后续的开发工作才能顺利开展。下面，我将以图文并茂的方式，详细地为大家讲解创建工程的每一个步骤。

启动 DevEco Studio：在桌面上找到 DevEco Studio 的图标，双击打开它。如果是首次启动，可能会出现一些初始化的提示和设置，按照提示操作即可。当看到 DevEco Studio 的欢迎界面时，就说明我们已经成功打开了这个强大的开发工具，这个界面就像是一个多功能的操作中心，为我们提供了各种便捷的入口。
新建项目：在欢迎界面中，点击 “Create Project” 按钮，这是创建新项目的入口，就像在游戏中选择 “开始新游戏” 一样。如果已经打开了一个工程，也可以在菜单栏中选择 “File -> New -> Create Project” 来创建新工程。
选择应用开发类型和模板：接下来，会弹出一个 “New Project” 的窗口，在这里我们需要选择应用开发类型和模板。我们选择 “Application” 应用开发类型，这是最常见的应用开发方式，适用于大多数场景。在模板选择中，我们选择 “Empty Ability”，这个模板就像是一个空白的画布，为我们提供了一个最基础的项目结构，让我们可以自由地发挥创意，构建自己的应用。选择好之后，点击 “Next” 按钮，进入下一步配置。
配置工程参数：进入配置工程界面后，这里有几个关键的参数需要我们设置。首先是 “Project name”，这是我们为项目起的名字，就像是给孩子取名字一样，要简洁明了且富有意义，比如我们可以将其命名为 “FirstArkTSApp”。“Bundle name” 是包名，它是应用在系统中的唯一标识，类似于每个人的身份证号码，一般默认生成的包名就可以满足需求，如果有特殊要求，也可以按照命名规则进行修改。“Save location” 是工程保存的路径，你可以选择默认路径，也可以点击 “Browse” 按钮，选择一个你喜欢的文件夹来保存工程，比如在 D 盘新建一个名为 “HarmonyOSProjects” 的文件夹，将工程保存在这里，方便管理和查找。

“Compile SDK” 是编译 SDK 的版本，它决定了我们的应用可以使用哪些系统特性和 API。这里我们选择 “3.0.0 (API 8)” ，当然，你也可以根据实际需求和项目要求选择其他版本，但要注意不同版本之间的兼容性和特性差异。“Language” 毫无疑问选择 “ArkTS”，因为我们要构建的是 ArkTS 应用。其他参数保持默认设置即可，这些默认设置是经过精心设计的，能够满足大多数项目的初始需求。

5. 创建工程：当我们把所有参数都设置好之后，点击 “Finish” 按钮，DevEco Studio 就会开始为我们创建工程。这个过程可能需要一些时间，具体时间取决于你的电脑性能和网络状况。在创建过程中，你可以看到进度条在不断前进，就像在等待一份珍贵的礼物被包装好送到你手中。当进度条完成，工程创建成功后，我们就可以看到一个完整的 ArkTS 工程结构