本教程是为需要在柿饼M3上进行开发的小伙伴准备的。在进行开发之前,需要准备两样东西:第一个是柿饼M3硬件板子(以核心板+底板为例);第二个是开发柿饼M3的设计器。
柿饼M3的开发就是在设计器上完成的,主要的开发工作是:
编写JavaScript脚本代码,完成项目开发的逻辑功能实现
显示界面的UI设计,完成界面、按钮、进度条等控件的动效设计
下面主要介绍如何使用设计器,并通过设计器完成第一个页面切换的简单例子。
!!!使用过柿饼派的小伙伴请注意:柿饼M3的设计器与柿饼派的不同,柿饼M3的版本号为1.4.0,如果不是该版本,请先更换为此版本再进行开发。
打开软件之后整体外观如下
基础控件: 柿饼UI的基础控件列表,例如Button、label、page等,开发者使用相应的控件进行UI设计
图片集合:柿饼UI的素材图片集合
工程管理器:管理此工程文件、文件夹等
操作属性: 对选中的控件进行属性更改,例如更改大小、颜色等操作
除此之外,还有菜单栏和工具栏:
左上角为菜单栏,用户进行新建工程、打开工程、下载工程、格式布局、查看帮助等可以在此处操作。
点击”帮助->使用说明“,可以打开设计器的帮助文档,以供参考。
然后是工具栏,主要介绍以下几个按钮:
“仿真”按钮,可以将设计好的工程在电脑上模拟运行。
“下载“按钮,将此工程下载到硬件板中运行(由于图示没有插接M3硬件板,所以此按钮是灰色的)
布局工具栏,将UI界面的控件进行对齐,居中等操作
未连接柿饼M3时,设计器右下角显示”设备:未连接“。
柿饼M3硬件板子有USB接口,将此接口插接到电脑上,设计器右下角便会显示”设备:已连接“,对应的,工具栏的 ”下载运行“按钮也会变成可使用的状态,此时,用户便可以将设计器的工程下载到硬件板中。
本例子是实现页面切换简单例子。大致为:
1、创建两个页面,页面1和页面2
2、页面1有按钮控件,可以跳转到页面2
3、页面2有按钮控件,可以返回到页面1
点击”文件->新建->新建工程“
然后设计器弹出选择新建工程的配置:此处需要注意的是LCD的相关参数配置,目前设计器仅支持显示模式为横屏,图片格式为PNG,像素模式为RGB888的参数,因此只需要更改适合的分辨率即可,这里选择柿饼M3的显示屏分辨率480x272,点击确定即可。
点击确定之后,会弹出选择页面名称的窗口,在这里我们设定第一个页面为page1。然后点击确定即可。
然后出现如下界面,新建工程完成。
在新建的工程中,可以看到右侧的工程管理器已经出现工程目录,此处的UI设计区域就是page1.ui的界面,
在属性栏中,展示page的属性。
首先我们在page1上放置label控件,点击工具箱的label,然后移动至UI绘图区域即可。
将label控件放置在page上之后,可以看到右侧属性栏已经更换为label,
然后我们更改label的属性,将控件文本由”label“更改为”页面切换例子“,文本对齐由TopLeft更改为MiddleCenter(注意:显示字体为点阵时,不可以更改字体大小,默认为16,在后边的例程中会添加新字体提供更改),更改后的效果如下。
按照label的步骤,在page1上创建button控件,并设置控件文本为”跳转到页面2“
在工程中新建一个page,在设计器右上角”工程管理器“内工程名节点下的”UI文件“节点右键进行选择,
然后设计器弹窗让修改page2的名称,此处选择默认名字。新建page2后,工程管理器也会出现page2的相关文件,且UI设计区域也停留在page2的页面上。
按照page1的步骤,添加button,并设置button的属性为:控制文本改为”返回页面1“
至此,页面的设计已经完成,如何实现切换页面,就需要编写JavaScript的逻辑代码了。
想要实现点击页面1的按钮,切换到页面2,那么需要对button1进行编写代码。可以参照帮助文档的button控件章节。
首先需要绑定页面1的button控件的调用属性,将其设置为onBtn,设置完之后,相当于该button被按下时有一个onBtn函数被调用,此时需要在page1.js文件中,编写onBtn函数即可实现触发的逻辑功能。双击bindTap,便可以打开page1.js文件。
由于点击button是实现界面切换功能,那么调用的API是navigate(可以参照帮助手册的navigate了解更多内容),因此我们选择pm.navigateTo方法去调转到页面2,相关代码:
按照page1的button,更改page2的属性,绑定bindTap为onBtn,完善page2.js的onBtn代码,因为page2点击button是需要返回到page1的,所以,调用的界面切换函数是pm.navigateBack,返回到page1.
至此,页面切换的JavaScript代码已经完成,可以先在设计器上仿真运行看下效果。有柿饼M3的小伙伴可以下载到硬件板中试试效果。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。