使用SDK进行线下应用开发

1. 下载SDK工具包并解压

SDK可以看成是一组API的集合,在平台控制台左侧菜单中选择“应用创建-应用管理”,创建应用成功后,进入该应用的详情页面。详情页面中的服务管理列表中默认展示了跟应用模板绑定的内置服务,点击服务管理区域右上角的“新增服务”可以添加外置服务。选择好服务后,点击“SDK下载”按钮即可下载SDK工具包。将下载的SDK工具包进行解压,如下图所示。​ 此工具包集成了应用开发相关接口,核心是lib目录下的两个jar包,和demo目录下的调用示例。调用示例中给出了一些如何调用各个接口的代码示范,供使用者参考,或者直接引入自身的开发代码中。接口文档在“doc”目录下的md文件中,文档列出了各api接口的请求入参

注:应用增加服务发生变化后,此SDK需要重新获取。

2. 引入jar包至项目中

​ 进入“lib“目录下,可以看到如图所示的两个jar包,使用者需使用mvn install 命令加它们加入到本地maven仓库,并将"pom.xml"中给出的maven坐标加入到自身项目pom文件中。具体操作如下:

在jar包所在目录中打开命令行,输入如下命令

mvn install:install-file -Dfile=aep-ecloud-agsdk-biz-${SDK版本}-SNAPSHOT.jar -DpomFile=aep-ecloud-agsdk-biz-${SDK版本}-SNAPSHOT.pom.xml

​ 使用者需分别执行两次上述命令,将两个jar包加入到本地maven仓库中,命令中的“${SDK版本}” 需替换为具体的jar包版本。例如,上图 jar包 1,其版本号为 “APP.tar.gz-1528805331429”,替换完成后执行,若执行结果出现”Build Success“字样,说明jar包注入成功。

注:jar包2 第一次加入到本地仓库成功后,之后无需因工具包的更新而再次执行上述命令(即工具包若更新,只需对jar包1执行上命令,jar包2可以省去此操作)。

3. 加入依赖坐标到本地pom文件中

​ 分别打开“lib”目录下的两个pom文件,即可获取到形如下图所示的依赖坐标,使用者需将其拷贝至本地pom文件中。

<groupId>com.aep.ecloud</groupId>
<artifactId>aep-ecloud-agsdkcore</artifactId>
<version>2.3.1-SNAPSHOT</version>

<groupId>com.aep.ecloud</groupId>
<artifactId>aep-ecloud-agsdk-biz-APP.tar.gz</artifactId>
<version>1528805331429-SNAPSHOT</version>

注:以上坐标供参考,具体以“lib”目录下的两个pom文件为准

4. 查看调用示例

​ 根据您的需求(如HTTPS调用、异步调用、数据签名等),参考demo/*.java编写调用程序即可。如HTTPS调用可参考“testApiWithSsl”的测试用例添加scheme(Scheme.HTTPS)的设置:

AepDeviceNbClient client = AepDeviceNbClient.newClient().scheme(Scheme.HTTPS).build();

如数据签名可参考“testApiWithSignature”的测试用例,如下图所示:请参考“doc”目录下的md文件,来输入具体的请求参数。APPkey和APPSecret的获取请查看平台控制台应用管理相关界面

​ 此工具包集成了应用开发相关接口,核心是lib目录下的两个jar包,和demo目录下的调用示例。调用示例中给出了一些如何调用各个接口的代码示范,供使用者参考,或者直接引入自身的开发代码中。接口文档在“doc”目录下的md文件中,文档列出了各api接口的请求入参

注:应用增加服务发生变化后,此SDK需要重新获取。

搜索结果 ""

    没有搜索结果 ""