<#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。

<@mdp.mdp_index_bottom/>