Android 8+应用内DownloadManager下载APK无法安装求助

开发了一款非Google Play商店的客户专属闭源系统应用，内置更新按钮通过DownloadManager从服务器下载新APK。出现以下现象：

• Chrome浏览器下载的APK可正常安装
• 应用内DownloadManager下载的APK，Android 8及以下系统可正常安装；Android 8及以上系统无法打开/安装，无任何报错信息，但下载完成事件能正常触发

相关配置 #

compileSdkVersion 29
minSdkVersion 23
targetSdkVersion 29

当前使用的Kotlin代码 #

下载链接示例：https://myserver.com/foo/bar/MyApp.apk

val r = DownloadManager.Request(Uri.parse(updateUri))

r.setMimeType(getMimeType(updateUri.toString()))
r.setTitle("MyApp.apk")
r.setDescription("Downloading attachment..")
r.allowScanningByMediaScanner()
r.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "MyApp.apk")
r.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)

val dm = activity.getSystemService(Context.DOWNLOAD_SERVICE) as DownloadManager
dm.enqueue(r)

1. 校验MIME类型是否正确 #

Android 8+对APK的MIME类型校验更严格，确保getMimeType返回值为application/vnd.android.package-archive，而非application/octet-stream等其他类型。可以直接硬编码测试：

r.setMimeType("application/vnd.android.package-archive")

2. 处理Android 8+的未知来源安装权限 #

Android 8（API 26）开始，安装未知来源应用需动态申请权限，默认状态下该权限是禁用的，无权限会导致下载完成后无法触发安装：

• 在AndroidManifest.xml中添加权限声明：

  <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
  

• 在下载完成准备安装前，检查并申请权限：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && !packageManager.canRequestPackageInstalls()) {
      val intent = Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES)
          .setData(Uri.parse("package:${packageName}"))
      startActivityForResult(intent, REQUEST_INSTALL_PERMISSION)
  } else {
      // 执行安装逻辑
  }
  

3. 验证下载的APK文件完整性 #

DownloadManager在Android 8+环境下可能因传输或缓存问题导致文件损坏，可通过以下方式排查：

• 下载完成后，对比本地APK的MD5/SHA值与服务器提供的校验值
• 手动从下载目录取出APK尝试安装，观察是否出现解析错误
• 检查本地APK文件大小是否与服务器上的文件一致

4. 调整下载路径的权限适配 #

Android 10（API 29）引入分区存储，公共目录Environment.DIRECTORY_DOWNLOADS的访问权限存在限制，可尝试切换到应用私有目录下载：

val apkFile = File(getExternalFilesDir(null), "MyApp.apk")
r.setDestinationUri(Uri.fromFile(apkFile))

注意：私有目录的APK需通过FileProvider提供安装路径，避免触发FileUriExposedException

5. 检查下载完成后的安装Intent配置 #

确保下载完成后正确获取APK的Uri，并配置合法的安装Intent：

• 正确获取下载文件的Uri：

  val query = DownloadManager.Query().setFilterById(downloadId)
  val cursor = dm.query(query)
  if (cursor.moveToFirst()) {
      val uriIndex = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI)
      val apkUri = Uri.parse(cursor.getString(uriIndex))
      // 构建安装Intent
      val installIntent = Intent(Intent.ACTION_VIEW)
          .setDataAndType(apkUri, "application/vnd.android.package-archive")
          .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
      // Android 7+需添加读权限标记
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
          installIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
      }
      startActivity(installIntent)
  }
  cursor.close()
  

• 注意：Android 7+环境下，公共目录的APK需使用content://类型的Uri（通过FileProvider生成），而非file://

6. 检查服务器响应头配置 #

服务器返回的响应头若配置不当，会导致DownloadManager无法正确识别APK文件，确保响应头包含：

Content-Disposition: attachment; filename="MyApp.apk"
Content-Type: application/vnd.android.package-archive

内容的提问来源于stack exchange，提问作者Bent Mucha