客户端开发文档-中国移动开发者社区.doc

有推客户端中间件（AOE_SDK）API使用说明书 修改记录 日期 内容 其他 2016-05-31 V1.2.1文档 2016-09-18 补充接入能力申请章节 2016-09-20 补充有推Token说明 调整文档格式 2016-09-23 修改有推推送Token作用示意图 规范启动服务方法采用Aoisdk#star()实现。屏蔽了aoisdk#init调用 有的app启动有推服务方式是直接使用aoisdk#init()初始化，不推荐这种方法。 请app检查集成配置和启动方式。 2017-01-04 针对v1.2.3版本修改文档。 增加action配置 android:name=com.aoe.action.TO_CLOSE_AOE 2017-03-02 添加章节集成AOESDK常见问题  目 录 1. 目 录 2 2. 概述 3 1.1 有推系统介绍 3 1.2 有推系统示意图 3 1.3 有推推送Token作用示意图 4 1.4 术语解释 4 3. 接入有推 5 3.1. 注册开发者 5 3.2. 有推能力 5 3.3. 开发测试 6 4. 6 4.1. 导入工程或者引用开发包 6 4.2. 第一步 继承AoiCallback 7 4.3. 第二步 配置AndroidMenifest.xml（参考demo中配置） 9 4.4. 13 4.5. 调试 13 4.6. 混淆规则配置 15 5. API接口说明 15 5.1. 类 15 5.1.1. 方法摘要 15 5.1.2. 接口说明 16 . 设置调试模式 16 . 16 . 查询状态 16 . 获取 16 6. 集成AOESDK常见问题 17 7. 常见问题列表FAQ 17 8. 升级集成说明 20 9. 编制历史 22 10. 23 10.1. 状态码说明 23  概述 有推系统介绍 有推系统是中国移动定义的永远在线平台，手机应用平台可以通过有推系统向终端发送消息。 有推系统由终端中间件（AOE)、AOI网关、服务端中间件（AOI_SDK）三部分组成。 AOE集成在手机终端应用中，管理与AOI网关的长连接并处理下发和上行的消息，它可以将收到的消息（下行）转发给终端应用，也可以将终端应用的消息转发给AOI网关(上行)。 AOI网关是有推系统的核心网元，它主要负责终端连接管理及处理消息的上下行。 服务端中间件（AOI_SDK）集成在与手机终端应用对应的应用平台中，管理应用平台和AOI网关之间的连接及处理消息的上下行。对于无应用平台的终端应用无需集成AOI_SDK，可通过有推网站进行推送（/aoi）。 有推系统示意图 下图为有推系统的示意图，图中的方框代表软件，AOE是由手机应用集成的，AOI-SDK是由应用平台集成的。AOI网关是中间一个独立系统。 有推推送Token作用示意图 术语解释 术语 解释 下行消息 流向为应用平台（或者有推网站）——AOI网关——手机终端应用的消息 上行消息 流向为手机终端应用——AOI网关——应用平台的消息 AOE Always Online Engine 供集成在三方应用里的有推SDK组件 AOI Always Online Infrastructure 永远在线消息推送平台 LID 客户端生成的唯一标示 Token AOI网关为终端上应用客户端产生的Token，唯一。 ——————————————————————————此实线以上部分改推 接入有推能力以下三步骤。开发者 能力中国移动开发者社区成为中国移动发者请前往中国移动开发者社区网址为/上角到注册，页面要求为个人用户。有推能力 登中国移动开发者社区网址为/择推能力。?管理中心布来到创建如下图）页面要求填写名称、应用简介等信息。 3.2.2勾选“有推”能力 在“能力如下图），勾选有推。 3.2.3 获取APPID、APPKEY 能力”后，国移动开发者社区此应用的APPIDAPPKEY，如下图所 备注：客户端集成SDK只用到APP ID。 开发测试 在开发者社区获取APPKEY、APPID，可按推发者指，配置并完成测试 最新及开发文档可国移动开发者社区有推自服务门户下载，/aoi/?。 以“3.1注册开发者注册的网址为/aoi/导航栏即 ————————————————————此实下部分未改。 导入工程或者引用开发包 将AOE DEMO源码导入IDE(此处使用Eclipse)，DEMO对应的工程名为AoeDemo，导入后如下图所示： 检查libs中是否成功引用了jar包（此处以1.2.0版本为例，最新版本请登录/aoi/downloadcenter/tosdk.do进行下载）。 ale