本文首先通过一个简单HAP(HarmonyOS Ability Package)包的开发,展示了采用JS扩展的类Web开发范式(简称“类Web开发范式”)进行鸿蒙应用前端开发的基本流程;然后将开发出来的HAP安装到小熊派BearPi-HM_Micro_small开发板上,对应用进行了测试。
小贴士:
带图形界面的OpenHarmony应用程序包括 前端 和 后端 两个部分:
(1)应用程序前端
应用程序前端主要负责图形界面的构建和展示,向上通过图形界面与用户进行交互,向下通过ArkUI框架的JS(JavaScript)接口或eTS(Extend TypeScript)接口与应用程序的后端进行交互。
OpenHarmony应用程序前端支持两种开发范式:基于JS扩展的类Web开发范式(简称“类Web开发范式”);基于TS扩展的声明式开发范式(简称“声明式开发范式”)。
(2)应用程序后端
应用程序后端负责实现应用程序的实际功能,向上通过ArkUI框架的C++接口与应用程序的前端进行交互,向下可以通过HDF驱动框架提供的接口与设备驱动进行交互。
参考文档:
DevEco Studio官方文档
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/versions_overview-0000001233344736
小熊派
https://gitee.com/bearpi/bearpi-hm_micro_app/blob/master/docs/hello_word.md
1、开发板:小熊派BearPi-HM_Micro_small开发板,OpenHarmony 3.0。
2、设备开发IDE:DevEco Device Tool (Release) v3.0.0
参考:《搭建小熊派BearPi-HM_Micro_Small的纯Ubuntu开发环境》
3、应用开发IDE:DevEco Studio 3.0 Beta2
参考:《安装DevEco Studio 3.0 Beta2》
1、启动DevEco Studio
,在首页左侧的导航栏里选择Create Project
,选择[lite]Empty Ability
模板,单击Next
,进入下一步。
2、 按照下图输入项目名称(Project name)、选择项目类型(Project type)、输入包名(Bundle name)、选择项目存放路径(Save location)、选择开发语言(Language、选择兼容的API版本(Compatible API version)、选择设备类型(Device type);然后,单击Finish
,开始创建项目。
包名的格式一般为:com.公司名称.项目名称
3、 耐心等待项目创建完毕。项目创建完毕后,如下图所示:
在这一步,我们需要对鸿蒙应用包的结构、鸿蒙应用工程的目录结构,以及鸿蒙应用工程中的文件有一个基本的了解,建议去看看我写的另外一篇文章《OpenHarmony APP开发基础》。
还有一点需要注意: DevEco Studio在创建项目的时候,默认指定在编译项目时使用最新的SDK版本,这就需要你的硬件设备中也使用这个最新的SDK版本才能运行应用程序,否则你需要到鸿蒙应用工程中找到两个名为build.gradle
的文件,将文件中的compileSdkVersion
的值改成你的设备中使用的SDK的版本号,比如:在本例中改成了6
。
在本例中,应用程序前端开发采用的是基于JS扩展的类Web开发范式(简称“类Web开发范式”),也就是经典的HML(类HTML)、CSS、JavaScript三段式开发方式。在这种开发方式中,使用HML标签文件进行图形界面的布局搭建;使用CSS文件对图形界面的样式进行描述;使用JavaScript文件实现图形界面的业务逻辑,即:与用户和后端程序进行交互。
页面(Page)和组件(Component) 是OpenHarmony应用开发中的两个基本概念:
(1)应用程序的图形界面可以由一个或多个页面组成。页面是ArkUI框架最小的分割和调度单位;每个页面可进行单独的文件管理。
(2)组件是构成页面的基本元素。开发者通过多种组件的组合,构建出满足自身应用诉求的完整界面。
在本文第二部分创建项目时使用的[lite]Empty Ability
模板中已经自带了一个用户页面,这个用户页面的功能非常简单,就是显示一个文本:Hello World,页面的代码如下图红框中所示:
双击打开三个文件:index.hml
、index.css
、index.js
中的任何一个,然后单击DevEco Studio最右侧工具栏中的 Preview ,可以预览页面的效果;每次对页面进行修改之后,单击 刷新 即可。
也可以按照下图所示步骤,打开仿真面板 ,仿真页面显示效果。
注:单击上方的小方块,关闭仿真面板;单击右侧的Simulator可以刷新仿真结果。
HML(OpenHarmony Markup Language)是一套类HTML的标记语言,用于描述页面中有哪些组件、组件在整个页面中的布局结构,以及组件所具备的数据绑定、事件绑定、列表渲染、条件渲染和逻辑控制等高级能力。比如:UI组件与数据之间通过单向数据绑定的方式建立关联,当数据发生变化时,UI界面自动触发更新。
HML语法参考:
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/ui/js-framework-syntax-hml.md/
https://developer.harmonyos.com/cn/docs/documentation/doc-guides/js-framework-syntax-hml-0000001281480758
如果在上述链接中找不到相关内容,也可以参考一下HTML的教程:
https://www.runoob.com/html/html-tutorial.html
原代码:
Hello {{ title }}
原代码解析:
(1)在hml
文件中,每一对标签用于声明一个组件,组件之间可以相互包含(嵌套)。
(2)标签div
通常被作为hml
文件中的根标签,其所声明的组件div
对应页面中的一个区域。class
是组件的一种通用属性(即:任何一个组件都可以拥有的属性),用于声明组件的样式类型,例如:container
就是由开发者自定义的一个样式类型的名称,具体的定义在css文件中。
组件div
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/reference/arkui-js/js-components-container-div.md/
(3)标签text
所声明的组件text
用于在页面中展示一段文本,起始标签
和结束标签之间的内容就是要展示的文本:
Hello {{ title }}
,双重花括号表示对变量的引用(数据绑定),花括号中的title
是在文件index.js
中定义的一个变量。
组件text
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/ui/ui-js-components-text.md/
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/reference/arkui-js/js-components-basic-text.md/
修改原代码:
接下来,我们在div
组件中再添加一个input
组件:
Hello {{ title }}
Input是交互式组件,用于接收用户数据。其类型可设置为日期、多选框和按钮等。
(1)class
是所有组件的通用属性,用于指明组件的样式类型。组件input
的样式类型是btn
(将在css文件中添加它的定义)。
通用属性
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/reference/arkui-js/js-components-common-attributes.md/
(2)type
和value
是组件input
可以支持的属性。
组件input
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/reference/arkui-js/js-components-basic-input.md/
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/ui/ui-js-components-input.md/
(3)click是组件的一种通用事件
通用事件
https://docs.openharmony.cn/pages/v3.1/zh-cn/application-dev/reference/arkui-js/js-components-common-events.md/
事件通过on
或者@
绑定在组件上,当组件触发事件时会执行JS文件中对应的事件处理函数,比如:本例中的exit函数(将在js文件中定义)。
未完,待续 …