腾讯信鸽推送Android SDK快速指南

信鸽Android SDK是一个可以提供Push服务的开发平台，提供给开发者简便、易用的API接口，方便快速接入。
目前支持Android 2.2及以上版本系统。

本文档将引导用户以最快的速度嵌入信鸽SDK。
注册&下载SDK

前往前台 信鸽首页，使用QQ号码登录，打开注册页面，填写“应用名称”和“应用包名”（必需要跟APP一致），选择“操做系统”和“分类”，最后点击“建立应用”。
应用建立成功后，点击“应用配置”便可看到APP专属的AccessId和AccessKey等信息。
10min demo regi.png

注册完成后，请下载最新版本的Android SDK到本地，并解压。
工程配置

以eclipse为开发的IDE为例，将SDK导入到工程的步骤为：
一、建立或打开Android工程（关于如何建立Android工程，请参照开发环境的章节）。
二、将信鸽 SDK目录下的libs目录全部文件拷贝到工程的libs（或lib）目录下。
三、选中libs（或lib）目录下的信鸽jar包，右键菜单中选择Build Path， 选择Add to Build Path将SDK添加到工程的引用目录中。
四、打开Androidmanifest.xml，添加如下配置（建议参考下载包的Demo修改），其中YOUR_ACCESS_ID和YOUR_ACCESS_KEY替换为APP对应的accessId和accessKey,请确保按照要求配置，不然可能致使服务不能正常使用。

<application
   <!-- APP项目的其它配置... -->

   <!-- 【必须】 信鸽receiver广播接收 -->
    <receiver
        android:name="com.tencent.android.tpush.XGPushReceiver"
        android:process=":xg_service_v2" >
        <intent-filter android:priority="0x7fffffff" >
            <!-- 【必须】 信鸽SDK的内部广播 -->
            <action android:name="com.tencent.android.tpush.action.SDK" />
            <action android:name="com.tencent.android.tpush.action.INTERNAL_PUSH_MESSAGE" />
            <!-- 【必须】 系统广播：开屏和网络切换 -->
            <action android:name="android.intent.action.USER_PRESENT" />
            <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            
            <!-- 【可选】 一些经常使用的系统广播，加强信鸽service的复活机会，请根据须要选择。固然，你也能够添加APP自定义的一些广播让启动service -->
            <action android:name="android.bluetooth.adapter.action.STATE_CHANGED" />
            <action android:name="android.intent.action.ACTION_POWER_CONNECTED" />
            <action android:name="android.intent.action.ACTION_POWER_DISCONNECTED" />
        </intent-filter>
    </receiver>

    <!-- 【必须】 (2.30及以上版新增)展现通知的activity -->
    <!-- 【注意】 若是被打开的activity是启动模式为SingleTop，SingleTask或SingleInstance，请根据通知的异常自查列表第8点处理-->
     <activity
         android:name="com.tencent.android.tpush.XGPushActivity"
         android:exported="true" >
         <intent-filter>
            <!-- 若使用AndroidStudio，请设置android:name="android.intent.action"-->
             <action android:name="" />
         </intent-filter>
    </activity>

    <!-- 【必须】 信鸽service -->
    <service
        android:name="com.tencent.android.tpush.service.XGPushService"
        android:exported="true"
        android:persistent="true"
        android:process=":xg_service_v2" />
 
    <!-- 【必须】 通知service，此选项有助于提升抵达率 -->
    <service
        android:name="com.tencent.android.tpush.rpc.XGRemoteService"
        android:exported="true" >
        <intent-filter>
            <action android:name="应用包名.PUSH_ACTION" />
        </intent-filter>
    </service>

    <!-- 【必须】 请将YOUR_ACCESS_ID修改成APP的AccessId，“21”开头的10位数字，中间没空格 -->
    <meta-data
        android:name="XG_V2_ACCESS_ID"
        android:value="YOUR_ACCESS_ID" />
    <!-- 【必须】 请将YOUR_ACCESS_KEY修改成APP的AccessKey，“A”开头的12位字符串，中间没空格 -->
    <meta-data
        android:name="XG_V2_ACCESS_KEY"
        android:value="YOUR_ACCESS_KEY" />
</application>

