app.json(.js|.ts)?

app.json(.js|.ts)? 是小程序应用配置入口。

支持哪些形式

• app.json
• app.json.js
• app.json.ts

它通常负责

• pages
• subPackages
• tabBar
• appBar
• 全局窗口配置

和目录结构的关键关系

• tabBar.custom === true 时，会启用 custom-tab-bar/
• 配置了 appBar 时，会启用 app-bar/
• 如果你开启了自动路由，可以通过脚本方式把扫描结果写回这里

什么时候用脚本化形式

如果你的配置需要消费变量、函数结果或自动路由数据，app.json.ts / app.json.js 会比纯 JSON 更合适。

import autoRoutes from 'weapp-vite/auto-routes'
import { defineAppJson } from 'weapp-vite/json'

export default defineAppJson({
  pages: autoRoutes.pages,
  subPackages: autoRoutes.subPackages,
})

glass-easel 配置

WebView glass-easel 是显式启用的兼容方案，weapp-vite 模板默认不启用。开发者工具只提供低于 3.8.12 的基础库时应保持回退；componentFramework: "glass-easel" 单独存在不会开启 WebView glass-easel。确认开发者工具与真机基础库均不低于 3.8.12 后，再由用户在宿主 JSON 中成对配置：

{
  "componentFramework": "glass-easel",
  "glassEaselWebview": true
}

Page 和 Plugin 也使用相同字段；插件必须直接写在 plugin.json。weapp-vite 不提供 weapp.glassEasel 之类的重复配置，宿主 JSON 是唯一配置源；删除或关闭 glassEaselWebview 即可回退。显式启用后可运行 wv analyze --glass-easel-check，详见 Analyze 报告配置。