Android远程下载安装APK更新报Operation not permitted错误

java.io.IOException: Operation not permitted报错由多版本适配缺失和代码逻辑错误共同导致：

• 存储权限适配失效：Android 10（API 29）默认启用分区存储，直接向Environment.getExternalStorageDirectory()根目录写入文件会被系统拦截；Android 13（API 33）后WRITE_EXTERNAL_STORAGE权限完全作废，即使动态申请也无法获取公共根目录写入权限。
• 安装权限缺失：Android 8.0（API 26）起，应用安装第三方APK需要单独持有REQUEST_INSTALL_PACKAGES权限，无权限触发安装流程会直接失败。
• 路径拼接错误：原代码拼接APK路径时遗漏文件分隔符，会生成/storage/emulated/0AppName.apk这类无效路径。
• Uri适配不兼容：Android 7.0（API 24）起禁止跨应用暴露file://类型Uri，原代码用Uri.fromFile()传递安装路径会触发FileUriExposedException，即使下载完成也无法唤起安装。
• 线程违规：原代码直接在主线程执行网络请求，会触发NetworkOnMainThreadException崩溃。
• 基础权限遗漏：未声明网络权限的情况下根本无法发起下载请求。

1. 清单文件配置 #

首先在AndroidManifest.xml中声明必要权限和FileProvider配置：

<!-- 网络访问权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 8及以下版本需要的存储写入权限，高版本自动忽略 -->
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />
<!-- 未知来源应用安装权限 -->
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

<application
    ...>
    <!-- FileProvider配置，适配7.0以上文件共享 -->
    <provider
        android:name="androidx.core.content.FileProvider"
        android:authorities="${applicationId}.fileprovider"
        android:exported="false"
        android:grantUriPermissions="true">
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/file_paths" />
    </provider>
    ...
</application>

在res目录下新建xml文件夹，创建file_paths.xml配置可访问的文件路径，这里直接用应用私有缓存目录，不需要申请存储权限：

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <cache-path name="apk_cache" path="." />
</paths>

2. 核心逻辑修正 #

• 放弃往外部公共根目录写文件，将APK下载到应用自身的cacheDir私有目录，全Android版本无需额外存储权限
• 下载逻辑放到子线程执行，避免主线程网络违规
• 安装时通过FileProvider生成content://类型Uri，临时授予安装程序读权限
• 安装前校验未知来源应用安装权限，无权限则引导用户开启

import android.content.Intent
import android.net.Uri
import android.os.Build
import android.provider.Settings
import android.util.Log
import androidx.core.content.FileProvider
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import java.io.File
import java.io.FileOutputStream
import java.io.IOException
import java.io.InputStream
import java.net.HttpURLConnection
import java.net.URL

/**
 * 下载并安装APK，在协程作用域内调用
 * 示例：lifecycleScope.launch { downloadAndInstallApk("你的APK下载地址") }
 */
private suspend fun downloadAndInstallApk(apkUrl: String) = withContext(Dispatchers.IO) {
    // APK存到应用私有缓存目录，无需存储权限
    val apkFile = File(cacheDir, "update_version.apk")
    if (apkFile.exists()) apkFile.delete()

    var connection: HttpURLConnection? = null
    var inputStream: InputStream? = null
    var outputStream: FileOutputStream? = null

    try {
        val url = URL(apkUrl)
        connection = url.openConnection() as HttpURLConnection
        connection.apply {
            requestMethod = "GET"
            connectTimeout = 15000
            readTimeout = 15000
            connect()
        }

        if (connection.responseCode != HttpURLConnection.HTTP_OK) {
            throw IOException("请求失败，响应码：${connection.responseCode}")
        }

        inputStream = connection.inputStream
        outputStream = FileOutputStream(apkFile)
        val buffer = ByteArray(1024)
        var readLength: Int
        while (inputStream.read(buffer).also { readLength = it } != -1) {
            outputStream.write(buffer, 0, readLength)
        }
        outputStream.flush()

        // 下载完成切主线程唤起安装
        withContext(Dispatchers.Main) {
            installApk(apkFile)
        }
    } catch (e: Exception) {
        Log.e("UpdateUtil", "APK下载/安装失败", e)
    } finally {
        inputStream?.close()
        outputStream?.close()
        connection?.disconnect()
    }
}

/**
 * 唤起系统安装流程
 */
private fun installApk(apkFile: File) {
    // 8.0以上检查未知来源安装权限，无权限跳设置页引导开启
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && !packageManager.canRequestPackageInstalls()) {
        val permissionIntent = Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES).apply {
            data = Uri.parse("package:$packageName")
            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        }
        startActivity(permissionIntent)
        // 可在onActivityResult或ActivityResultLauncher回调中重新校验权限，通过后再次调用installApk
        return
    }

    val installIntent = Intent(Intent.ACTION_VIEW).apply {
        addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
        // 7.0以上用FileProvider生成合规Uri，低版本继续用file类型Uri
        val apkUri = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            FileProvider.getUriForFile(this@MainActivity, "${packageName}.fileprovider", apkFile)
        } else {
            Uri.fromFile(apkFile)
        }
        setDataAndType(apkUri, "application/vnd.android.package-archive")
    }
    startActivity(installIntent)
}

• 如果需要显示下载进度，可通过connection.contentLength获取文件总大小，在读取流时计算已下载字节占比，回调到UI层更新进度条即可。
• 若项目未接入协程，可将下载逻辑包裹在Thread{}.start()中执行，通过runOnUiThread切回主线程更新UI和唤起安装。
• targetSdkVersion升级到31及以上时，需保证所有组件配置exported属性，上述FileProvider已配置android:exported="false"，符合系统要求。

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