超强下载管理：DownloadManager核心接口全方位解析

2026-02-05 05:17:05作者：裴锟轩Denise

你是否还在为下载速度慢、任务管理混乱而烦恼？ab-download-manager的DownloadManager类提供了全方位的下载管理接口，让你轻松掌控多线程下载、断点续传、速度限制等核心功能。本文将详细解析DownloadManager的每一个接口，帮助开发者快速集成并优化下载体验。

项目概述

AB Download Manager是一款旨在提升下载效率的桌面应用，支持多平台（Windows/Linux）、多线程下载、队列管理等功能。其核心在于DownloadManager类，该类封装了下载任务的创建、暂停、恢复、删除等全套操作。

项目主页：README.md
核心源码：downloader/core/src/main/kotlin/ir/amirab/downloader/DownloadManager.kt

应用主界面

核心接口详解

初始化与启动

DownloadManager的使用始于初始化与启动流程。通过boot()方法完成初始化，确保所有挂起的下载任务被正确恢复。

val downloadManager = DownloadManager(
    dlListDb = ...,
    partListDb = ...,
    settings = DownloadSettings(),
    diskStat = ...,
    emptyFileCreator = ...,
    client = OkHttpDownloaderClient()
)
downloadManager.boot() // 启动管理器，恢复未完成任务
downloadManager.awaitBoot() // 等待初始化完成

接口定义：DownloadManager.kt#L48

添加下载任务

addDownload()方法用于创建新下载任务，支持重复策略（覆盖/重命名/中止）和上下文传递。

参数	类型	描述
newItem	DownloadItem	包含URL、文件名、保存路径的下载元数据
onDuplicateStrategy	OnDuplicateStrategy	重复处理策略：AddNumbered/OverrideDownload/Abort
context	DownloadItemContext	任务上下文信息

val downloadItem = DownloadItem(
    link = "https://example.com/largefile.zip",
    folder = "/home/user/Downloads",
    name = "largefile.zip"
)
val taskId = downloadManager.addDownload(
    newItem = downloadItem,
    onDuplicateStrategy = OnDuplicateStrategy.AddNumbered
)

接口定义：DownloadManager.kt#L68

任务控制接口

DownloadManager提供了完整的任务生命周期控制：

方法	描述
pause(id)	暂停指定ID的下载任务
resume(id)	恢复暂停的下载任务
reset(id)	重置下载任务（清空已下载部分）
deleteDownload(id)	删除任务及文件
stopAll()	暂停所有活跃任务

// 暂停任务
downloadManager.pause(taskId)

// 恢复任务
downloadManager.resume(taskId)

// 删除任务（保留文件）
downloadManager.deleteDownload(taskId) { false }

下载任务监控

通过getDownloadList()获取所有任务状态，通过getParts()查看分块下载进度：

// 获取所有任务
val tasks = downloadManager.getDownloadList()

// 查看任务分块
val parts = downloadManager.getParts(taskId)

高级功能

全局速度限制

通过limitGlobalSpeed()方法限制整体下载带宽：

downloadManager.limitGlobalSpeed(1024 * 1024) // 限制为1MB/s

接口定义：DownloadManager.kt#L326

任务事件监听

通过listOfJobsEvents流监听任务状态变化：

downloadManager.listOfJobsEvents.collect { event ->
    when (event) {
        is DownloadManagerEvents.OnJobCompleted -> {
            println("任务 ${event.downloadItem.id} 完成")
        }
        is DownloadManagerEvents.OnJobCanceled -> {
            println("任务 ${event.downloadItem.id} 取消: ${event.throwable.message}")
        }
    }
}