Skip to content

打包与发布 ​

插件做好后,打成一个 .lpxs 文件就能发给别人本地安装;想让所有用户都能搜到,就在开发者工具里提交到插件市场,审核通过后上架。

打包前检查 ​

  • [ ] 执行过 pnpm build,src-ling/dist/ 是最新的构建产物(开发者工具只打包插件目录里现有的文件,不会替你构建);
  • [ ] plugin.json 的 main 指向构建产物(如 dist/index.html),而不是开发服务;
  • [ ] permissions 只包含真正用到的权限;
  • [ ] logo 是清晰的正方形图标(市场里显示的就是它);
  • [ ] 用到了较新的 API 时写了 minAppVersion;
  • [ ] 插件目录里没有源码、node_modules(preload 需要的除外)、测试文件等不该打进包的东西。

打成 .lpxs ​

  1. 在开发者工具里选中项目,按 ⌘ P(Windows 为 Ctrl P)打包;
  2. 确认版本号(默认在上次打包的版本上加一),选择保存位置(默认「下载」文件夹);
  3. 得到 <name>-<version>.lpxs。打包时版本号会写回 plugin.json。

.lpxs 是 lingtools 的插件包格式:插件目录里的全部文件压缩在一个文件里,并带有每个文件的校验值。

本地安装 ​

把 .lpxs 文件拖进(或复制后粘贴到)lingtools 搜索框,选择「安装插件包」,确认页会显示插件名称、版本、作者和简介,点安装即可。

  • 本地安装的插件在插件管理里带「本地」标记;
  • 同名插件视为同一个插件:安装会替换已有的版本,但不会用旧版本覆盖新版本;
  • 平台不符或 lingtools 版本低于 minAppVersion 时,确认页会显示原因并禁止安装。

可以用这种方式把插件发给同事、在别的电脑上测试,或者在提交市场前最后验证一遍正式版的表现。

发布到插件市场 ​

准备 ​

  • 在 lingtools 设置的「账户」里登录(任何账号都可以发布);
  • 准备展示信息:一句话介绍、详细介绍、截图(最多 8 张,每张不超过 3 MiB)、分类。

提交 ​

  1. pnpm build 构建最新的页面;
  2. 在开发者工具里打开项目详情,选择「发布」;
  3. 填写版本号、更新说明和展示信息,提交。

开发者工具会现场打包并上传,不需要你先手动打包。上传成功后才把版本号写回 plugin.json,失败时源码不变。

名字与版本规则 ​

  • 名字先到先得:第一次提交(即使还在审核中)就把 name 记到你的账号下,之后只有你能给它发新版本。名字不能以 dev- 开头,也不能使用 lingtools 保留的名字。
  • 版本号必须递增:新版本号必须大于这个插件所有提交过的版本(包括被驳回、已撤回的),用过的版本号不能再用。
  • 同一插件同时只能有一个待审核版本。等不及审核结果时可以撤回待审版本,再提交新的。
  • 市场图标只取包里 plugin.json 的 logo,想换图标就改 logo 再发新版本。

大小限制 ​

内容上限
安装包20 MiB
logo 文件1 MiB
截图每张 3 MiB,最多 8 张

审核 ​

每个版本都要审核,首次发布和每次更新都一样。审核时会实际安装试用,重点关注:

  • 申请的权限是否与功能相符,有没有新增权限;
  • 是否带 Node 后端(preload)、是否运行本地程序;
  • 展示信息是否真实。

审核通过后版本立即上架,已安装的用户可以在插件市场里更新;被驳回时会给出理由,修改后用新的版本号重新提交。提交记录和审核结果在开发者工具的项目详情里查看。

市场只保留每个插件最新的两个已发布版本供下载。