鸿蒙（HarmonyOS）--开发环境搭建

目录

一、DevEco Studio 概述

二、下载与安装

（一）软件下载

（二）软件安装

三、环境配置

（一）系统要求

（二）配置开发环境

四、JDK 安装与配置

（一）下载 JDK

（二）安装 JDK

（三）配置系统环境

五、不同版本特点及适用场景

（一）工程模板和开发语言

（二）版本兼容性

（三）新特性体验

六、鸿蒙项目结构

（一）工程介绍

（二）资源文件组织

七、模拟器调试与真机连接

（一）模拟器安装与使用

（二）真机连接调试

八、总结与展望

一、DevEco Studio 概述

DevEco Studio 作为 HarmonyOS 应用及服务开发的集成开发环境，具有至关重要的地位和广泛的应用前景。

在当今科技飞速发展的时代，HarmonyOS 作为一种面向全场景多设备的智能操作系统，正逐渐在市场上崭露头角。而 DevEco Studio 则是开发者们进入 HarmonyOS 生态的关键工具。它为开发者提供了一个功能强大、便捷高效的开发平台，使得开发者能够轻松地创建、开发、编译、调试和发布 HarmonyOS 应用及服务。

DevEco Studio 的重要性不言而喻。首先，它提供了一站式的开发服务，大大提高了开发效率。从项目创建到最终发布，开发者可以在一个环境中完成所有的开发步骤，无需在不同的工具之间切换，节省了大量的时间和精力。其次，它支持多种编程语言，包括 Java、XML、C/C++、JS、CSS 和 HML 等，满足了不同开发者的需求。无论你是擅长哪种编程语言的开发者，都可以在 DevEco Studio 中找到适合自己的开发方式。此外，DevEco Studio 还提供了丰富的开发工具和功能，如代码编辑、调试、模拟器、预览器等，帮助开发者更好地完成开发任务。

DevEco Studio 的广泛应用也体现在多个方面。一方面，它适用于各种不同类型的设备开发，包括手机、平板、电视、智能穿戴等。开发者可以使用同一套代码，在不同的设备上进行开发和调试，实现代码的最大化重用。这不仅提高了开发效率，还降低了开发成本。另一方面，DevEco Studio 也为企业和个人开发者提供了广阔的发展空间。企业可以利用 DevEco Studio 开发出适用于多种设备的应用和服务，满足不同用户的需求，提高企业的竞争力。个人开发者也可以通过开发 HarmonyOS 应用，展示自己的技术实力，获得更多的机会和收益。

例如，在智能穿戴设备领域，开发者可以使用 DevEco Studio 开发出具有个性化功能的应用，如健康监测、运动记录等。这些应用可以与智能穿戴设备完美结合，为用户提供更加便捷、高效的服务。在智能家居领域，DevEco Studio 也可以帮助开发者开发出智能家电控制、家庭安防等应用，实现家居设备的智能化管理。

此外，DevEco Studio 还不断更新和完善，为开发者提供更好的开发体验。例如，最新版本的 DevEco Studio 可能会增加新的功能和工具，优化开发流程，提高开发效率。同时，华为也会不断推出新的技术和产品，与 DevEco Studio 相结合，为开发者提供更多的开发资源和支持。

总之，DevEco Studio 作为 HarmonyOS 应用及服务开发的集成开发环境，具有重要的地位和广泛的应用前景。它为开发者提供了强大的开发工具和功能，帮助开发者更好地完成开发任务，实现自己的技术梦想。随着 HarmonyOS 生态的不断发展壮大，DevEco Studio 也将发挥越来越重要的作用。

二、下载与安装

（一）软件下载

DevEco Studio 可以从华为开发者联盟进行下载。首先，打开华为开发者联盟官网，点击 “一探究竟”，在最下面的工具中找到 “DevEco Studio” 点击进入，然后点击首页的 “立即下载”。此时，根据不同的操作系统选择适用版本。

