WPS二次开发系列：如何对打开文档路径FileUri授权

1. 什么是FileProvider

若要安全地将应用中的文件提供给其他应用，您需要配置应用，以内容 URI 的形式提供文件的安全句柄。Android FileProvider 组件会根据您在 XML 中指定的内容生成文件的内容 URI。

这部分知识是Android FileProvider通用知识，详细请参考FileProvider

2. Demo参考

2.1 在项目工程的AndroidManifest.xml中定义FileProvider

如Demo所示

注意事项：

• 注意这里authorities 一般可以定义为 包名.fileprovider, 这里在后面集成代码中要用到
• 定义file_paths.xml 这个文件会定义文件的实际路径和映射成fileuri的内容路径的规则，详细请参考Android 官方FileProvider

2.2 file_paths.xml 定义参考

如WPS-SDK Demo所见

2.3 在代码中使用

将普通的 filePath 转换成 fileuri

 Uri fileUri; // Android 7.0(包含)之后使用FileProvider，之前使用file协议
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // File转化为FileProvider类型的Uri，对应FileProvider名字必须是AndroidManifest.xml中定义匹配
    fileUri = FileProvider.getUriForFile(context, "cn.wps.sdk.demo.fileprovider", new File(filePath));
} else{
    fileUri = Uri.fromFile(filePath);
}

2.4 完整的打开文档参考

如Demo所见

//1.------------ 将filePath 转换成FileUri----------
String filePath = "/storage/emulated/0/Android/data/cn.wps.sdk.demo/files/document/123.docx";
Uri fileUri; // Android 7.0(包含)之后使用FileProvider，之前使用file协议
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // File转化为FileProvider类型的Uri，对应FileProvider名字必须是AndroidManifest.xml中定义匹配
    fileUri = FileProvider.getUriForFile(context, "cn.wps.sdk.demo.fileprovider", new File(filePath));
} else{
    fileUri = Uri.fromFile(filePath);
}
//2.------------ 调用WPS SDK 相关接口打开文档----------       
FileService fileService = WpsSdk.getInstance().getService(FileService.class);
if (fileService != null) {
    fileService.openFile(context, fileUri);
}

上面示例代码可以参考FilePath和fileUri的变化

filePath : /storage/emulated/0/Android/data/cn.wps.sdk.demo/files/document/123.docx
fileUri: content://cn.wps.sdk.demo.fileprovider/myprovider/files/document/123.docx

结合上面file_paths.xml和fileProvider的定义能够更好理解这种变化规则