manifest.json文件中包含了应用描述、接口声明、页面路由信息
manifest
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
package | String | - | 是 | 应用包名,确认与原生应用的包名不一致, 推荐采用com.company.module的格式, 如:com.example.demo |
name | String | - | 是 | 应用名称,6个汉字以内, 与应用商店保存的名称一致,用于 在桌面图标、弹窗等处显示应用名称 |
icon | String | - | 是 | 应用图标,提供192x192大小的即可 |
versionName | String | - | 否 | 应用版本名称,如:“1.0” |
versionCode | Integer | - | 是 | 应用版本号,从1自增,推荐每次 重新上传包时versionCode+1 |
minPlatformVersion | Integer | 1000 | 是 | 支持的最小平台版本号,原理同 Android API Level,兼容性检查, 避免上线后在低版本平台运行并导致不兼容 |
features | Array | - | 否 | 接口列表,绝大部分接口都需要在这里声明, 否则不能调用,详见每个接口的文档说明 |
config | Object | - | 是 | 系统配置信息,详见下面说明 |
router | Object | - | 是 | 路由信息,详见下面说明 |
display | Object | - | 否 | UI显示相关配置,详见下面说明 |
config
用于定义系统配置和全局数据。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
logLevel | String | log | 打印日志等级,分为off,error,warn,info,log,debug |
designWidth | Integer | 750 | 页面设计基准宽度,根据实际设备宽度来缩放元素大小 |
data | Object | - | 全局数据对象,属性名不能以$或_开头,在页面中可 通过this进行访问;如果全局数据属性与页面中data属性 重名,则页面初始化时,全局数据会覆盖页面中对应的属性值 |
router
用于定义页面的组成和相关配置信息,如果页面没有配置路由信息,则在编译打包时跳过。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
entry | String | - | 首页名称 |
pages | Object | - | 页面配置列表,key值为页面名称(对应页面目录名, 例如Demo对应’Demo’目录),value为页面详细配置page, 详见下面说明 |
router.page
用于定义单个页面路由信息。
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
component | String | - | 是 | 页面对应的组件名,与ux文件名保持一致, 例如’index’ 对应 ‘index.ux’ |
path | String | /<页面名称> | 否 | 页面路径,例如“/user”, 不填则默认为/<页面名称>。path必须唯一, 不能和其他page的path相同。 当page的path缺失,path会被设置为“/Index” |
filter | Object | - | 否 | 声明页面可以处理某种请求 |
router.page.filter
声明页面可以处理某种请求,页面可以从$page获取打开页面的参数,参见script脚本。filter的结构如下:
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
action | String | - | 是 | 请求的动作,目前仅支持view这一种 |
uri | Pattern | - | 是 | 请求的数据的匹配规则。必须是正则表达式。 如https??/.*可以匹配所有http和https类型的网址 |
display
用于定义与UI显示相关的配置。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
backgroundColor | String | #ffffff | 窗口背景颜色 |
fullScreen | Boolean | false | 是否是全屏模式,默认不会 同时作用于titleBar,titleBar需要 继续通过titleBar控制 |
titleBar | Boolean | true | 是否显示titleBar |
titleBarBackgroundColor | String | - | 标题栏背景色 |
titleBarTextColor | String | - | 标题栏文字颜色 |
titleBarText | String | - | 标题栏文字(也可通过页面 跳转传递参数(titleBarText)设置) |
menu | Boolean | false | 是否显示标题栏右上角菜单按钮 |
pages | Object | - | 各个页面的显示样式, key为页面名(与路由中的页面名 保持一致),value为窗口显示样式, 页面样式覆盖default样式。 |
实例
{
"package": "com.application.demo",
"name": "myQuickapp",
"versionName": "1.0.0",
"versionCode": "1",
"minPlatformVersion": "101",
"icon": "/Common/logo.png",
"features": [
{ "name": "system.prompt" },
{ "name": "system.router" },
{ "name": "system.shortcut" }
],
"permissions": [
{ "origin": "*" }
],
"config": {
"logLevel": "debug"
},
"router": {
"entry": "Demo",
"pages": {
"Demo": {
"component": "index"
},
"DemoDetail": {
"component": "index"
},
"About": {
"component": "index"
}
}
},
"display": {
"titleBarBackgroundColor": "#f2f2f2",
"titleBarTextColor": "#414141",
"menu": true,
"pages": {
"Demo": {
"titleBarText": "示例页",
"menu": false
},
"DemoDetail": {
"titleBarText": "详情页"
},
"About": {
"menu": false
}
}
}
}