????在鸿蒙操作系统上开发 Javascript 应用程序的首次实践尝试(一)
起因
最近鸿蒙OS很火,本着吃瓜群众的心理,我也想看看号称可以用js直接开发应用的鸿蒙OS是什么样的。我对Android和Flutter都略有接触(学学写法,写个demo的水平),希望可以通过这次学习了解js直接开发会有什么不同。
准备工作
- 安装编译器
打开华为鸿蒙OS开发者中心-开发,往下翻可以看到官方编译器HUAWEI DevEco Studio的下载链接:
点击立即下载,然后下载完成后解压安装。
编译器是基于IntelliJ平台的,所以操作使用与idea/as及其相似,几乎没有学习成本。
- 环境配置
这个不用多说,基础的nodejs运行环境都要配置好。其他配置内容都可以在开发者中心-文档-工具-配置开发环境参考。
创建项目
- 新建鸿蒙OS项目
这里需要注意的是需要点击新建鸿蒙OS项目才可以创建一个带有模板的项目,如果直接点新建项目将会创建一个全新的空项目。
- 新建js空应用
这里应用名后面的括号里都有标注模板是使用什么语言开发,注意要选择正确。
然后填写应用的相关信息,点击完成就可以创建一个项目了。
- 了解项目模板文件作用
模板中开发文件夹位置是entry/src
文件夹中的内容,其中结构与node项目相似,然后进入js开发目录,即main/js
目录,其中:
- common是公共文件夹,这里应该放置的是公共资源
- i18n是国际化文件夹,里面放的是各语言环境文本内容
- pages是页面,有html,css,js三个文件组成
- app.js是入口文件
新建页面时推荐在右键新建中选择JS Page,这样可以自动添加路由到config.json文件中。
开发应用
总体写法感觉与主流前端框架相似,没有上手难度,IDE提示很全面,这个很舒服。
- html标签
组件类型 | 主要组件 |
---|---|
基础组件 | text、image、progress、rating、span、marquee、image-animator、divider、search、menu、chart |
容器组件 | div、list、list-item、stack、swiper、tabs、tab-bar、tab-content、list-item-group、refresh、dialog |
媒体组件 | video |
画布组件 | canvas |
2.双向绑定
双向绑定可以直接使用双花括号,即{{}}
,而且部分标签内容与标签属性,都是需要使用双花括号的。使用$t
可以直接引用国际化对象的内容。
- 列表循环
<!-- xxx.hml -->
<div class="array-container">
<!-- div列表渲染 -->
<!-- 默认$item代表数组中的元素, $idx代表数组中的元素索引 -->
<div for="{{array}}" tid="id" onclick="changeText">
<text>{{$idx}}.{{$item.name}}</text>
</div>
<!-- 自定义元素变量名称 -->
<div for="{{value in array}}" tid="id" onclick="changeText">
<text>{{$idx}}.{{value.name}}</text>
</div>
<!-- 自定义元素变量、索引名称 -->
<div for="{{(index, value) in array}}" tid="id" onclick="changeText">
<text>{{index}}.{{value.name}}</text>
</div>
</div>
- 条件判断
一种是ifelse语法,false时不渲染;另一种是show语法,false时渲染但不显示。
<text if="{{show}}"> Hello-One </text>
<text elif="{{display}}"> Hello-Two </text>
<text else> Hello-World </text>
<text show="{{visible}}" > Hello World </text>
- 模板引用
<!-- template.hml -->
<div class="item">
<text>Name: {{name}}</text>
<text>Age: {{age}}</text>
</div>
<!-- index.hml -->
<element name='comp' src='../../common/template.hml'></element>
3.事件绑定
时间绑定与原生js相同,由onevent等关键词绑定方法。官网给出的时间绑定方法有如下多种:
<!-- xxx.hml -->
<div>
<!-- 通过'@'绑定事件 -->
<div @click="clickfunc"></div>
<!-- 通过'on'绑定事件 -->
<div onclick="clickfunc"></div>
<!-- 使用事件冒泡模式绑定事件回调函数。5+ -->
<div on:touchstart.bubble="touchstartfunc"></div>
<!-- 使用事件捕获模式绑定事件回调函数。5+ -->
<div on:touchstart.capture="touchstartfunc"></div>
<!-- on:{event}等价于on:{event}.bubble。5+ -->
<div on:touchstart="touchstartfunc"></div>
<!-- 绑定事件回调函数,但阻止事件向上传递。5+ -->
<div grab:touchstart.bubble="touchstartfunc"></div>
<!-- 绑定事件回调函数,但阻止事件向下传递。5+ -->
<div grab:touchstart.capture="touchstartfunc"></div>
<!-- grab:{event}等价于grab:{event}.bubble。5+ -->
<div grab:touchstart="touchstartfunc"></div>
</div>
IDE提示中的on:event写法与onevent写法在实际使用时并没有表现出差别。
4.路由跳转
路由使用@system.router
的方法完成:
- 跳转至其他页面
// index.js
import router from '@system.router';
// 跳转至detail页面
jumpToDetail(){
router.push({
uri:'pages/detail/detail' //路由在config.json文件中
})
}
- 返回上一页面
// detail.js
import router from '@system.router';
backToIndex(){
router.back()
}
- dom操作
- 获取某个dom节点
通过ref绑定在标签上,然后在js中使用$refs获取dom
<!-- index.hml -->
<div class="container">
<text ref="hello">hello</text>
</div>
const helloElement = this.$refs.hello; // 获取ref属性为animator的DOM元素
- 获取父组件
const parent = this.$parent();
- 获取子组件
<div class="container">
<childComponent id = "childComponent"></childComponent>
</div>
const childComponent = this.$child('childComponent');
- 生命周期
刚才提到的app.js文件中有两个特殊生命周期,表示应用的创建与销毁:
export default {
onCreate() {
console.info('AceApplication onCreate');
},
onDestroy() {
console.info('AceApplication onDestroy');
}
};
除了这两个以外,每一个page也有生命周期,官网对于每一个生命周期的描述如下:
属性 | 参数 | 返回值 | 描述 | 触发时机 |
---|---|---|---|---|
onInit | 无 | 无 | 页面初始化 | 页面数据初始化完成时触发,只触发一次。 |
onReady | 无 | 无 | 页面创建完成 | 页面创建完成时触发,只触发一次。 |
onShow | 无 | 无 | 页面显示 | 页面显示时触发。 |
onHide | 无 | 无 | 页面消失 | 页面消失时触发。 |
onDestroy | 无 | 无 | 页面销毁 | 页面销毁时触发。 |
onBackPress | 无 | Boolean | 返回按钮动作 | 当用户点击返回按钮时触发。返回true表示页面自己处理返回逻辑。返回false表示使用默认的返回逻辑。不返回值会作为false处理。 |
onActive()5+ | 无 | 无 | 页面激活 | 页面激活时触发。 |
onInactive()5+ | 无 | 无 | 页面暂停 | 页面暂停时触发。 |
onNewRequest()5+ | 无 | 无 | FA重新请求 | 该回调当FA已经启动时收到新的请求后触发。 |
onStartContinuation()5+ | 无 | 无 | 详细描述见链接内容 | 分布式能力接口,详细解释见分布式迁移。 |
onSaveData(OBJECT)5+ | OBJECT | 无 | 详细描述见链接内容 | 分布式能力接口,详细解释见分布式迁移。 |
onRestoreData(OBJECT)5+ | OBJECT | 无 | 详细描述见链接内容 | 分布式能力接口,详细解释见分布式迁移。 |
onCompleteContinuation(code)5+ | code | 无 | 详细描述见链接内容 | 分布式能力接口,详细解释见分布式迁移。 |
页面A的生命周期接口的调用顺序:
- 打开页面A:onInit() -> onReady() -> onShow() -> onActive()
- 在页面A打开页面B:onInactive() -> onHide()
- 从页面B返回页面A:onShow() -> onActive()
- 退出页面A:onBackPress() -> onInactive() -> onHide() -> onDestroy()
- 页面隐藏到后台运行:onInactive() -> onHide()
- 页面从后台运行恢复到前台:onShow()
其中5+的含义应该是API版本5及以上,根据官网发布版本的信息,HarmonyOS SDK 2.1.1.21即v5。
调试应用
调试分为真机与虚拟机,因为我没有鸿蒙系统的手机,所以这里只说明虚拟机的调试方法。
1.获取虚拟机
点击顶部菜单栏的工具-设备管理,会弹出一个预设虚拟机弹窗,如下图所示:
第一次打开此弹窗,如果没有登录和实名认证的开发者是看不到右侧的设备列表的,需要先去注册华为开发者账号,然后进行实名认证。认证完成后回到IDE退出并重新登录(这里弹出的授权页面也需要重新登录才可以),才会显示设备列表。
选择想要运行的设备,点右侧运行按钮,然后再运行项目,就可以看到虚拟机演示效果了。
注意:
- 开发时没有热更新,需要重新运行才可以看到修改后的效果。
- 虚拟机是云手机,所以会出现操作迟滞,画面模糊等问题。
- 云手机有使用时长限制,上侧有1个小时倒计时。
总结
本次文档就记到这里,之后进一步开发会持续更新~欢迎关注收藏~
个人博客:encaik.gitee.io/
推荐阅读
-
????在鸿蒙操作系统上开发 Javascript 应用程序的首次实践尝试(一)
-
Grid++Report 锐浪报表开发常见问题解答集锦-报表设计 问:怎样在设计时打印预览报表? 答:为了及时查看报表的设计效果,Grid++Report 报表设计应用程序提供了四种查看视图:普通视图、页面视图、预览视图与查询视图。通过窗口下边的 Tab 按钮可以在四种视图中任意切换。在预览视图中查看报表的打印预览效果,在查询视图中查看报表的查询显示效果。如果在报表的记录集提供了数据源连接串与查询 SQL,在进入预览视图与查询视图时会利用数据源连接串与查询 SQL 从数据源中自动取数,否则 Grid++Report 将自动生成模拟数据进行模拟打印预览与查询显示。注意:在预览视图与查询视图中看到的报表运行结果有可能与在你程序中的最终运行结果有差异,因为在报表的生成过程中我们可以在程序中对报表的生成行为进行一定的控制。 问:怎样用 Grid++Report 设计交叉表? 答:Grid++Report 没有提供专门实现交叉表的功能,其它的报表构件提供的交叉表功能一般也比较死板和功能有限。利用 Grid++Report 的编程接口可以做出灵活多变,功能丰富的交叉表。示例程序 CrossTab 就是一个实现交叉表的例子程序,认真领会此例子程序,你就可以做出自己想要各种交叉表,并能提取一些共用代码,便于重复使用。 问:怎样设置整个报表的缺省字体? 答:设置报表主对象的字体属性,也就是设置了整个报表的缺省字体。如果改变报表主对象的字体属性,则没有专门的设置字体属性的子对象的字体属性也跟随改变。同样每个报表节与明细网格也有字体属性,他们的字体属性也就是其拥有的子对象的缺省字体。 问:怎样在打印时限制一页的输出行数? 答:设定明细网格的内容行的‘每页行数(RowsPerPage)’属性即可。另外要注意‘调节行高(AdjustRowHeight)’属性值:为真时根据页面的输出高度自动调整行的高度,使整个页面的输出区域充满。为假时按设计时的高度输出行。 问:怎样显示中文大写金额? 答:将对象的“格式(Format)”属性设为 “$$” 及可,可以设置格式的对象有:字段(IGRField)、参数(IGRParameter)、系统变量(IGRSystemVarBox)与综合文字框(IGRMemoBox),其中综合文字框是在报表式上设格式。 问:能否实现自定义纸张与票据打印? 答:Grid++Report 完全支持自定义纸张的打印,只要在报表设定时在页面设置中选定自定义纸张,并指定准确的纸张尺寸。当然要在最终输出时得道合适的打印结果,输出打印机必须支持自定义纸张打印。Windows2000/XP/2003 操作系统上可以在打印机上定义自定义纸张,也可以采用这种方式实现自定义纸张打印。 问:怎样实现 0 值不打印? 答:直接设置格式串就可以,在“数字格式”设置对话框中选定“0 不显示”,就会得到合适的格式串。也可以通过直接录入格式串来指定 0 不显示,但格式串必须符合 Grid++Report 的规定格式。另一种实现办法是在报表获取明细记录数据时,在 BeforePostRecord 事件中将值为零的字段设为空,调用字段的 Clear 方法将字段置为空。 问:怎样实现多栏报表? 答:在明细网格上设‘页栏数(PageColumnCount)’属性值大于 1 即可。通过 Grid++Report 的“页栏输出顺序”还可以指定多栏报表的输出顺序是“先从上到下”还是“先从左到右”。 问:如何实现票据套打? 答:Grid++Report 为实现票据套打做了很多专门的安排:报表设计器提供了页面设计模式,按照设定的纸张尺寸显示设计面板,如果将空白票据的扫描图设为设计背景图,在定位报表内容的输出位置会非常方便。报表部件可以设定打印类别,非套打输出的内容在套打打印模式下就不会输出。 问:Grid++Report 有没有横向分页功能? 答:回答是肯定的,在列的总宽度超过打印页面的输出宽度时,Grid++Report 可以另起新页输出剩余的列,如果左边存在锁定列,锁定列可以在后面的新页中重复输出,这样可以保证关键数据列在每一页都有输出。仔细体会 Grid++Report 提供的多种打印适应策略,选用最合适的方式。Grid++Report 的多种打印适应策略为开发动态报表提供了很好的支持。 问:怎样实现报表本页小计功能? 答:定义一个报表分组,将本分组定义为页分组,在本分组的分组头与分组尾上定义统计。页分组就是在每页产生一个分组项,在每页的上端与下端都会分别显示页分组的分组头与分组尾,页分组不用定义分组依据字段。 报表运行 问:怎样与数据库建立连接? 答:如果在设计报表时指定了数据集的数据源连接串与查询 SQL 语句,Grid++Report 采用拉模式直接从数据源取得报表数据,Grid++Report 利用 OLE DB 从数据源取数,OLE DB 提供了广泛的数据源操作能力。如果 Grid++Report 的数据来源采用推模式,即 Grid++Report 不直接与数据库建立连接,各种编程语言/平台都提供了很好的数据库连接方式,并且易于操作,应用程序在报表主对象(IGridppReport)的 FetchRecord 事件中将数据传入,例子程序提供了各种编程语言填入数据的通用方法,对C++Builder 和 Delphi 还进行了专门的包装,直接关联 TDataSet 对象也可以将 TDataSet 对象中的数据传给报表。 问:打印时能否对打印纸张进行自适应?支持表格的折行打印吗? 答:Grid++Report 在打印时采用多种适应策略,通过设置明细网格(IGRDetailGrid)的‘打印策略(PrintAdaptMethod)’属性指定打印策略。(1)丢弃:按设计时列的宽度输出,超出范围的内容不显示。(2)绕行:按设计时列的宽度输出,如果在当前行不能完整输出,则另起新行进行输出。(3)缩放适应:对所有列的输出宽度进行按比例地缩放,使总宽度等于页面的输出宽度。(4)缩小适应:如果列的总宽度小于页面的输出宽度,对所有列的输出宽度进行按比例地缩小,使总宽度等于页面的输出宽度。(5)横向分页:超范围的列在新页中输出。(6)横向分页并重复锁定列。 问:如何改变缺省打印预览窗口的窗口标题? 答:改变报表主对象的‘标题(Title)’属性即可。 问:利用集合对象的编程接口取子对象的接口引用,但不是自己期望的结果。 答:Grid++Report中所有集合对象的下标索引都是从 1 开始,另按对象的名称查找对象的接口引用时,名称字符是不区分大小写的。 问:怎样在运行时控制报表中各个对象的可见性?即怎样在运行时显示或隐藏对象? 答:在报表主对象(GridppReport)的 SectionFormat 事件中设定相应报表子对象的可见(Visible)属性即可。 问:报表主对象重新载入数据,设计器中为什么没有反映新载入的数据? 答:应调用 IGRDesigner 的 Reload 方法。 问:怎样实现不进入打印预览界面,直接将报表打印出来?