前言
內容類應用中圖片或檔案下載,一般應用中應用更新和升級,這些都是經典的下載場景。下載是專案中基礎且重要的模組。
從程式碼邏輯複用性和人力成本考慮,一直想實現一個純Dart實現的下載庫,作為技術儲備。
最近發現了一個純Dart實現的下載庫flutter_download_manager,相對來說各方面還算滿足需求,支援斷點續傳,暫停,取消等我比較看重的功能。但是有些地方還需要改進。
話不多說,首先簡單介紹下這個庫吧。
flutter_download_manager簡介
地址: https://github.com/nabil6391/flutter_download_manager
版本: 0.5.4
特點:
- 純Dart實現
- 透過 url 管理下載任務
- 能夠通知狀態和進度更改
- 部分下載功能
- 佇列下載
- 暫停、取消或恢復下載
- 並行檔案下載(2 個或可以更改)
- 支援批次下載
支援平臺: Linux | MacOS | Windows | Android | iOS
使用方法
簡單下載一個檔案
var dl = DownloadManager();
var url = "adasdad.com/asda.sdas";
dl.addDownload(url, "./test.sdas");
DownloadTask? task = dl.getDownload(url4);
task?.status.addListener(() {
print(task.status.value);
});
task?.progress.addListener(() {
print(task.progress.value);
});
await dl.whenDownloadComplete(url4);
獲取下載狀態
DownloadTask? task = dl.getDownload(url4);
task?.status.addListener(() {
print(task.status.value);
});
獲取下載進度
DownloadTask? task = dl.getDownload(url4);
task?.progress.addListener(() {
print(task.progress.value);
});
等待任務完成
DownloadTask? task = dl.getDownload(url4);
await task.whenDownloadComplete();
取消下載任務
var dl = DownloadManager();
dl.cancelDownload(url5);
暫停下載任務
var dl = DownloadManager();
dl.pauseDownload(url5);
恢復下載任務
var dl = DownloadManager();
dl.resumeDownload(url5);
效果展示
原始碼解析
類圖
任務管理類:DownloadManager
整個核心就類DownloadManager, 而每個下載任務的抽象是DownloadTask,所謂Manager當然是要管理這些Task了。那麼如何管理呢? 遊離的沒法管控,只有先找到才能調配,透過Map持有Task控制程式碼達到“找到”目的,其中_cache中以<下載URL,下載任務>方式在記憶體中快取每個任務狀態;而_queue則是新新增的下載任務請求,這兩者關係後面流程中會具體講到。
任務的抽象:DownloadTask
重點說下status和progress欄位設計,不論是批次下載還是單任務下載,進度監聽不是透過傳統傳入一個回撥給download或者addDownload來進行的,而是用了系統的ValueNotifier。筆者考慮這樣設計原因是配合flutter系統提供的ValueListenerBuilder更容易組織UI。(這樣的設計是不是看起來更Dart)
任務請求抽象:DownloadRequest
重點說下cancelToken,該欄位在暫停,取消,恢復下載任務實現中起了關鍵作用。像放出去的風箏,想收回時可以收回。怎麼收回呢?透過線,這條線的作用就是cancelToken。而風箏就像是一個個任務請求,放風箏的人就是Manager,放風箏這件事就是Task。
每個請求都必須帶個cancelToken,方便取消請求。(不帶線的風箏,難道讓你上天?)
未標明方法說明
圖中DownloadManager中方法只寫了單任務下載相關方法,批次相關方法差不多就省略了,類似(add | pause | cancel | resume | remove ).BatchDownload等,最終透過迴圈執行了單實現的方法。
原理解析
如何管理任務
這裡不具體闡述程式碼流程,為方便理解直接拿生活中慣用做事邏輯舉例,程式碼實現可自行查閱,也是按照這個套路來滴,首先有兩個集合:
- 任務請求列表,裡面是想做的事情,每件事情如果非要定義狀態的話,可以說是“規劃中”。
後續簡稱任務列表均指請求列表。
- 任務管理表,裡面的事情一般不會去記,在腦子裡面。軟體開發中,PM該表格維護者。
完成某任務一般流程如下:
- 生成一個任務請求表達意願。
- 查詢任務管理表中任務狀態並決定是否有資格真正新增到請求列表。
- 已完成任務:3天前已經摸過了一次魚,一週最多摸魚一次,直接返回任務結果,否掉這種不切實際的想法,沒臉加入請求列表。
- 未開始任務:一週沒玩lol,可以將遊戲新增到請求列表中,並更新到任務管理列表中。
- 未執行完任務:搬磚上次搬了50%下週繼續搬。此時看你怎麼處理了,若50%的磚還在,你可以繼續搬,將任務新增到請求列表,從50%開始直到完成。若沒搬的磚堆得橫七豎八不想繼續碼,可刪除任務管理表中記錄,當一次新任務新增請求列表和管理列表中。
- 新規劃任務:任務管理列表中無該記錄的情況,當新任務重新新增到請求列表中。
- 迴圈執行請求列表中各任務並適時更新管理列表中狀態,直至請求列表為空。
流程圖如下:
如何實現暫停恢復取消
關鍵是對DownloadRequest中cancelToken的控制。
暫停任務
恢復任務
取消任務
暫停和取消任務騙誰呢?
一般理解暫停表示之前下載了50%,恢復後繼續從50%下載;取消表示之前下載50%點選恢復重頭再來。
暫停和取消邏輯除更新狀態不一樣其他基本一樣,是在忽悠我麼?
莫慌!在下載時候還有處理呢?
透過上述恢復實現與如下下載中邏輯歸納整個暫停實現流程:
- 恢復下載中③④⑤會賦予暫停中url新的CancelToken重新新增到請求列表中,並開啟請求列表的自遍歷執行。
- 請求列表的自遍歷執行是給暫停掉Task重新執行的機會,Cancel掉的任務就沒法再執行了(下述第6行)。
- 下載過程中如果之前暫停未下載完畢的檔案,透過設定header中range:bytes來實現斷點續傳(下述第29行)。
優點和缺點
優點
- 邏輯複用:Dart側支援暫停,取消,恢復,下載流程,一般下載框架會用橋接實現,涉及到多端實現和通用性問題,比較耗人力。要麼就是dio簡單實現下載,沒有暫停恢復等實現。
- 任務管理,一般應用都是單任務下載,沒有管理過程。
- 程式碼簡單明瞭可讀性強,類抽象合理符合單一職責。
缺點
- 任務管理列表只實現了記憶體快取未實現磁碟快取,應用退出再進入啥都沒了。
- 網路庫不支援擴充套件,太過依賴dio。
預告:下一篇將實現dio解耦和網路庫擴充套件。
import 'package:dio/dio.dart';
class DownloadRequest {
var cancelToken = CancelToken();
}
------------------------------------------------
import 'package:dio/dio.dart';
class DownloadManager {
var dio = Dio();
Future<void> download(String url, String savePath, cancelToken,
{forceDownload = false}) async {
//...
if(fileExist){
}else(partialFileExist)
{
var response = await dio.download(...);
}else{
var response = await dio.download(...);
}
總結
任務管理體現在列表的增刪改查; 斷點續傳體現在range設定;任務取消單純透過請求庫取消實現。
❤️本文由 程式設計黑板報 原創,歡迎關注同名公眾號,原創技術文章第一時間推送❤️