BILIBILIAS 中文文档 下载 App

用 GitHub Actions 自动构建 APK

配置机密变量

进入你自己的 Fork 仓库页面:

  1. 点击顶部菜单的「Settings」
  2. 左侧菜单找到「Secrets and variables」下面的「Actions」
  3. 点击「New repository secret」按钮
仓库 Settings 页面的 Actions 机密变量入口

你需要创建以下 4 个机密变量(名称必须完全一致):

变量名值
ALPHA_KEYSTORE_BASE64上一页生成的 keystore.jks 文件的 Base64 内容
ALPHA_KEYSTORE_PASSWORD你设置的 Keystore 密码
ALPHA_KEY_ALIAS你设置的别名
ALPHA_KEY_PASSWORD别名密码
创建机密变量的弹窗

机密变量创建后会显示在列表中,但值永远不可见——后续如果你忘了填的是什么,只能删了重新创建。

手动触发构建

机密变量配置完成后:

  1. 切换到你 Fork 仓库的「Actions」标签页
  2. 在左侧工作流列表中找到「Build and Upload Compose APK (Alpha)」
  3. 点击「Run workflow」下拉按钮
  4. 点击弹窗中的「Run workflow」按钮开始构建
Run workflow 下拉按钮和运行确认弹窗

新用户可能需要先授权启用 Actions——按提示操作一次即可。

等待构建

运行完成后,工作流会从黄色(进行中)变成绿色(成功)或红色(失败)。整个构建过程大约需要 12 分钟——包含拉取代码、编译、签名、打包等步骤。

黄色表示运行中,点击可查看详细日志

如果显示红色失败,点击进入查看具体错误。最常见的失败原因是机密变量配置错误(密码或别名写错)。

下载构建产物

构建成功后,滚动到 Actions 运行页面的最底部,会看到「Artifacts」区域列出的构建产物。

Actions 运行页面底部的 Artifacts 区域
构建产物列表,4 个 APK 对应不同架构

BILIBILIAS 的流水线会产出 4 个 APK:

产物名适用场景
APK-alpha-arm64-v8a主流 arm64 架构,绝大多数现代 Android 设备用这个
APK-alpha-armeabi-v7a较老的 32 位 arm 设备
APK-alpha-x86x86/x86_64 架构(模拟器、少数特殊设备)
APK-alpha-universal包含所有架构,体积最大但兼容性最好

推荐: 不知道选哪个就直接下 APK-alpha-universal——体积大一点但不用担心架构不匹配。如果你的设备比较新,可以选 APK-alpha-arm64-v8a 节省下载时间。