Skip to content

Manifest 配置

apps/<appname>/manifest 是 fnOS 应用的基础清单,使用 INI 风格的键值格式。

常用字段

字段说明
appname应用唯一标识,通常与应用目录名一致
version应用版本号,由根目录 bump 脚本统一维护
display_name应用中心显示名称
desc应用描述
platform目标架构,例如 x86armall
source应用来源,第三方应用通常为 thirdparty
maintainer原始项目维护者
maintainer_url原始项目地址
distributor当前分发者
desktop_uidir桌面入口 UI 目录
desktop_applaunchname桌面启动项名称
install_dep_apps应用依赖的运行时或中间件
os_min_version最低 fnOS 版本
micro_app是否作为微应用运行

版本约定

不要单独修改某个应用的版本来绕过项目版本流程。执行以下命令会同步更新根 package.json、所有应用 manifest 和 README 中的版本示例:

bash
pnpm run bump:patch
# 或 pnpm run bump:minor / pnpm run bump:major

校验建议

修改 Manifest 后至少检查:

  • appname 与目录名一致。
  • version 是合法的三段式版本号。
  • 依赖名称与 fnOS 应用中心可用的依赖一致。
  • desktop_uidirdesktop_applaunchname 与实际入口文件一致。

基于 VitePress 构建