飞道科技

飞道科技文档总汇

程序配置及程序初始化

1. 程序全局配置

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

1.1 配置页面文件路径

所有小程序都需要配置页面文件路径, 示例如下:

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

“pages/index/index” 路径为页面WXML文件的路径

1.2 配置tabBar页面

有的小程序需要使用tabBar, 如下

tabBar页面示例

这就需要在app.json中配置tabBar页面的路径, 示例如下

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

1.3 配置程序样式

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

文档地址: https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#window

在app.json内配置的样式的优先级低于page.json的优先级

2. 程序初始化

微信小程序每次运行的时候都会先初始化程序

./src-wx-app/app 目录为初始化程序的代码, 如下

初始化程序

a0001为程序事件, 在app.ts内初始化小程序, s为事件响应

假设我需要在程序初始化的时候, 去做一些事情。那只需要在s.ts文件里面使用'fd-events-init':'a001'绑定初始化事件即可, 初始化要做的事情写在程序事件a001内。s.ts文件示例:

export default {
    'fd-events-init': 'a001'
};

2.2 系统事件

当然程序初始化是分为不同的阶段的, 不同阶段也会触发不同的事件, 这就是程序的生命周期。生命周期对应如下:

属性 描述 触发时机
fd-events-init 生命周期回调—监听小程序初始化 小程序初始化完成时(全局只触发一次)
fd-events-wx-app-show 生命周期回调—监听小程序显示 小程序启动,或从后台进入前台显示时
fd-events-wx-app-hide 生命周期回调—监听小程序隐藏 小程序从前台进入后台时
fd-events-wx-app-error 错误监听函数 小程序发生脚本错误,或者 api 调用失败时触发,会带上错误信息