android7.0版本适配(一):应用间文件文件共享——FileProvider

自7.0开始,android不允许应用之间通过file://协议的Uri共享文件,否则将抛出FileUriExposedException异常。举个常见的使用场景:调用系统应用拍照,我们需要传递一个Uri,告诉照片的存储位置。

Intent capturePicIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
File destinationFile = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "my_pic.jpg");
Uri savePicFileUri = Uri.fromFile(destinationFile);
capturePicIntent.putExtra(MediaStore.EXTRA_OUTPUT, savePicFileUri);
startActivity(capturePicIntent);

在7.0及以后,如此创建Uri会抛出异常。

调取系统相机拍照的本质是与系统应用交互,而不同应用之间不允许通过file://协议的Uri共享文件。Android给出的解决方案是通过FileProvider生成一个content://协议的Uri。

第一步,继承android.support.v4.content.FileProvider定义一个FileProvider类,但不需要如外实现任何代码。大多数开发者会直接使用android.support.v4.content.FileProvider,不推荐那么做,原因后面剖析。

package com.coder.zzq.system.version.sdk.adaptation.provider;

public class MyFileProvider extends android.support.v4.content.FileProvider {
    
}

第二步,声明FileProvider,FileProvider本质是一个ContentProvider,所以要在Manifest.xml文件中声明。

<provider
    android:name=".provider.MyFileProvider"
    android:authorities="com.coder.zzq.system.version.sdk.adaptation.FILE_PROVIDER"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/mapping_file_path" />
</provider>

<provider>标签下,

  • name,FileProvider的全称类名
  • authorities,FileProvider的唯一标识,一般以包名打头,确保唯一性
  • exported,false表示不公开给其他应用
  • android:grantUriPermissions,true表示授予Uri临时权限

<meta>标签下,

  • name,固定值,"android.support.FILE_PROVIDER_PATHS",该项meta-data的名称
  • resource,路径映射文件

第三步,编写路径映射文件,路径映射文件用于配置其他应用通过FileProvider可访问的目录。

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-files-path
        name="external_storage_files_dir"
        path="/Pictures" />
</paths>

paths提供了6个子标签,用于配置可访问的路径类型。

  • <file-path>,根路径对应内部存储:/data/user/0/包名/files
  • <cache-path> 根路径对应内部存储:/data/user/0/包名/cache
  • <external-path> 根路径对应外部存储:storage/emulated/0
  • <external-files-path> 根路径对应外部存储:/storage/emulated/0/Android/data/包名/files
  • <external-cache-path> 根路径对应外部存储:/storage/emulated/0/Android/data/包名/cache
  • <external-media-path> 根路径对应外部存储:/storage/emulated/0/Android/media/包名

每个子标签的name属性表示该项配置的名字,可自由设置,path为子路径,如果是该路径类型下所有文件及子路径均可访问,则用“.”表示。

第四步,使用FileProvider创建Uri,

Intent capturePicIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
File destinationFile = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "my_pic.jpg");
Uri savePicFileUri = null;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    savePicFileUri = MyFileProvider.getUriForFile(this, getString(R.string.file_provider_authorities), destinationFile);
} else {
    savePicFileUri = Uri.fromFile(destinationFile);
}
capturePicIntent.putExtra(MediaStore.EXTRA_OUTPUT, savePicFileUri);
startActivity(capturePicIntent);

至此,适配完成。

最后说一下为什么不推荐直接使用android.support.v4.content.FileProvider而是多此一举创建一个没有任何新代码的子类。

我们的项目都会引入第三方库,在第三方库中由于功能需要,可能也进行了FileProvider的配置。假设这个第三方库就是用来拍照的,它封装了拍照功能,实现上把照片的Uri直接置于内部存储的/data/user/0/包名/files/Pictures下。它的路径映射文件如下:

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

</paths>

封装代码如下:

public class CaptureUtils {
    public static void capture(Context context) {
        Intent capturePicIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
        File destinationFile = new File(context.getFilesDir(), "my_pic.jpg");
        Uri savePicFileUri = null;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            savePicFileUri = FileProvider.getUriForFile(context, context.getString(R.string.file_provider_authorities), destinationFile);
        } else {
            savePicFileUri = Uri.fromFile(destinationFile);
        }
        capturePicIntent.putExtra(MediaStore.EXTRA_OUTPUT, savePicFileUri);
        context.startActivity(capturePicIntent);
    }
}

我们的项目和该库都直接使用android.support.v4.content.FileProvider类的话,那么我们的项目将编译报错。

清单文件合并失败,因为同一个FileProvider实现类,存在两个authorities,提示我们用tools语法进行replace。

我们replace一下,

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="com.coder.zzq.system.version.sdk.adaptation.FILE_PROVIDER"
    android:exported="false"
    android:grantUriPermissions="true"
    tool:replace="android:authorities">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/mapping_file_path" />
