2.4 DevEco Studio功能简介

下面介绍DevEco Studio的常用功能。

2.4.1 创建新的工程

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

1. 创建和配置新工程

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

①如果当前未打开任何工程，则可以在DevEco Studio的欢迎页选择Create HarmonyOS Project，开始创建一个新工程。

②如果已经打开了工程，则可以选择File→New→New Project命令，创建一个新工程。

（2）根据工程创建向导选择需要进行开发的设备类型，并选择对应的Ability模板，如图2-21所示。

（3）单击Next按钮，进入工程配置阶段，需要根据向导配置工程的基本信息。

①Project Name：工程名称，可以自定义。

②Package Name：软件包名称。默认情况下，应用ID也会使用该名称。应用发布时，应用ID需要唯一。

③Save Location：工程文件本地存储路径，存储路径中不能包含中文字符。

④Compatible SDK：兼容的SDK版本。

（4）单击Finish按钮，工具会自动生成示例代码和相关资源，等待工程创建完成。

2. 打开现有工程

打开现有工程时应注意，待导入的工程文件存储路径不能包含中文字符。打开现有工程包括如下两种方式。

（1）如果当前未打开任何工程，则可以在DevEco Studio的欢迎页选择Open Project，打开现有工程。

（2）如果已经打开了工程，则可以选择File→Open命令打开现有工程。

打开现有工程时，DevEco Studio会提醒用户可以选择在新的窗口打开工程，或者选择在当前窗口打开工程。

2.4.2 添加Module

Module是HarmonyOS应用的基本功能单元，包含源代码、资源文件、第三方库及应用清单文件，每一个Module都可以独立进行编译和运行。一个HarmonyOS应用通常会包含一个或多个Module，因此可以在工程中创建多个Module，每个Module分为Ability和Library（HarmonyOS Library和Java Library）两种类型。

以HarmonyOS工程为例，在一个App中，对于同一类型设备有且只有一个Entry Module，其余Module的类型均为Feature。因此，在创建一个类型为Ability的Module时，应遵循如下原则。

（1）若新增Module的设备类型为已有设备，则Module的类型将自动设置为Feature。

（2）若新增Module的设备类型为当前还没有创建Module，则Module的类型将自动设置为Entry。

新增Module

（1）通过如下两种方法在工程中添加新的Module。

方法1：将鼠标指针移到工程目录顶部并右击，在弹出的快捷菜单中选择New→Module命令，开始创建新的Module。

方法2：选择File→New→Module命令，开始创建新的Module。

（2）在New Project Module对话框中选择Module对应的设备类型和模板，如图2-22所示。

（3）单击Next按钮，在Module配置页面设置新增Module的基本信息。

①当Module类型为Ability或者HarmonyOS Library时，应根据如下内容进行设置，完成后单击Next按钮，如图2-23所示。

a. Application/Library name：新增Module所属的类名称。

b. Module Name：新增模块的名称。

c. Module Type：仅Module类型为Ability时存在，工具自动根据设备类型下的模块进行设置。

d. Package Name：软件包名称，可以单击Edit按钮修改默认包名称，需全局唯一。

e. Compatible SDK：兼容的SDK版本。

②当Module类型为Java Library时，应根据如下内容进行设置，完成后单击Finish按钮，完成创建，如图2-24所示。

a. Library name：Java Library类名称。

b. Java package name：软件包名称，可以单击Edit按钮修改默认包名称，需全局唯一。

c. Java class name：class文件名称。

d. Create.gitignore file：是否自动创建.gitignore文件，选中表示创建。

（4）设置新增Ability或HarmonyOS Library的Page Name。若该Module的模板类型为Abili-ty，还需要设置Visible参数，表示该Ability是否可以被其他应用调用。

①勾选（true）：可以被其他应用调用。

②不勾选（false）：不可被其他应用调用。

（5）单击Finish按钮，等待创建完成后，即可在工程目录中查看和编辑新增的Module。

2.4.3 删除Module

为防止开发者在删除Module的过程中误将其他模块删除，DevEco Studio提供了统一的模块管理功能，模块必须在模块管理中被移除后才允许删除。

选择File→Project Structure命令，弹出Project Structure对话框，选择Modules，选择需要删除的Module，如图2-25所示，单击“-”按钮，并在弹出的对话框中单击Yes按钮。

然后在工程目录中选中该模块，右击，在弹出的快捷菜单中选择Delete命令，并在弹出的对话框中单击Delete按钮。