个推平台客户端SDK接入文档1.3.8-Android

个信互动（北京）网络科技有限公司[普通]1/22个推平台客户端SDK接入文档（JAR模式）编号:GEXIN_ANDROID_SDK_JAR版本:GEXIN_ANDROID_SDK_JARV1.3.8个信互动（北京）网络科技有限公司2013年11月个信互动（北京）网络科技有限公司[普通]2/22目录开发准备...........................................................................................................................................41.注册账号并登记应用（必须）.......................................................................................42.获取SDK开发工具包（必须）......................................................................................4集成SDK（必须）...........................................................................................................................5测试（必须）...................................................................................................................................9扩展功能.........................................................................................................................................10获取透传消息（可选）.........................................................................................................10用户关系映射（可选）.........................................................................................................15SDK接口.........................................................................................................................................16MessageManager....................................................................................................................18getInstance.....................................................................................................................18initialize..........................................................................................................................18getNetstat........................................................................................................................18feedbackAction..............................................................................................................19getVersion......................................................................................................................19setTag..............................................................................................................................20setSilentTime..................................................................................................................20stopService.....................................................................................................................20GexinSdkNetstat......................................................................................................................21inboundBytes.................................................................................................................21outboundBytes...............................................................................................................21Tag...........................................................................................................................................21setName..........................................................................................................................22getName.........................................................................................................................22个信互动（北京）网络科技有限公司[普通]3/22运行环境1.SDK支持Android1.6及以上版本的手机系统2.手机必须要有网络（GPRS、3G或Wifi网络等）3.手机可以没有SIM卡，但是可能导致部分功能缺失4.手机可以不挂载SD卡，但会使部分功能无法正常工作。推送服务框架个信SDK个信服务端第三方服务端第三方客户端客户端整合发布维护UID,ClientID映射表UID为第三方系统内的用户ID3.将UID,ClientID保存到Server1.SDK初始化2.返回ClientID4.推送消息payload指定CID进行推送5.查找到相应的设备，推送消息6.消息通知，将payload传递给客户端说明：Appkey：预先分配的第三方应用ID。AppSecret：认证密钥，预先协商后登记到双方服务端。ClientID：用于标识客户端身份，由第三方客户端获取并保存到第三方服务端。payload：透明数据（对用户透明），支持二进制格式（不支持转义字符），数据大小不超过2k。个信系统不对消息内容进行解释，只负责将数据透传至第三方客户端。个信互动（北京）网络科技有限公司[普通]4/22开发准备1.注册账号并登记应用（必须）[1]访问个推开放平台（），点击“免费注册”注册个推账户[2]按要求填入用户名、邮箱等基本信息，注册并激活账户[3]登录个推平台，按照提示登记应用，输入应用相关信息，点击“保存”创建您的应用（应用标识请务必填写正确，如Android的标识为工程的packagename，通常以com开始）2.获取SDK开发工具包（必须）在网站下载开发工具包，包含客户端和服务端两部分：（下载地址：）客户端包含：个信互动（北京）网络科技有限公司[普通]5/22•文档（手把手教你在Android上嵌入SDK）•需导入的资源（包含GexinSdk.jar和IncrementSDK.jar包、armeabi\libincrement.so文件、layout文件夹等，您的应用需导入该jar库用于和SDK通信）•演示工程源码•真机测试包服务端包含：•文档（服务端API文档，详细指导如何调用接口）•需导入的资源•php演示工程集成SDK（必须）在Eclipse中打开您应用所在工程，并按照如下步骤集成1.将工具包中“个推Android平台SDK接入/客户端/需导入的资源”目录下的GexinSdk.jar、IncrementSDK.jar以及armeabi文件夹(包含libincrement.so文件)复制到工程根目录下的libs文件夹中（若没有libs目录，则选中工程右键“New”-Folder-命名为“libs”）2.右键单击工程，选择BuildPath中的ConfigureBuildPath...，选中Libraries，并通过AddJars...导入工程libs目录下的GexinSdk.jar和IncrementSDK.jar文件（最新的ADT工具会自动导入libs目录下的jar包，故该步骤可以省略）3.在您应用程序主Activity里导入MessageManager如下所示：importcom.igexin.slavesdk.MessageManager;然后在您应用程序启动初始化阶段，初始化SDK：MessageManager.getInstance().initialize(this.getApplicationContext());该方法必须在Activity或Service类内调用。一般情况下，可以在Activity的onCreate()方法中调用。不建议在Application继承类中调用。为保证意外情况导致初始化失败，建议应用程序每次启动时都调用一次该初始化接口。4.将app_download_notification.xml、notification.xml、increment_popup_dialog.xml和notification_inc.xml（