You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.5 KiB
2.5 KiB
裁剪基础能力
配置入口
app.config.json 中的 capabilities 是启动时固定的部署配置,默认全部启用:
{
"capabilities": {
"files": true,
"storage": true,
"credentials": true,
"updates": true
}
}
| 开关 | 关闭后的行为 |
|---|---|
| files | 不构造 FileService;隐藏文件导航,直接进入文件路由会回到首页 |
| storage | 不构造 StorageService,不打开 SQLite;隐藏笔记与 JSON 草稿演示 |
| credentials | 不构造 SecretService;隐藏凭证面板 |
| updates | 不构造 UpdateService,不注册 updater 监听;隐藏更新面板 |
窗口、配置、主题、角色授权和原生基础操作始终保留。storage 当前包含 JSON 与 SQLite,适合模板的演示组合;若产品只需要其中一种,再按真实需求拆开服务。关闭服务不会删除已有用户数据,也不会自动删除依赖或缩减安装包。
最小配置验证
可以修改配置并重新构建,或使用只能关闭能力的启动参数:
pnpm build
pnpm exec electron . --disable-capabilities=files,storage,credentials,updates
启动参数不能开启部署配置已经关闭的能力。未知名称会被拒绝。已打包程序也支持该参数;它不绕过来源、角色或输入输出校验。能力在一次应用运行期间固定,不支持 renderer 动态开关。
类型与授权
API 的类型结构保持稳定,不让每个能力组合都产生一套客户端类型。禁用能力的 API 会经过正常角色和输入校验,再返回 PRECONDITION_FAILED / DISABLED,不会创建服务。对应订阅也拒绝建立。
app.info 的 capabilities 由实际构造出的服务生成,renderer 据此展示功能。moduleIds 只展示本次启用的路由组。配置不是方法授权清单;方法权限仍定义在所属 procedure。
新增可选能力
需要资源的能力使用 optionalService 在入口构造,立即登记 Scope 清理;所属 router 通过 requireCapability 显式取得服务。只有真正需要部署选择的能力才添加开关,普通业务接口不需要自动升级为插件。
验证至少包含:关闭时构造函数不执行、调用与订阅被拒绝、界面不创建对应功能、开启后行为正常、退出释放资源。真实 Electron E2E 已覆盖默认组合及全部可选能力关闭的组合。