Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/itenfay/cxdownload
Swift断点续传下载，支持Objective-C。包含大文件下载，后台下载，杀死进程，重新启动时继续下载，设置下载并发数，监听网络改变等。
https://github.com/itenfay/cxdownload
breakpoint-download ios objc objcective-c swift swift4 swift5
Last synced: 3 months ago
JSON representation
Swift断点续传下载，支持Objective-C。包含大文件下载，后台下载，杀死进程，重新启动时继续下载，设置下载并发数，监听网络改变等。
- Host: GitHub
- URL: https://github.com/itenfay/cxdownload
- Owner: itenfay
- License: mit
- Created: 2020-04-02T16:00:14.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T14:46:20.000Z (8 months ago)
- Last Synced: 2024-06-02T10:13:52.019Z (7 months ago)
- Topics: breakpoint-download, ios, objc, objcective-c, swift, swift4, swift5
- Language: Swift
- Homepage:
- Size: 7.42 MB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-en.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[中文版](README.md) | **English Version**
# CXDownload
Realization of breakpoint transmission download with Swift, support Objective-C. Including large file download, background download, killing the process, continuing to download when restarting, setting the number of concurrent downloads, monitoring network changes and so on.
[](https://cocoapods.org/pods/CXDownload)
[](https://cocoapods.org/pods/CXDownload)
[](https://cocoapods.org/pods/CXDownload)
## Preview
> **If you think it's okay, please give it a `star`**
## Explanation
- CXDownloadManager.swift: **The download task management**
- CXDownloadTaskProcessor.swift: **The download task processor**
- CXDownloadModel.swift: **The download model**
- CXDownloadDatabaseManager.swift: **The download database management**
- FileUtils.swift: **The file tool**
- Logger.swift: **This outputs the log to the console**
- String+Cx.swift: **This extends the `cx_md5`, `cxd_sha2` properties for `String`**
- ...
## Installation
`CXDownload` is available through [CocoaPods](https://cocoapods.org). To install it, simply add the following line to your Podfile:
```ruby
pod 'CXDownload'
```
## Usage
> Note: In order to better understand the usages, please check the project example.
### Monitor download status and progress
```
func addNotification() {
NotificationCenter.default.addObserver(self, selector: #selector(downloadStateChange(_:)), name: CXDownloadConfig.stateChangeNotification, object: nil)
NotificationCenter.default.addObserver(self, selector: #selector(downloadProgressChange(_:)), name: CXDownloadConfig.progressNotification, object: nil)
}
@objc func downloadStateChange(_ noti: Notification) {
guard let downloadModel = noti.object as? CXDownloadModel else {
return
}
if downloadModel.state == .finish {
CXDLogger.log(message: "filePath: \(downloadModel.localPath ?? "")", level: .info)
} else if downloadModel.state == .error || downloadModel.state == .cancelled {
if let stateInfo = downloadModel.stateInfo {
CXDLogger.log(message: "error: \(stateInfo.code), message: \(stateInfo.message)", level: .info)
}
}
}
@objc func downloadProgressChange(_ noti: Notification) {
guard let downloadModel = noti.object as? CXDownloadModel else {
return
}
CXDLogger.log(message: "[\(downloadModel.url)] \(Int(downloadModel.progress * 100)) %", level: .info)
}
```
### Download
- Default download directory and file name.
```
CXDownloadManager.shared.download(url: urls[0])
```
```
downloadButton1.dl.download(url: urls[0])
```
- Custom download directory and file name.
```
CXDownloadManager.shared.download(url: urls[1], toDirectory: "Softwares", fileName: "MacDict_v1.20.30.dmg")
```
```
downloadButton2.dl.download(url: urls[1], toDirectory: "Softwares", fileName: "MacDict_v1.20.30.dmg")
```
### Pause
```
CXDownloadManager.shared.pause(url: urls[0])
```
```
pauseButton1.dl.pauseTask(url: urls[0])
```
### Cancel
```
CXDownloadManager.shared.cancel(url: urls[0])
```
```
cancelButton1.dl.cancelTask(url: urls[0])
```
### Delete target file
```
CXDownloadManager.shared.deleteTaskAndCache(url: urls[0])
deleteButton1.dl.deleteTaskAndCache(url: urls[0])
```
```
CXDownloadManager.shared.deleteTaskAndCache(url: urls[1], atDirectory: "Softwares", fileName: "MacDict_v1.20.30.dmg")
deleteButton2.dl.deleteTaskAndCache(url: urls[1], atDirectory: "Softwares", fileName: "MacDict_v1.20.30.dmg")
```
## Recommendation
- [FireKylin](https://github.com/itenfay/FireKylin) - `FireKylin` provides many utilities and rich extensions of Swift language.
- [MarsUIKit](https://github.com/itenfay/MarsUIKit) - `MarsUIKit` wraps some commonly used UI components.
- [RxListDataSource](https://github.com/itenfay/RxListDataSource) - `RxListDataSource` provides data sources for UITableView or UICollectionView.
- [CXNetwork-Moya](https://github.com/itenfay/CXNetwork-Moya) - `CXNetwork-Moya` encapsulates a network request library with Moya and ObjectMapper.
## Example
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## License
`CXDownload` is available under the MIT license. See the LICENSE file for more info.
## Feedback is welcome
If you notice any issue to create an issue. I will be happy to help you.