android 7.0之后版本 出现file:// URI引起的FileUriExposedException

本文解析了Android 7.0系统中针对文件访问的新特性,特别是对file://Uri的限制,以及如何使用FileProvider和content://Uri进行解决,确保应用在不同版本的Android系统上能够顺利进行版本更新。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在我们app版本更新的迭代几个版本之后发现这次这个版本在7.0的手机上下载新版本,无法安装,出现

怎么会这一次出现这个问题呢?? 原来是我们这次版本更新将targetSdk 变到了25 以前是23 所以在以前的版本更新是不会出现这个问题, 默认代码会兼容高于23的版本.所以解决的方法我们可以把build.gradle的targetSdk变回到23,但是这样 不是最好的解决办法 如果项目以后还是需要使用新的特性或者以后后面项目移交别人时 targetSDK还是会变到高版本的 第二种解决方法 从病根着手 是什么原因导致出现这个?原来是android 7.0 系统开始对文件访问又加了保护,这属于7.0的新特性  查看android 7.0 文档 

简而言之,就是7.0开始

Android不再允许在app中把file://Uri暴露给其他app,包括但不局限于通过Intent或ClipData 等方法。原因在于使用file://Uri会有一些风险,比如:

        文件是私有的,接收file://Uri的app无法访问该文件。

        在Android6.0之后引入运行时权限,如果接收file://Uri的app没有申请READ_EXTERNAL_STORAGE权限,在读取文件时会引发崩溃。

因此,google提供了FileProvider,使用它可以生成content://Uri来替代file://Uri解决方案首先,在AndroidManifest.xml中添加provider

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/provider_paths" />
</provider>

其次,再values目录下创建xml资源文件目录,然后创建provider_paths文件

 最后修改代码

       String filePath = Config.downLoadPath + "/" + filebean.getFileName();
        File file = new File(filePath);
        if (!file.exists()) {
            throw new NullPointerException(
                    "The package cannot be found");
        }
        Intent install = new Intent(Intent.ACTION_VIEW);
        // 调用系统自带安装环境
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            install.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_ACTIVITY_NEW_TASK);
//            install.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            Uri contentUri = FileProvider.getUriForFile(this, getPackageName()+".fileprovider", file);
            install.setDataAndType(contentUri, "application/vnd.android.package-archive");
        } else {
            install.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            install.setDataAndType(Uri.fromFile(file), "application/vnd.android.package-archive");
        }
        getApplicationContext().startActivity(install);

其中Config.downLoadPath是

/**
 * 文件下载地址
 */
public static String downLoadPath = Environment.getExternalStorageDirectory().getAbsolutePath() + "/downloads/";

fileBean.getFileName(),就是xxx.apk

注意这里

这里设置权限和启动模式最好放在一起,因为有时候会出现安装不成功是因为权限的问题. 这里,基本就可以实现版本更新了分析FileProvider使用content://Uri的优点:它可以控制共享文件的读写权限,只要调用Intent.setFlags()就可以设置对方app对共享文件的访问权限,并且该权限在对方app退出后自动失效。相比之下,使用file://Uri时只能通过修改文件系统的权限来实现访问控制,这样的话访问控制是它对所有 app都生效的,不能区分app。它可以隐藏共享文件的真实路径。定义FileProvider在AndroidManifest.xml的<application>节点中添加<provider>

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/provider_paths" />
</provider>

android:authorities是用来标识provider的唯一标识,在同一部手机上一个"authority"串只能被一个app使用,冲突的话会导致app无法安装。我们可以利用manifest placeholders来保证authority的唯一性。android:exported必须设置成false,否则运行时会报错java.lang.SecurityException: Provider must not be exported。android:grantUriPermissions用来控制共享文件的访问权限,也可以在java代码中设置。指定路径和转换规则FileProvider会隐藏共享文件的真实路径,将它转换成content://Uri路径,因此,我们还需要设定转换的规则。android:resource="@xml/provider_paths"这个属性指定了规则所在的文件。<paths>中可以定义以下子节点
 

子节点对应路径
files-pathContext.getFilesDir()
cache-pathContext.getCacheDir()
external-pathEnvironment.getExternalStorageDirectory()
external-files-pathContext.getExternalFilesDir(null)
external-cache-pathContext.getExternalCacheDir()

file://到content://的转换规则:

1.替换前缀:把file://替换成content://${android:authorities}。

