Swiftpack.co - Swift Packages by Danie1s

The markdown parsing is broken/disabled for release notes. Sorry about that, I'm chasing the source of a crash that's been bringing this website down for the last couple of days. 修复可能出现死循环的问题 修复 success 重复调用 之前 Tiercel 3.0.0 版本已经针对批量操作进行大量优化，足以应付数百个下载任务批量操作的需求。但我万万没想到竟然有人会在手机端上同时下载成千上万的文件，显然这种做法是不正确的，手机的性能非常有限，就算是性能很好的电脑，也不应该这么做。正常来说如果同时下载的文件达到上百个的话，最好就把它们压缩成一个文件进行下载，节省大量的资源，这才是最优的做法。但既然有开发者发现 Tiercel 在批量操作时还是会产生性能方面的问题，那也证明了它还存在继续优化的空间，于是我再次对批量操作方面进行优化，达到了应付上万个下载任务批量操作的要求。但我还是再次强调，这种大量文件同时下载的做法是非常不合理的，对于 Tiercel 使用的常见问题和注意事项，请查看 [常见问题](https://github.com/Danie1s/Tiercel/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98) - 进一步提升批量操作的性能 - 减少内存占用 - 不再保留原始的 `URLSessionDownloadTask`，如果下载任务出现错误，会保留 `response` - 对 `error` 和 `response` 进行持久化 - 对 `SessionManager` 的 `download` 和 `multiDownload` 方法添加了回调 - 暴露 `UnfairLock` 和 `Protector<T>`，新增 `Debouncer`，方便开发者使用 - 优化各种状态回调的逻辑 - 优化代码逻辑 - 更新 Demo - 修复 iOS 12.0 - iOS 12.1 `resumeData`引起的 Bug - 优化断点续传判断的逻辑 - 增加`Download`和`SessionManager`的状态通知，使用方法请看 [Wiki](https://github.com/Danie1s/Tiercel/wiki/%E7%94%A8%E6%B3%95) - 修改下载信息的计算间隔，提高性能 - 修复`multiDownload(_:headersArray:fileNames:)`返回值问题 Tiercel 3.0 大幅提高了性能，拥有更完善的错误处理，提供了更多方便的 API。从 Tiercel 2.0 升级到 Tiercel 3.0 并不会很困难，强烈推荐所有开发者都进行升级，具体请查看 [迁移指南](https://github.com/Danie1s/Tiercel/wiki/%E8%BF%81%E7%A7%BB%E6%8C%87%E5%8D%97) ### 改进 - 大幅提高`multiDownload(_:headersArray:fileNames:)`、`totalSuspend(onMainQueue:handler:)`、`totalCancel(onMainQueue:handler:)`、`totalRemove(completely:onMainQueue:handler:)`等批量操作的速度 - 改用字典来匹配任务，提高`fetchTask(_:)`方法的性能 - 改用 iOS 中性能最高的锁`os_unfair_lock`进行线程同步 - 更完善的错误处理，任何错误都会打印出来 - 将`TiercelLog`改成`struct Logger: Logable`，开发者可以取消所有的默认打印，也可以自定义`Logger` - 修改部分属性名称和方法名称，更加规范 - 提高线程安全 ### 新增 - `Cache`支持自定义下载模块的文件夹 - 支持 iOS 13 的低数据模式访问限制和昂贵网络访问限制 - 支持改变单个任务在所有任务中的位置 - 支持对所有任务进行排序 - 增加直接对任务进行操作的API，如：`sessionManager.cancel(task)` - 添加一个统一回调`completion(onMainQueue:handler:)`方法，把`success(onMainQueue:handler:)`方法和`failure(onMainQueue:handler:)`方法合并在一起，避免代码分隔 - 增加下载速度、剩余时间等信息的字符串版本，方便使用 ### 修复 - `controlExecuter`每次调用完毕后赋值为`nil`，避免混乱 - 增加`Cache`的`invalidate`方法，修复`Cache`的内存泄漏 - 改进`Demo`中的代码 这应该是 Tiercel 2 的最后一个版本，即将移除 `NSCoding` 的兼容代码，如果之前没有升级到 `2.3.0` 版本的使用者，请务必先升级到此版本作为过渡 - 添加 Swift Package Manager 支持 - `DownloadTask` 暴露 `originalRequest`、`currentRequest`、`response`、`statusCode` 属性 - 改进下载成功的判断：在`DownloadTask`完成后，会进一步判断`statusCode`，只有`200 <= statusCode < 300`才算成功，否则失败 - 优化部分代码 - 使用更先进安全的`Codable`进行编码解码 - `NSCoding`存在安全隐患，不再使用，新版本会兼容旧版本的持久化数据。 - 把`URLStirng`改为`URLConvertible`，适应更多类型 - 不再局限于`String`，更加灵活方便，同样开发者无需修改任何代码即可以兼容。 - 优化部分代码 - `Task`不再暴露给外界，目前统一返回`DownloadTask` - 修复回调时有可能出现的线程问题 - 增加清除磁盘缓存时的回调 - 类名、结构体名重构，更加Swifty - 更多的线程同步，更加安全 - 初始化`SessionManager`时，可以传入自定义队列，Tierecl回调都在此队列中执行 - 增加回调执行队列选择，适应更复杂的使用场景 - `onMainQueue`参数控制回调是否在主队列上执行，如果`onMainQueue`传`false`，则会在`SessionManager`初始化时指定的队列上执行 - 优化下载速度的计算方式

The markdown parsing is broken/disabled for release notes. Sorry about that, I'm chasing the source of a crash that's been bringing this website down for the last couple of days. - 支持 RTL - 增加颜色对于 alpha 的考虑 - 支持 SPM 增加一个单独改变 `title` 的方法，用法如下 ```swift titleView.updateTitle("iOS", at: 3) ``` DNSPageView 升级到 2.0，部分 API 发生了变化，主要是”通过 xib 初始化“部分，详情请参考 `Demo` 中 `ViewController2` 的代码 - 增加动态修改样式的功能，请参考 `Demo` 中 `ViewController5` 的代码 - 修改部分属性的访问控制 - 更改部分 API - 优化布局逻辑 - 统一改用 `currentIndex` 替代 `startIndex` - 更新 `Demo` 增加一个 `UIColor` 的初始化方法来适配 iOS 13 Dark Mode： ```Swift dynamic(_ light: UIColor, dark: UIColor) -> UIColor ``` 用法： ```Swift // 设置 Style 的时候，使用该方法来创建 UIColor style.titleSelectedColor = UIColor.dns.dynamic(UIColor.red, dark: UIColor.blue) ``` 添加 `PageStyle` 属性 `titleInset` 添加 `PageStyle` 属性 `titleSelectedFont` - 修复下划线布局问题 - 移除前缀DNS，更加符合Swift风格 - 增加`DNSStyle`一个属性：`bottomLineWidth`，可以自定义下划线宽度 - 使用`center.x`布局，适应更多情景 支持Xcode 10.2 + Swift 5.0 #### 修改 - 优化了方法名：`public func selectedTitle(at index: Int)` - 协议`DNSPageReloadable`改成`DNSPageEventHandleable` #### 新增 - 增加了一个事件回调：`@objc optional func contentViewDidDisappear()`