1.x 旧版本向 2.x 迁移指南

为什么不能就地升级

BILIBILIAS 的 1.x 版本和 2.x 版本之间存在架构级别的差异，两个版本使用完全不同的数据模型、存储路径和文件组织方式。主维护者明确建议所有还在使用 1.x 的用户不要尝试就地升级（覆盖安装），而是卸载旧版、重装新版，再手动迁移下载文件。

迁移前准备：备份下载文件

在卸载 1.x 之前，首先要确保之前缓存的视频文件不会丢失。操作步骤：

1. 打开手机上的文件管理器（推荐 MT 管理器或系统自带的文件管理）
2. 找到 BILIBILI AS 1.x 的存储路径——具体位置因你当时的设置而异，常见位置有：

• 内部存储/Download/BILIBILIAS/
• 内部存储/Android/data/包名/files/

1. 将整个 BILIBILI AS 文件夹复制到一个安全的临时位置（比如另一个新建文件夹）

卸载与重装

备份完成后：

1. 在 Android 设置 → 应用管理中找到 BILIBILI AS（注意 1.x 版本的应用名可能是「BILIBILI AS」，带一个空格）
2. 先点击「清除数据」确保不留残留
3. 再点击「卸载」
4. 然后安装 BILIBILIAS 2.x 或 3.x 版本
5. 首次启动时授予必要权限（见上一页）

找回旧文件

安装新版本并完成首次启动后：

1. 打开 BILIBILIAS 应用的设置，确认存储路径（默认是 Download/BILIBILIAS）
2. 在文件管理器中将之前备份的文件夹拷贝到新存储路径下
3. 注意新版本不会自动扫描旧文件，你可能需要在新版本中重新解析这些视频的 BV 号来确认关联

关于版本号说明

1.1.5 是 1.x 版本的最后一个正式版本。如果你还在使用 1.1.5 或任何更早的版本，建议尽快完成迁移——这些版本的代码不再维护，可能存在已知的 Bug 和安全问题。

2.1.5 是一个重要的中间版本，它引入了「可选登录」机制。如果你之前因为必须登录才能用而犹豫是否升级，2.1.5 之后的版本可以不登录使用基础解析和缓存功能，只是最高画质会受限在 480P。