Aniyomi项目升级与数据迁移完整指南

存储架构变更解析

在Aniyomi 0.15.2.0版本中，存储管理机制进行了重大重构。旧版本允许用户将下载目录设置在任意位置（包括外部存储），而新版本采用了统一存储策略，要求所有应用数据必须集中存放在Aniyomi主目录下。这一变更主要基于Android存储访问框架(Saf)的合规性要求，同时也提高了数据管理的安全性。

升级前准备事项

1. 完整备份创建

   • 通过应用内备份功能生成.proto格式备份文件
   • 建议同时备份以下目录：
     • /Android/data/aniyomi/files/backup
     • /Android/data/aniyomi/files/downloads
   • 注意：扩展插件(.apk)无需单独备份

2. 存储路径规划

   • 确保目标设备有足够存储空间
   • 建议预留至少原数据体积2倍的空间

分步升级指南

步骤1：新版本安装

1. 卸载旧版本应用（保留数据选项不要勾选）
2. 安装最新版Aniyomi
3. 首次启动时不进行任何设置

步骤2：存储初始化

1. 进入"设置 > 高级 > 存储"
2. 选择新的统一存储位置（建议使用内部存储）
3. 系统会自动创建标准目录结构：

   /Aniyomi/
   ├── backups/
   ├── downloads/
   ├── extensions/
   └── ...
   

步骤3：数据迁移

1. 将旧备份文件(.proto)复制到新备份目录
2. 使用文件管理器将旧下载内容移动到新downloads目录
   • 保持原有目录结构不变
   • 注意文件权限设置

步骤4：恢复与配置

1. 通过"设置 > 备份"恢复库数据
2. 重新配置以下关键设置：
   • 下载线程数
   • 网络超时设置
   • 主题偏好
3. 重新安装扩展（建议从官方仓库获取）

常见问题解决方案

Q：扩展显示不受信任 A：这是正常现象，由于项目维护策略变更，需要：

1. 移除所有旧扩展
2. 通过官方仓库重新安装

Q：备份恢复后设置丢失 A：当前版本设置不包含在备份中，需要手动重新配置。建议记录以下关键配置：

• 阅读器设置
• 网络代理配置
• 通知偏好

最佳实践建议

1. 定期备份策略

   • 设置自动备份（每周）
   • 采用增量备份命名方案（如backup_YYYYMMDD.proto）

2. 存储管理技巧

   • 使用"存储分析"功能定期清理缓存
   • 对大容量设备建议启用"按来源分类下载"

3. 版本过渡期

   • 新旧版本并行运行一段时间
   • 使用"导出/导入书签"功能过渡阅读进度

技术说明

新版本采用Android Storage Access Framework实现存储访问，这种设计：

• 更好地适配Android 11+的存储限制
• 提高数据访问稳定性
• 支持更精细的权限控制

对于高级用户，仍可通过ADB命令实现特殊存储位置的访问，但官方不建议此操作。

通过遵循本指南，用户可以顺利完成Aniyomi的版本升级和数据迁移，同时适应新的存储管理体系。建议用户在操作前充分理解存储架构变更的影响，并做好完整备份。