Files
Aria/ANDROID_COMPATIBILITY.md
T

35 lines
2.8 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