Android DownloadManager实现应用自更新详解
1. Android DownloadManager核心机制解析DownloadManager是Android系统提供的原生下载服务组件它本质上是一个长期运行的系统服务。与第三方下载工具不同DownloadManager具有以下架构特点使用ContentProvider机制管理下载任务和状态通过NotificationManager显示下载进度通知依赖系统级的DownloadService处理实际下载逻辑自动处理网络切换和任务恢复这种系统级集成带来了几个关键优势无需额外权限即可实现后台下载系统自动管理任务队列和线程池下载过程不受应用生命周期影响统一的通知栏进度展示1.1 更新场景的特殊考量应用自更新场景对DownloadManager有特殊需求需要处理APK文件的MIME类型application/vnd.android.package-archive必须配置正确的下载目录不能直接写入应用私有目录需要处理下载完成后的安装意图要考虑不同Android版本的存储权限差异典型的问题场景包括Android 10的外部存储访问限制下载完成后无法自动弹出安装界面大文件下载时的进度回调延迟网络切换导致的下载中断2. 完整实现方案2.1 基础配置首先在AndroidManifest.xml中添加必要权限uses-permission android:nameandroid.permission.INTERNET/ uses-permission android:nameandroid.permission.WRITE_EXTERNAL_STORAGE android:maxSdkVersion28/ !-- 仅Android 9及以下需要 -- uses-permission android:nameandroid.permission.REQUEST_INSTALL_PACKAGES/ !-- 安装APK需要 --对于Android 10需要在manifest中添加application ... android:requestLegacyExternalStoragetrue2.2 下载请求构建创建DownloadManager.Request对象时需要注意val request DownloadManager.Request(Uri.parse(downloadUrl)).apply { // 必须设置正确的MIME类型 setMimeType(application/vnd.android.package-archive) // 设置通知可见性 setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED) // 设置下载目录Android 10需要使用MediaStore if (Build.VERSION.SDK_INT Build.VERSION_CODES.Q) { setDestinationInExternalPublicDir( Environment.DIRECTORY_DOWNLOADS, update_${System.currentTimeMillis()}.apk ) } else { setDestinationInExternalFilesDir( context, Environment.DIRECTORY_DOWNLOADS, update.apk ) } // 仅在WIFI下下载 setAllowedNetworkTypes(DownloadManager.Request.NETWORK_WIFI) // 设置通知标题和描述 setTitle(应用更新) setDescription(正在下载新版本) }2.3 任务执行与监控注册下载完成的广播接收器private val downloadCompleteReceiver object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { val id intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1) if(id thisDownloadHelper.downloadId) { queryDownloadStatus() } } } // 注册接收器 context.registerReceiver( downloadCompleteReceiver, IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE) )查询下载状态的方法private fun queryDownloadStatus() { val query DownloadManager.Query().setFilterById(downloadId) val cursor downloadManager.query(query) if (cursor.moveToFirst()) { when (cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS))) { DownloadManager.STATUS_SUCCESSFUL - { val uri cursor.getString( cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI) ) startInstall(uri) } DownloadManager.STATUS_FAILED - { val error cursor.getInt( cursor.getColumnIndex(DownloadManager.COLUMN_REASON) ) handleDownloadError(error) } } } cursor.close() }2.4 安装处理处理APK安装的兼容性方法private fun startInstall(uriString: String) { val uri if (Build.VERSION.SDK_INT Build.VERSION_CODES.N) { // Android 7需要使用FileProvider FileProvider.getUriForFile( context, ${context.packageName}.fileprovider, File(Uri.parse(uriString).path!!) ) } else { Uri.parse(uriString) } val install Intent(Intent.ACTION_VIEW).apply { setDataAndType(uri, application/vnd.android.package-archive) addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION) } context.startActivity(install) }3. 高级优化技巧3.1 断点续传优化默认情况下DownloadManager支持断点续传但可以通过以下方式增强// 在Request中添加 request.apply { // 允许漫游时下载 setAllowedOverRoaming(false) // 设置重试策略 setRetryOnConnectionFailure(true) }3.2 进度监控优化系统默认的进度更新间隔较大可以通过轮询实现更细粒度的监控private fun startProgressPolling() { val handler Handler(Looper.getMainLooper()) val progressRunnable object : Runnable { override fun run() { queryDownloadProgress() handler.postDelayed(this, 1000) // 每秒更新一次 } } handler.post(progressRunnable) } private fun queryDownloadProgress() { val query DownloadManager.Query().setFilterById(downloadId) downloadManager.query(query).use { cursor - if (cursor.moveToFirst()) { val bytesDownloaded cursor.getInt( cursor.getColumnIndex(DownloadManager.COLUMN_BYTES_DOWNLOADED_SO_FAR) ) val bytesTotal cursor.getInt( cursor.getColumnIndex(DownloadManager.COLUMN_TOTAL_SIZE_BYTES) ) val progress if (bytesTotal 0) { (bytesDownloaded * 100 / bytesTotal).toInt() } else { 0 } updateProgress(progress) } } }3.3 安全验证在安装前验证APK的完整性private fun verifyApk(file: File): Boolean { return try { val packageInfo context.packageManager.getPackageArchiveInfo( file.path, PackageManager.GET_SIGNATURES ) val signatures packageInfo?.signatures ?: return false val currentSignature context.packageManager .getPackageInfo(context.packageName, PackageManager.GET_SIGNATURES) .signatures[0] signatures.any { it.toCharsString() currentSignature.toCharsString() } } catch (e: Exception) { false } }4. 常见问题解决方案4.1 下载失败处理常见错误代码及解决方案错误代码原因解决方案1001存储空间不足检查可用空间提示用户清理1002无网络连接检查网络状态等待网络恢复1004文件已存在删除旧文件或重命名新文件1008HTTP错误检查服务器状态和URL有效性4.2 安装失败处理常见安装问题排查检查FileProvider配置是否正确验证APK签名是否一致检查AndroidManifest中的install权限确认存储权限是否授予4.3 兼容性问题不同Android版本的适配要点Android 5.0: 需要动态请求存储权限Android 7.0: 需要使用FileProviderAndroid 8.0: 需要允许未知来源安装Android 11: 需要适配分区存储5. 性能优化实践5.1 批量更新策略当需要更新多个组件时fun enqueueMultipleDownloads(urls: ListString) { val requests urls.map { url - DownloadManager.Request(Uri.parse(url)).apply { // 公共配置 setMimeType(application/vnd.android.package-archive) setNotificationVisibility(VISIBILITY_VISIBLE) } } requests.forEach { request - downloadManager.enqueue(request) } }5.2 下载优先级管理通过COLUMN_PRIORITY控制任务优先级request.apply { // 设置高优先级 setPriority(DownloadManager.Request.PRIORITY_HIGH) // 仅在充电时下载 setRequiresCharging(true) }5.3 网络优化配置根据网络类型调整策略when (networkType) { ConnectivityManager.TYPE_WIFI - { request.setAllowedNetworkTypes(NETWORK_WIFI) request.setTitle(WIFI环境下下载) } ConnectivityManager.TYPE_MOBILE - { request.setAllowedNetworkTypes(NETWORK_MOBILE) request.setTitle(移动网络下载) request.setAllowedOverMetered(true) } }在实际项目中我们发现合理配置DownloadManager的参数可以显著提升更新成功率。特别是在弱网环境下通过调整重试策略和超时设置可以使更新流程更加健壮。建议在正式使用前针对不同的网络条件进行充分的测试验证。
