下面介绍DevEco Studio的常用功能。
当开始开发一个HarmonyOS应用时,首先需要根据工程创建向导,创建一个新的工程,工具会自动生成对应的代码和资源模板。
首先,通过如下两种方式打开工程创建向导界面。
· 如果当前未打开任何工程,可以在DevEco Studio的欢迎页选择Create HarmonyOS Project开始创建一个新工程。
· 如果已经打开工程,可以在菜单栏选择File→New→New Project来创建一个新工程。
接着,根据工程创建向导选择需要开发的设备类型,然后选择对应的Ability模板,如图2-21所示。
图2-21 工程创建向导界面
单击Next按钮,进入工程配置阶段,需要根据向导配置工程的基本信息。
· Project Name:工程的名称,可以自定义。
· Project Type:工程的类型,可选Service或Application。
· Package Name:软件包名称,默认情况下,应用ID也会使用该名称,应用发布时,应用ID需要唯一。
· Save Location:工程文件本地存储路径,存储路径中不能包含中文字符。
· Compatible API Version:兼容的SDK最低版本。
· Device Type:设备类型。
· Show in Service Center:是否在服务中心露出,仅在Ability模板存在。
单击Finish按钮,工具会自动生成示例代码和相关资源,等待工程创建完成。
打开现有工程时请注意,待导入的工程文件存储路径不能包含中文字符。打开现有工程包括如下两种方式:
· 如果当前未打开任何工程,可以在DevEco Studio的欢迎页选择Open Project打开现有工程。
· 如果已经打开了工程,可以在菜单栏选择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时,遵循如下原则:
· 若新增Module的设备类型为已有设备,则Module的类型将自动设置为Feature。
· 若新增Module的设备类型为当前还没有创建Module,则Module的类型将自动设置为Entry。
接下来介绍新增Module的步骤。
首先,通过如下两种方法在工程中添加新的Module。
· 方法1:鼠标移到工程目录顶部,右击选择New→Module,开始创建新的Module。
· 方法2:在菜单栏选择File→New→Module,开始创建新的Module。
接着,在New Project Module界面中,选择Module对应的设备类型和模板,如图2-22所示。
图2-22 选择Module对应的设备类型和模板
单击Next按钮,在Module配置页面设置新增Module的基本信息。
· Module类型为Ability或者HarmonyOS Library时,请根据如下内容进行设置,然后单击Next按钮。如图2-23所示。
Application/Library name:新增Module所属的类名称。
Module Name:新增模块的名称。
Module Type:仅在Ability模板存在,工具自动根据设备类型下的模块进行设置。
Package Name:软件包名称,可以单击Edit按钮修改默认包名称,需全局唯一。
Compatible API Version:兼容的SDK最低版本。
Device Type:选择模块的设备类型,如果新建模块的Module Type为Feature,则只能选择该工程原有的设备类型;如果Module Type为Entry,可以选择该Module支持的其他设备类型。
Show in Service Center:是否在服务中心露出,仅在Ability模板存在。
图2-23 Module类型为Ability或者HarmonyOS Library
· Module类型为Java Library时,请根据如下内容进行设置,然后单击Finish按钮完成创建,如图2-24所示。
Library name:Java Library类名称。
Java package name:软件包名称,可以单击Edit按钮修改默认包名称,需全局唯一。
Java class name:class文件名称。
Create.gitignore file:是否自动创建.gitignore文件,勾选表示创建。
图2-24 Module类型为Java Library
接着,设置新增Ability或HarmonyOS Library的Page Name。若该Module的模板类型为Ability,则还需要设置Visible参数,表示该Ability是否可以被其他应用调用。
· 勾选(true):可以被其他应用调用。
· 不勾选(false):不能被其他应用调用。
最后,单击Finish按钮,等待创建完成后,可以在工程目录中查看和编辑新增的Module。
为防止开发者在删除Module的过程中误将其他的模块删除,DevEco Studio提供了统一的模块管理功能,需要先在模块管理中移除对应的模块,才允许删除。
在菜单栏中选择File→Project Structure→Modules,选择需要删除的Module,单击 按钮,并在弹出的对话框中单击Yes,如图2-25所示。
图2-25 删除Module
在工程目录中选中该模块,右击,选中Delete,并在弹出的对话框中单击Delete即可。