下载掌阅APP，畅读海量书库
立即打开
本节首先介绍HarmonyOS NEXT开发工具DevEco Studio的下载与安装，然后介绍其基本功能和使用方法，最后，介绍ArkTS Stage模型的工程目录结构。
HarmonyOS NEXT开发专属的IDE（集成开发系统）是HUAWEI DevEco Studio（简称DevEco Studio）。作为一款专为HarmonyOS应用及服务开发者设计的集成开发环境，DevEco Studio提供了全面的开发、调试和部署支持。
读者可以在Harmonyos官方网站免费下载和使用DevEco Studio。
DevEco Studio支持Windows系统和macOS系统，在开发应用/服务前，需要配置应用/服务的开发环境。环境配置可参考如图1-1所示的流程。
下面将分别介绍在Windows和macOS系统中安装DevEco Studio的操作方法。
图1-1 环境配置流程
1．Windows环境下的安装
在Windows环境下，用户可以通过华为开发者联盟官网下载DevEco Studio的安装包，并根据向导完成安装过程。为保证DevEco Studio正常运行，建议计算机配置满足如表1-1所示的条件。
表1-1 Windows环境下安装DevEco Studio的计算机配置
安装DevEco Studio的具体步骤如下：
01 下载完成后，双击下载的deveco-studio-xxxx.exe，进入DevEco Studio安装向导。在打开的对话框中选择安装路径，默认安装于C:\Program Files路径下，也可以单击Browse...按钮指定其他安装路径；然后单击Next按钮，如图1-2所示。
02 在安装选项界面勾选DevEco Studio复选框后，单击Next按钮，直至安装完成，如图1-3所示。
图1-2 安装DevEco Studio 1
图1-3 安装DevEco Studio 2
03 最后，单击Finish按钮完成安装，如图1-4所示。
图1-4 安装DevEco Studio 3
注意 Windows环境下同样需要配置Node.js环境，可以参考“2. macOS环境下的安装”中的“开发环境配置”中的相关步骤进行操作。
2．macOS环境下的安装
macOS用户可以按照Windows环境下的安装步骤安装DevEco Studio。为保证DevEco Studio能够在macOS系统中正常运行，建议计算机配置满足如表1-2所示的要求。
表1-2 macOS环境下安装DevEco Studio的计算机配置
1）安装DevEco Studio
在安装界面中，将DevEco-Studio.app拖曳到Applications中，等待安装完成，如图1-5所示。
图1-5 安装DevEco Studio
2）开发环境配置
开发软件安装完成后，还需要进行环境配置才可以使用，具体步骤如下：
01 运行已安装的DevEco Studio，首次使用时选择Do not import settings，单击OK按钮。
02 安装Node.js。单击Local选项，可以指定本地已安装的Node.js（IDE级别）路径位置，如果本地没有合适的版本，可以单击Install选项，选择下载源和存储路径后进行在线下载；然后单击Next按钮进入下一步，如图1-6所示。
图1-6 开发环境配置1
03
在SDK Setup界面，单击
按钮，设置HarmonyOS SDK存储路径，然后单击Next按钮进入下一步，如图1-7所示。
图1-7 开发环境配置2
04 确认设置项的信息，单击Next按钮开始安装，如图1-8所示。
图1-8 开发环境配置3
05 配置完成后，单击Finish按钮，界面会进入DevEco Studio欢迎页。
接下来，我们就可以使用DevEco Studio来构建工程项目了。
安装完成后，用户可以开始探索DevEco Studio的基本功能，如创建Hello World项目，这是每个开发者入门编程的第一步。
让我们一起来创建第一个Hello World吧！
01 打开DevEco Studio，在欢迎页单击Create Project选项，创建一个新工程。
02 根据工程创建向导，选择创建Application或Atomic Service。选择Empty Ability模板，然后单击Next按钮，如图1-9所示。
图1-9 DevEco Studio的基本使用1
03 填写工程相关信息，然后单击Finish按钮，如图1-10所示。
图1-10 DevEco Studio的基本使用2
注意 单击Finish按钮之后，DevEco Studio会自动进行工程的同步。等待工程同步完成之后就可以在界面右侧看到预览效果图了，如图1-10所示。创建工程页面的各项目参数解释如表1-3所示。
表1-3 创建工程页面的参数解释
在掌握了DevEco Studio的基本操作后，我们将进入实践阶段，通过手机运行一个简单的Hello World应用，来直观体验HarmonyOS应用的开发流程和运行效果。
01 将搭载HarmonyOS系统的手机与计算机连接起来。
02 单击File→Project Structure...→Project→Signing Configs，勾选Support HarmonyOS和Automatically generate signature复选框，单击界面提示中的Sign In按钮，使用华为账号登录。等待自动签名完成后，单击OK按钮即可，如图1-11所示。
图1-11 配置项目选项
03
系统会自动生成工程代码，然后在编辑窗口右上角的工具中单击
按钮运行，如图1-12所示。手机上就会出现“Hello World”的运行效果，如图1-13所示。
图1-12 自动生成的工程代码
图1-13 运行结果
至此，我们已成功运行了第一个应用。这虽然是一个入门案例，但却让我们迈出了成为HarmonyOS开发者的第一步。接下来，我们将循序渐进地介绍原生鸿蒙开发的一系列知识点。
本小节将详细介绍ArkTS Stage模型的工程目录结构，重点要掌握该工程目录的构成及各部分的作用。
首先，看一下我们创建的第一个项目的目录结构，如图1-14所示。
图1-14 目录结构
目录结构中各部分的功能和作用说明如下：
· AppScope > app.json5：应用的全局配置信息。
· entry：应用/服务模块，编译构建生成一个HAP。
提示 HAP（HarmonyOS Ability Package）是鸿蒙操作系统中的一种应用包格式，用于打包和分发应用程序。它与Android中的APK文件类似，包含应用程序的所有必要组件，如代码、资源、配置文件等。在鸿蒙系统中，HAP文件用于安装和运行应用程序。
· src > main > ets：用于存放ArkTS源码。
· src > main > ets > entryability：应用/服务的入口。
· src > main > ets > pages：应用/服务包含的页面。
· src > main > resources：用于存放应用/服务模块所用到的资源文件，如图形、多媒体、字符串、布局文件等。其相关目录及说明如表1-4所示。
提示 在实际的开发过程中，我们通常会在media目录下存放一些静态的媒体资源；在element目录下存放开发过程中的一些公有变量，比如全局的字体颜色、背景颜色以及一些文本信息等；当使用Web组件加载页面时，会在rawfile目录下存放一些HTML页面，用于本地的加载。
表1-4 resources（资源）目录文件说明
· src > main > module.json5：Stage模型模块配置文件，主要包含HAP的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。
· entry > build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。
· entry > hvigorfile.ts：模块级编译构建任务脚本。
· entry >oh-package.json5：配置第三方包声明文件的入口及包名。
· oh_modules：用于存放第三方库依赖信息，包含应用/服务所依赖的第三方库文件。
· build-profile.json5：应用级配置信息，包括签名、产品配置等。
· hvigorfile.ts：应用级编译构建任务脚本。
DevEco Studio采用了ArkTS Stage模型，以帮助开发者更好地组织和管理项目文件。了解该工程目录结构对于高效开发至关重要。