kiefer-/AndroidDownloader-1

主要功能

高效的App版本更新库，提供两个下载引擎：HttpURLConnection(推荐) 和系统的 DownloadManager
支持断点续传，节省流量（避免网络抖动时重新下载）
支持设置是否使用本地下载好的缓存文件
通知栏显式下载进度，且支持根据下载状态设置通知策略
统一处理应用没有安装权限的交互逻辑
内置通用的更新弹窗、支持强制更新（支持自定义更新弹窗）

开发过程

参考过 github 上其他的一些更新库，主要是参考了系统的 DownloadManager 源码。

系统的 DownloadManager 更新通知栏进度之前，会进行时间、速度采样，不能在 I/O 的时候 buffer 满了就通知，避免短时间创建大量通知对象
重定向需要考虑 301,302,303,307 308，其中 301,302,303 在 HttpURLConnection 定义了常量，307，308 没有定义，需要自己定义常量
重定向需要考虑最大次数，避免极端情况的死循环
需要考虑下载续传的 Response code
由于各厂商 Android 定制化，最好能够统一处理应用没有安装权限的交互逻辑

如何使用

添加依赖：

implementation 'io.github.chiclaim:downloader:1.0.2'

开始下载

val request = DownloadRequest(applicationContext, url, mode)
    // 通知栏标题
    .setNotificationTitle(resources.getString(R.string.app_name))
    // 通知栏描述
    .setNotificationContent(getString(R.string.downloader_notifier_description))
    // 是否忽略本地下载好的文件，如果忽略则会重新下载
    .setIgnoreLocal(ignoreLocalFile)
    // 下载完成是否启动安装
    .setNeedInstall(needInstall)
    // 通知栏显示策略
    .setNotificationVisibility(notifierVisibility)
    // 通知栏图标
    .setNotificationSmallIcon(R.mipmap.ic_launcher)
    // 通知栏被禁用是否提示
    .setShowNotificationDisableTip(notifierDisableTip)
    // 下载监听（进度、成功、失败等）
    .registerListener(this)
    .startDownload()

监听的回调

override fun onDownloadStart() {
}

override fun onProgressUpdate(percent: Int) {
}

override fun onDownloadComplete(uri: Uri) {
}

override fun onDownloadFailed(e: Throwable) {
}

移除监听：

override fun onDestroy() {
    super.onDestroy()
    request?.unregisterListener(this)
}

注意：下载完成、下载失败都会自动移除监听器

默认升级弹窗

UpgradeDialogActivity.launch(this, UpgradeDialogInfo().also {
    it.url = fileUrl
    // 是否忽略本地下载好的文件
    it.ignoreLocal = ignoreLocalFile
    // 弹窗 title
    it.title = if (isForceUpdate) "重要安全升级" else "发现新版本"
    // 更新描述
    it.description = "1. 修复已知问题\n2. 修复已知问题"
    // 是否为强制更新
    it.forceUpdate = isForceUpdate
    // 左侧按钮文案
    it.negativeText = if (isForceUpdate) "退出程序" else "取消"
    // 通知栏小图标
    it.notifierSmallIcon = R.mipmap.ic_launcher
    // 是否后台下载
    it.backgroundDownload = isBackgroundDownload
    // 下载完成是否需要启动安装程序
    it.needInstall = needInstall
})

自定义升级弹窗

自定义升级弹窗非常简单，只需要在你的 Activity/Fragment/Dialog 调用：

val request = DownloadRequest(applicationContext, url, mode)
    .setNotificationTitle(resources.getString(R.string.app_name))
    .setNotificationContent(getString(R.string.downloader_notifier_description))
    .setIgnoreLocal(ignoreLocalFile)
    .setNeedInstall(needInstall)
    .setNotificationVisibility(notifierVisibility)
    .setNotificationSmallIcon(R.mipmap.ic_launcher)
    .setShowNotificationDisableTip(notifierDisableTip)
    .registerListener(this) // 注册监听
    .startDownload()

然后实现相应的监听即可，关闭自定义弹窗时移除件监听即可。

混淆

本库不需要额外的配置，四大组件不混淆即可

经过测试的机型

厂商	机型	系统版本
小米	Redmi4	Android 6.0.1
华为	荣耀7i	Android 6.0.1
华为	荣耀V8	Android 7.0
小米	Note4X	Android 7.0
vivo	Y85A	Android 8.1.0
华为	荣耀V10	Android 9
华为	Mate20	Android 9
vivo	x50	Android 10
荣耀	Magic3 至臻版	Android 11
小米	小米 11 Ultra	Android 12

kiefer- / AndroidDownloader-1

主要功能

开发过程

如何使用

开始下载

监听的回调

默认升级弹窗

自定义升级弹窗

混淆

经过测试的机型

TODOs

About

Languages