概述

概述

1. 简介

Android SDK 下载链接

个推Android SDK为Android应用提供了安全稳定的推送服务模块,开发者只需在原有App中进行简单的配置和编码工作,即可快速获得实时稳定的消息推送能力。

2. 推送流程

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

img_eclipse_res

  • APP调用个推SDK初始化接口,获取推送标识ClientID(简称CID);
  • APP将CID上传到服务端进行保存。通常需要将该CID与相应的用户ID进行关联,以便后续针对特定用户进行消息推送。
  • 业务方服务端需要给指定CID的设备发送消息时,调用个推服务端消息推送接口,个推服务端寻找目标设备,将消息下发给相应的个推SDK,进而将消息进行展示或由APP自行处理。

3. 运行环境

  • 本SDK支持Android 2.2及以上版本的Android系统;
  • 支持Phone、TV、机顶盒等其他基于Android系统的智能设备;

4. 权限控制

4.1 必选权限

(1)网络连接(必选)

    <uses-permission android:name="android.permission.INTERNET”/>

(2)获取手机状态参数,并作为生成个推唯一标识的必要参数(必选)

   <uses-permission android:name="android.permission.READ_PHONE_STATE”/>

(3)查看网络状态,sdk重连机制等需要使用(必选)

    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE”/>

(4)获取wifi连接状态变化,对应提供不同的推送策略,以及sdk连接及时性。(必选)

    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE”/>

(5)查看wifi连接状态(必选)

    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE”/>

(6)开机自启动权限,提升sdk活跃,保障触达(必选)

    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED”/>

(7)写sd卡权限,做数据备份(必选)

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE”/>

(8)震动权限(使用通知功能必选)

    <uses-permission android:name="android.permission.VIBRATE”/>

(9)获取任务信息,目的是防止sdk被频繁唤醒(必选)

    <uses-permission android:name="android.permission.GET_TASKS”/>

4.2 可选权限

(1)支持电子围栏功能(可选)

    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION”/>

(2)自定义权限,为了防止小部分手机服务没法正常工作(可选)

    <uses-permission android:name="getui.permission.GetuiService.${applicationId}"/>
    <permission
        android:name="getui.permission.GetuiService.${applicationId}"
        android:protectionLevel="normal"/>
开发者中心 SDK 下载

文档中心搜索