用 GitHub Actions 自动构建 APK
配置机密变量
进入你自己的 Fork 仓库页面:
- 点击顶部菜单的「Settings」
- 左侧菜单找到「Secrets and variables」下面的「Actions」
- 点击「New repository secret」按钮

你需要创建以下 4 个机密变量(名称必须完全一致):
| 变量名 | 值 |
|---|---|
ALPHA_KEYSTORE_BASE64 | 上一页生成的 keystore.jks 文件的 Base64 内容 |
ALPHA_KEYSTORE_PASSWORD | 你设置的 Keystore 密码 |
ALPHA_KEY_ALIAS | 你设置的别名 |
ALPHA_KEY_PASSWORD | 别名密码 |

机密变量创建后会显示在列表中,但值永远不可见——后续如果你忘了填的是什么,只能删了重新创建。
手动触发构建
机密变量配置完成后:
- 切换到你 Fork 仓库的「Actions」标签页
- 在左侧工作流列表中找到「Build and Upload Compose APK (Alpha)」
- 点击「Run workflow」下拉按钮
- 点击弹窗中的「Run workflow」按钮开始构建

新用户可能需要先授权启用 Actions——按提示操作一次即可。
等待构建
运行完成后,工作流会从黄色(进行中)变成绿色(成功)或红色(失败)。整个构建过程大约需要 12 分钟——包含拉取代码、编译、签名、打包等步骤。

如果显示红色失败,点击进入查看具体错误。最常见的失败原因是机密变量配置错误(密码或别名写错)。
下载构建产物
构建成功后,滚动到 Actions 运行页面的最底部,会看到「Artifacts」区域列出的构建产物。


BILIBILIAS 的流水线会产出 4 个 APK:
| 产物名 | 适用场景 |
|---|---|
APK-alpha-arm64-v8a | 主流 arm64 架构,绝大多数现代 Android 设备用这个 |
APK-alpha-armeabi-v7a | 较老的 32 位 arm 设备 |
APK-alpha-x86 | x86/x86_64 架构(模拟器、少数特殊设备) |
APK-alpha-universal | 包含所有架构,体积最大但兼容性最好 |
推荐: 不知道选哪个就直接下 APK-alpha-universal——体积大一点但不用担心架构不匹配。如果你的设备比较新,可以选 APK-alpha-arm64-v8a 节省下载时间。