1 Star 1 Fork 0

PersimUI / wiki

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
教程:柿饼M3上手指南.md 6.15 KB
一键复制 编辑 原始数据 按行查看 历史
chenjh 提交于 2020-02-06 17:34 . 增加m3使用教程:上手指南

教程:柿饼M3上手指南

简介

本教程是为需要在柿饼M3上进行开发的小伙伴准备的。在进行开发之前,需要准备两样东西:第一个是柿饼M3硬件板子(以核心板+底板为例);第二个是开发柿饼M3的设计器。

柿饼M3的开发就是在设计器上完成的,主要的开发工作是:

  • 编写JavaScript脚本代码,完成项目开发的逻辑功能实现

  • 显示界面的UI设计,完成界面、按钮、进度条等控件的动效设计

下面主要介绍如何使用设计器,并通过设计器完成第一个页面切换的简单例子。

M3设计器的使用

!!!使用过柿饼派的小伙伴请注意:柿饼M3的设计器与柿饼派的不同,柿饼M3的版本号为1.4.0,如果不是该版本,请先更换为此版本再进行开发。

设计器总体介绍

打开软件之后整体外观如下

figures01
  1. 基础控件: 柿饼UI的基础控件列表,例如Button、label、page等,开发者使用相应的控件进行UI设计

  2. 图片集合:柿饼UI的素材图片集合

  3. 工程管理器:管理此工程文件、文件夹等

  4. 操作属性: 对选中的控件进行属性更改,例如更改大小、颜色等操作

除此之外,还有菜单栏和工具栏:

左上角为菜单栏,用户进行新建工程、打开工程、下载工程、格式布局、查看帮助等可以在此处操作。

点击”帮助->使用说明“,可以打开设计器的帮助文档,以供参考。

figures02然后是工具栏,主要介绍以下几个按钮:

  • “仿真”按钮,可以将设计好的工程在电脑上模拟运行。

  • “下载“按钮,将此工程下载到硬件板中运行(由于图示没有插接M3硬件板,所以此按钮是灰色的)

  • 布局工具栏,将UI界面的控件进行对齐,居中等操作

    figures03

柿饼M3连接到设计器

未连接柿饼M3时,设计器右下角显示”设备:未连接“。

柿饼M3硬件板子有USB接口,将此接口插接到电脑上,设计器右下角便会显示”设备:已连接“,对应的,工具栏的 ”下载运行“按钮也会变成可使用的状态,此时,用户便可以将设计器的工程下载到硬件板中。

完成第一个页面切换的例子

本例子是实现页面切换简单例子。大致为:

1、创建两个页面,页面1和页面2

2、页面1有按钮控件,可以跳转到页面2

3、页面2有按钮控件,可以返回到页面1

新建一个工程

点击”文件->新建->新建工程“

figure04

然后设计器弹出选择新建工程的配置:此处需要注意的是LCD的相关参数配置,目前设计器仅支持显示模式为横屏,图片格式为PNG,像素模式为RGB888的参数,因此只需要更改适合的分辨率即可,这里选择柿饼M3的显示屏分辨率480x272,点击确定即可。

figure05

点击确定之后,会弹出选择页面名称的窗口,在这里我们设定第一个页面为page1。然后点击确定即可。

figure06

然后出现如下界面,新建工程完成。

figure07

在新建的工程中,可以看到右侧的工程管理器已经出现工程目录,此处的UI设计区域就是page1.ui的界面,

在属性栏中,展示page的属性。

创建page1的button和label控件

首先我们在page1上放置label控件,点击工具箱的label,然后移动至UI绘图区域即可。

figure08

将label控件放置在page上之后,可以看到右侧属性栏已经更换为label,

figure09

然后我们更改label的属性,将控件文本由”label“更改为”页面切换例子“,文本对齐由TopLeft更改为MiddleCenter(注意:显示字体为点阵时,不可以更改字体大小,默认为16,在后边的例程中会添加新字体提供更改),更改后的效果如下。

figure10

按照label的步骤,在page1上创建button控件,并设置控件文本为”跳转到页面2“

figure11

新建page2,并创建page2的button

在工程中新建一个page,在设计器右上角”工程管理器“内工程名节点下的”UI文件“节点右键进行选择,

figure12

然后设计器弹窗让修改page2的名称,此处选择默认名字。新建page2后,工程管理器也会出现page2的相关文件,且UI设计区域也停留在page2的页面上。

figure13

按照page1的步骤,添加button,并设置button的属性为:控制文本改为”返回页面1“

figure14

至此,页面的设计已经完成,如何实现切换页面,就需要编写JavaScript的逻辑代码了。

编写JavaScript的逻辑代码

想要实现点击页面1的按钮,切换到页面2,那么需要对button1进行编写代码。可以参照帮助文档的button控件章节。

首先需要绑定页面1的button控件的调用属性,将其设置为onBtn,设置完之后,相当于该button被按下时有一个onBtn函数被调用,此时需要在page1.js文件中,编写onBtn函数即可实现触发的逻辑功能。双击bindTap,便可以打开page1.js文件。

figure15

由于点击button是实现界面切换功能,那么调用的API是navigate(可以参照帮助手册的navigate了解更多内容),因此我们选择pm.navigateTo方法去调转到页面2,相关代码:

figure16

按照page1的button,更改page2的属性,绑定bindTap为onBtn,完善page2.js的onBtn代码,因为page2点击button是需要返回到page1的,所以,调用的界面切换函数是pm.navigateBack,返回到page1.

figure17

至此,页面切换的JavaScript代码已经完成,可以先在设计器上仿真运行看下效果。有柿饼M3的小伙伴可以下载到硬件板中试试效果。

figure18

figure19

JavaScript
1
https://gitee.com/PersimUI/wiki.git
git@gitee.com:PersimUI/wiki.git
PersimUI
wiki
wiki
master

搜索帮助