Sketchware中如何实现多文件按队列逐个下载

核心逻辑很简单：维护有序的待下载列表，同一时间只跑一个下载任务，当前任务结束后自动触发下一个，直到列表遍历完成，用Sketchware自带组件就能做，不用额外加第三方库。

前期准备 #

• 打开你的Sketchware项目，在组件面板的网络分类里找到内置的Downloader组件添加到项目中。
• 提前配好存储权限：Android 12及以下版本申请WRITE_EXTERNAL_STORAGE、READ_EXTERNAL_STORAGE；Android 13及以上版本申请对应媒体读取权限、POST_NOTIFICATIONS权限，否则下载的文件无法写入本地存储。
• 在全局作用域新建3个变量：
  • fileList：List类型，用来按顺序存储所有待下载文件的信息，每个元素用Map结构存下载链接、本地保存路径、文件名三个字段即可
  • currentIndex：整数类型，初始值设为0，用来标记当前正在下载的文件在列表中的位置
  • isPause：布尔类型，初始值设为false，用来控制队列暂停/继续，不需要暂停功能可以不建

具体实现步骤 #

• 第一步：初始化下载队列
  把你需要下载的所有文件，按照想要的下载顺序逐个添加到fileList里，比如先下配置文件、再下资源包、最后下安装包，添加顺序就是实际下载顺序。列表填充完成后，调用自定义的startNextDownload()方法启动队列。
• 第二步：编写队列调度方法startNextDownload()
  新建一个自定义方法，逻辑参考如下伪代码：

  // 队列调度核心逻辑
  if currentIndex >= fileList.size:
      弹出Toast提示"所有文件下载完成"
      重置currentIndex为0（需要重复下载就加这行）
      return
  if isPause:
      return
  // 取当前要下载的文件信息
  currentFile = fileList.get(currentIndex)
  // 启动当前文件下载
  Downloader.download(currentFile["url"], currentFile["savePath"])
  // 更新UI，比如显示"正在下载第X/Y个文件：当前文件名"
  updateDownloadTip(currentIndex, fileList.size, currentFile["name"])
  

• 第三步：绑定Downloader组件的事件回调
  找到Downloader组件的三个常用事件，分别写对应逻辑：
  • 下载进度更新事件：拿到当前下载的字节数、总字节数，换算成百分比更新进度条即可
  • 下载完成事件：不要直接结束流程，先把currentIndex的值加1，再主动调用一次startNextDownload()，自动启动下一个文件的下载
  • 下载失败事件：根据你的需求选处理方式：要么弹出提示让用户选择重试当前文件/跳过当前文件，要么直接计数加1跳过当前文件调用startNextDownload()，别让队列卡在失败的任务上就行

常见坑点提醒 #

• 一定不要同时多次调用Downloader的download方法，Sketchware自带的Downloader没有内置队列调度，同时触发多个下载会变成并行下载，不仅顺序乱，还容易占满带宽导致大量下载失败
• 如果需要断点续传，在下载失败时记录当前文件已经下载的字节数，重试的时候把已下载字节数传给Downloader的续传参数即可，不需要改动队列调度的核心逻辑
• 退出下载页面或者Activity销毁时，记得调用Downloader.cancel()终止正在进行的下载，避免内存泄漏
• 如果下载的是APK文件，下载完成后可以直接在完成回调里调系统安装意图，不影响队列流程

内容的提问来源于stack exchange，提问作者DASTAN K.D.I.T