</provider>

然后编译继续报错。

  该库的映射文件名和我们不一致,我们继续按照提示replace。

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="com.coder.zzq.system.version.sdk.adaptation.FILE_PROVIDER"
    android:exported="false"
    android:grantUriPermissions="true"
    tool:replace="android:authorities">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/mapping_file_path"
        tool:replace="android:resource"/>
</provider>

然后在调用CaptureUtils.capture(this)的地方依然编译报错。

因为我们的路径映射文件中,并不包含第三方库路径映射文件的配置范围。现在我们把它加进来。

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <external-files-path
        name="external_storage_files_dir"
        path="/Pictures" />
    <files-path
        name="internal_storage_files_dir"
        path="." />
</paths>

最后终于通过了编译。

这说明,我们的项目和第三方库都直接使用android.support.v4.content.FileProvider类的话,我们需要replace它们的authorities和resource,并且把所有第三方库映射文件中的配置项都要包含到我们项目的映射文件中来。非常麻烦且容易疏漏。最好的办法就是自定义FileProvider类,使我们的FileProvider同其他的库的FileProvider分开,互不干扰。由于不需要如外实现新的代码,所以是很简单的。

  • 2
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
package com.example.tigongzhe; import android.R.integer; import android.content.ContentProvider; import android.content.ContentUris; import android.content.ContentValues; import android.content.Context; import android.content.UriMatcher; import android.database.Cursor; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.database.sqlite.SQLiteOpenHelper; import android.net.Uri; import android.provider.SyncStateContract.Helpers; import android.text.Selection; import android.util.Log; public class provider extends ContentProvider { private MyOpenHelper myOpenHelper; private SQLiteDatabase sqLiteDatabase; private static final UriMatcher URI_MATCHER=new UriMatcher(UriMatcher.NO_MATCH); private final String TAG="provider"; private static final String authority="com.example.tigongzhe.provider"; static { URI_MATCHER.addURI(authority, "contacter", 1); URI_MATCHER.addURI(authority, "contacter/#", 2); } private static final String _id="id"; private static final String name="name"; private static final String num="num"; @Override public boolean onCreate() { // TODO Auto-generated method stub myOpenHelper=new MyOpenHelper(getContext(), DB_Name, null, version_1); return true; } @Override public String getType(Uri uri) { // TODO Auto-generated method stub int flag=URI_MATCHER.match(uri); switch (flag) { case 2: return "vnd.android.cursor.item/contacter"; case 1: return "vnd.android.dir.item/contacter"; default: throw new IllegalArgumentException("异常参数"); } } @Override public Uri insert(Uri uri, ContentValues values) { // TODO Auto-generated method stub sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: sqLiteDatabase.insert(Table_Name, name, values); break; case 2: long id=sqLiteDatabase.insert(Table_Name, name, values); ContentUris.withAppendedId(uri, id); default: break; } return uri; } @Override public Cursor query(Uri uri, String[] arg1, String arg2, String[] arg3, String arg4) { // TODO Auto-generated method stub Cursor cursor; sqLiteDatabase=myOpenHelper.getReadableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: cursor=sqLiteDatabase.query(Table_Name, arg1, arg2, arg3, null, null,arg4); break; case 2: long id=ContentUris.parseId(uri); arg2=(arg2==null||"".equals(arg2.trim()))? _id+"="+id:arg2+"and"+_id+"="+id; cursor=sqLiteDatabase.query(Table_Name, arg1, arg2, arg3, null, null,arg4); default: throw new IllegalArgumentException("参数错误"); } return cursor; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int num=0; sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: num=sqLiteDatabase.update(Table_Name, values,selection, selectionArgs); break; case 2: long id=ContentUris.parseId(uri); selection=(selection==null||"".equals(selection.trim()))? _id+"="+id:selection+"and"+_id+"="+id; num=sqLiteDatabase.update(Table_Name, values,selection, selectionArgs); default: break; } return num; } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int num=0; sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: num=sqLiteDatabase.delete(Table_Name, selection, selectionArgs); break; case 2: long id=ContentUris.parseId(uri); selection=(selection==null||"".equals(selection.trim()))?_id+"="+id:selection+"and"+_id+"="+id; num=sqLiteDatabase.delete(Table_Name, selection, selectionArgs); default: throw new IllegalArgumentException("异常参数"); } return num; } private final String DB_Name = "mydb.db"; private final String Table_Name="contacter"; private final int version_1=1; private class MyOpenHelper extends SQLiteOpenHelper { public MyOpenHelper(Context context, String name, CursorFactory factory, int version) { super(context, name, factory, version); } /** * @description 当数据表无连接时创建新的表 */ @Override public void onCreate(SQLiteDatabase db) { String sql = " create table if not exists " + Table_Name + "(id INTEGER PRIMARY KEY AUTOINCREMENT," + "name varchar(64),num varchar(64))"; db.execSQL(sql); } /** * @description 当版本更新时触发的方法 */ @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { String sql = " drop table if exists " + Table_Name; db.execSQL(sql); onCreate(db); } } } +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.tigongzhe" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="18" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="com.example.tigongzhe.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <provider android:name=".provider" android:authorities="com.example.tigongzhe.provider" android:multiprocess="true" android:exported="true" android:permission="com.example.tigongzhe.permission" ></provider> </application> <permission android:name="com.example.tigongzhe.permission" android:protectionLevel="normal"></permission> </manifest> ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++package com.example.tigongzhe; import android.R.integer; import android.content.ContentProvider; import android.content.ContentUris; import android.content.ContentValues; import android.content.Context; import android.content.UriMatcher; import android.database.Cursor; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.database.sqlite.SQLiteOpenHelper; import android.net.Uri; import android.provider.SyncStateContract.Helpers; import android.text.Selection; import android.util.Log; public class provider extends ContentProvider { private MyOpenHelper myOpenHelper; private SQLiteDatabase sqLiteDatabase; private static final UriMatcher URI_MATCHER=new UriMatcher(UriMatcher.NO_MATCH); private final String TAG="provider"; private static final String authority="com.example.tigongzhe.provider"; static { URI_MATCHER.addURI(authority, "contacter", 1); URI_MATCHER.addURI(authority, "contacter/#", 2); } private static final String _id="id"; private static final String name="name"; private static final String num="num"; @Override public boolean onCreate() { // TODO Auto-generated method stub myOpenHelper=new MyOpenHelper(getContext(), DB_Name, null, version_1); return true; } @Override public String getType(Uri uri) { // TODO Auto-generated method stub int flag=URI_MATCHER.match(uri); switch (flag) { case 2: return "vnd.android.cursor.item/contacter"; case 1: return "vnd.android.dir.item/contacter"; default: throw new IllegalArgumentException("异常参数"); } } @Override public Uri insert(Uri uri, ContentValues values) { // TODO Auto-generated method stub sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: sqLiteDatabase.insert(Table_Name, name, values); break; case 2: long id=sqLiteDatabase.insert(Table_Name, name, values); ContentUris.withAppendedId(uri, id); default: break; } return uri; } @Override public Cursor query(Uri uri, String[] arg1, String arg2, String[] arg3, String arg4) { // TODO Auto-generated method stub Cursor cursor; sqLiteDatabase=myOpenHelper.getReadableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: cursor=sqLiteDatabase.query(Table_Name, arg1, arg2, arg3, null, null,arg4); break; case 2: long id=ContentUris.parseId(uri); arg2=(arg2==null||"".equals(arg2.trim()))? _id+"="+id:arg2+"and"+_id+"="+id; cursor=sqLiteDatabase.query(Table_Name, arg1, arg2, arg3, null, null,arg4); default: throw new IllegalArgumentException("参数错误"); } return cursor; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int num=0; sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: num=sqLiteDatabase.update(Table_Name, values,selection, selectionArgs); break; case 2: long id=ContentUris.parseId(uri); selection=(selection==null||"".equals(selection.trim()))? _id+"="+id:selection+"and"+_id+"="+id; num=sqLiteDatabase.update(Table_Name, values,selection, selectionArgs); default: break; } return num; } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int num=0; sqLiteDatabase=myOpenHelper.getWritableDatabase(); int flag=URI_MATCHER.match(uri); switch (flag) { case 1: num=sqLiteDatabase.delete(Table_Name, selection, selectionArgs); break; case 2: long id=ContentUris.parseId(uri); selection=(selection==null||"".equals(selection.trim()))?_id+"="+id:selection+"and"+_id+"="+id; num=sqLiteDatabase.delete(Table_Name, selection, selectionArgs); default: throw new IllegalArgumentException("异常参数"); } return num; } private final String DB_Name = "mydb.db"; private final String Table_Name="contacter"; private final int version_1=1; private class MyOpenHelper extends SQLiteOpenHelper { public MyOpenHelper(Context context, String name, CursorFactory factory, int version) { super(context, name, factory, version); } /** * @description 当数据表无连接时创建新的表 */ @Override public void onCreate(SQLiteDatabase db) { String sql = " create table if not exists " + Table_Name + "(id INTEGER PRIMARY KEY AUTOINCREMENT," + "name varchar(64),num varchar(64))"; db.execSQL(sql); } /** * @description 当版本更新时触发的方法 */ @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { String sql = " drop table if exists " + Table_Name; db.execSQL(sql); onCreate(db); } } }

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Vincent(朱志强)

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值