05 Advanced Build

5.1 自构建 APK

如果你想从源码自行构建 SillyDroid APK，本页提供完整指引。

---

构建环境要求

项目	要求
操作系统	Windows + WSL，或 Linux bash
Shell	bash、curl、unzip、tar
校验工具	sha256sum、realpath
架构	linux-arm64（当前唯一支持）
Android SDK	脚本会自动补齐

---

一键构建

git clone https://github.com/jialmaster/SillyDroid.git
cd SillyDroid
bash ./scripts/build-tavern-android-local.sh

---

指定版本和类型

bash ./scripts/build-tavern-android-local.sh \
    --tavern-tag 1.18.0 \
    --build-type debug

参数	说明	可选值
--tavern-tag	SillyTavern 版本	如 1.18.0
--build-type	APK 构建类型	debug / release

---

构建阶段

构建过程分为四个阶段：

阶段	脚本	产物
Stage 1	sync-android-rootfs.sh build-tavern-android-runtime-image.sh	Linux rootfs + runtime image
Stage 2	build-tavern-dependency-packs.sh	node / git 依赖包
Stage 3	sync-tavern-android-bootstrap.sh	server-source.zip（酒馆源码 + npm 依赖）
Stage 4	build-tavern-android-apk.sh	最终 APK

⚠️ 各阶段有严格的边界约定，详见各脚本开头的 Contract 注释。

---

构建输出

APK 默认输出到：

artifacts/releases/android-apk/

---

CI 构建

项目通过 GitHub Actions 自动构建：

• APK Action
• Runtime Action