ext.json配置说明

ext.json定义

ext.json是一个配置文件，放置在元服务项目的根目录下。当使用模板生成应用时，用于承载应用信息（AppID、服务名称、资源网址等）以及模板的可变的配置。

配置字段说明

属性	类型	是否必填	描述
extAppId	String	是	配置待构建应用的appid。
ascfConfig	Object	否	可替换ASCF框架模板资源的配置。即替换hap/resources/rawfile/manifest.json的相关资源，除entryPagePath之外支持增量替换。 ascfConfig详细内容请参见ascfConfig。相比ArkUI框架，ASCF框架能替换的资源更多，包括Client_id、主包资源、分包资源、全局配置、运行配置数据、页面配置数据、默认启动页等。

属性

类型

是否必填

描述

extAppId

String

是

配置待构建应用的appid。

ascfConfig

Object

否

可替换ASCF框架模板资源的配置。

即替换hap/resources/rawfile/manifest.json的相关资源，除entryPagePath之外支持增量替换。

ascfConfig详细内容请参见ascfConfig。

相比ArkUI框架，ASCF框架能替换的资源更多，包括Client_id、主包资源、分包资源、全局配置、运行配置数据、页面配置数据、默认启动页等。

ascfConfig

属性	类型	是否必填	描述
entryPagePath	字符串	否	启动页的路径。此字段不支持增量替换。
pages	Object	否	pages节点下的页面设置。 pages下的“pages/discovery/discovery”是用于定位具体位置。实际仅替换info下的内容。
tabBar	Object	否	全局的导航栏设置。 tabBar详细内容请参见tabBar。
window	Object	否	全局的窗口设置。 window详细内容请参见window。

tabBar

属性	类型	是否必填	描述
backgroundColor	字符串	否	导航栏的背景颜色。
borderStyle	字符串	否	导航栏的边框风格。
color	字符串	否	导航栏的颜色。
list	对象数组	否	导航栏中组件的配置清单。 list详细内容请参见list。
selectedColor	字符串	否	导航栏选中后的颜色。

list

属性	类型	是否必填	描述
iconPath	字符串	否	导航栏中组件的图标路径。
pagePath	字符串	否	导航栏中组件的跳转页面路径。
selectedIconPath	字符串	否	导航栏中组件的被选中后图标路径。
text	字符串	否	导航栏中组件的名称文本。

window

属性	类型	是否必填	描述
backgroundColor	字符串	否	全局的窗口背景颜色。
backgroundTextStyle	字符串	否	全局的窗口字体风格。
enablePullDownRefresh	枚举值	否	全局的窗口是否支持下拉更新。
navigationBarBackgroundColor	字符串	否	全局的窗口导航栏的背景颜色。
navigationBarTextStyle	字符串	否	全局的窗口导航栏标题风格。
navigationBarTitleText	字符串	否	全局的窗口导航栏标题名称。

ext.json样例

以下是一个构建元服务的ext.json的样例：

{
   "extAppId": "1118669435474119700", 
   "ascfConfig": {
        "entryPagePath": "entryPagePath",
        "pages": {
            "pages/discovery/discovery": {
                "info": {
                    "navigationBarTitleText": ""
                }
            }
        },
        "tabBar": {
            "backgroundColor": "#FFFFFF",
            "borderStyle": "white",
            "color": "#626567",
            "list": [
                {
                    "iconPath": "images/index.png",
                    "pagePath": "pages/index/index",
                    "selectedIconPath": "images/index_focus.png",
                    "text": ""
                }
            ],
            "selectedColor": "#2A8CE5"
        },
        "window": {
            "backgroundColor": "#F4F4F4",
            "backgroundTextStyle": "light",
            "enablePullDownRefresh": true,
            "navigationBarBackgroundColor": "#0068C4",
            "navigationBarTextStyle": "white",
            "navigationBarTitleText": "知乎"
        }
    }
}