Files
Aria/ANDROID_COMPATIBILITY.md
T

2.8 KiB
Raw Blame History

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 局域网授权允许/拒绝,公网 授权后局域网可访问;拒绝不影响公网

官方依据: