概述

概述

1. 简介

个推Android SDK为Android应用提供了安全稳定的推送服务模块,应用开发者只需在原有App中进行简单的配置和编码工作,即可快速获得实时稳定的消息推送能力。本文档帮助开发者理解个推SDK的工作流程,手把手介绍所需的各项集成步骤,同时介绍了个推提供的各种进阶功能,供应用开发者根据实际业务需求进行选择。

2. 版本说明

国内标准版 Google Play专版
发布日期 2017-08-17 2017-08-03
版本号 2.11.1.0 2.10.3.5
下载地址 Android SDK 下载(国内版) Android SDK 下载(国外版)
更新功能
  • 增加 "绑定、解绑别名" 结果回调
  • 修复 "设置标签" 在某些情况下失败问题
  • 修复若干其他 bug
  • 调整代码符合google审核规则
  • 针对海外用户进行联网优化
  • 3. 运行环境

    • 本SDK支持Android 2.2及以上版本的Android系统;
    • 支持各大手机厂商的设备(包括华为、三星、小米、OPPO、VIVO、魅族等);
    • 手机需要有网络支持(包括GPRS、3G或Wifi网络等);
    • 手机可以没有SIM卡,但是可能导致部分功能缺失;
    • 手机可以不挂载SD卡,但部分功能可能无法正常工作。

    4. 主要功能及特点

    • 个推SDK为应用提供推送服务,可在后台长期驻留,维持与推送服务器的长连接,实时接收推送消息。采用独有技术确保推送服务省电省流量运行,不会给应用和手机设备造成影响。
    • 集成简单快速,提供7x24技术支持。
    • 支持多个APP合并一条长连接,共享链路,省电省流量。
    • SDK接口丰富,可定制推送模式和通知栏提示样式。
    • 可以根据用户属性建立不同标签,进行定向推送,也可以进行A/B分组测试,从而进行精细化运营。
    • 提供别名接口、静默时间设置接口、推送控制接口,满足APP的各种需求。
    • 个推SDK不仅能提供云端到客户端的推送服务,也可以提供从客户端上传至云端的服务,即推送消息链路支持上下行双向通道,开发者与客户端之间互动更便利。

    5. 推送流程

    一个典型的程序化推送的技术方案如下图所示:

    img_eclipse_res

    • 第三方APP调用个推SDK初始化接口,获取推送标识ClientID(简称CID);
    • 第三方APP将CID上传到第三方应用服务器进行保存。通常需要将该CID与相应的用户ID进行关联,以便后续针对特定用户进行消息推送;
    • 第三方应用服务器需要给指定CID的设备发送透传数据(Payload)时,调用个推平台消息推送接口,个推平台寻找目标设备,将消息下发给相应的个推SDK后台服务,进而将Payload发送给APP进行后续处理。
    通知
    2017.12.18 iOS SDK 2.1.0.0

    新增 SDK 离线状态返回。 优化 SDK 解决已知问题。

    ......
    2017.08.17 Android SDK 2.11.1.0

    增加 "绑定、解绑别名" 结果回调 修复 "设置标签" 在某些情况下失败问题 修复若干其他 bug【感谢快看小说的反馈及大力支持~】

    ......
    2017.08.10 iOS SDK 2.0.0.0

    新增支持一键解绑该别名下对应的所有用户。 优化 SDK 解决已知问题,以 Framework 形式提供 SDK 库。 扩展 SDK(GtExtensionSdk)新增资源释放接口,防止超时处理导致的问题。

    ......
    2017.08.03 Android SDK 2.10.3.5

    调整代码符合google审核规则 针对海外用户进行联网优化 bug修复

    ......
    2017.07.13 PYTHON SDK 4.0.1.4

    修改获取用户状态接口的返回值无法识别的问题

    ......

    文档中心搜索