# 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
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
2
3
4
5
6
7
8
9
10
11
←
→