<!-- 【必须】 信鸽SDK所需权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.RESTART_PACKAGES" />
<uses-permission android:name="android.permission.BROADCAST_STICKY" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.KILL_BACKGROUND_PROCESSES" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.VIBRATE" />
<!-- 【可选】 信鸽SDK所需权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BATTERY_STATS" />

启动并注册App

完成工程配置后，打开工程的主Activity，在其onCreate(Bundle savedInstanceState)重载方法内，添加如下代码，完成信鸽服务的启动与APP注册过程。

// 开启logcat输出，方便debug，发布时请关闭
// XGPushConfig.enableDebug(this, true);
// 若是须要知道注册是否成功，请使用registerPush(getApplicationContext(), XGIOperateCallback)带callback版本
// 若是须要绑定帐号，请使用registerPush(getApplicationContext(),account)版本
// 具体可参考详细的开发指南
// 传递的参数为ApplicationContext
Context context = getApplicationContext();
XGPushManager.registerPush(context);    

// 2.36（不包括）以前的版本须要调用如下2行代码
Intent service = new Intent(context, XGPushService.class);
context.startService(service);


// 其它经常使用的API：
// 绑定帐号（别名）注册：registerPush(context,account)或registerPush(context,account, XGIOperateCallback)，其中account为APP帐号，能够为任意字符串（qq、openid或任意第三方），业务方必定要注意终端与后台保持一致。
// 取消绑定帐号（别名）：registerPush(context,"*")，即account="*"为取消绑定，解绑后，该针对该帐号的推送将失效
// 反注册（再也不接收消息）：unregisterPush(context)
// 设置标签：setTag(context, tagName)
// 删除标签：deleteTag(context, tagName)

代码嵌入完成后，启动APP，若是在logcat中的TPush标签看到如下相似的输出，说明已经注册成功，并返回token。

    图：注册成功本地标签为“TPush”标签的logcat日志打印

10 min demo token.png
验证

前往信鸽前台，选择“建立通知”，输入“标题”和“内容”，点击“确认推送”。稍等几秒后，若是顺利的话，终端设备应该可以收到这条通知。

    图：前台下发通知界面

10min demo pushprocess.png

    图：终端设备收到通知界面

10 min demo arrived.png

经过上面的接入，APP已经具有接收通知推送的能力。
固然，若是还须要更高级的功能，请继续阅读或参数《SDK开发指南》
通知的异常自查列表

信鸽的发布包都是通过严格测试的，遇到问题时，尤为是开发环境问题，建议先自行搜索网上解决方案。
常见的检查列表：
1.设备是否正常联网？
2.检查AndroidManifest.xml是否配置正确？建议直接参考demo的例子改

2.1. accessId、accessKey设置是否与前台注册的一致？
2.2. 相关权限是否齐全？
2.3. receiver、service和activity相关组件是否配置好？

3.设备是否注册成功？
4.当前APP包名是否与前台注册的一致，若是不一致请在前台选中“使用多包名”选项？
5.前台下发通知时，“时段控制”选项里的时间段是否符合终端设备当前时间？
6.请根据“常见问题与解答”，看看是否有解决方案。
7.2.30及以上版本请检查xml配置文件是否添加com.tencent.android.tpush.XGPushActivity相关的内容
8.停留在后台的APP点击通知不能打开APP：被打开的activity（特别是LAUNCHER）启动模式为SingleTop，SingleTask或SingleInstance，请在该activity重载onNewIntent方法：

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);        
    setIntent(intent);// 必需要调用这句
}

9.对于使用AndriodStudio的同窗，若AndroidManifest.xml编译不经过，XGPushActivity配置改成： <action android:name="android.intent.action" />
10.请检查AndroidManifest.xml是否已正确配置XGRemoteService，且intent-filter中是否正确设置： <action android:name="应用包名.PUSH_ACTION" />，应用包名为当前APP包名，如com.tencent.xgdemo
11.是否已设置APP默认的icon？因为系统缘由，若没有icon，通知将不能展现。
12.（2.36以前的版本）已知MIUI V6上会禁用全部静态广播，若出现有相似的状况，请添加如下代码兼容该系统。

// 在XGPushManager.registerPush(context)或其它版本的注册接口以后调用如下代码
// 使用ApplicationContext
Context context = getApplicationContext();
Intent service = new Intent(context, XGPushService.class);
context.startService(service);


