Rethink-App 存储权限问题解析与修复方案

在 Android 应用开发中，文件存储权限管理一直是个复杂的话题。近期 Rethink-App 项目中出现了一个典型问题：用户无法将数据包捕获文件保存到 Downloads 目录，且"管理所有文件"权限选项呈现灰色不可用状态。

问题现象分析

多位用户报告，在尝试启用"设置 > 数据包捕获 > 输出到 Downloads 文件夹"功能时，系统会跳转到应用设置页面要求授予"允许访问管理所有文件"权限，但该权限选项显示为灰色不可用状态。这个问题在不同厂商设备上均有出现，包括 OnePlus Nord CE（Android 13）和 Pixel（Graphene OS）等机型。

技术背景

Android 的存储权限模型经历了多次演变：

1. 传统存储模型（Android 4.4及之前）：应用可以访问外部存储
2. 作用域存储（Scoped Storage，Android 10引入）：限制应用对共享存储的访问
3. 管理所有文件权限（MANAGE_EXTERNAL_STORAGE）：Android 11引入的特殊权限，允许应用绕过作用域存储限制

问题根源

开发团队通过代码审查发现，问题的根本原因是最近一次发布版本中意外移除了 AndroidManifest.xml 文件中必要的权限声明。具体来说，缺少了管理所有文件权限的声明，导致系统无法识别应用需要此权限的能力。

解决方案

修复方案包含以下关键步骤：

1. 在 AndroidManifest.xml 中重新添加必要的权限声明
2. 确保应用正确处理权限请求流程
3. 验证权限授予后文件写入功能是否正常

技术实现考量

虽然使用存储访问框架（Storage Access Framework，SAF）理论上可以避免特殊权限需求，但团队评估后认为：

1. 通过文件描述符（FD）在 Go 层实现存在跨进程兼容性问题
2. 该功能属于高级用户功能，使用频率较低
3. 当前方案在大多数设备上工作正常

用户影响与建议

对于终端用户：

1. 升级到 v0.5.5d 及以上版本即可解决此问题
2. 普通用户建议使用默认存储位置
3. 高级用户在使用数据包捕获功能时需注意权限授予

最佳实践建议

针对类似场景的开发建议：

1. 权限声明应纳入版本控制的关键检查项
2. 考虑实现功能降级方案（如无法获取权限时使用应用私有目录）
3. 对于高级功能，提供清晰的用户引导和错误提示

此案例展示了 Android 权限系统在实际开发中的复杂性，也提醒开发团队在版本迭代时需特别注意系统关键配置的完整性检查。