如何一步到位给B站装上BiliRoamingX：5步完成APK修补
【免费下载链接】BiliRoamingX-integrationsBiliRoamingX integrations and patches powered by ReVanced.项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations
想给B站加功能，又怕修补完打不开？BiliRoamingX 是一款面向哔哩哔哩客户端的 B站补丁 项目，它以补丁式修改的方式直接改动官方 APK，无需 root 就能解锁区域受限番剧、自定义首页、字幕翻译等能力。整个 APK修补 流程其实只有两条命令，这份 BiliRoamingX编译教程 帮你把坑都踩完了。
动手前先看你会得到什么
完成后，你手机里会多一个可用的自定义 B 站 APK：设置里多出一整个补丁菜单，首页标签、播放器清晰度、动态过滤等功能随便开关，不想用了随时换回官方版。全程就 4 个动作：准备环境 → 编译补丁 → 修补 → 装包验证。只要你有目标 APK（如 7.70.0 版本）、会敲命令行，就不需要读源码。
动手前的检查清单
| 项目 | 要求 | 为什么 |
|---|---|---|
| Java | 推荐 11 版本 | ⚠️ Java 17 下签名校验可能直接失败 |
| Gradle | 随项目自带 | 负责构建补丁包 |
| 目标 APK | 哔哩哔哩 7.70.0 起 | 不同版本可能要调参数 |
| revanced-cli | 必须用修改版 | 优化了签名流程，保证修补后的包能装能跑 |
修补环节一共涉及 3 个文件：目标 APK、编译出的 integrations、patch 补丁包，提前备齐，省得中途卡住。
编译加修补，5步走完
- 拿源码。需要 clone 的话，仓库地址：https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations
- 编译补丁：下面这条命令一次性构建整套补丁集。
./gradlew :patches:build看到 BUILD SUCCESSFUL，再去项目根目录的 build 文件夹里找到integrations 和 patch 两个产物文件，就是对了。
- 备工具：准备好修改版 revanced-cli（官方版不行，签名流程不如它稳），把目标 APK 和两个产物放同一个目录。
- 执行修补：这条命令把 integrations 合进目标包、再套上补丁集。⚠️ 签名级别参数千万别漏：
java -jar revanced-cli.jar patch \ --sign-levels "2,3" \ --merge integrations.apk \ --patch-bundle BiliRoamingX-patches.jar \ target.apk签名过程无报错、产出一个签好名的 APK，就算过关。
- 装包验证：用新 APK 覆盖安装，打开后设置里应出现 BiliRoamingX 入口，能正常打开并稳定跑满一分钟才算真正成功。
翻车了？对照这三个症状修
闪退？大概率是签名参数漏了
症状：刚装完能打开，一分钟内必死。原因：漏了--sign-levels "2,3"，签名级别不够。解法：补上参数重跑修补，或对产物手动做 V2+V3 重签名。
签名时 JCE 无法验证提供者
症状：命令报错 JCE 校验失败。原因：Java 17 与签名校验存在兼容问题。解法：切到Java 11环境重跑；嫌麻烦就把未签名 APK 拿出来，用 MT 管理器等工具手动 V2+V3 签名。
修补报路径错误
症状：工具找不到文件。原因：路径写错，或编译产物不完整。解法：依次核对目标 APK、integrations.apk、BiliRoamingX-patches.jar三个路径，确认 build 阶段完整结束后再修补。另外修补时生成的patches.json只是副产物，没有任何实际作用，无视即可。
以上以 7.70.0 为例。换其他版本的 B 站 APK 时，通常只需按版本差异微调参数；想搞懂补丁到底改了哪里，可以翻patches/目录下的源码，挑一个功能照着魔改，就是下一个 BiliRoamingX编译教程 的作者了。
【免费下载链接】BiliRoamingX-integrationsBiliRoamingX integrations and patches powered by ReVanced.项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
