下面介绍DevEco Studio的常用功能。
当开始开发一个HarmonyOS应用时,首先需要根据工程创建向导,创建一个新的工程,工具会自动生成对应的代码和资源模板。
1. 创建和配置新工程
(1)通过如下两种方式打开工程创建向导界面。
①如果当前未打开任何工程,则可以在DevEco Studio的欢迎页选择Create HarmonyOS Project,开始创建一个新工程。
②如果已经打开了工程,则可以选择File→New→New Project命令,创建一个新工程。
(2)根据工程创建向导选择需要进行开发的设备类型,并选择对应的Ability模板,如图2-21所示。
图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会提醒用户可以选择在新的窗口打开工程,或者选择在当前窗口打开工程。
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所示。
图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版本。
图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文件,选中表示创建。
图2-24 Module类型为Java Library
(4)设置新增Ability或HarmonyOS Library的Page Name。若该Module的模板类型为Abili-ty,还需要设置Visible参数,表示该Ability是否可以被其他应用调用。
①勾选(true):可以被其他应用调用。
②不勾选(false):不可被其他应用调用。
(5)单击Finish按钮,等待创建完成后,即可在工程目录中查看和编辑新增的Module。
为防止开发者在删除Module的过程中误将其他模块删除,DevEco Studio提供了统一的模块管理功能,模块必须在模块管理中被移除后才允许删除。
选择File→Project Structure命令,弹出Project Structure对话框,选择Modules,选择需要删除的Module,如图2-25所示,单击“-”按钮,并在弹出的对话框中单击Yes按钮。
然后在工程目录中选中该模块,右击,在弹出的快捷菜单中选择Delete命令,并在弹出的对话框中单击Delete按钮。
图2-25 删除Module