13.点击通知，出现不能打开activity的状况，请在AndroidManifest.xml中将XGPushActivity的exported属性设置为true。
14.点击通知，出现重复打开APP的状况，请将被打开的Activity启动模式改成SingleTop，SingleTask或SingleInstance。
15.点击通知，不但愿触发activity被打开的动做，能够：1.推送时，填写一个不存在的页面名称；2.使用消息透传（命令字）推送，收到消息后，本身弹出通知。
若是还不能排查问题，请加入信鸽开发者技术QQ群：333782566，会有专门的人员协助。

包冲突

1.jar包冲突：

若是提示jar包冲突，请删除冲突的包，保留一份便可，建议保留版本高的。
常见的冲突有：
1）MSDK与信鸽冲突：删除wup.jar
2）MTA与信鸽冲突：删除低版本的mid.jar

2. .so文件导入：.so文件是信鸽必须的组件，支持armeabi、armeabi-v7a、misp和x86平台，请根据本身当前.so支持的平台添加

1）若是你的项目中没有使用其它.so，建议复制四个平台目录到本身工程中
2）若是已有.so文件，只须要复制信鸽对应目录下的文件
3）如果MSDK接入的游戏，一般只须要armeabi目录下的.so
4）若当前工程已经有armeabi，那么只须要添加信鸽的armeabi下的.so，其它目录无需添加。其它状况相似，只添加当前平台存在的平台便可。

代码混淆

若是你的项目中使用proguard等工具作了代码混淆，请保留如下选项，不然将致使信鸽服务不可用。

-keep public class * extends android.app.Service
-keep public class * extends android.content.BroadcastReceiver
-keep class com.tencent.android.tpush.**  {* ;}
-keep class com.tencent.mid.**  {* ;}

关于抵达量/点击量和自定义key-value的统计

2.30及以上版本
2.30及以上版本：使用信鸽SDK内置的activity展现页面，默认已经统计通知/消息的抵达量、通知的点击和清除动做。但若是开发者要监听这些事 件，可参考“Android SDK开发指南”中的“【2.30及以上版本】通知效果监听和自定义key-value”章节。
XGPushManager.onActivityStarted(this)获取通知被点击及自定义key-value由原来的onStart()改成onResume()

        @Override
    protected void onResume() {
        super.onResume();
        XGPushClickedResult click = XGPushManager.onActivityStarted(this);
        if (click != null) { // 判断是否来自信鸽的打开方式
            // 根据实际状况处理...
            // 如获取自定义key-value
        }
    }

    同理，XGPushManager.onActivityStoped(this)由onStop()改成onPause()内调用，即：

    @Override
    protected void onPause() {
        super.onPause();
        XGPushManager.onActivityStoped(this);
    }

    注意：
1）须要将onActivityStarted和onActivityStoped嵌入到全部可能被打开的activity，建议全部activity都加上。
2）若是被打开的activity启动模式为SingleTop，SingleTask或SingleInstance，请根据如下在该activity重载onNewIntent方法：

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);        
        setIntent(intent);// 必需要调用这句
    }

通知在通知栏被点击或清除时的回调，即自定义Receiver（需重载XGPushBaseReceiver）的 onNotifactionClickedResult重载方法中区分点击和清除动做，XGPushClickedResult添加 getActionType()，其中XGPushClickedResult.NOTIFACTION_CLICKED_TYPE表示点击操 做，XGPushClickedResult.NOTIFACTION_DELETED_TYPE表示清除操做。即：

    @Override
    public void onNotifactionClickedResult(Context context,
            XGPushClickedResult message) {
        if (context == null || message == null) {
            return;
        }
        if (message.getActionType() == XGPushClickedResult.NOTIFACTION_CLICKED_TYPE) {
            // 通知在通知栏被点击啦。。。。。
            // APP本身处理点击的相关动做
            // 这个动做能够在activity的onResume也能监听，请看第3点相关内容
        } else if (message.getActionType() == XGPushClickedResult.NOTIFACTION_DELETED_TYPE) {
            // 通知被清除啦。。。。
            // APP本身处理通知被清除后的相关动做
        }
    }

2.30版本以前
2.0/2.1x/2.2x版本：SDK默认统计通知/消息的抵达量，但对于点击量和自定义key-value，须要全部activity的 onStart重载方法中调用 XGPushManager.onActivityStarted(this);才能统计，具体请参考“Android SDK开发指南”中的“【2.30之前版本】通知打开效果和自定义key-value”章节