开源鸿蒙 js标签配置

2022-08-09
浏览 (722)

js标签配置

开发框架需要应用的config.json中配置相关的js标签，其中包含了实例名称、页面路由、视图窗口配置信息。

标签	类型	默认值	必填	描述
name	string	default	是	标识ETS实例的名字。
pages	Array	-	是	页面路由信息，详见pages说明。
window	Object	-	否	视图窗口配置信息，详见window说明。
mode	Object	-	否	配置Js Component运行类型与语法风格，详见mode说明。

pages

定义每个页面入口组件的路由信息，每个页面由页面路径和页面名组成，页面的文件名就是页面名。比如：

{
    "pages": [
        "pages/index",
        "pages/detail"
    ]
}

说明： - pages列表中第一个页面为应用的首页入口。

页面文件名不能使用组件名称，比如：Text.ets、Button.ets等。

每个页面文件中必须包含页面入口组件(\@Entry装饰)。

window

window用于配置相关视图显示窗口，支持配置如下属性：

类型	默认值	说明
designWidth	-	配置视图显示的逻辑宽度，缺省默认720（智能穿戴默认454）。视图显示的逻辑宽度决定了lpx像素单位大小，如designWidth配置720时，在视图宽度为1440物理像素时，1lpx为2物理像素。详见lpx像素单位说明。

{
  ...
  "window": {
    "designWidth": 720
  }
  ...
}

mode

mode用于配置JS Component的运行类型与语法风格，支持如下属性：

类型	默认值	说明
type	-	配置该JS Component的运行类型，可选值为： - pageAbility：以ability的方式运行该JS Component。 - form：以卡片的方式运行该JS Component。
syntax	-	配置该JS Component的语法风格，可选值为： - hml：以hml/css/js风格进行编写。 - ets：以声明式语法风格进行编写。

说明： 不支持同时配置type类型为form，syntax类型为ets。

示例

config.json:

{
    "app": {
        "bundleName": "com.example.player",
        "version": {
            "code": 1,
            "name": "1.0"
        },
        "vendor": "example"
    },
    "module": {
        "js": [{            
            "name": "default",            
            "pages": [                
                "pages/index",                
                "pages/detail"            
            ],            
            "window": {                
                "designWidth": 720            
            },            
            "mode": {                
                "type": "pageAbility",                
                "syntax": "ets"            
            },        
        }],
        "abilities": [{
            ... 
        }]
    }
}