Android JSAPI集成开发文档

快速体验WPS SDK接入

授权版快速接入指南

文档对象服务能力(专业版能力)

API接口

事件回调

启动参数

场景案例

如何获取应用签名SHA256值

FileUri授权参考

错误码

SDK更新日志

申请移动WPS个人版对接资料

常见问题

附录

Android SDK集成开发文档

移动WPS二次开发方案

<h2>&nbsp;</h2><h2>1. 什么是<a href="https://developer.android.com/training/secure-file-sharing/setup-sharing?hl=zh-cn">FileProvider</a></h2><blockquote><p><span style="background-color:rgb(255,255,255);color:rgb(32,33,36);">若要安全地将应用中的文件提供给其他应用，您需要配置应用，以内容 URI 的形式提供文件的安全句柄。Android </span><a href="https://developer.android.com/reference/androidx/core/content/FileProvider?hl=zh-cn"><code>FileProvider</code></a><span style="background-color:rgb(255,255,255);color:rgb(32,33,36);"> 组件会根据您在 XML 中指定的内容生成文件的内容 URI。</span></p></blockquote><p>这部分知识是Android FileProvider通用知识，详细请参考<a href="https://developer.android.com/training/secure-file-sharing/setup-sharing?hl=zh-cn">FileProvider</a></p><h2>2. Demo参考</h2><h3>2.1 在项目工程的AndroidManifest.xml中定义FileProvider</h3><p>如Demo所示</p><figure class="image"><img src="/wiki/api/v1/file/download?fid=2dd0bd494a73fa42e16f6ce890ac0ac09fee1e69"></figure><p>注意事项：</p><ul><li>注意这里authorities 一般可以定义为 包名.fileprovider, 这里在后面集成代码中要用到</li><li>定义file_paths.xml 这个文件会定义文件的实际路径和映射成fileuri的内容路径的规则，详细请参考Android 官方<a href="https://developer.android.com/training/secure-file-sharing/setup-sharing?hl=zh-cn">FileProvider</a></li></ul><h3>2.2 file_paths.xml 定义参考</h3><p>如WPS-SDK Demo所见</p><figure class="image"><img src="/wiki/api/v1/file/download?fid=499b11383a3b1125671a4b5c2e437174e4968f4d"></figure><p>&nbsp;</p><h3>2.3 &nbsp;在代码中使用</h3><p>将普通的 filePath 转换成 fileuri</p><pre><code class="language-java"> Uri fileUri; // Android 7.0(包含)之后使用FileProvider，之前使用file协议
if(Build.VERSION.SDK_INT &gt;= 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);
}</code></pre><h3>2.4 完整的打开文档参考</h3><p>如Demo所见</p><pre><code class="language-java">//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 &gt;= 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);
}</code></pre><p>上面示例代码可以参考FilePath和fileUri的变化</p><blockquote><p><strong>filePath :</strong> /storage/emulated/0/Android/data/cn.wps.sdk.demo/files/document/123.docx</p><p><strong>fileUri: </strong>content://cn.wps.sdk.demo.fileprovider/myprovider/files/document/123.docx</p></blockquote><p>结合上面file_paths.xml和fileProvider的定义能够更好理解这种变化规则</p><p>&nbsp;</p><p>&nbsp;</p><p>&nbsp;</p>