​
先决条件

发布前，请确保您已准备：

  • 一个完整且经过测试的插件
  • 一个公开的GitHub仓库
  • 一个有效的GitHub账户
  • 已安装Github Cli Github Cli

​
发布流程

​
1. 准备您的插件

发布前，请确保您的插件满足所有要求：

  1. 更新您的plugin.json中的最新版本号

  2. 确保plugin.json中所有必填字段都已填写：

    {
  "name": "your-plugin-name",
  "author": "your-name",
  "url": "https://github.com/your-username/your-plugin",
  "version": "1.0.0",
  "minAppVersion": "0.0.0",
  "displayName": {
    "default": "Your Plugin Name",
    "zh": "你的插件名称"
  },
  "description": {
    "default": "Your plugin description",
    "zh": "你的插件描述"
  }
}

  3. 彻底测试您的插件

  4. 提交并推送所有更改到GitHub

​
2. 运行发布命令

模板提供了一个简单的命令来处理发布过程：

bun release:publish

此命令将：

  1. 为生产环境构建您的插件
  2. 创建发布包（release.zip）
  3. 使用该包创建GitHub发布
  4. 将您的插件提交到Blinko插件市场

​
3. 幕后过程

release:publish命令使用blinko-cli处理发布过程。以下是具体流程：

  1. CLI验证您的plugin.json并确保所有必填字段都存在
  2. 将您插件的release目录打包成ZIP文件
  3. 使用GitHub的API，以您的版本号创建新的发布
  4. 发布包被上传到GitHub发布中
  5. 在Blinko插件市场仓库中创建一个问题请求发布

​
4. 发布后

运行发布命令后：

  1. 将在Blinko插件市场中创建一个新问题
  2. Blinko团队将审核您的插件
  3. 一旦获得批准，您的插件将在市场中可用
  1. 您可以通过GitHub问题跟踪您的提交状态

​
故障排除

​
常见问题

  1. GitHub身份验证

    • 确保您已配置正确的GitHub凭据
    • 检查您的仓库权限

  2. 版本号问题

    • 确保您的版本遵循语义化版本控制（例如，1.0.0）
    • 版本号必须高于先前的发布版本

  3. 发布包问题

    • 验证您的发布目录包含所有必要的文件
    • 检查ZIP文件是否成功创建

  4. 仓库访问

    • 确认您的仓库是公开的
    • 验证plugin.json中的仓库URL是否正确

​
需要帮助？

如果您遇到任何问题或需要帮助：