企业官网建设流程全解析

BiliRoamingX 完整上手指南：快速编译补丁包并修补哔哩哔哩 APK

【免费下载链接】BiliRoamingX-integrationsBiliRoamingX integrations and patches powered by ReVanced.项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations

BiliRoamingX 是一个给哔哩哔哩 Android 客户端打补丁的开源项目，能给原版 APP 加上解锁番剧区域限制、播放器自定义、信息流过滤等功能。本教程带你完成补丁编译并修补哔哩哔哩 APK 的完整操作。

开工前：环境自查三步走

先花 30 秒对齐概念：APK 是原版安装包，补丁包是一套代码修改规则，revanced-cli 则是负责把"模组装进底模"的命令行工具——它把补丁和集成代码合进 APK 并签名。动手前要备齐三样东西：

1. Java 11 运行环境。这是项目推荐的版本。Java 17 看起来更现代，但在签名校验环节更容易触发提供者错误，一旦失败查不出原因，先切回 Java 11 排除变量。可用java -version查看当前版本。
2. Gradle 构建工具。项目自带 gradlew 包装脚本，无需额外安装。
3. 修改版 revanced-cli。社区基于官方 CLI 改进了签名流程，打签名更稳，建议直接使用修改版。

如果还没拿过项目源码，先执行：

git clone https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations

这条命令把项目源码拉到本地，后续编译都在这份源码里进行。

编译出补丁包：一条命令出两个产物

进入项目根目录执行：

./gradlew :patches:build

这条命令让 Gradle 编译整个补丁模块；Windows 上把开头的./gradlew换成gradlew.bat。

构建成功后，项目根目录的 build 文件夹里会出现两个文件，缺一不可：

• integrations.apk（集成模块）：真正"住进"APP 里的代码，补丁后 B 站内那些设置页和功能都来自它。
• BiliRoamingX-patches.jar（补丁包）：修改规则集，告诉修补工具在原版 APK 的哪些位置动刀、怎么缝合。

把补丁打进 APK：完整命令与参数逐条解读

准备一份目标哔哩哔哩 APK（如 7.70.0 版），重命名为 target.apk，与两个产物、CLI 工具放在同一目录后执行：

java -jar revanced-cli.jar patch \ --sign-levels "2,3" \ --merge integrations.apk \ --patch-bundle BiliRoamingX-patches.jar \ target.apk

这条命令一口气完成合并集成、注入补丁、签名三件事，参数逐条看：

• --merge integrations.apk：把集成模块合并进 APK，提供实际功能；
• --patch-bundle：指定补丁包，相当于"模组安装说明书"；
• --sign-levels "2,3"⚠️：要求工具按安卓 V2 + V3 两套签名方案签名。这是全命令里最要命的一个参数——少了它，修补后的 APP 活不过一分钟，签名校验一跑就闪退。

产出是一份已签名的新 APK。装上手机验证一下：设置页能看到 BiliRoamingX 入口、启动后正常使用一段时间不闪退，就算成功了。

翻车急救站：按症状分诊处理

✅ 先认症状再动手，常见就这四种情况：

情况一：APP 启动后很快闪退九成是修补命令里漏了--sign-levels "2,3"。重新执行修补并补上该参数即可。

情况二：JCE 报"无法验证提供者"几乎总是 Java 版本问题，当前环境（常见于 Java 17）无法校验签名提供者。切到 Java 11 重跑一遍，通常立刻消失。

情况三：签名环节失败两条路：要么换 Java 11 重试；要么拿到修补流程产出的未签名 APK，用 MT 管理器在手机上手动做一次 V2+V3 签名，再安装验证。

情况四：修补过程直接报错按顺序查三处：命令里的文件路径是否写对且文件确实存在；Java 版本是否兼容；补丁包是否完整编译（看 Gradle 输出是否有 BUILD SUCCESSFUL）。

收尾：三个容易忽略的细节

1. patches.json 没有实际作用。修补过程中会生成这个文件，但它不参与任何功能，看到就忽略。
2. 修改版 CLI 值得信任。它针对签名流程做了优化，是全程"一次签名就成功"的关键，别手痒换回官方版。
3. 不同 B 站版本不通用。补丁参数是按特定版本调校的，换其他版本的哔哩哔哩 APK 时可能需要相应调整参数，做好试错准备。

【免费下载链接】BiliRoamingX-integrationsBiliRoamingX integrations and patches powered by ReVanced.项目地址: https://gitcode.com/gh_mirrors/bi/BiliRoamingX-integrations