对于 Windows 系统，可选择 Windows 64 位版本。例如，在 Windows 10 /11 64 位系统下，内存 16GB 及以上、硬盘 100GB 及以上、分辨率 1280*800 像素及以上的环境能保证 DevEco Studio 正常运行。

对于 macOS 系统，macOS (X86) 12/13/14 以及 macOS (ARM) 12/13/14 版本均可安装。同样，要求内存 8GB 及以上、硬盘 100GB 及以上、分辨率 1280*800 像素及以上。

（二）软件安装

1. Windows 系统安装步骤：

• • 下载完成后，双击下载的 “deveco-studio-xxxx.exe” 安装文件。在欢迎界面点击 “next”。

• • 选择安装路径（默认一般为 “C:\Program Files”，可以点击 “browse…” 自定义路径） ，然后点击 “next”。

• • 在安装选项界面勾选 DevEco Studio 后，单击 Next，直至安装完成。安装完成后，单击 Finish 完成安装。

1. macOS 系统安装步骤：

• • 在安装界面中，将 “DevEco-Studio.app” 拖拽到 “Applications” 中，等待安装完成。

DevEco Studio 提供开箱即用的开发体验，将 HarmonyOS SDK、Node.js、Hvigor、OHPM、模拟器平台等进行合一打包，简化了安装配置流程。HarmonyOS SDK 已嵌入 DevEco Studio 中，无需额外下载配置。如需进行 OpenHarmony 应用开发，可通过 Settings > OpenHarmony SDK 页签下载 OpenHarmony SDK。

三、环境配置

（一）系统要求

对于 Windows 操作系统，为保证 DevEco Studio 正常运行，建议电脑配置满足以下要求：操作系统为 Windows 10/11 64 位，内存 8GB 及以上，硬盘 100GB 及以上，分辨率 1280*800 像素及以上。

对于 macOS 操作系统，macOS (X86) 10.15/11/12/13 以及 macOS (ARM) 11/12/13 版本均可安装。同样需要内存 8GB 及以上、硬盘 100GB 及以上、分辨率 1280*800 像素及以上。

（二）配置开发环境

1. 安装 Node.js 与 ohpm：

• • Node.js 应用于开发 JS 应用和运行预览器功能，在开发 HarmonyOS 应用过程中，若涉及 JS 开发则必备此软件。DevEco Studio 可指定本地已安装的 Node.js/ohpm，也可在线下载。Node.js 版本要求为 v14.19.1 及以上，且低于 v17.0.0；对应的 npm 版本要求为 6.14.16 及以上。

• • 如果本地没有合适的版本，可以选择 Install 按钮，选择下载源和存储路径后，进行在线下载。

1. 下载 HarmonyOS SDK：

• • DevEco Studio 提供 SDK Manager 统一管理 SDK 及工具链。启动 DevEco Studio，工具会自动检查本地路径下是否存在 HarmonyOS SDK，如果不存在，会弹出向导提示下载。

• • 默认情况下，SDK 会下载到 user 目录下，也可以指定对应的存储路径（不支持中文字符），然后点击 Next。默认会下载最新版本的 Java SDK 和 Toolchains。

• • 在弹出的 License Agreement 窗口，点击 Accept 开始下载 SDK。如果本地已有 SDK 包，请选择本地已有 SDK 包的存储路径，DevEco Studio 会增量更新 SDK 及工具链。

1. 设置网络代理：

• • 如果网络不能直接访问 Internet，需要通过代理服务器才可以访问。这种情况下，需要设置 DevEco Studio 代理，来访问和下载外部资源。

• • 运行已安装的 DevEco Studio，首次使用，请选择 Do not import settings，点击 OK。根据 DevEco Studio 欢迎界面的提示，点击 Setup Proxy，或者在欢迎页点击 Configure > Settings > Appearance&Behavior > System Settings > HTTP Proxy 进入 HTTP Proxy 设置界面。

