FileProvider是Android 7.0出現的新特性,它是ContentProvider的子類,可以通過創建一個Content URI並賦予臨時的文件訪問權限來代替File URI實現文件共享。
FileProvider注冊配置
1)Manifest中聲明FileProvider對象
在 Manifest.xml文件中注冊 FileProvider;
support庫:
<manifest> ... <application> ... <provider android:name="android.support.v4.content.FileProvider" android:authorities="<包名>.fileprovider" android:exported="false" android:grantUriPermissions="true">
<meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"/>
</provider> ... </application>
</manifest>
androidx庫:
<manifest> ... <application> ... <provider android:name="androidx.core.content.FileProvider" android:authorities="<包名>.fileprovider" android:exported="false" android:grantUriPermissions="true">
<meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths"/>
</provider> ... </application>
</manifest>
屬性說明:
- provider
name:一般為android.support.v4.content.FileProvider
或者androidx.core.content.FileProvider
。如果自定義FileProvider,這里則是自定義FileProvider文件的路徑(android:name="com.xxx.XXFileProvider"
);
authorities:作為唯一標識,用來表明使用者。一般用包名 + 參數
表示(android:authorities="${applicationId}.fileprovider"
),在FileProvider的函數getUriForFile()
方法中需要傳入該參數(APPLICATION_ID + ".fileProvider"
);
exported:是否允許公開使用;
grantUriPermissions:是否允許授權文件的臨時訪問權限。 - meta-data
name:值為android.support.FILE_PROVIDER_PATHS
不可修改;
resource:是引用配置文件路徑信息的xml文件。
2)在res/xml中創建對外暴露的文件夾路徑
① 在項目app/src/main/res
文件夾下xml
文件夾,並新建一個file_paths.xml
文件,編寫file_paths.xml
文件,配置文件路徑信息:
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<external-path name="external_files" path="."/>
</paths>
文件路徑配置標簽可以參考FileProvider文件中的TAG配置:
屬性說明:
- paths
name:是一個文件別名,對外可見路徑的一部分,隱藏真實文件目錄 ;
path:是一個相對目錄,相對於當前標簽的根目錄。path
值為點符號(".
")時,該根目錄下所有的文件夾都可以臨時授權訪問。
root-path:表示設備的根目錄,對應File DEVICE_ROOT = new File("/")
目錄路徑:"/"
;
files-path:表示內部存儲空間應用私有目錄下的 files/ 目錄,對應Context.getFilesDir()
所獲取的目錄路徑:/data/data/<包名>/files
;
cache-path:表示內部存儲空間應用私有目錄下的 cache/ 目錄,對應Context.getCacheDir()
所獲取的目錄路徑:/data/data/<包名>/cache
;
external-path:表示外部存儲空間根目錄,對應Environment.getExternalStorageDirectory()
所獲取的目錄路徑:/storage/emulate/0
;
external-files-path:表示外部存儲空間應用私有目錄下的 files/ 目錄,對應Context.getExternalFilesDir()
所獲取的目錄路徑:/storage/emulate/0/Android/data/<包名>/files
;
external-cache-path:表示外部存儲空間應用私有目錄下的 cache/ 目錄,對應Context.getExternalCacheDir()
所獲取的目錄路徑:/storage/emulate/0/Android/data/<包名>/cache
;
external-media-path:表示外部媒體區域根目錄中的文件,對應Context.getExternalMediaDirs()
所獲取的目錄路徑:/storage/emulated/0/Android/media/<包名>
。
FileProvider授權使用
1)調用相機
private static void goCamera(Activity activity, String filePath, int requestCode) { Intent intent = new Intent(); File imagePath = new File(filePath); Uri imageUri; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { imageUri = FileProvider.getUriForFile(activity, BuildConfig.APPLICATION_ID + ".fileProvider", imagePath); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } else { imageUri = Uri.fromFile(imagePath); } intent.setAction(MediaStore.ACTION_IMAGE_CAPTURE); intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri); activity.startActivityForResult(intent, requestCode); }
2)安裝應用
public static void installApk(Context context, String filePath) { Intent intent = new Intent(Intent.ACTION_VIEW); File file = new File(filePath); Uri apkUri; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { apkUri = FileProvider.getUriForFile(context, BuildConfig.APPLICATION_ID + ".fileProvider", file); intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); } else { apkUri = Uri.fromFile(file); } intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intent.setDataAndType(apkUri, "application/vnd.android.package-archive"); context.startActivity(intent); }