manifest 文件

更新时间：2025-04-16 11:53:40

manifest.json 文件中包含了应用描述、接口声明、页面路由信息

manifest

属性	类型	默认值	必填	描述
package	string	-	是	应用包名，确认与原生应用的包名不一致，推荐采用 com.company.module 的格式，如：com.example.demo
name	string	-	是	应用名称，6 个汉字以内，与应用商店保存的名称一致，用于在桌面图标、弹窗等处显示应用名称
icon	string	-	是	应用图标，提供 114x114 大小的即可
versionName	string	-	否	应用版本名称，如：`"1.0"`
versionCode	number	-	是	应用版本号，从`1`自增，推荐每次重新上传包时`versionCode`+1
features	FeatureInfo[]	-	否	接口列表，绝大部分接口都需要在这里声明，否则不能调用，详见每个接口的文档说明
config	Config	-	是	系统配置信息，详见下面说明
router	Router	-	是	路由信息，详见下面说明
deviceTypeList	Array<string>	watch	否	可选值有：`watch`, `watch-square`, `watch-round`, `tv` , `car`, `phone`
display	Display	-	否	UI 显示相关配置，详见下面说明
permissions	PermissionInfo[]	-	否	权限申请示例:[{ "name": "watch.permission.LOCATION" }]
appCategory	AppCategory[]	-	是	应用类别,可选值详见下文应用类别说明,最多 2 个分类
distributionRules	DistributionRules	-	否	表示分发规则，定义包对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括minAPILevel

appCategory 要求开发者必填，如有开发者未填，系统将设置为 ['other']。

声明应用需要使用的 feature

属性	类型	默认值	描述
name	string	-	feature 名称，可在具体feature的说明文档中查阅

示例：

{ 
  "name": "blueos.storage.file" 
}

复制代码

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

属性	类型	默认值	描述
designWidth	number	-	页面设计基准宽度，根据实际设备宽度来缩放元素大小，建议使用 466

示例：

{ 
  "designWidth": 466 
}

复制代码

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

属性	类型	默认值	必填	描述
entry	string	-	是	首页名称
pages	Record<string, Page>	-	是	页面配置列表，key 值为页面名称（对应页面目录名，例如 Hello 对应'Hello'目录），value 为页面详细配置 page，详见下面说明

示例：

{
  "entry": "Demo",
  "pages": {
    "Demo1": {
      "component": "index"
    },
    "Demo2": {
      "component": "index"
    }
  }
}

复制代码

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

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

用于定义与 UI 显示相关的配置。

如果在 display 对象下定义以下属性值，则生效范围为此蓝河应用全部页面；

属性	类型	默认值	描述
backgroundColor	string	#000	窗口背景颜色

示例：

{
  "backgroundColor": "#ffffff"
}

复制代码

权限配置信息

属性	类型	默认值	含义
name	PermissionName	-	权限名

示例：

{ 
  "name": "watch.permission.LOCATION" 
}

复制代码

分发规则详细信息

属性	类型	默认值	含义
minAPILevel	number	1	表示最低的 APILevel 要求，只有支持该 APILevel 的系统版本，才能被分发。

示例：

{
  "minAPILevel": 2
}

复制代码

权限名及模块接口信息，该信息也可以在具体的模块文档中查看。

权限名	模块	需要权限申请的具体接口	说明	权限错误码
watch.permission.LOCATION	@blueos.hardware.geolocation	getLocation() subscribe() unsubscribe()	位置信息	400 : 拒绝授予权限, 402: 权限错误（未声明该权限）
watch.permission.STEP_COUNTER	@blueos.hardware.sensor	subscribeStepCounter()	计步传感器	400 : 拒绝授予权限, 402: 权限错误（未声明该权限）
watch.permission.DEVICE_INFO	@blueos.hardware.device	getId() getDeviceId() getSerial()	设备信息	400: 拒绝授予权限 , 402: 权限错误（未声明该权限）
watch.permission.RECORD	@blueos.multimedia.record	start() stop() release()	录音	400: 拒绝授予权限, 401: 敏感权限不能在后台运行, 402: 权限错误（未声明该权限）
watch.permission.BLUETOOTH	@blueos.communication.bluetooth.bluetooth @vivo.bluetooth	getBindState() startBind() confirmBind() cancelBind() startDevicesDiscovery() onDevicefound stopDevicesDiscovery() getConnectedDevices() getPairedDevices() createConnection() closeConnection() pair() unpair() subscribeBind() clearBindData() replyPhone() onadapterstatechange	允许使用设备蓝牙	400 : 拒绝授予权限, 402: 权限错误（未声明该权限）
watch.permission.READ_HEALTH_DATA	@blueos.health.health @vivo.health	getRecentSamples() subscribeSample() unsubscribeSample() getTodayStatistic() subscribeTodayStatistic() unsubscribeTodayStatistic()	读取健康数据	400 : 拒绝授予权限, 402: 权限错误（未声明该权限）