![鸿蒙HarmonyOS应用开发从入门到精通](https://wfqqreader-1252317822.image.myqcloud.com/cover/849/46727849/b_46727849.jpg)
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所示。
![](https://epubservercos.yuewen.com/A3A972/26001476301725106/epubprivate/OEBPS/Images/Figure-0034-0040.jpg?sign=1739247360-v1OsG8yY30KK9RXQtRUTxN2VY7ph9SGM-0-0928ce58cc970a7abba0b2706ee5a9a6)
图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所示。
![](https://epubservercos.yuewen.com/A3A972/26001476301725106/epubprivate/OEBPS/Images/Figure-0035-0041.jpg?sign=1739247360-5aNwoqqiTxzDcOtiLWhEw24KqVFr9Yz5-0-0b5d456d330bc6ca14d335420051d609)
图2-22 选择Module对应的设备类型和模板
(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版本。
![](https://epubservercos.yuewen.com/A3A972/26001476301725106/epubprivate/OEBPS/Images/Figure-0036-0042.jpg?sign=1739247360-lAm9HXDKtZZy4faCPA01PKp3rVZiz9H9-0-27c684dd2a22758d8311fe38d02c9494)
图2-23 Module类型为Ability或者HarmonyOS Library
②当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文件,选中表示创建。
![](https://epubservercos.yuewen.com/A3A972/26001476301725106/epubprivate/OEBPS/Images/Figure-0036-0043.jpg?sign=1739247360-DJyzcNaSMrIuXy1FRERZYAY5GCmyd4mD-0-ac7001d53548dd6f8c12e27df610394d)
图2-24 Module类型为Java Library
(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按钮。
![](https://epubservercos.yuewen.com/A3A972/26001476301725106/epubprivate/OEBPS/Images/Figure-0037-0044.jpg?sign=1739247360-xWFneTZTqARsHi3ToMJrL6YltXjIc5r8-0-6e36d1420b198148410c735a07d2730f)
图2-25 删除Module