NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #2281 most downloaded on pub.dev
The sdk basic of Qiniu products
Last release 4 months ago
05 Jun 2026
Release timing varies
gaps range from 5 weeks to 13 months
Nearly every release is documented
notes for 22 of 23 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
23 releases · first in 2020
One column per quarter.
Task / RequestTask 生命周期方法签名由 void 改为 Future （preStart / postStart / postReceive / postError / preRestart / postRestart）。 外部继承 RequestTask 时所有重写方法必须改成
Task / RequestTask 生命周期方法签名由 void 改为 Future<void>
（preStart / postStart / postReceive / postError / preRestart / postRestart）。
外部继承 RequestTask 时所有重写方法必须改成 async / Future<void>。storage.dart 不再 export RequestTask / Task / TaskManager，
这些类型回归内部实现。HttpClientAdapter 仍通过 storage.dart 透出，
自定义网络适配器请直接实现 dio 的 HttpClientAdapter 或继承本 SDK 的 QiniuHttpClient。RequestTaskManager。QiniuHttpClient：在 dio 默认 adapter 之上提供 connectTimeout /
writeTimeout / readTimeout（请求/响应流闲时超时，pause-aware），
并通过 sendBufferSize（默认 128KB）配合内核 SO_SNDBUF 触发写阶段背压检测。QiniuIdleTimeoutException：明确标识读/写阶段的闲时超时错误，
上层 StorageError.fromDioError 据此精确映射到
SEND_TIMEOUT / RECEIVE_TIMEOUT。Config 的默认 httpClientAdapter 改为 QiniuHttpClient()，
即默认启用 30 秒读写闲时超时。如需关闭，传入
Config(httpClientAdapter: QiniuHttpClient(readTimeout: Duration.zero, writeTimeout: Duration.zero))。StorageErrorType.RESOURCE_READ_EXCEPTION 错误类型，
在资源读取异常（实际上传字节数与预期不符）时上报。RequestTaskController 增加单调钳制
屏蔽 retry 引起的进度回退。HostProvider 新增 unfreezeOne() 默认实现（空方法）。
支持冻结的自定义实现仍需重写该方法以恢复正常工作。Config.retryLimit 默认值从 10 改为 2（单域名重试次数，
多域名场景下总重试次数 = retryLimit × 可用域名数）。文件进行第一次上传时，如果域名全部冻结，会随机选择一个域名进行上传
Nothing published for this version
- 优化表单上传进度更新粒度 - 修复分片上传重试时进度超过100%的问题
100%的问题解除platform_info和system2的依赖，以修复Android平台小概率崩溃问题
修复由于 SystemInfo2 引入导致的 Web/iOS/Windows 平台的不兼容问题
- 增强区域查询和上传的可靠性
- 补充遗漏的 Content-Type
- 移除冗余的 uuid 依赖声明
- 修复分片上传中断恢复后文件内容出错的问题
更新 uuid 到最新版本，对 Flutter SDK 的最低版本要求提升到 3.0
- 添加上传时的 mimetype 支持（仅分片上传支持）
修复由于 dio 更新内部自动替换 null 为空字符串导致的 614 错误问题。
- upgrade dio to 5.0.0
新增 putBytes 接口用于上传 Uint8List 类型的资源
- 修复 UserAgent 可能被设置为中文导致报错的问题
- 修复 PutPolicy 的 forceSaveKey 类型
PutPolicy 的 forceSaveKey 类型在 PutOptions 中增加 customVars 参数，为用户配置自定义变量提供入口
PutOptions 中增加 customVars 参数，为用户配置自定义变量提供入口PutResponse 中 rawData 参数变更为 required- 增加 null-safety
- 增加 User-Agent
- 修复关闭 App 缓存丢失的问题
- 优化了 StorageError 输出的调用栈 - CacheProvider 的方法都改成异步的
StorageError 输出的调用栈CacheProvider 的方法都改成异步的- Initial Release.
Your coding agent can read these notes before it upgrades. Set up the MCP server →