概述

1. 简介

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

2. SDK下载

点击前往下载Android SDK

3. 推送流程

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

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

4. 运行环境

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

5. 权限控制

• 只有jar集成方式才需要开发者处理

5.1 必选权限

（1）网络连接（必选）

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

（2）查看网络状态，sdk重连机制等需要使用（必选）

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

（3）查看wifi连接状态（必选）

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

（4）震动权限（使用通知功能必选）

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

（5）获取任务信息，目的是防止sdk被频繁唤醒（必选）

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

（6）自定义权限，内部广播通信及为了防止小部分手机服务没法正常工作（必选）

    <uses-permission android:name="getui.permission.GetuiService.${applicationId}"/>
    <permission
        android:name="getui.permission.GetuiService.${applicationId}"
        android:protectionLevel="signature"/>

（7）兼容android12 alarm权限（必选）

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

（8）vivo角标设置（必选）

 <uses-permission android:name="com.vivo.notification.permission.BADGE_ICON" /> 

5.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="android.permission.READ_PHONE_STATE"/>