全局配置

配置界面、路径

可以通过配置 app.json 文件，设置 SWAN 的界面、路径、多 TAB 等。
app.json 配置项列表如下

示例：

{
    "pages": [
        "pages/index/index",
        "pages/detail/detail"
    ],
    "window": {
        "navigationBarTitleText": "Demo"
    },
     "tabBar": {
        "list": [{
        "pagePath": "pages/index/index",
        "text": "首页"
    }, {
        "pagePath": "pages/logs/logs",
        "text": "日志"
        }]
  }
}

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

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

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

如，开发目录为：

├── app.js
├── app.json
├── app.css
├── project.config.json
└──  pages
    └── index
        ├── index.swan
        ├── index.css
        ├── index.js
        └── index.json
    └── detail
        ├── detail.swan
        ├── detail.css
        ├── detail.js
        └── detail.json

则需要在 app.json 中书写

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

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

注意：

• navigationStyle 全局配置Android和iOS从手百版本11.1.0开始支持, 但子页面配置支持情况Android从手百版本11.1开始支持，iOS从手百版本11.2开始支持, 做低版本兼容时，通过 swan.getSystemInfo 或者 swan.getSystemInfoSync 获取手百版本号进行兼容判断，具体见下表；
• 无其它特殊说明，请使用canIUse或者SWAN基础库版本进行兼容判断。

navigationStyle配置

示例：

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

tabBar
用于设置客户端底部的tab栏：可通过tabBar设置tab的颜色、个数、位置、背景色等内容。

配置全局数据

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 生命周期

属性介绍：

原理图：

图片

1、notify:当渲染线程初始化后，向APP服务线程派发消息，请求获取初始化渲染数据；
2、sendInitData:APP服务线程将初始化渲染数据派发给渲染线程；
3、notify:渲染线程渲染达到Ready状态后，派发消息通知APP服务线程；
4、SendData:APP服务线程触发onReady事件，向渲染线程传送数据；

说明
每次前台切后台会触发Page的onHide生命周期函数，后台切前台触发Page的onShow。