Skip to main content
浏览文档目录
第 12 章

打包、分发与更新

pack、版本号、更新与降级、官方认证

Terminal
npx uniflow-plugin pack            # → <id>-<version>.uniplugin(同时刷新 dist/)
npx uniflow-plugin validate x.uniplugin
  • 打包是确定性的(固定时间戳与文件顺序):同样的源码打出同样的字节、同样的 sha256。
  • 分发有两条路:上架插件商店(推荐,见下一节),或把 .uniplugin 直接发给用户,用户在插件库「已安装 › 从文件添加」或拖进插件库。安装对话框显示名字、版本、作者、大小、 权限(按风险标色)、UniMind 能调用哪些命令,第三方插件有醒目的「未经审核,只安装你信任的来源」提示。
  • 安装后立即生效:命令注册进 UniMind,面板可以打开,不用重启、不用更新应用。
  • 已安装的插件在插件库里可以:开关、打开、详情、导出(原样导出成 .uniplugin)、移除(数据保留)。

上架插件商店

UniFlow 桌面端侧边栏的「插件」就是插件商店,内容来自 UniFlow 网站。上架流程:

  1. 登录 开发者中心,创建开发者资料(handle、显示名、头像、网站、支持邮箱)。
  2. 新建插件:填插件 id(必须等于 plugin.json 的 id,全商店唯一、先到先得)与分类。
  3. 编辑商店页:中英文名称、一句话介绍、详细介绍(Markdown)、强调色、支持与隐私政策链接;上传素材:
    素材 规格 用在哪
    Banner 16:7,至少 1600×700,推荐 2400×1050,PNG / JPEG / WebP ≤ 5MB 首页大幅轮播、编辑精选卡片、详情页顶部。左下角约 45% 宽 × 40% 高会叠加图标、名字、一句话和按钮,重要内容放右侧与上部,那一块保持干净
    图标 1:1,至少 256×256(推荐 1024×1024) 列表、详情页、已安装
    截图 16:10,至少 1200×750(推荐 1600×1000),最多 8 张,每张可写中英文说明 详情页画廊
  4. 提交版本:上传 uniflow-plugin pack 打出的 .uniplugin 与更新说明。服务端用与应用安装时同一套规则校验包, 还会检查:manifest.id 等于条目 id、版本号高于已通过的最高版本、同一时间只有一个待审核版本。
  5. 审核:UniFlow 团队按安全模型与审核规范的清单审核(重点看新增的权限、给 UniMind 的命令说明、确认卡片是否说实话)。 通过后插件自动上架,用户在商店里立刻能看到、装上即用;驳回会附上理由,改完再提交。
  6. 更新:提交更高版本号的包,审核通过后,已安装的用户在商店「已安装」里看到「更新」(新增的权限在更新确认里标红)。 你可以随时把插件下架(已安装的用户照常使用,商店不再展示)或重新上架。

商店里显示的评分、评论与安装数来自真实用户;官方插件、认证开发者有对应标记。

更新

  • 发新版:version 必须升;用户添加新文件时对话框显示「更新 1.2.0 → 1.3.0」,新增的权限单独标红。
  • 降级:允许但会警告(旧版本可能读不懂新数据)。
  • 数据格式要向前兼容,见存储 · 数据迁移。
  • 需要新版宿主能力时写 minAppVersion,旧版 UniFlow 会拒绝安装并说明原因。

官方插件与「官方」标记

官方插件随应用内置(插件库「可添加的官方插件」里一键添加回来)。它们的包的 sha256 登记在应用的官方清单里: 导出再添加回来依然是「官方」;改过一个字节就不是了,且不能再用官方插件的 id —— 想基于官方插件改一个自己的版本, 复制源码、换一个 id 发布即可。