打包与发布
插件做好后,打成一个 .lpxs 文件就能发给别人本地安装;想让所有用户都能搜到,就在开发者工具里提交到插件市场,审核通过后上架。
打包前检查
- [ ] 执行过
pnpm build,src-ling/dist/是最新的构建产物(开发者工具只打包插件目录里现有的文件,不会替你构建); - [ ]
plugin.json的main指向构建产物(如dist/index.html),而不是开发服务; - [ ]
permissions只包含真正用到的权限; - [ ]
logo是清晰的正方形图标(市场里显示的就是它); - [ ] 用到了较新的 API 时写了
minAppVersion; - [ ] 插件目录里没有源码、
node_modules(preload 需要的除外)、测试文件等不该打进包的东西。
打成 .lpxs
- 在开发者工具里选中项目,按 ⌘ P(Windows 为 Ctrl P)打包;
- 确认版本号(默认在上次打包的版本上加一),选择保存位置(默认「下载」文件夹);
- 得到
<name>-<version>.lpxs。打包时版本号会写回plugin.json。
.lpxs 是 lingtools 的插件包格式:插件目录里的全部文件压缩在一个文件里,并带有每个文件的校验值。
本地安装
把 .lpxs 文件拖进(或复制后粘贴到)lingtools 搜索框,选择「安装插件包」,确认页会显示插件名称、版本、作者和简介,点安装即可。
- 本地安装的插件在插件管理里带「本地」标记;
- 同名插件视为同一个插件:安装会替换已有的版本,但不会用旧版本覆盖新版本;
- 平台不符或 lingtools 版本低于
minAppVersion时,确认页会显示原因并禁止安装。
可以用这种方式把插件发给同事、在别的电脑上测试,或者在提交市场前最后验证一遍正式版的表现。
发布到插件市场
准备
- 在 lingtools 设置的「账户」里登录(任何账号都可以发布);
- 准备展示信息:一句话介绍、详细介绍、截图(最多 8 张,每张不超过 3 MiB)、分类。
提交
pnpm build构建最新的页面;- 在开发者工具里打开项目详情,选择「发布」;
- 填写版本号、更新说明和展示信息,提交。
开发者工具会现场打包并上传,不需要你先手动打包。上传成功后才把版本号写回 plugin.json,失败时源码不变。
名字与版本规则
- 名字先到先得:第一次提交(即使还在审核中)就把
name记到你的账号下,之后只有你能给它发新版本。名字不能以dev-开头,也不能使用 lingtools 保留的名字。 - 版本号必须递增:新版本号必须大于这个插件所有提交过的版本(包括被驳回、已撤回的),用过的版本号不能再用。
- 同一插件同时只能有一个待审核版本。等不及审核结果时可以撤回待审版本,再提交新的。
- 市场图标只取包里
plugin.json的logo,想换图标就改logo再发新版本。
大小限制
| 内容 | 上限 |
|---|---|
| 安装包 | 20 MiB |
logo 文件 | 1 MiB |
| 截图 | 每张 3 MiB,最多 8 张 |
审核
每个版本都要审核,首次发布和每次更新都一样。审核时会实际安装试用,重点关注:
- 申请的权限是否与功能相符,有没有新增权限;
- 是否带 Node 后端(preload)、是否运行本地程序;
- 展示信息是否真实。
审核通过后版本立即上架,已安装的用户可以在插件市场里更新;被驳回时会给出理由,修改后用新的版本号重新提交。提交记录和审核结果在开发者工具的项目详情里查看。
市场只保留每个插件最新的两个已发布版本供下载。