SuperAPI AI 工具集

configuring-webapp-metadata

前端与建站

查看项目

更新于 10-15 21:43

技能介绍

用途:该技能用于配置 Web 应用元数据结构,包括 WebApplication bundle 布局、webapplication.json 与 meta XML 的组织方式。

主要能力与规则: Bundle 规则:bundle 必须位于 webapplications/<AppName>/ 下,必须包含 <AppName>.webapplication-meta.xml,元数据文件名须与文件夹名完全一致;必须存在构建输出目录且至少含一个文件,默认目录为 dist/,若 webapplication.json.outputDir 已设置则覆盖 dist/。

元数据 XML:必填字段为 masterLabel、version(最多 20 字符)、isActive(布尔值);可选字段为 description(最多 255 字符)。

webapplication.json:可选,仅允许顶层键 outputDir、routing、headers;须为合法 UTF-8 JSON,最大 100 KB,根必须为非空对象,禁止 {}、数组或原始值作为根。

路径安全:适用于 outputDir 与 routing.fallback,拒绝反斜杠、前导 / 或 \、.. 段、null 或控制字符、glob(*、?、**)及 %;所有解析路径须留在应用 bundle 内。

outputDir:须为非空字符串,仅引用子目录,拒绝 . 与 ./,目录须存在且至少含一个文件。

routing:若存在须为非空对象,仅允许 rewrites、redirects、fallback、trailingSlash、fileBasedRouting。trailingSlash 取值为 "always"、"never"、"auto";fileBasedRouting 为布尔值;fallback 为非空字符串且须满足路径安全、目标文件须存在;rewrites 为非空数组,每项为非空对象,允许键 route、rewrite,rewrite 为非空字符串,route 若存在须为非空字符串;redirects 为非空数组,每项为非空对象,允许键 route、redirect、statusCode,redirect 为非空字符串,statusCode 若存在取 301、302、307、308。

headers:若存在须为非空数组,每项为非空对象,允许键 source、headers;headers 为非空数组,每项含非空字符串 key 与 value。

禁止建议:{} 作为 JSON 根、"routing": {}、空数组、空数组项如 [{}]、"outputDir": "."、"outputDir": "./"。

适用场景:需要按规范创建或校验 WebApplication bundle、编写 webapplication.json 与 meta XML 时。限制:资料未提供具体平台、收费、价格或效果信息。