• • 设置 DevEco Studio 的 HTTP Proxy 信息。HTTP 配置项，设置代理服务器信息。Host name：代理服务器主机名或 IP 地址。Port number：代理服务器对应的端口号。No proxy for：不需要通过代理服务器访问的 URL 或者 IP 地址（地址之间用英文逗号分隔）。

• • Proxy authentication 配置项，如果代理服务器需要通过认证鉴权才能访问，则需要设置。否则，请跳过该配置项。Login：访问代理服务器的用户名。Password：访问代理服务器的密码。Remember：勾选，记住密码。

• • 配置完成后，点击 Check connection，输入网络地址（如：https://developer.harmonyos.com），检查网络连通性。提示 “Connection successful” 表示代理设置成功。点击 OK 按钮完成 DevEco Studio 代理配置。

四、JDK 安装与配置

（一）下载 JDK

JDK 有多个版本可供选择，不同版本有其特点和适用场景。例如，JDK1.8 是一个较为稳定的版本，被广泛应用于各种项目中。下载地址为：https://www.oracle.com/java/technologies/javase-downloads.html。在下载页面中，需要注意选择适合自己操作系统的版本。同时，下载前可能需要登录 Oracle 账户。

JDK19 作为较新的版本，可能包含一些新的特性和优化。同样在上述下载地址中可以找到 JDK19 的下载选项。下载时需根据自身需求和项目要求选择合适的版本。

（二）安装 JDK

安装 JDK 的步骤如下：

1. 双击下载的 JDK 安装文件，开始安装过程。

1. 根据自己的习惯选择安装路径，建议安装路径中不要出现中文、标点符号和空格等特殊字符。

1. 按照安装向导的提示逐步进行操作，直到安装完成。

（三）配置系统环境

在桌面通过 “此电脑” 属性进行环境变量配置的方法如下：

1. 右键点击 “此电脑”，选择 “属性”，在弹出的对话框中选择 “高级系统设置”，然后点击 “高级” 选项卡下的 “环境变量”。

1. 在系统变量中点击 “新建”，创建一个名为 “JAVA_HOME” 的变量，变量值为 JDK 的安装路径。例如，如果 JDK 安装在 “C:\Program Files\Java\jdk1.8.0_201”，则将该路径作为变量值。

1. 继续在系统变量中点击 “新建”，创建一个名为 “CLASSPATH” 的变量，变量值为 “.;% JAVA_HOME%\lib;% JAVA_HOME%\lib\tools.jar”。

通过以上步骤，就完成了 JDK 的安装与配置，为后续的开发工作做好了准备。

五、不同版本特点及适用场景

（一）工程模板和开发语言

DevEco Studio 支持包括手机、平板、车机、智慧屏、智能穿戴、轻量级智能穿戴和智慧视觉设备的 HarmonyOS 应用 / 服务开发，预置了丰富的工程模板。它提供了多种编程语言供开发者进行 HarmonyOS 应用 / 服务开发，如 Java、JS、eTS 和 C/C++。这些语言各有特点，满足不同开发者的需求。

Java 是一种通用编程语言，具有广泛的应用场景和强大的生态系统。在 DevEco Studio 中，Java 可用于开发应用的后端逻辑。例如，对于需要进行复杂业务逻辑处理的项目，Java 的稳定性和强大的类库支持使其成为一个不错的选择。

JS（JavaScript）主要用于在 Web 浏览器中添加交互性和动态性。在 DevEco Studio 中，JS 可以用于开发应用程序的前端逻辑。对于注重用户界面交互和快速开发的项目，JS 的灵活性和丰富的前端开发工具生态能够提高开发效率。

eTS（Enhanced TypeScript）是一种强类型的编程语言，适用于开发高性能的 UI 界面和复杂的业务逻辑。它具有简洁的语法和强大的类型系统，能够提高代码的可读性和可维护性。例如，在开发需要高度定制化 UI 的项目中，eTS 的声明式编程风格可以快速构建出美观的界面。

