Files
Aria/ANDROID_COMPATIBILITY.md
T

46 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Android 兼容性说明
本次保留 minSdk 15、compileSdk/targetSdk 36 和现有发布坐标;Android 17/API 37 的宿主接入要求如下,尚未宣称通过 API 37 真机验证。
## 存储
- 内部 files/cache 目录无需存储权限。API 19+ 的 getExternalFilesDir 也无需存储权限,外部卷可能不可用。
- 公共下载目录在现代系统上优先使用现有 MediaStore/SAF Uri 下载接口。SAF 必须由宿主获取读写授权;需要跨重启恢复时保存系统实际授予的持久权限。授权撤销后必须重新选择。
- READ_MEDIA_IMAGES/VIDEO/AUDIO 只授权相应媒体读取,不授予任意文件写权限。不能用任意一种媒体权限证明所有下载/上传路径可访问。
- 旧系统共享目录仍需宿主按路径和操作申请 READ/WRITE_EXTERNAL_STORAGE。移除统一权限门槛不代表绕过系统访问限制;路径检查与实际 I/O 仍会失败。
- MANAGE_EXTERNAL_STORAGE 不作为一般下载接入前提;已有示例中的全文件访问仅用于其旧路径演示,应按产品需求改用私有目录或 Uri。
## 网络和后台
- 宿主声明 INTERNET;网络监测需要 ACCESS_NETWORK_STATE。API 24+ 监听默认网络,API 21–23 使用不限定传输类型的回调,更旧版本实时查询。
- 网络存在不保证服务器可达;局域网连接无需通过公网 VALIDATED 检查,连接失败仍由协议层处理。
- targetSdk 37+ 在 Android 17 访问局域网 HTTP/FTP/SFTP 服务时,宿主需按业务声明并在前台请求 ACCESS_LOCAL_NETWORK;只访问公网时无需申请。库不弹权限框、不代替宿主管理授权。
- 库的线程任务不保证进程退出后的后台持续运行。宿主如需长时间用户可见传输,应按目标系统的前台服务类型、启动限制和时限设计生命周期;不要仅提高 targetSdk 后假设后台任务持续运行。
- HTTPS 优先;如确需明文 HTTP,由宿主对具体域名配置 Network Security Config。
## 待设备验证矩阵
| 系统 | 场景 | 预期 |
| --- | --- | --- |
| API 15–18 | 私有目录、共享目录拒绝权限 | 私有下载可用;共享访问明确失败 |
| API 19–28 | 应用外部目录,不申请存储权限 | 下载与恢复可用 |
| API 29–36 | MediaStore/SAF、权限撤销、私有目录 | 正常写入;撤销后明确失败或重新授权 |
| API 21+ | Wi-Fi/蜂窝/以太网/VPN、多网络切换 | 不因传输类型漏判,断网可恢复 |
| API 37,宿主 target 37 | 局域网授权允许/拒绝,公网 | 授权后局域网可访问;拒绝不影响公网 |
官方依据:
- https://developer.android.com/training/data-storage/app-specific
- https://developer.android.com/develop/connectivity/network-ops/reading-network-state
- https://developer.android.com/privacy-and-security/local-network-permission
## 下载可靠性修复
- HTTPS 默认使用系统信任链及域名验证;私有 CA 服务应显式配置证书,不再默认信任任意证书。
- 断点请求写入前校验 206、Content-Range 和未压缩响应;服务器忽略 Range 时失败,不将完整响应追加到断点。
- 组合任务的信息请求最多并发 4 个,完成状态用于保护等待;停止与取消会唤醒等待并中断待执行工作。
- 事件在单个消费线程顺序执行。队列容量为 10,满时 post 抛出 RejectedExecutionException,调用方应降低频率或显式处理,不再静默丢弃事件。事件处理器应避免长时间阻塞。
- MediaStore 恢复不再选择任意同名文件;没有精确匹配时尝试创建新记录。
- 数据库条件查询使用绑定参数并返回真实 rowid,未命中返回 -1。
仍需后续完善:持久化 ETag/Last-Modified 并以 If-Range 校验跨重启续传的资源身份。当前 Range 验证不能识别远端同长度内容被替换。组合任务取消时,正在进行的底层网络读取仍可能持续到 I/O 超时。尚未进行设备上的证书、MediaStore 与断网集成测试。