Java版SDK&DEMO

第一步：创建应用及相关权限申请

请先阅读快速接入模块，开展相关环节。

第二步：下载SDK和DEMO

SDK获取

DEMO获取

第三步：DEMO试用

DEMO服务的首页地址为： http://demo.cn/wpsdoc/index.html模拟应用中心调起服务的首页地址为： http://demo.cn/wpsdocdemo

开放平台官网应用基本设置： 填入已申请的APPID和APPKEY IP白名单： 贵公司出口IP 域名白名单：demo.cn 回调地址：调用DEMO服务的地址，即 http://demo.cn/wpsdoc/index.html

本地配置： 在本地测试运行DEMO需要设置hosts文件 127.0.0.1 demo.cn

注意： 开放平台官网设置的服务回调地址应与DEMO服务地址一致 若修改回调地址，请同时修改本地hosts、域名白名单以及wpsdocdemo/js/wpsdocindex.js中的redirect_uri回调地址

以Windows为例：

1.解压压缩包，进入demo-wpsdoc下的exec目录，试用DEMO所需的文件都放在这里:      nginx-1.15.5为nginx启动及配置目录      server.jar为打包好的DEMO服务      application.Properties为jar包的配置文件       wpsdocdemo模拟了应用中心，旨在调起DEMO首页 
2.需要在Application.properites文件中填写已申请的appId和appKey;    3.需要在wpsdocdemo/js/wpsdocindex.js中填写已申请的appId,并查看redirect_uri回调地址是否与官网设置一致;    4.需要在nginx-1.15.5文件夹下的nginx.conf中配置nginx访问根路径，将C:/demo-wpsdoc/exec修改为当前exec目录；    5.在nginx-1.15.5文件夹下，运行nginx.exe启动nginx;    6.在当前目录下打开shell环境，输入java -jar server.jar启动DEMO服务；    7.在浏览器上输入 [http://demo.cn/wpsdocdemo](http://demo.cn/wpsdocdemo) 即可进入首页,如图所示：![image](/projects/wps-doc/c138936cd87829ab470e21a146bc232d.png)    **Mac版的使用方式除了更换适应平台的nginx外，其余步骤基本一致，详情请参考压缩包中的使用指南。如若不能正常运行，请联系open@wps.cn.**

第四步:应用开发

该模块将详细介绍demo的集成和涉及的SDK接口调用详解，可参考该部分打造属于您自己的应用，剖析如下：

集成开发环境

进入压缩包的的源码文件夹，用IntelliJ IDEA开发工具导入OpenWPSDoc文件夹下代码即可。其中： 1. Gradle版本用gradle-2.2.1及以上版本，JDK使用JDK1.7及以上版本， 2. 依赖Jar包opensdk-1.0.jar在工程的libs目录下，导入工程时会自动导入， 3. Demo前端代码在src\main\resources\static\wpsdoc目录下，前端代码建议使用JetBrains WebStorm导入后再编辑， 4. 在application.properties中配置好server.port、appid以及appkey参数， 5. 在Application.java文件中启动工程， 6. 控制台出现类似如下信息表示工程启动成功：Started Application in 3.489 seconds (JVM running for 4.135)。

此DEMO主要包含通过WPS文件选择器获取用户云文档文件，并获取其分享链接进行在线编辑：

WPS选择器的使用步骤和Js举例使用请参考WPS文件选择器进行接入。

文件选择器选择文件后，获取该文件的分享链接的流程操作请参考以下SDK接口进行对接。

SDK相关接口调用

注意： 在调用SDK的文件相关接口前，需要先配置SDK的应用信息：

public static void setConfig(String appid, String appKey);

参数说明

调用方式：Config.setConfig(appId, appKey);

SDK接口说明如下：

1, 获取分享链接

public static LinkInfo getFileLinkInfo(String access_token, long fileid);

参数说明

调用方式：LinkInfo linkInfo = YunFile.getFileLinkInfo(accessToken, fileId);

有任何疑问，请加入QQ群: 732130805 或者联系open@wps.cn获取帮助。