配置

框架预定义了一组全局配置,可以简化内部插件调用时的参数传递。

// 全局配置
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_runapicloud:使用 ApiCloud 官方的版本升级
apphub:应用控制中心,对 APP 进行独立升级与维护
ver_url版本更新请求地址,升级模式为 apphub 时有效

应用数据分析

涉及插件:AnalysisApp 等。

参数名说明类型
jpush是否启用极光推送布尔值
analysis应用数据分析地址字符串

config.header_fill 详解

终端设备为 iPhone X 时有效,主要用于其刘海适配。

当 APP 的头部为沉浸式时,顶部边框(黑边)高度为 30,否则为 40。