鸿蒙初体验：手把手教你构建首个HarmonyOS应用（ArkTS）_鸿蒙harmonyos跨平台开发+arkts实战项目-优快云博客

本文链接：https://blog.youkuaiyun.com/xiaoyingxixi1989/article/details/148826836

一、准备启航：开发前的必备准备

在科技飞速发展的当下，HarmonyOS 凭借其独特的分布式理念和卓越的跨设备协同能力，正逐渐在操作系统领域崭露头角，成为众多开发者关注的焦点。随着 HarmonyOS 生态的日益壮大，学习构建 HarmonyOS 应用不仅能让我们紧跟技术潮流，还能为我们打开一扇通往全新开发领域的大门，获得更多的职业发展机会和广阔的创新空间。

“工欲善其事，必先利其器”，要开启 HarmonyOS 应用开发之旅，首先需要准备好一系列开发工具，而其中最为关键的就是 DevEco Studio 和 HarmonyOS SDK。下面，让我们一步步来完成这些准备工作。

安装 DevEco Studio：DevEco Studio 是华为官方为 HarmonyOS 应用开发量身打造的一站式集成开发环境（IDE），它集成了代码编辑、编译、调试、测试等丰富功能，能极大地提升我们的开发效率。我们可以前往华为 HarmonyOS 官方开发者网站（https://developer.har monyo s.com /cn/d evelo p/dev eco-s tudio），根据自己的操作系统（Windows、macOS 或 Linux）选择对应的版本进行下载。下载完成后，双击安装包，按照安装向导的提示进行操作，如选择安装路径、勾选所需组件等。安装过程中，请确保网络连接稳定，以顺利完成相关组件的下载与安装。此外，需要注意安装路径不要包含中文或特殊字符，以免在后续使用中出现问题。

配置 HarmonyOS SDK：HarmonyOS SDK（软件开发工具包）是开发 HarmonyOS 应用必不可少的工具，它包含了开发所需的各种库文件、API 文档、模拟器等。当我们首次运行 DevEco Studio 时，会弹出配置向导，其中就包含了 HarmonyOS SDK 的配置选项。在配置过程中，我们可以选择 SDK 的安装路径，同样要注意路径的简洁性，避免中文和特殊字符。如果 DevEco Studio 没有自动检测到 SDK，我们也可以手动进行添加。具体操作是在 DevEco Studio 的 “File” 菜单中选择 “Settings”（Windows/Linux）或 “DevEco Studio” 菜单中的 “Preferences”（macOS），在弹出的设置窗口中找到 “Appearance & Behavior” -> “System Settings” -> “SDKs”，点击 “+” 号，选择 “HarmonyOS SDK”，然后浏览到 SDK 的下载位置进行安装。在下载 SDK 时，耐心等待下载完成，期间确保网络稳定，避免下载中断导致安装失败。同时，注意查看 SDK 的版本信息，尽量选择与当前开发需求和 DevEco Studio 版本相匹配的 SDK 版本，以确保开发过程的兼容性和稳定性。

完成上述工具的安装与配置后，我们就成功搭建好了 HarmonyOS 应用开发的基础环境，为后续的开发工作做好了充分准备。

二、搭建舞台：创建 ArkTS 工程

当我们完成了开发环境的搭建，就如同为一场精彩的演出准备好了华丽的舞台，接下来便可以着手创建我们的 ArkTS 工程，开启真正的开发之旅。

启动 DevEco Studio 并创建项目：打开已经安装好的 DevEco Studio，在欢迎界面中，我们可以看到 “Create Project” 的选项，点击它即可开始创建新的工程。如果已经打开了一个工程，也可以通过菜单栏中的 “File” -> “New” -> “Create Project” 来进行新建项目的操作。

选择工程类型和模板：在弹出的工程创建向导中，左侧视图提供了 “Application” 和 “Atomic Service” 两种选择。“Application” 用于创建普通应用程序，而 “Atomic Service” 则是创建元服务应用，这里我们以创建普通应用程序为例进行讲解。右侧视图中展示了各种 Ability 工程模板，这些模板为我们提供了不同的项目结构和基础代码，方便我们根据项目需求快速搭建框架。对于初学者来说，“Empty Ability” 模板是一个很好的选择，它提供了一个简洁的基础结构，便于我们理解和进行后续的代码编写。选择 “Empty Ability” 模板后，点击 “Next” 进入下一步。

配置工程参数：接下来的页面需要我们配置工程的相关参数，这些参数对于工程的创建和后续的开发都至关重要。具体参数如下：

- Project name：工程的名称，我们可以根据项目内容自定义一个有意义的名称，比如 “FirstHarmonyApp”，需注意名称由大小写字母、数字和下划线组成。

- Bundle name：标识应用的包名，它用于确保应用在系统中的唯一性，包名必须为以点号（.）分隔的字符串，且至少包含三段，每段中仅允许使用英文字母、数字、下划线（_），例如 “com.example.firstharmonyapp”。首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结尾，长度为 7 - 128 个字符。