2.匹配和替换遍历<paths>的子节点,找到最大能匹配上文件路径前缀的那个子节点。用path的值替换掉文件路径里所匹配的内容。

3.文件路径剩余的部分保持不变.


 

<think>我们正在处理将`file://` URI转换为`content://` URI的问题。根据引用[1]和[2],我们需要使用FileProvider来实现这个转换。以下是步骤: 1. **在AndroidManifest.xml中声明FileProvider**: 我们需要在应用的`AndroidManifest.xml`文件中声明一个FileProvider。注意,FileProvider是v4支持库的一部分,但现在通常使用androidx,所以如果是androidx,则使用`androidx.core.content.FileProvider`。 2. **创建文件路径配置**: 在`res/xml`目录下创建一个XML文件(例如`provider_paths.xml`),用于定义我们想要共享的文件路径。 3. **使用FileProvider获取Content URI**: 在代码中,对于给定的文件,我们使用FileProvider的`getUriForFile`方法来获取对应的`content://` URI。 下面详细说明: ### 步骤1:在AndroidManifest.xml中声明FileProvider ```xml <application> ... <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/provider_paths" /> </provider> ... </application> ``` 注意:`android:authorities`属性通常使用应用的包名加上一个字符串(如".fileprovider")来确保唯一性。这里我们使用`${applicationId}`来自动替换为应用的包名。 ### 步骤2:创建文件路径配置文件 在`res/xml`目录下创建`provider_paths.xml`文件。这个文件定义了哪些路径可以共享。 例如,如果我们想共享外部存储的私有缓存目录(即`/storage/emulated/0/Android/data/<package-name>/cache`),我们可以这样配置: ```xml <?xml version="1.0" encoding="utf-8"?> <paths xmlns:android="http://schemas.android.com/apk/res/android"> <!-- 对应Context.getExternalCacheDir() --> <external-cache-path name="external_cache" path="." /> <!-- 其他路径也可以配置,例如: <files-path name="my_files" path="path/" /> 对应Context.getFilesDir() <cache-path name="my_cache" path="path/" /> 对应Context.getCacheDir() <external-path name="external" path="." /> 对应Environment.getExternalStorageDirectory() <external-files-path name="external_files" path="." /> 对应Context.getExternalFilesDir(null) --> </paths> ``` ### 步骤3:在代码中将File URI转换为Content URI 假设我们有一个文件路径:`file:///storage/emulated/0/Android/data/cm.komect.aqb.android.ccsdk/cache/download/test.apk` 我们可以通过以下方式获取其对应的Content URI: ```java // 假设context是当前上下文,file是目标文件 File file = new File("/storage/emulated/0/Android/data/cm.komect.aqb.android.ccsdk/cache/download/test.apk"); Uri contentUri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider", file); ``` 注意:这里`FileProvider.getUriForFile`的第二个参数必须与我们在Manifest中声明的authorities一致。我们使用了`${applicationId}.fileprovider`,所以这里用`context.getPackageName() + ".fileprovider"`。 ### 注意事项 1. **文件路径必须在FileProvider配置的路径之下**:例如,上面的文件位于外部缓存目录,所以我们在`provider_paths.xml`中配置了`<external-cache-path>`。如果文件位于其他位置,需要配置相应的路径。 2. **权限授予**:当我们使用这个Content URI启动其他应用(例如安装APK)时,需要授予目标应用读取该URI的权限。通常通过设置Intent的Flag: ```java intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); ``` 3. **Android版本适配**:在Android 7.0(API 24)及以上,必须使用Content URI,以下版本可以使用File URI。所以通常我们会进行版本判断: ```java Uri uri; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { uri = FileProvider.getUriForFile(context, context.getPackageName() + ".fileprovider", file); } else { uri = Uri.fromFile(file); } ``` ### 示例:安装APK 在安装APK时,我们通常需要将File URI转换为Content URI: ```java File apkFile = new File(getExternalCacheDir(), "download/test.apk"); Intent installIntent = new Intent(Intent.ACTION_VIEW); installIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); Uri uri; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { uri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", apkFile); installIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } else { uri = Uri.fromFile(apkFile); } installIntent.setDataAndType(uri, "application/vnd.android.package-archive"); startActivity(installIntent); ``` ### 总结 将`file://` URI转换为`content://` URI的步骤: 1. 在Manifest中声明FileProvider。 2. 在`res/xml`目录下配置共享路径。 3. 使用`FileProvider.getUriForFile`方法转换。 这样,我们就能够安全地在应用间共享文件了。 ### 引用 根据引用[1]和[2]的内容,我们使用了FileProvider来生成content URI[^1][^2]。 §§相关问题§§ 1. 如何配置FileProvider以共享多个目录? 2.Android 11及以上版本,使用FileProvider有哪些新的权限要求? 3. 如何处理FileProvider的FileNotFoundException?</think>### 如何将 file:// URI 转换为 content:// URI in AndroidAndroid 开发中,将 `file://` URI 转换为 `content://` URI 的核心解决方案是使用 **FileProvider**。以下是完整实现步骤: #### 一、配置 FileProvider(关键步骤) 1. **AndroidManifest.xml 声明** 在 `<application>` 标签内添加: ```xml <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/provider_paths" /> </provider> ``` - `android:authorities`:使用 `${applicationId}` 确保唯一性[^1] - `android:grantUriPermissions="true"`:允许临时权限授予 2. **创建路径配置文件** 在 `res/xml/provider_paths.xml` 定义共享路径: ```xml <paths xmlns:android="http://schemas.android.com/apk/res/android"> <!-- 外部缓存目录 --> <external-cache-path name="cache" path="/" /> <!-- 外部文件目录 --> <external-files-path name="files" path="download/" /> <!-- 内部存储 --> <files-path name="internal" path="documents/" /> </paths> ``` #### 二、转换代码实现 ```kotlin // 核心转换函数 fun convertFileUriToContentUri(context: Context, fileUri: Uri): Uri? { return try { if (fileUri.scheme != "file") return null val file = File(fileUri.path!!) if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { // 使用 FileProvider 转换 FileProvider.getUriForFile( context, "${context.packageName}.fileprovider", // 与 Manifest 一致 file ) } else { // Android 6.0 以下直接使用 file:// fileUri } } catch (e: Exception) { Log.e("URI_Convert", "Error: ${e.message}") null } } // 使用示例 val fileUri = Uri.parse("file:///storage/emulated/0/Android/data/cache/download/test.apk") val contentUri = convertFileUriToContentUri(context, fileUri) // 输出结果示例:content://com.your.package.fileprovider/cache/download/test.apk ``` #### 三、路径映射原理 FileProvider 通过路径配置实现映射: ``` 原始路径:file:///storage/emulated/0/Android/data/{package}/cache/file.txt ↓ 通过 <external-cache-path> 配置 转换结果:content://{authority}/cache/file.txt ``` #### 四、使用注意事项 1. **权限授予** 传递 URI 时必须添加权限标志: ```kotlin intent.apply { data = contentUri addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION) } ``` 2. **路径匹配规则** - 文件必须位于 `provider_paths.xml` 声明的目录中 - 路径名称区分大小写(Linux 文件系统特性) 3. **Android 11+ 适配** ```xml <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" /> <queries> <intent> <action android:name="android.intent.action.VIEW" /> </intent> </queries> ``` #### 五、常见问题解决方案 1. **FileNotFoundException** - 检查 `provider_paths.xml` 是否包含目标目录 - 验证文件实际存在:`file.exists()` 2. **SecurityException** ```kotlin // 必须显式授权 context.grantUriPermission( targetPackage, contentUri, Intent.FLAG_GRANT_READ_URI_PERMISSION ) ``` 3. **ContentResolver 查询** 如果需要获取文件信息: ```kotlin contentResolver.query(contentUri, null, null, null, null)?.use { cursor -> if (cursor.moveToFirst()) { val displayName = cursor.getString(cursor.getColumnIndex(OpenableColumns.DISPLAY_NAME)) val size = cursor.getLong(cursor.getColumnIndex(OpenableColumns.SIZE)) } } ``` #### 六、性能优化建议 1. **URI 缓存** ```kotlin private val uriCache = LruCache<String, Uri>(20) fun getCachedUri(path: String): Uri? { return uriCache.get(path) ?: run { convertFileUriToContentUri(context, Uri.fromFile(File(path)))?.also { uriCache.put(path, it) } } } ``` 2. **路径精确匹配** 避免使用根路径: ```xml <!-- 不推荐 --> <external-path name="root" path="/" /> <!-- 推荐 --> <external-files-path name="downloads" path="download/" /> ``` > **关键点**:FileProvider 通过 ContentProvider 机制实现安全文件共享,解决了 Android 7.0+ 的 `FileUriExposedException` 问题[^1][^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值