HarmonyOS Next 之旅：DevEco Studio 工程创建与模板指南

1 工程模板介绍

DevEco Studio 支持多种品类的应用/元服务开发，预置丰富的工程模板，可以根据工程向导轻松创建适应于各类设备的工程，并自动生成对应的代码和资源模板。同时，DevEco Studio 还提供了多种编程语言供开发者进行应用/元服务开发，包括 ArkTS、JS 和 C/C++。

工程模板支持的开发语言及模板说明如下表所示：

模板名称	说明
Empty Ability	用于 Phone、Tablet、2in1、Car 设备的模板，展示基础的 Hello World 功能。
Native C++	用于 Phone、Tablet、2in1、Car 设备的模板，作为应用调用 C++ 代码的示例工程，界面显示'Hello World'。
[CloudDev]Empty Ability	端云一体化开发通用模板。
[Lite]Empty Ability	用于 Lite Wearable 设备的模板，展示了基础的 Hello World 功能。可基于此模板，修改设备类型及 RuntimeOS，进行小型嵌入式设备开发。
Flexible Layout Ability	用于创建跨设备应用开发的三层工程结构模板。三层工程结构包含 common(公共能力层)、features(基础特性层)、products(产品定制层)。
Embeddable Ability	用于开发支持被其他应用嵌入式运行的元服务的工程模板。

2 创建一个新的工程

当开始开发一个应用/元服务时，首先需要根据工程创建向导，创建一个新的工程，工具会自动生成对应的代码和资源模板。

注意 在运行 DevEco Studio 工程时，建议每一个运行窗口有 2GB 以上的可用内存空间。

2.1 创建和配置新工程

DevEco Studio 提供了基础的工程模板资源，不同模板支持的设备类型、API Version 可能不同，在创建新工程前，提前了解各模板的相关信息。

2.1.1 创建 HarmonyOS 工程

1. 通过如下两种方式，打开工程创建向导界面。

   • 如果当前未打开任何工程，可以在 DevEco Studio 的欢迎页，选择 Create Project 开始创建一个新工程。
   • 如果已经打开了工程，可以在菜单栏选择 File > New > Create Project 来创建一个新工程。

2. 根据工程创建向导，选择创建 Application 或 Atomic Service。再选择需要的 Ability 工程模板，然后单击 Next。

注意 从 API 11 版本开始支持 Atomic Service 元服务工程开发。 Atomic Service 元服务工程暂不支持 Native 开发。

3. 在工程配置页面，需要根据向导配置工程的基本信息。
   • Project name：工程的名称，可以自定义，由大小写字母、数字和下划线组成。
   • Bundle name：标识应用的包名，用于标识应用的唯一性。

注意

• 应用包名要求：
  • 必须为以点号（.）分隔的字符串，且至少包含三段，每段中仅允许使用英文字母、数字、下划线（_），如'com.example.myapplication'。
  • 首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结尾，如'com.01example.myapplication'。
  • 不允许多个点号（.）连续出现，如'com.example..myapplication'。
  • 长度为 7~128 个字符。
• Save location：工程文件本地存储路径，由大小写字母、数字和下划线等组成，不能包含中文字符。
• Compatible SDK：兼容的最低 API Version。
• Module name：模块的名称。
• Device type：该工程模板支持的设备类型。