BUI buijs cli工具

一、简介

buijs 是BUI Webapp交互框架 的npm命令工具(专注webapp快速开发), 用于快速生成指定平台与模板必须的工程文件. 需要先安装 node环境 才能使用npm命令.

通过命令行构建的工程,每次都会自动获取最新的BUI模板工程, 并且可以指定模板及平台. BUI模板图片预览

二、安装buijs命令行工具

windows:

npm install -g buijs

mac:

sudo npm install -g buijs

三、初始化工程目录:

创建默认Webapp工程 (demo 为工程名称)

buijs create demo

默认模板预览 更多模板点击这里 BUI模板图片预览

四、命令列表

命令行	描述
buijs -v	查看当前工具的版本
buijs -h	命令帮助信息
buijs list	显示可用的版本
buijs list-template	显示可用的模板列表 BUI模板图片预览
buijs list-platform	显示可用的平台列表
buijs create <projectName> [version]	创建bui默认工程
buijs create <projectName> [version] -t tab	创建bui tab在底部的模板工程,默认平台 webapp
buijs create <projectName> [version] -t tab -p link	创建bui tab在底部的模板工程,更改平台为 link

创建某个模板工程 ( main-tab 为模板名称)

可以先查看有什么模板 buijs list-template, BUI模板图片预览

buijs create demo -t main-tab

效果预览

注意:
1. 同一个工程可以多次创建模板;
模板名以 main-开头 会覆盖 main 模块, 例如: 模板名 main-tab 预览地址 index.html
模板名以 page-开头 会新增模块, 例如: 模板名 page-sidebar 预览地址 index.html#pages/sidebar/sidebar
2. 同一个工程只能创建一个平台, 多次创建会相互覆盖;

创建指定平台工程 ( dcloud 为平台名称 )

可以先查看有什么平台选择 buijs list-platform

注意:
1. 目前已经支持以下打包平台 cordova,bingotouch,link,dcloud,apicloud,appcan,微信 等;
2. 不同平台对应的文件会有些许不同, 绑定原生后退的方法也不同, 不指定平台时, 默认是webapp平台, 可以在微信及webkit浏览器内核预览.

buijs create demo -p dcloud

创建某个平台下的某个模板工程

buijs create demo -t sidebar -p dcloud

创建指定版本工程

可以先查看有什么版本 buijs list

buijs create demo v1.0

五、目录说明:

单页应用包文件夹说明:

路径	描述
index.html	入口文件
index.js	入口的脚本
css/bui.css	BUI库的样式文件
font/	字体图标目录
images/	应用图片目录
js/zepto.js	bui的依赖库
js/plugins/fastclick.js	移动端快速点击的插件
js/bui.js	BUI交互控件库
pages/	模块目录
pages/main	默认 main 模块
pages/main/main.html	默认 main 模块模板
pages/main/main.js	默认 main 模块定义脚本