剖析flutter_download_manager學習如何做下載管理,暫停和取消

程式設計黑板報發表於2023-03-03

前言

內容類應用中圖片或檔案下載,一般應用中應用更新和升級,這些都是經典的下載場景。下載是專案中基礎且重要的模組。

從程式碼邏輯複用性和人力成本考慮,一直想實現一個純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);

效果展示

Record_2023-02-24-18-20-47_082aea295e0e2b19157fadadca43d2cc.gif

原始碼解析

類圖

Untitled.png

任務管理類: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該表格維護者。

Untitled 1.png

完成某任務一般流程如下:

  1. 生成一個任務請求表達意願。
  2. 查詢任務管理表中任務狀態並決定是否有資格真正新增到請求列表。
  • 已完成任務:3天前已經摸過了一次魚,一週最多摸魚一次,直接返回任務結果,否掉這種不切實際的想法,沒臉加入請求列表。
  • 未開始任務:一週沒玩lol,可以將遊戲新增到請求列表中,並更新到任務管理列表中。
  • 未執行完任務:搬磚上次搬了50%下週繼續搬。此時看你怎麼處理了,若50%的磚還在,你可以繼續搬,將任務新增到請求列表,從50%開始直到完成。若沒搬的磚堆得橫七豎八不想繼續碼,可刪除任務管理表中記錄,當一次新任務新增請求列表和管理列表中。
  • 新規劃任務:任務管理列表中無該記錄的情況,當新任務重新新增到請求列表中。
  1. 迴圈執行請求列表中各任務並適時更新管理列表中狀態,直至請求列表為空。

流程圖如下:

Untitled 2.png

如何實現暫停恢復取消

關鍵是對DownloadRequest中cancelToken的控制。

暫停任務

Untitled 3.png

恢復任務

Untitled 4.png

取消任務

Untitled 5.png

暫停和取消任務騙誰呢?

一般理解暫停表示之前下載了50%,恢復後繼續從50%下載;取消表示之前下載50%點選恢復重頭再來。

暫停和取消邏輯除更新狀態不一樣其他基本一樣,是在忽悠我麼?

莫慌!在下載時候還有處理呢?

透過上述恢復實現與如下下載中邏輯歸納整個暫停實現流程:

  1. 恢復下載中③④⑤會賦予暫停中url新的CancelToken重新新增到請求列表中,並開啟請求列表的自遍歷執行。
  2. 請求列表的自遍歷執行是給暫停掉Task重新執行的機會,Cancel掉的任務就沒法再執行了(下述第6行)。
  3. 下載過程中如果之前暫停未下載完畢的檔案,透過設定header中range:bytes來實現斷點續傳(下述第29行)。

Untitled 6.png

優點和缺點

優點

  • 邏輯複用: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設定;任務取消單純透過請求庫取消實現。

❤️本文由 程式設計黑板報 原創,歡迎關注同名公眾號,原創技術文章第一時間推送❤️

相關文章