#import "/ftl/spring.ftl" as spring/> <@mdp.mdp_index_common/>
<@mdp.mdp_index_top/>

移动警务应用支撑平台提供统一的应用升级检测和更新服务,并提供自定义升级策略制定服务。应用开发者可更具实际需要制定灵活多样的升级策略。
接口通信协议及格式定义
通信协议采用HTTP,交互数据格式为XML或表单键值对,交互数据使用UTF-8编码。
访问URL地址为: http://[ip]:[port]/Update。其中"ip"、"port"以项目实际情况而定。
接口列表
| 接口名 | 参数请求方式 | 返回结果 |
|---|---|---|
| 升级检测接口 | http post + 表单键值对参数 | 二进制流或文件url地址 |
| 下载接口 | http post + body中放入xml参数 | xml字符串 |
接口协议
| URL | http://ip:端口/Update/update/httpupdate.do |
| 调用方 | 第三方客户端 |
| 调用方式 | http post |
请求参数
请求参数为xml格式,均放置在http协议中的body部分。
<?xml version="1.0" encoding="utf-8"?>
<Root>
<PactVersion>4.1</PactVersion> <--固定为4.1-->
<Req>checkver</Req> <--固定为checkver-->
<Factory>信大捷安</Factory> <--厂商,非空-->
<OS>Android2.3</OS> <--系统平台 非空-->
<Mod>XT711</Mod> <--手机型号,非空-->
<Soft>青岛警务通</Soft> <--软件名称,非空-->
<UserName/> <--冗余字段-->
<cardNo>ddsssfdd</cardNo> <--客户端唯一标识,灰度发布时需要该字段-->
<Vers> <--客户端本地已存在的该apk版本集合-->
<Ver>
<VerType>com.xdja.qdjwt.frame</VerType> <--apk包名,非空-->
<Version>2.371.4.1</Version> <-- apk版本,非空-->
<Date>2012-12-01</Date> <--apk的最后更新日期,非空-->
</Ver>
</Vers>
</Root>
返回结果
升级检测接口根据检测结果的不同分为两种情况:未检测到更新和检测到更新。
未检测到更新
返回xml格式的字符串,具体如下:
<?xml version="1.0" encoding="UTF-8"?>
<Root>
<Req>checkver</Req>
<Result>1</Result> <--检测到更新时值为1-->
<ModPower>
<![CDATA[com.xdja.jxclient|0|警信|1]]> <--apk中拥有的权限-->
</ModPower>
<Msg>无更新版本信息</Msg>
</Root>
检测到更新
同未检测到更新的xml返回结果相比,该场景会一次返回2个xml报文。第一个报文的格式同“未检测到更是”时返回的报文格式一致。第二个报文为检测到的更新apk列表。具体如下:
<?xml version="1.0" encoding="UTF-8"?>
<Root>
<Req>checkver</Req>
<Result>0</Result> <--检测到更新时值为0-->
<ModPower>
<![CDATA[com.xdja.jxclient|0|警信|1]]> <--apk中拥有的权限-->
</ModPower>
<Msg>有新版本信息</Msg>
</Root>
<?xml version="1.0" encoding="UTF-8"?>
<Root>
<Updates> <--老协议没有此结点,4.1和4.2协议有此结点-->
<Update>
<verType>com.xdja.jxclient</verType> <--包名-->
<Version>2.2.3.9092</Version> <--版本
<Date>
<![CDATA[2017-10-19 14:37:13]]> <--更新日期-->
</Date>
<Comment>
<![CDATA[test]]> <--更新内容-->
</Comment>
<UpdateTag>0</UpdateTag>
<Files> <--待更新apk集合对应的文件信息-->
<File>
<RPath>7507c26b43de44b19161c42860e1cb53.apk</RPath> <--服务器端文件名-->
<LPath>data</LPath> <--本地安装目录-->
<FName>JXIM_2.2.3.9092.apk</FName> <--apk真实名-->
<FSize>35586616</FSize> <--apk大小,单位字节-->
<Action>0</Action> <--固定为0-->
<State>0</State> <--固定为0-->
<CSize>0</CSize> <--固定为 0-->
<CheckCode>f2b84277ffa2c8340e85eb75e9f0c8ad</CheckCode> <--apk对应的md5值-->
<DeleteDb>0</DeleteDb> <--升级是否需要删除本地数据库,0:不需要,其他:需要-->
<FileId>7507c26b43de44b19161c42860e1cb53</FileId> <--apk对应的文件id-->
</File>
</Files>
</Update>
</Updates>
</Root>
接口协议
| URL | http://ip:端口/Update/update/httpgetfile.do |
| 调用方 | 第三方客户端 |
| 调用方式 | http post |
请求参数
以post表单键值对的形式提交参数。具体如下:
| 参数名 | 约束 | 值 | 说明 |
|---|---|---|---|
| fileId | String not null | 要下载的文件id | 例如:cbaea60dc7d748ad89490297ad741bd9 |
| billInfo | String not null | 票据 | 统一认证生成的票据,会根据票据进行合法性验证 |
返回结果
返回APK的下载链接URL。