快应用入门:配置文件manifest文件

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
      }
    }
  }
}

你可能感兴趣的:(快应用)