bili-small-app-service

同构小程序构建工具

本地构建 -> 上传QQ后台，获取上传后的开发版链接 -> 生成二维码（添加构建人、版本号、commit_id）->企微机器人通知发送二维码到群

安装方法(Install）

方式一：（当前方案）

1. 拉取https://git.bilibili.co/smallapp/bili-small-app-builder仓库代码
2. 拉取的代码根目录下执行：npm install or yarn 安装包依赖
3. npm link or yarn link

方式二：直接 npm 安装全局 (暂时不用)

yarn global add bili-small-app-builder

或

npm i -g bili-small-app-builder

使用方法(Usage)

前置条件：

开启QQ开发者工具安全端口 并 登录，QQ开发者工具版本请保证是0.3.1，下载地址：0.3.1

命令行常用使用范例：

• 全量打包上传，自动叠加第四位版本号并复制最终的 app.json 文件：

bss uni -ai -j -v ++ -u "本次更新内容说明"

• 只打包频道、详情页，不更新版本号，也不上传：

bss uni -ai -p channel,detail -v

• 不打包，不更新版本，只上传：(多用于，构建成功但上传失败的情况)

bss uni -v -U "本次更新内容说明"

命令行参数说明(Cli Options)

执行bss uni --help可以查看参数使用说明

参数名	简介	必填	可选值/格式	默认行为
-ai, --auto-install	是否自动更新npm包依赖	N		不自动更新
-i, --install	是否重新安装npm包依赖	N		不重新安装
-j, --json	是否拷贝 app.json 文件	N	需要拷贝的 app.json 文件路径配置在 bl.config.js 内，详见下文说明	不拷贝
-p, --pages <pages>	仅打包指定页面	N	页面名称用英文逗号隔开	全量打包
-v, --appVersion [version]	更新版本号	N	见具体说明	不更新版本
-u, --upload [message]	是否上传	N	见具体说明	不上传
-U, --upload-only [message]	是否仅上传	N	传了这个参数，不做任何构建，仅上传。会忽略 -u, -ai, -j, -p，仅 -v 生效见具体说明	不上传

-v, --appVersion [version]

写法	说明	效果示例
(不写开关)	命令行等待用户输入版本号，输入格式同下
-v	不更新版本号
-v ""	不更新版本号
-v +	第三位数字+1	1.2.3 --> 1.2.4 1.2.3.1 --> 1.2.4
-v ++	第四位数字+1	1.2.3 --> 1.2.3.1 1.2.3.1 --> 1.2.3.2
-v +++	第三位数字+1，第四位数字改成 1	1.2.3 --> 1.2.4.1 1.2.3.1 --> 1.2.4.1
-v -	抹去第四位数字，保留前三位	1.2.3 --> 1.2.3 1.2.3.1 --> 1.2.3
-v 2.3.4	改成对应版本号，必须是 3 位以上才有效，否则不更新版本号

-u, --upload [message]

写法	说明
(不写开关)	不上传（写了 -U 除外）
-u	上传，message 留空（写了 -U 除外）
-u ""	上传，message 留空（写了 -U 除外）
-u "......"	带 message 上传（写了 -U 除外）

-U, --upload-only [message]

写法	说明
(不写开关)	不上传（写了 -u 除外）
-U	仅上传，message 留空
-U ""	仅上传，message 留空
-U "......"	仅上传，带 message 上传

相关资源

• tapd: https://www.tapd.bilibili.co/43838420/prong/tasks/view/1143838420002378287
• QQ后台地址：https://q.qq.com/#/

常见问题(Q & A)

---

Q: 构建完成后，去哪里查看我的二维码？

A: 推送结果 -> 企微群（群名:QQ小程序构建二维码）中推送下图的生成二维码，右上是版本号，左下是commit_id。

• 二维码分为粉色（完整版），黑色（只打部分页面）两种

---

Q: 如果遇到截图问题，应该怎么办？

A: 关掉QQ小程序开发者工具（CMD + Q），重新运行构建命令即可

---

bl.config.js (待补充)

版本历史 (Version History) （暂略）

维护者(Author)

@SYY @alexq @shuangwhywhy