Skip to main content
Browse the docs

The developer docs are currently available in Chinese only. The SDK, the CLI and every code sample work the same in any language.

Chapter 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 发布即可。