Net/docs/download-file.md

简单下载

下载文件和普通的接口请求唯一区别就是泛型不同

scopeNetLife {
    val file = Get<File>("download").await()
}

Download函数一调用就会开始执行下载文件请求, 然后await则会等待下载文件完成然后返回一个File对象

下载选项

支持丰富的下载定制方案, 并且会不断地更新完善

scopeNetLife {
    val file =
        Get<File>("https://download.sublimetext.com/Sublime%20Text%20Build%203211.dmg") {
            setDownloadFileName("net.apk")
            setDownloadDir(requireContext().filesDir)
            setDownloadMd5Verify()
        }.await()
}

配置选项

| 函数 | 描述 | |-|-| | setDownloadFileName | 下载的文件名称 | | setDownloadDir | 下载保存的目录, 也支持包含文件名称的完整路径, 如果使用完整路径则无视setDownloadFileName设置 | | setDownloadMd5Verify | 下载是否开启MD5校验, 如果服务器返回 "Content-MD5"响应头和制定路径已经存在的文件MD5相同是否直接返回File, 不会重新下载 | | setDownloadFileNameConflict | 下载文件名如果在指定路径下存在同名会自动重新命名, 例如file_name(1).apk | | setDownloadFileNameDecode | 文件名称是否使用URL解码, 例如下载的文件名如果是中文, 服务器传输给你的会是被URL编码的字符串. 你使用URL解码后才是可读的中文名称 | | setDownloadTempFile | 下载是否使用临时文件, 避免下载失败后覆盖同名文件或者无法判别是否已下载完整, 仅在下载完整以后才会显示为原有文件名 | | addDownloadListener | 下载进度监听器, 具体介绍在进度监听中 |

不使用await函数则下载报错也不会被Net捕捉到, 将会被忽略, 使用await则会触发Net的错误处理, 终止当前作用域(scope)内其他网络请求, 被Net全局错误处理捕获

缓存文件

文件缓存推荐以下三种方式

• 文件判断: 这种方式比较自由, 你自己去判断本地磁盘是否有该文件, 没有才发起请求, 比如你根据文件名判断. 无需网络
• 缓存模式: 占用设备两份空间(因为缓存和下载后的文件都要占空间), 并且读取缓存的时候会本地磁盘复制依旧有耗时. 如果下载地址动态可以自定义缓存Key. 无需网络
• MD5校验: 这种比较安全, 就是由服务器返回文件的MD5给你, 请查看BaseRequest.setDownloadMd5Verify方法. 要求服务器返回指定响应头, 要求联网