C/C++ 是一种低级别的语言，被广泛用于系统开发和嵌入式设备。在 DevEco Studio 中，C/C++ 可以用于开发底层逻辑和与硬件交互的应用程序。对于需要高性能计算和直接访问硬件资源的项目，C/C++ 的高效性和底层控制能力是不可或缺的。

（二）版本兼容性

DevEco Studio 3.0 和 3.1 在 HarmonyOS SDK 和 OpenHarmony SDK 支持的 API 版本、开发语言、设备类型等方面存在一定的差异。

在 HarmonyOS SDK 方面，DevEco Studio 3.0 支持 API 4 至 8，不同的 API 版本支持不同的开发语言和设备类型。例如，API 8 支持 eTS、JS 语言，暂支持的设备是 Phone。而 DevEco Studio 3.1 在 HarmonyOS SDK 方面有了一些新的增强，如 Ability 框架新增 Stage 开发模型，增强了应用的运行管理能力；ArkUI 开发框架增强了声明式 Canvas/XComponent 组件能力等。

在 OpenHarmony SDK 方面，DevEco Studio 3.0 的 Beta4 版本支持 API 8 和 9。其中，API 9 支持 eTS 语言，暂支持的设备是 Default、Tablet。DevEco Studio 3.1 在 OpenHarmony SDK 方面也有一些改进，例如可能会进一步优化对 Stage 模型的支持。

此外，在开发语言方面，两个版本都支持 Java、JS、eTS 和 C/C++ 等多种语言，但在具体的使用场景和功能上可能会有所不同。在设备类型方面，DevEco Studio 3.1 可能会支持更多的设备类型或者对现有设备类型的开发提供更好的支持。

（三）新特性体验

1. 同时支持 HarmonyOS 和 OpenHarmony 应用 / 服务开发是 DevEco Studio 的一个重要新特性。在创建项目的过程中，开发者可以切换 Tab 选择创建 HarmonyOS 或 OpenHarmony 的项目。HarmonyOS 的项目目前提供了多个模板，OpenHarmony 的项目也提供了一些模板，为开发者提供了更多的选择。

1. HarmonyOS 应用 / 服务的低代码开发是另一个新特性。新增支持 eTS 语言的低代码开发功能，可通过可视化的界面进行 HarmonyOS 应用的开发；同时低代码开发功能还新增支持服务卡片的开发。开发者可以选择默认模板，然后选择 Compile SDK 8，打开 Enable Super Visual 和 Show in service center，体验低代码开发的便捷性。

1. 针对 Hvigor 工程（API Version 8 和 9），支持开发者在 hvigorfile.js 文件中自定义编译构建任务。虽然目前具体作用还不太明确，但这为开发者提供了更多的灵活性和定制化选项，有待开发者进一步探索和实践。

六、鸿蒙项目结构

（一）工程介绍

鸿蒙项目的工程结构主要分为工程级目录和模块级目录。

工程级目录：

• AppScope 中存放应用全局所需要的资源文件。其中，app.json5是应用的全局配置文件，用于存放应用公共的配置信息，如包名、应用程序供应商、版本号、图标、应用名等。AppScope 下的 resources 目录为其服务，存放全局资源，包括 base 目录和 media 目录等。base 目录下的 element 文件夹存放公共的字符串、布局文件等资源，例如string.json保存字符串配置，media 目录存放全局公共的多媒体资源文件，如app_icon.png。

• oh_modules 存放工程依赖包。

• build-profile.json5是工程级配置信息，包括签名、产品配置等。

• hvigorfile.ts是工程级编译构建任务脚本。

• oh-package.json5是工程级依赖配置文件，用于记录引入包的配置信息。

模块级目录：

• entry是应用的主模块，存放 HarmonyOS 应用的代码、资源等。

• src目录是源代码存放目录，其中 main 文件夹是核心代码所在处。main 文件夹包含 ets、configuration 和 resources 等目录。

