PUA
解锁 APP 开发最后一公里的新姿势。
PUA（Plugin Upload App）是一个面向 Flutter 项目的 VS Code 分发扩展，目标不是再造一个“上传按钮”，而是把应用从本地构建、版本整理、渠道配置到多平台分发这一整段最后一公里流程，收敛到一个可视化、可复用、可追踪的工作台里完成。
传统发布流程里，开发者往往需要在命令行、构建脚本、各家应用市场后台和测试分发平台之间来回切换。PUA 把这些碎片化动作重新编排成一个统一入口，让发布动作更短、反馈更及时、错误更容易定位。
为什么是 PUA
- 把构建、上传、分发、版本查询集中到 VS Code 内完成
- 降低发布过程对命令行和平台后台的依赖
- 用可视化配置替代重复输入，减少人为失误
- 用任务进度、取消、失败重试提升发布可控性
- 面向多平台分发场景，不再局限于单一测试分发工具
核心能力
1. 一键构建并分发
- 支持 Flutter Android / iOS 构建
- 支持自定义版本号、构建号
- 支持自动递增构建号
- 支持自定义 Dart 入口文件
- 支持自定义构建产物输出目录
- 支持全局更新说明，并可被平台级说明覆盖
2. 直接上传已有安装包
- 支持上传已有 APK / IPA 文件
- 适合 CI 产物复用、补发渠道包、跳过本地构建场景
3. 多平台统一分发配置
当前已接入平台包括：
- 蒲公英
- 华为应用市场
- 荣耀应用市场
- 小米应用商店
- OPPO 开放平台
- 魅族应用商店
- VIVO 开放平台
- 腾讯应用宝
- App Store
4. 平台版本总览
- 在扩展内查看已配置平台的在架版本信息
- 快速比对版本号、构建号、发布时间、状态
- 支持直接跳转平台后台或安装页
5. 发布任务可观测
- 展示构建和分发的完整任务进度
- 支持上传进度反馈
- 支持任务取消
- 支持单节点失败后重试
- 支持查看构建产物与分发结果
适用场景
- Flutter 应用日常测试包分发
- 多安卓渠道市场同步提审或上传
- iOS / Android 版本发布前的统一出包操作
- 希望在 VS Code 内完成“构建 + 分发 + 查版本”的团队流程
快速开始
1. 安装扩展
在 VS Code 中安装 PUA 扩展。
2. 打开扩展入口
可通过以下任一方式使用：
- 侧边栏打开
PUA
- 快捷键
Cmd+Shift+R / Ctrl+Shift+R
- 命令面板输入
PUA
3. 配置发布参数
在扩展面板中完成：
- Flutter 构建参数
- 版本名称 / 构建号
- Dart 入口文件
- 输出目录
- 全局更新说明
- 各平台 API 凭证与发布参数
4. 执行发布
根据场景选择：
推荐工作流
- 在
发布设置 中维护统一的构建参数
- 在
平台配置 中启用需要参与分发的渠道
- 先通过
平台版本总览 确认当前线上或测试版本状态
- 执行
构建并分发 或 上传已有安装包
- 根据任务结果决定是否重试失败节点或进入下一轮发布
设计理念
PUA 想解决的不是“如何再快一点上传一个包”，而是 APP 开发中最容易被忽视、却又最消耗注意力的最后一公里：
- 发布动作散落在不同平台
- 构建参数容易漂移
- 更新说明重复填写
- 渠道状态缺少统一视图
- 出错后很难快速恢复
所以在 1.0.0，我们把重点放在两个词上：
平台与凭证说明
不同平台需要各自的 API 凭证、应用标识或发布参数。请根据面板内字段提示和平台官方文档完成配置。
部分常用文档入口：
安全说明
- 平台敏感信息通过 VS Code 扩展配置和安全存储能力进行管理
- 建议使用最小权限原则配置各平台凭证
- 发布前请确认版本号、包名、渠道配置与更新说明
工具使用条款
使用本工具即表示您同意以下条款：
- 自觉遵守各分发平台服务协议及 API 使用规范
- 对因不当使用本工具而产生的任何后果自行负责
- 本工具作者不对任何违规使用行为或由此产生的损失承担责任
| |
