腾讯应用宝自更新SDK使用指南

应用宝自更新sdk使用指南平台产品中心2017年2月10日目录1. 创建您的应用12. 下载该SDK的zip包13. 搭建开发环境1 3.1.在Eclipse中建立你的工程 (1)3.2.添加jar包并编译 (1)3.3.AndroidManifest.xml 设置 (2)4. 使用自更新功能2 4.1.初始化Manager (3)4.2.实现自更新状态监听器和应用宝下载状态监听器 (3)4.3.开始自更新 (5)4.4.释放资源 (5)4.5.只检查更新信息 (6)4.5.更新接口使用示例 (6)5. 更多功能8 5.1.检查应用宝是否存在 (8)5.2.取消应用宝下载 (9)5.3.检查应用宝是否已经下载完成 (9)5.4.开始预下载应用宝 (9)注：本文为Android平台的新手使用教程，只涉及教授SDK的使用方法，默认读者已经熟悉IDE 的基本使用方法（本文以Eclipse为例），以及具有一定的编程知识基础等。

1.创建您的应用请到开发者页面创建应用，并获取平台分配的appid。

如已有相同包名的应用，则直接在管理页面进行应用认领操作。

2.下载该SDK的zip包请到产品介绍页下载应用宝第三方调用SDK的zip包，该开发工具包主要包含4部分内容：1)API文档（供开发者查阅）2)Demo（供开发者参考）3)Jar包（包含所有的API功能接口）4)使用指南（供开发者快速接入）3.搭建开发环境3.1.在Eclipse中建立你的工程3.2.添加jar包并编译在工程中新建一个libs目录（如不存在），并将zip中的tmassistantsdk_selfupdate*.jar包copy 到你的工程libs目录下面右击工程，并选择buildPath，选择该jar并add to build Path：注意：如果eclipse安装应用到手机的时候报如下的错误NoClassDefFoundError（protocol.jce.*）：ng.NoClassDefFoundError: com.tencent.tmassistantsdk.internal.protocol.jce.StatStdReport说明接入的宿主应用没有压缩包中的jce.jar包，请把jce这个jar包添加到工程libs下面。

3.3.AndroidManifest.xml 设置添加必要的权限支持：<uses-permission android:name="android.permission.INTERNET"/><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permission android:name="android.permission.READ_PHONE_STATE"/><uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>还需要声明下载过程中会用到的serivce：<service android:name="com.tencent.tmdownloader.TMAssistantDownloadService"android:exported="false"android:process=":TMAssistantDownloadSDKService" />4.自更新功能接口介绍我们为调用方提供了两种自更新方式可供选择：1)跳转到应用宝中进行自更新，如果用户没安装应用宝，则会先自动下载并安装应用宝，安装完成后再跳转到应用宝进行自更新。

应用宝提供了强大的下载和管理功能，可以快速便捷地帮助用户下载更新包。

2)直接使用SDK进行自更新，仅提供简单的自更新逻辑，不提供自更新任务的管理等功能，如下载过程中的暂停，取消，重新开始等。

3)资源包更新（直接在应用中更新），提供资源包更新的目录，4.1.初始化Manager自更新的功能主要通过调用TMSelfUpdateManager中的接口实现。

使用自更新SDK前，必须对其进行初始化。

可以参考以下初始化的代码：// 自更新sdk初始化TMSelfUpdateManager selfUpdateManager = TMSelfUpdateManager.getInstance();try {Context context = getApplication();//application的contextString channelid = "990483"; //应用宝渠道包的渠道号，申请方法请参见《腾讯应用宝自更新SDK产品介绍》中的产品接入步骤step1ITMSelfUpdateListener selfupdateListener = new ITMSelfUpdateListener(){//实现请参考下一小节实现自更新状态监听器部分的内容};//自更新状态监听器YYBDownloadListener yybDownloadListener = new YYBDownloadListener() {//实现请参考下一小节实现应用宝下载状态监听器部分的内容};//应用宝下载状态监听器Bundle bundle = null;//附加参数的bundle，一般情况下传空，可以由外部传入场景信息等，具体字段可参考TMSelfUpdateConst. BUNDLE_KEY_* 的定义selfUpdateManager.init(context, channelid, selfupdateListener, yybDownloadListener, bundle);} catch (Exception e) {e.printStackTrace();}4.2.实现自更新状态监听器和应用宝下载状态监听器自更新状态监听器（ITMSelfUpdateListener），是用于监听当前更新包的下载状态变化的回调接口。

应用宝下载状态监听（YYBDownloadListener），是用于监听应用宝的下载状态变化的回调接口，只在跳应用宝进行自更新的时候才会被使用。

这两个监听器在初始化Manager中已经作为参数传入进行注册，需要开发者在回调方法中实现自定义的业务逻辑。

1)实现自更新状态监听器ITMSelfUpdateListener：private ITMSelfUpdateListener selfupdateListener = new ITMSelfUpdateListener() { @Overridepublic void onDownloadAppStateChanged(final int state, final int errorCode, final String errorMsg) {//TODO 更新包下载状态变化的处理逻辑}@Overridepublic void onUpdateInfoReceived(TMSelfUpdateUpdateInfo arg0) {//TODO 收到更新信息的处理逻辑}@Overridepublic void onDownloadAppProgressChanged(final long arg0, final long arg1){ //TODO 更新包下载进度发生变化的处理逻辑}};2)实现应用宝下载状态监听器YYBDownloadListener：private YYBDownloadListener yybDownloadListener = new YYBDownloadListener() { @Overridepublic void onDownloadYYBStateChanged(String url, final int state, int errorCode, String errorMsg) {//TODO 应用宝下载状态变化的处理逻辑}@Overridepublic void onDownloadYYBProgressChanged(final String url, final long receiveDataLen, final long totalDataLen) {//TODO 应用宝下载进度变化的处理逻辑}};4.3.开始自更新调用开始自更新接口即可开始自更新：selfUpdateManager.startSelfUpdate(isUseYYB);其传入的参数说明如下：(1)isUseYYB为true时，使用省流量更新，跳应用宝进行自更新，在应用宝已安装的情况下，会call起调用方app的应用宝详情页，让用户下载更新；在应用宝未安装的情况下，会下载最新的应用宝，必须在Activity的onResume()方法中调用onActivityResume()方法，安装完成应用宝后才会继续call起调用方app的应用宝详情页，让用户下载更新：@Overrideprotected void onResume() {super.onResume();try {selfUpdateManager.onActivityResume();} catch (Throwable e) {e.printStackTrace();}}(2)isUseYYB为false时，无需下载应用宝，使用sdk一条龙服务进行普通更新，包含检查更新、Apk的下载、合成等。

不需要调用onActivityResume()方法。

4.4.释放资源在TMSelfUpdateManager中提供了destroy( )接口进行资源清理，包括移除已经注册过的监听器。

所以在不再使用自更新功能时建议主动调用destroy( )释放资源，例如在调用方的Activity的OnDestroy()中释放资源：@Overrideprotected void onDestroy() {super.onDestroy();selfUpdateManager.destroy();}4.5.只检查更新信息在TMSelfUpdateManager中提供了checkSelfUpdate接口来检查更新信息，更新信息异步回调到ITMSelfUpdateListener中，在onUpdateInfoReceived方法中接受相关的信息。