配置
框架预定义了一组全局配置,可以简化内部插件调用时的参数传递。
// 全局配置 config = { mode: "run", // 运行环境(run:生产环境 | debug:开发环境) page: "", // 远程页面地址 host: "", // 本地页面地址 qn_server: "", // 七牛存储空间地址 qn_token: "", // 七牛令牌生成地址 ver_run: "apphub", // 版本升级(apicloud:使用 AC 官方的版本升级 | apphub:应用控制中心) ver_url: "", // 版本更新请求地址 jpush: false, // 是否启用极光推送 analysis: "", // 应用数据分析地址 header_fill: true // 苹果 X 的头部为沉浸式时,顶部边框(黑边)高度为 30,否则为 40 };
config.mode 详解
运行环境:开发环境(debug)、生产环境(run)。
涉及插件:UpdateApp、AnalysisApp、hhAlipay、hhWeixin 等。
具体说明:当 APP 处于开发环境时,以上涉及的插件不会生效或有一些特殊处理。
config.page 详解
具体说明:当 APP 需要打开一个远程地址(用户协议、使用说明 等)时使用,如果服务器地址变更,可以进行快速切换。
config.host 详解
涉及插件:Ajax、Cache 等。
具体说明:主要用于 Ajax 异步请求时使用。
七牛存储
涉及插件:imgupload、hhFs 等。
参数名 | 说明 | 接口接收参数 |
---|---|---|
qn_server | 七牛存储空间地址,用来显示图片 | 不做规定 |
qn_token | 七牛文件上传令牌的生成地址 | 不做规定 |
七牛令牌生成地址(qn_token)
// 接口返回的数据格式 { "uptoken": "xxxxxx", // 七牛上传令牌 "expire": "1516347766000" // 令牌过期时间 }
版本升级
涉及插件:UpdateApp 等。
参数名 | 说明 |
---|---|
ver_run | apicloud:使用 ApiCloud 官方的版本升级 apphub:应用控制中心,对 APP 进行独立升级与维护 |
ver_url | 版本更新请求地址,升级模式为 apphub 时有效 |
应用数据分析
涉及插件:AnalysisApp 等。
参数名 | 说明 | 类型 |
---|---|---|
jpush | 是否启用极光推送 | 布尔值 |
analysis | 应用数据分析地址 | 字符串 |
config.header_fill 详解
终端设备为 iPhone X 时有效,主要用于其刘海适配。
当 APP 的头部为沉浸式时,顶部边框(黑边)高度为 30,否则为 40。