• • ets 目录存放 ArkTs 源代码，其中entryability文件夹专门处理逻辑代码以及生命周期管理，pages文件夹存放 UI 界面相关代码文件。

• • configuration 里面存放有关模块的配置，如build-profile.json5是模块级配置信息，包括编译构建配置项；hvigorfile.ts文件是模块级构建脚本；oh-package.json5是模块级依赖配置信息文件。

• • resources 目录使用频率仅次于 ets，里面放的都是图片、字符串、颜色、样式等资源。与工程级目录下的 resources 结构类似，按照 main 和 ohosTest 目录结构进行组织，如 main 的目录结构中，base 目录下的 element 文件存放颜色、字符等 json 文件，media 目录存放多媒体文件，profile 目录存放页面配置，如main_pages.json文件保存的是页面 page 的路径配置信息，所有需要进行路由跳转的 page 页面都要在这里进行配置。

• module.json5是模块的配置文件，包含当前模块的配置信息。一个模块对应一个打包后的 hap 包，hap 包全称是 HarmonyOS Ability Package，其中包含了 ability、第三方库、资源和配置文件。

（二）资源文件组织

鸿蒙项目中资源文件的组织方式较为清晰和规范。资源文件主要存放在工程级目录的 AppScope 和模块级目录的 resources 中。

资源文件包括两大类目录，一类为 base 目录与限定词目录，另一类为 rawfile 目录。

base 目录与限定词目录：

• 按照两级目录形式来组织，目录命名必须符合规范，以便根据设备状态去匹配相应目录下的资源文件。base 目录是默认存在的目录，当应用的 resources 资源目录中没有与设备状态匹配的限定词目录时，会自动引用该目录中的资源文件。限定词目录需要开发者自行创建，目录名称由一个或多个表征应用场景或设备特征的限定词组合而成，包括语言、文字、国家或地区、横竖屏、设备类型和屏幕密度等六个维度，限定词之间通过下划线（_）或者中划线（-）连接。

• 二级子目录为资源目录，用于存放字符串、颜色、布尔值等基础元素，以及媒体、动画、布局等资源文件。例如，element 目录用于存放字符串、颜色等基础元素的 json 文件；media 目录存放媒体、动画等文件；profile 目录存放页面索引配置等。

rawfile 目录：

• 支持创建多层子目录，目录名称可以自定义，文件夹内可以自由放置各类资源文件。rawfile 目录的文件不会根据设备状态去匹配不同的资源，通过指定文件路径和文件名来引用。

在鸿蒙项目中，资源的获取和管理主要通过以下方式：

• 对于应用资源，通过 “ rawfile (‘filename’)" 形式引用，其中，filename 为 rawfile 目录下文件的相对路径，文件名需要包含后缀。

• 资源管理模块根据当前 configuration：语言、区域、横竖屏、Mcc（移动国家码）和 Mnc（移动网络码）、Device capability（设备类型）、Density（分辨率）提供获取应用资源信息读取接口。例如，从 API Version9 开始，Stage 模型通过 context 获取 resourceManager 对象的方式后，可直接调用其内部获取资源的接口，无需再导入包。此方式 FA 模型不适用，FA 模型还需要先导入包，再调用 getResourceManager 接口获取资源对象。

七、模拟器调试与真机连接

（一）模拟器安装与使用

DevEco Studio 提供了强大的模拟器功能，方便开发者在没有真机的情况下进行应用调试。以下是下载安装本地模拟器的方法：

1. 打开 DevEco Studio，在菜单栏中选择 “Tools”（工具）>“Device Manager”（设备管理器）。

1. 在设备管理器窗口中，点击 “Local Emulator”（本地模拟器）选项卡，然后点击 “New Emulator”（新建模拟器）按钮。

1. 在弹出的创建模拟器窗口中，可以选择不同的设备类型、API 版本等参数。根据自己的需求进行选择后，点击 “Next”（下一步）。

