【译】使用Fuse创建App的入门教程
官网原文:https://www.fusetools.com/learn/guides/tutorial
安装设置
请参见安装指南页面。
创建一个新项目
使用命令行工具输入如下命令新建一个项目
fuse create app <projectname> [optional path]
如忽略路径,缺省在当前目录新建项目。
你也可以在Fuse控制台上点击“New Project”来新建一个项目。
pic使用UX文件
一个刚刚新建的Fuse项目应该包含了唯一的一个.ux
文件,缺省名叫MainView.ux
。
在命令行的项目目录中键入fuse preview
可以预览该文件,或者在控制台上点选Preview
也行。
MainView.ux
的预览图应该看起来是这样(老版本):
打开文件预览后,Fuse会监听任何UX和JavaScript的改动并即刻更新预览,更酷的是你可以在你的手机上获得同样的实时预览效果。
首个App
是时候打开.ux
文件看看里面的标记了,代码编辑器推荐使用Sublime Text 3并安装上Fuse插件。
MainView.ux
文件的基本内容如下所示:
<App Theme="Basic">
</App>
试着加点UI元素:
<App Theme="Basic" Background="#eeeeeeff">
<DockPanel>
<StatusBarBackground Dock="Top" />
<ScrollView ClipToBounds="true">
<StackPanel>
<Slider />
<Button Text="Button" />
<Switch Alignment="Left" />
</StackPanel>
</ScrollView>
</DockPanel>
</App>
理解标记
UX文件中的每一个XML元素都表示了一个Uno对象。元素的名字就是类名。
MainView.ux
现有的标记包括:
-
App
- App类是你的应用的入口点, 而且只能有一个App
。Theme
主题详细列举了App用到的缺省字体、颜色、控制外表等。ClearColor
指定背景色。 -
DockPanel
- 用来布局(layout),它可以在上下左右定位各类子元素,随后一个子元素缺省会填充最后的空间。 -
StatusBarBackground
- 给状态栏的保留空间,以防状态栏为透明。它可以在iOS和Android里控制状态栏的背景。Fuse中还没有状态栏,但你可以在手机上查看效果。 -
ScrollView
- 用于操控滚动视图,缺省方向是垂直滚动。 -
StackPanel
- 用来布局(layout),它可以将若干子元素按水平或垂直方向排列,缺省是按垂直方向,如上面的例子。 -
Slider
- 让用户在给定范围中选一个值的滑动控制器 -
Button
- 鼠标单击或触摸点击的控制器 -
Switch
- 可以切换开与关的控制器
所有可用的标签都是类,你可以在Fuse API文档里找到一个完整的可用标记清单。
关于视觉感受
示例中的Slider
、Button
和Switch
都是通过Theme
主题来设置视觉效果的,该例中应用了Basic
主题,Fuse.BasicTheme
是基于谷歌的Material Design设计并使用UX标记来定义的。Basic
主题在所有平台都能保持同样的视觉效果,实为开发跨平台应用开始时的方便之选。
使用样式(Styling)可以轻松修改外表。如果要全部自定义App中所有字体、颜色、动画和控制这些设置,推荐创建自己的主题。
逻辑与脚本
Fuse使用JavaScript来给App添加逻辑。UX标记与脚本的组合,给你实施App时所有需要的功能,从视觉设计到数据模型、逻辑和后台集成。
在首个示例中,我们来简单创建一个计数器,数字随按钮被点击的次数而增长。
首先在DockPanel
标记中添加如下JavaScript字段:
<JavaScript>
var Observable = require('FuseJS/Observable');
var buttontext = Observable('Button');
var clickcount = 0;
function click() {
buttontext.value = 'Clicks: ' + ++clickcount;
}
module.exports = {
buttontext : buttontext,
click : click
}
</JavaScript>
然后将点击处理器和buttontext
变量绑定到已有的Button
标记中,如下所示:
<Button Text="{buttontext}" Clicked="{click}"/>
保存已修改的MainView.ux
文件的同时,预览窗会自动刷新,so,开始愉快的点击按钮吧!
上述脚本和标记的作用是,给按钮上的文字显示创建了一个数据绑定,当click()
函数被调用时,buttontext
就会被改变,按钮上的文字段就会随之更新。
Uno
当更多底层任务需要完全访问原生安卓或iOS编程接口时,或者当需要创建全新的UI组件时,你可以使用Uno. Uno是一个轻量的C#方言,它可以编译成原生的安卓和iOS代码,这使之成为Fuse的基石。
输出App
现在你的App至少已有了一个功能,是时候输出到安卓或iOS上了。
使用命令行工具,你可以这样:
fuse build --target=<ios or Android> --run
更多信息参见“预览与输出”页面。
很简单,是不是,下一步做什么?
熟悉上述基础内容后,你可以试着到这里消化那些范例了。
如果你觉得JavaScript不够用,可以试试Uno。
有任何问题可以到官网论坛发帖。