配置界面，路径

---

可以通过配置app.json文件，设置SWAN的界面，路径，多TAB等。

app.json配置项列表如下：

属性	类型	必填	描述
网页	{String，Array}	是	设置页面路径
窗口	目的	否	设置页面展现

示例：

{
	"pages": [
		"pages/index/index",
		"pages/detail/detail"
	],
	"window": {
		"navigationBarTitleText": "Demo"
	}
}

pages

---

pages接受一个数组，每一项都是一个字符串，指定SWAN App都有哪些页面。每一项代表页面的[路径+文件名]，数组第一项代表SWAN初始页面。

SWAN中新增或减少页面的话，需要在pages中进行配置。

配置项中不需要加文件后缀名，SWAN会自动解析。

如，开发目录为：

pages/

	pages/index/index.swan

	pages/index/index.css

	pages/index/index.js

	pages/detail/detail.swan

	pages/detail/detail.css

	pages/detail/detail.js

app.js

app.json

app.css

则需要在app.json中书写：

{
	"pages":[
		"pages/index/index",
		"pages/detail/detail"
	]
}

window

---

用于设置SWAN的状态栏，导航条，标题，窗口背景色。

属性	类型	必填	描述
navigationBarBackgroundColor	HexColor	＃000000	导航栏背景颜色，如“＃000000”
navigationBarTextStyle	String	white	导航栏标题颜色，目前仅支持黑/白
navigationBarTitleText	String		导航栏标题文字内容
backgroundColor	HexColor	#FFFFFF	背景颜色
backgroundTextStyle	String	dark	下拉背景字体，loading图的样式，仅支持暗/光
enablePullDownRefresh	Boolean	false	是否开启下拉刷新
onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面底部距离，单位为px

示例：

{
	"window":{
		"navigationBarBackgroundColor": "#ffffff",
		"navigationBarTextStyle": "black",
		"navigationBarTitleText": "swan接口功能演示",
		"backgroundColor": "#eeeeee",
		"backgroundTextStyle": "light"
	}
}

配置全局数据

---

app.js中存放全局的JS逻辑。

示例：

App({
	onLaunch: function () {
		console.log('SWAN launch');
	},
	onShow: function () {
		console.log('SWAN展现');
	},
	onHide: function () {
		console.log('SWAN当前处于后台');
	},
	onError: function () {
		console.log('SWAN发生错误');
	},
	globalData: 'SWAN'
});

SWAN生命周期

---

属性	类型	描述	触发时机
onLaunch	Function	SWAN初始化的生命周期函数	当SWAN App初始化完成时，会触发onLaunch（全局只触发一次）
onShow	Function	SWAN App展示时调用的生命周期函数	SWAN App从后台进入前台，触发onShow
onHide	Function	SWAN App隐藏时调用的生命周期函数	SWAN App从前台进入后台，触发onHide
onLoad	Function	监听页面加载的生命周期函数	SWAN App页面加载完成，触发onLoad
onReady	Function	监听页面初次渲染完成的生命周期函数	SWAN App页面渲染完成，触发onReady
onunload	Function	监听页面卸载的生命周期函数	页面卸载，触发onUnload
onerror	Function	错误监听函数	当SWAN App发生错误时，会触发