# 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 - 支持的最小平台版本号,兼容性检查,避免上线后在低版本平台运行并导致不兼容;如果不填按照内测版本处理
features Array - 接口列表,绝大部分接口都需要在这里声明,否则不能调用,详见每个接口的文档说明
config Object - 系统配置信息,详见下面说明
router Object - 路由信息,详见下面说明
display Object - UI 显示相关配置,详见下面说明
deviceTypeList Array<String> watch 可选值有:watch, tv , car, phone, 现只支持watch
minAPILevel 3+ Integer - 支持的最小 APILevel,兼容性检查,避免上线后在低版本平台运行并导致不兼容;如果不填按照 1 处理

# config

用于定义系统配置和全局数据。

属性 类型 默认值 描述
designWidth Integer -- 页面设计基准宽度,根据实际设备宽度来缩放元素大小

# router

用于定义页面的组成和相关配置信息,如果页面没有配置路由信息,则在编译打包时跳过。

属性 类型 默认值 必填 描述
entry String - 首页名称;使用分包功能时,建议将首页定义在基础包中
pages Object - 页面配置列表,key 值为页面名称(对应页面目录名,例如 Hello 对应'Hello'目录),value 为页面详细配置 page,详见下面说明

示例代码:

"router": {
  "entry": "Demo",
  "errorPage": "ErrorPage",
  "pages": {
    "Demo": {
      "component": "index"
    },
    "ErrorPage": {
      "component": "index"
     },
  }
}
1
2
3
4
5
6
7
8
9
10
11
12

# router.pages

用于定义单个页面路由信息。

属性 类型 默认值 必填 描述
component String - 页面对应的组件名,与 ux 文件名保持一致,例如'hello' 对应 'hello.ux'
path String /<页面名称> 页面路径,例如“/user”,不填则默认为/<页面名称>。
path 必须唯一,不能和其他 page 的 path 相同。
下面 page 的 path 因为缺失,会被设置为“/Index”:
"Index": {"component": "index"}
launchMode String standard 声明页面的启动模式,支持"singleTask","standard"两种页面启动模式。
标识为"singleTask"模式时每次打开目标页面都会打开已有的目标页面并回调 onRefresh 生命周期函数,清除该页面上打开的其他页面,没有打开过此页面时会创建新的目标页面实例。
标识为"standard"模式时会每次打开新的目标页面(多次打开目标页面地址时会存在多个相同页面)

# pageAnimation 3+

用于配置页面切换动画。除了下面示例中的两种动画配置方法之外,在 router.push 时可以通过 ___PARAM_PAGE_ANIMATION___ 配置页面切换动画。配置生效优先级 ___PARAM_PAGE_ANIMATION___ > display.pages.pageAnimation,注意高优先级 pageAnimation 配置会覆盖低优先级 pageAnimation 配置。

属性 类型 默认 描述
openEnter String slide 打开进入当前页时当前页动画,可选值 slide, none
closeEnter String slide 关闭返回当前页时当前页动画,可选值 slide, none
openExit String slide 打开下一页,退出当前页时当前页动画,可选值 slide, none
closeExit String slide 返回上一页,退出当前页时当前页动画,可选值 slide, none

slide 模式在各动作下的动画变化详情如下:

页面动作 动画变化 动画时长
openEnter x from 100%~0 300ms
closeEnter x from -25%~0, alpha 0.6~1.0 300ms
openExit x from 0~-25%, alpha 1.0~0.6 300ms
closeExit x from 0~100% 300ms

# 示例:

{
  "display": {
    "entry": "Form",
    "pageAnimation": {
      "openEnter": "none",
      "closeEnter": "none",
      "openExit": "none",
      "closeExit": "none"
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11