A-下载与库配置

一、下载与库配置

此章节主要为 XAPP SDK 的下载相关说明及库使用时的配置信息说明。

1、下载

请从资源下载处下载 XAPP SDK 库文件

注意:请确保下载的压缩包解压后包括了以下的文件

  • xlink_sdk.jar
  • xlink_common.jar
  • xlink_task_lib.jar
  • xlink_wrapper.jar
  • xlink_restful.jar
  • expiringmap-0.5.7.jar

2、XAPP SDK 导入指引

  1. 删除原来项目中引入libs文件夹下的所有前缀为 xlink_ 的jar(如果有引用旧文件)
  2. 将刚下载的 XAPP SDK 压缩包解压缩,将得到的所有 jar 文件夹导入到你的项目中

注意:请务必删除掉所有旧文件再导入,详细原因说明请查看版本升级

下面是关于 jar 的简单说明:

jar 包 说明
xlink_sdk xlink_common xlink_task_lib XAPP SDK 的核心功能实现
xlink_restful XAPP SDK 所有相关的REST API实现,也包括了后台所有主要的API实现 推荐调用后台API时使用此JAR包
xlink_wrapper XAPP SDK依赖于Android环境的中间件,也是 XAPP SDK 默认的初始化入口及一些默认实现类
expiringmap-0.5.7 第三方依赖库

3、库配置

XAPP SDK 引用库导入后,需要使用 gradle 进行一些配置工作,同时 mainfest 文件也需要进行一些权限配置。

注意:
1.旧版本的库配置与新版本有一些差异,如果从旧版本升级到新版本请参考版本升级-v5版本升级到v6.0.6.9版本
2.不同版本配置时有任何疑问请查看对应版本的版本升级

3.1、gradle 配置

XAPP SDK 中对一些第三方库有依赖关系,包括处理http请求的网络请求等,请根据确保添加以下依赖(依赖库版本可根据实际情况进行更新)

compile fileTree(include: ['*.jar'], dir: 'libs')
//网络请求库
compile 'com.squareup.retrofit2:retrofit:2.3.0'
compile 'com.squareup.retrofit2:converter-gson:2.3.0'
compile 'com.squareup.retrofit2:converter-scalars:2.3.0'
compile 'com.squareup.okhttp3:logging-interceptor:3.8.1'

3.2、manifest 权限与配置

mainifest文件的配置权限

<!--存储权限为日志文件需要,如果不需要提供日志的文件存储功能,也可以不提供此权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--wIFI权限用于本地及云端状态切换及网络状态的检测需要-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<!--网络权限用于云端连接的需要-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>

二、更新说明

日期 说明
2018.09.04 修正文档说明错误
没找到需要的文档?
你可以提交工单反馈 或 阅读常见问题