1. 等待模拟器下载和安装完成。这个过程可能需要一些时间，具体取决于网络速度和计算机性能。

安装完成后，可以在设备管理器中看到已创建的模拟器。要在模拟器上运行工程，可以按照以下步骤操作：

1. 在 DevEco Studio 中打开要调试的项目。

1. 点击工具栏中的 “Run”（运行）按钮，或者在菜单栏中选择 “Run”>“Run 'app'”。

1. 在弹出的设备选择窗口中，选择已创建的模拟器。

1. 等待应用在模拟器上启动。启动过程中，可以在 DevEco Studio 的控制台窗口中查看应用的启动日志和调试信息。

（二）真机连接调试

连接真机进行调试可以让开发者更真实地测试应用的性能和功能。以下是连接真机进行调试的步骤和注意事项：

步骤：

1. 打开开发者选项：在手机设置菜单中点击【关于手机】选项。连续点击 7 次【版本号】进入开发者模式。返回设置菜单，在系统和更新中即可找到【开发人员选项】。

1. 开启 USB 调试：打开 “设置”—“系统更新”—“开发者选项”，下拉找到 “USB 调试” 并勾选。

1. 允许通过 HDB 连接设备：打开手机设置搜索 hdb ，允许通过 HDB 连接设备，开启。

1. 排除 adb：任务管理器里面也看一下呢，有没有 adb.exe，有的话结束一下。

1. 把手机连接上电脑：当手机提示 “是否允许 USB 调试” 时，点击 “确定”。在开发工具的设备中会自动选择当前连接手机。

1. 签名配置：选择开发工具的 “文件”—“Project Structure...”，打开项目配置。选择 “Project”—“Signing Configs”—“default”，点击页面中的 “Sign In” 按钮跳转到华为开发者登录页面完成登录，并允许开发工具访问。回到开发工具，可以修改相关信息，也可以直接默认。点击 “OK” 完成配置。

注意事项：

1. 不同手机型号可能在操作步骤上略有差异，例如有些手机在开启开发者选项和 USB 调试的路径可能不同。

1. 确保手机驱动已正确安装，否则可能无法正常连接手机。

1. 在连接过程中，如果遇到问题，可以参考华为官方文档或在开发者社区寻求帮助。

八、总结与展望

DevEco Studio 作为 HarmonyOS 应用及服务开发的集成开发环境，在鸿蒙生态系统的建设中发挥着举足轻重的作用。它为开发者提供了一站式的开发服务，涵盖了从项目创建、代码编写、调试到发布的各个环节，极大地提高了开发效率。

在鸿蒙开发的过程中，DevEco Studio 面临着一些挑战。例如，不同版本的兼容性问题需要开发者在选择版本时仔细考虑项目需求和技术特点。同时，对于一些新特性的探索和应用也需要开发者不断学习和实践，以充分发挥 DevEco Studio 的优势。

然而，尽管面临挑战，DevEco Studio 的未来发展潜力巨大。随着 HarmonyOS 生态的不断壮大，DevEco Studio 将持续更新和完善，为开发者提供更多强大的功能和工具。例如，未来可能会进一步优化低代码开发功能，使开发者能够更加高效地构建应用界面；加强对多设备协同开发的支持，实现更加无缝的跨设备应用开发体验；提升性能优化工具的能力，帮助开发者打造更加流畅和高效的应用。

此外，随着技术的不断进步，DevEco Studio 还有望与人工智能、大数据等领域相结合，为开发者提供更加智能化的开发辅助功能。例如，通过智能代码推荐和错误检测，提高开发效率和代码质量；利用大数据分析用户行为和需求，为应用开发提供更加精准的方向。

总之，DevEco Studio 在鸿蒙开发中具有重要的地位和作用。虽然面临一些挑战，但随着技术的不断发展和创新，它的未来发展潜力巨大。相信在开发者和华为的共同努力下，DevEco Studio 将为 HarmonyOS 生态的繁荣做出更大的贡献。