Android：应用宝省流量更新
应用宝省流量更新介绍
应用宝省流量更新（SDK），是应用宝提供给开发者轻松实现应用省流量更新的功能，可以帮助开发者缩短更新过程，提高应用下载量。在每次应用升级更新时，只需更新部分数据而无需下载完整大小的安装包，帮用户节省了流量，也大大提高了产品升级速度。
注册开发者
进入腾讯开放平台
点击
移动应用，进入登录界面
使用QQ号码登录或注册新账号，登录后进入注册开发者界面，可选择注册为个人或公司开发者
创建应用
注册成功后，进入管理中心，点击
创建应用
填写应用信息，提交审核
实现省流量更新
邮件申请渠道号
添加引用TMAssistantSDK_selfUpdate_201407240950
修改AndroidManifest.xml
- 添加服务
<service android:name="com.tencent.tmassistantsdk.downloadservice.TMAssistantDownloadSDKService" android:exported="false" android:process=":TMAssistantDownloadSDKService" > service>- 添加权限
<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" />添加检查更新代码
SoftwareUpgrade.java
软件升级管理对象
import android.content.Context; import android.content.DialogInterface; import android.content.Intent; import android.os.Handler; import android.os.Looper; import android.view.View; import com.tencent.tmassistantsdk.common.TMAssistantDownloadSDKTaskState; import com.tencent.tmassistantsdk.selfUpdateSDK.ITMSelfUpdateSDKListener; import com.tencent.tmassistantsdk.selfUpdateSDK.TMSelfUpdateSDK; import com.tencent.tmassistantsdk.selfUpdateSDK.TMSelfUpdateSDKUpdateInfo; import java.text.DecimalFormat; /** * 软件升级，利用应用宝的接口进行软件版本检查、软件升级 */ public class SoftwareUpgrade { private Context ctx = null; private static final String TAG = "SoftwareUpgrade"; /** * AppID，应用上线后获得 */ private static final long APP_ID = 0000000000; /** * 渠道ID，邮件申请省流量更新后获得 */ private static final String CHANNEL_ID = "0000000"; /** * 省流量更新SDK */ private TMSelfUpdateSDK sdk = null; /** * 线程操作对象 */ private Handler handler = null; /** * 是否需要提醒更新（自动检查更新时需要） */ private boolean isNeedNotify = false; /** * 软件更新的信息 */ private SoftwareUpdateInfo updateInfo = null; public static SoftwareUpdateInfo getUpdateInfo() { if (instance != null) { return instance.updateInfo; } return null; } /** * 更新提示对话框 */ private UpgradeDialog updateDialog = null; /** * 单例模式 */ private static SoftwareUpgrade instance = null; public static SoftwareUpgrade getInstance() { if (instance == null) { instance = new SoftwareUpgrade(); } if (instance.sdk == null) { // 初始化失败，无法使用自动更新功能 instance = null; } return instance; } /** * 初始化检查更新（软件启动时调用） */ private SoftwareUpgrade() { // 得到主线程的Looper实例 Looper looper = Looper.getMainLooper(); handler = new Handler(looper); try { sdk = TMSelfUpdateSDK.getInstance(); sdk.initTMSelfUpdateSDK(App.getInstance().getApplicationContext() , APP_ID, CHANNEL_ID, selfUpdateSDKListener); } catch (Exception ex) { sdk = null; LogUtil.d(TAG, "Init TMSelfUpdateSDK failed!"); } } /** * 释放（退出软件时调用） */ public static void release() { if (instance != null && instance.sdk != null) { instance.sdk.destroySelfUpdateSDK(instance.selfUpdateSDKListener); instance = null; } } /** * 检查软件是否需要更新（静默检查，不弹出提示对话框） */ public static void checkNeedUpdate() { if (instance != null && instance.sdk != null) { instance.isNeedNotify = false; instance.sdk.checkNeedUpdate(); } } /** * 检查软件是否需要更新（若有更新，则提醒用户更新） */ public static void checkNeedUpdateNeedNotify(Context context) { if (instance != null && instance.sdk != null) { instance.ctx = context; instance.isNeedNotify = true; instance.sdk.checkNeedUpdate(); } } /** * 开始省流量更新 * 1、弹出更新信息对话框，询问用户是否更新 * 2、若未安装应用宝，询问用户是否安装 * 3、跳转到应用宝更新软件 * @param ctx */ public static void startSaveUpdate(final Context ctx) { if (instance != null && instance.sdk != null) { instance.updateDialog = new UpgradeDialog(ctx); instance.updateDialog.setVersion(instance.updateInfo.newVersion); instance.updateDialog.setUpdateContent(instance.updateInfo.updateContent); instance.updateDialog.setUpdateSize(instance.updateInfo.updateSize); instance.updateDialog.setUpdateButtonOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { try { // 检查应用宝是否安装 int yybInstalled = instance.sdk.checkYYBInstalled(); if (yybInstalled == TMAssistantDownloadSDKTaskState.UN_INSTALLED) { // 未安装应用宝，提示用户需要安装应用宝 DialogUtil.showWarnDialog(ctx, R.string.msg_no_yyb, new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { instance.sdk.startSaveUpdate(ctx); } }); } else { // 打开应用宝更新 instance.sdk.startSaveUpdate(ctx); instance.updateDialog.dismiss(); } } catch (Exception e) { LogUtil.e(e); } } }); } } /** * 省流量更新调用 * 应用宝已经下载安装完毕，回到调用方的页面，调用方可以选择是否调用该方法，call起应用宝下载管理页去更新 */ public static void onResume() { if (instance != null && instance.sdk != null) { instance.sdk.onResume(App.getInstance().getApplicationContext()); } } private ITMSelfUpdateSDKListener selfUpdateSDKListener = new ITMSelfUpdateSDKListener() { /** * 使用sdk自更新前，调用方法checkNeedUpdate检查是否需要更新时回调 * 如果有更新包，则返回新包大小、增量包大小 * @param tmSelfUpdateSDKUpdateInfo 这个参数，当继续往下走，下载 完成时，要传回来给接口 */ @Override public void OnCheckNeedUpdateInfo(final TMSelfUpdateSDKUpdateInfo tmSelfUpdateSDKUpdateInfo) { updateInfo = new SoftwareUpdateInfo(); if (tmSelfUpdateSDKUpdateInfo != null && tmSelfUpdateSDKUpdateInfo.getStatus() == TMSelfUpdateSDKUpdateInfo.STATUS_OK && tmSelfUpdateSDKUpdateInfo.getNewApkSize() > 0) { // 解析版本号 String url = tmSelfUpdateSDKUpdateInfo.getUpdateDownloadUrl(); String version = ""; if (url != null && url.length() > 0) { String[] temp = url.split("_"); if (temp.length > 2) { version = temp[1]; } } updateInfo.hasNewVersion = true; updateInfo.newVersion = version; updateInfo.updateContent = tmSelfUpdateSDKUpdateInfo.getNewFeature(); updateInfo.updateSize = getDataSize(tmSelfUpdateSDKUpdateInfo.getNewApkSize()); } if (isNeedNotify) { // 如果需要更新，则跳转到关于界面 if (updateInfo.hasNewVersion) { DialogUtil.showWarnDialog(ctx, R.string.msg_has_new_version, new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { // 跳转到关于界面进行更新 MainActivity mainActivity = (MainActivity) ctx; if (mainActivity != null) { mainActivity.startActivity(new Intent(mainActivity, AboutActivity.class)); } } }); } else { App.getInstance().toast(R.string.msg_current_lastest_version_software); } } } /** * 省流量更新时回调 * 检查应用宝状态，若未安装，则开始自动安装 * @param url 指定任务的url * @param state 下载状态 * @param errorCode 错误码 * @param errorMsg 错误描述 */ @Override public void OnDownloadYYBStateChanged(String url, final int state,int errorCode, String errorMsg) { handler.post(new Runnable() { @Override public void run() { switch (state) { case TMAssistantDownloadSDKTaskState.DownloadSDKTaskState_WAITING: if (updateDialog != null) { updateDialog.startProgress(); updateDialog.setProgressText(R.string.msg_waiting_install_yyb); } break; case TMAssistantDownloadSDKTaskState.DownloadSDKTaskState_DOWNLOADING: // 下方提供进度更新显示，此处不需要 // if (updateDialog != null) { // updateDialog.setProgressText("正在下载应用宝"); // } break; case TMAssistantDownloadSDKTaskState.DownloadSDKTaskState_PAUSED: // if (updateDialog != null) { // updateDialog.setProgressText("应用宝下载暂停"); // } break; case TMAssistantDownloadSDKTaskState.DownloadSDKTaskState_SUCCEED: if (updateDialog != null) { updateDialog.setProgressText(R.string.msg_download_yyb_success); updateDialog.dismiss(); } break; case TMAssistantDownloadSDKTaskState.DownloadSDKTaskState_FAILED: if (updateDialog != null) { updateDialog.dismiss(); App.getInstance().toast(R.string.msg_download_yyb_failed); } break; default: // App.getInstance().toast(state); break; } } }); } /** * 省流量更新时回调 * 下载应用宝的进度 * @param url 指定任务的url * @param receiveDataLen 已经接收的数据长度 * @param totalDataLen 全部需要接收的数据长度（如果无法获取目标文件的总长度，此参数返回-1） */ @Override public void OnDownloadYYBProgressChanged(final String url,final long receiveDataLen, final long totalDataLen) { handler.post(new Runnable() { @Override public void run() { if (updateDialog != null) { updateDialog.setProgress((int) (receiveDataLen * 100 / (double) totalDataLen)); updateDialog.setProgressText( getDataSize(receiveDataLen) + " / " + getDataSize(totalDataLen)); } } }); } }; /** * 计算数据大小，将bit转换为k或M的单位输出 * @param dataSize * @return */ private String getDataSize(long dataSize) { long kb = dataSize / 1024; // 单位k if (kb < 1024) { return kb + "k"; } double mb = dataSize / 1024.0 / 1024.0 + 0.05; // 转换为M，保留一位小数，四舍五入 return new DecimalFormat(".0").format(mb) + "M"; } /** * 软件更新信息 */ public class SoftwareUpdateInfo { /** * 是否有新版本 */ public boolean hasNewVersion = false; /** * 新版本号 */ public String newVersion = ""; /** * 更新内容 */ public String updateContent = ""; /** * 更新大小 */ public String updateSize = ""; } }UpgradeDialog.java
软件升级信息对话框
import android.app.AlertDialog; import android.content.Context; import android.support.annotation.StringRes; import android.view.LayoutInflater; import android.view.View; import android.widget.Button; import android.widget.LinearLayout; import android.widget.ProgressBar; import android.widget.TextView; public class UpgradeDialog { private Context ctx = null; private AlertDialog dialog = null; private TextView tvVersion = null; private TextView tvUpdateContent = null; private LinearLayout layoutUpdateButton = null; private Button btnNotUpdate = null; private Button btnUpdate = null; private LinearLayout layoutUpdateProgress = null; private ProgressBar progressBar = null; private TextView tvUpdateProgress = null; public UpgradeDialog(Context context) { ctx = context; LayoutInflater layoutInflater = LayoutInflater.from(ctx); View view = layoutInflater.inflate(R.layout.dialog_notify_update, null); if (view != null) { tvVersion = (TextView) view.findViewById(R.id.tv_version); tvUpdateContent = (TextView) view.findViewById(R.id.tv_update_content); layoutUpdateButton = (LinearLayout) view.findViewById(R.id.layout_update_button); btnNotUpdate = (Button) view.findViewById(R.id.btn_not_update); btnUpdate = (Button) view.findViewById(R.id.btn_update); layoutUpdateProgress = (LinearLayout) view.findViewById(R.id.layout_update_progress); progressBar = (ProgressBar) view.findViewById(R.id.progressBar); tvUpdateProgress = (TextView) view.findViewById(R.id.tv_update_progress); AlertDialog.Builder builder = new AlertDialog.Builder(ctx); builder.setTitle(R.string.layout_update_software_notify); builder.setView(view); dialog = builder.create(); dialog.setCancelable(false); dialog.show(); btnNotUpdate.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { dialog.dismiss(); } }); progressBar.setMax(100); } } public void setVersion(String version) { if (tvVersion != null) { tvVersion.setText(version); } } public void setUpdateContent(String updateContent) { if (tvUpdateContent != null) { tvUpdateContent.setText(updateContent); } } public void setUpdateSize(String newApkSize) { if (btnUpdate != null) { btnUpdate.setText(ctx.getString(R.string.layout_update_software_update_now, newApkSize)); } } public void setUpdateButtonOnClickListener(View.OnClickListener listener) { if (btnUpdate != null) { btnUpdate.setOnClickListener(listener); } } public void dismiss() { if (dialog != null && dialog.isShowing()) { dialog.dismiss(); } } public void setProgress(int value) { if (progressBar != null) { progressBar.setProgress(value); } } public void setProgressText(@StringRes int progress) { if (tvUpdateProgress != null) { tvUpdateProgress.setText(progress); } } public void setProgressText(String progress) { if (tvUpdateProgress != null) { tvUpdateProgress.setText(progress); } } public void startProgress() { if (layoutUpdateProgress != null) { layoutUpdateProgress.setVisibility(View.VISIBLE); } if (progressBar != null) { progressBar.setProgress(0); } if (layoutUpdateButton != null) { layoutUpdateButton.setVisibility(View.GONE); } } }dialog_notify_update.xml
软件升级提示界面
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="vertical" android:layout_width="wrap_content" android:layout_height="wrap_content" android:padding="@dimen/app_content_border_size" android:layout_gravity="center"> <LinearLayout android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="horizontal" android:gravity="center_horizontal"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/layout_update_software_update_content" android:textColor="@color/app_title_textColor" android:textSize="@dimen/app_content_textSize" android:textStyle="bold"/> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_marginLeft="@dimen/app_space_size" android:textColor="@color/app_title_textColor" android:textSize="@dimen/app_content_textSize" android:textStyle="bold" android:id="@+id/tv_version"/> LinearLayout> <ScrollView android:layout_width="match_parent" android:layout_height="0dp" android:layout_weight="1" android:layout_marginTop="@dimen/app_content_border_size" android:minWidth="@dimen/software_upgrade_scrollbar_min_width" android:minHeight="@dimen/software_upgrade_scrollbar_min_height" android:scrollbars="vertical"> <TextView android:layout_width="match_parent" android:layout_height="match_parent" android:textColor="@color/app_title_textColor" android:id="@+id/tv_update_content"/> ScrollView> <LinearLayout android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="vertical" android:layout_marginTop="@dimen/app_content_border_size" android:visibility="gone" android:id="@+id/layout_update_progress"> <ProgressBar style="?android:attr/progressBarStyleHorizontal" android:layout_width="match_parent" android:layout_height="wrap_content" android:id="@+id/progressBar" /> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_gravity="center_horizontal" android:layout_marginTop="@dimen/app_space_size" android:textColor="@color/app_title_textColor" android:id="@+id/tv_update_progress"/> LinearLayout> <LinearLayout android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="horizontal" android:layout_marginTop="@dimen/app_content_border_size" android:id="@+id/layout_update_button"> <Button android:layout_width="0dp" android:layout_height="wrap_content" android:layout_weight="1" android:text="@string/layout_update_software_not_update" android:id="@+id/btn_not_update"/> <Button android:layout_width="0dp" android:layout_height="wrap_content" android:layout_weight="1" android:text="@string/layout_update_software_update_now" android:id="@+id/btn_update"/> LinearLayout> LinearLayout>MainActivity.xml
主界面中初始化和释放软件升级管理对象
public class MainActivity extends FragmentActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mainView = LayoutInflater.from(this).inflate(R.layout.activity_main, null); setContentView(mainView); // 初始化软件更新对象 SoftwareUpgrade softwareUpgrade = SoftwareUpgrade.getInstance(); if (softwareUpgrade == null) { app.setCanAutoUpdate(false); // 公共变量，用于标识自动更新对象是否初始化成功，若不成功，则屏蔽相关功能 app.toast(R.string.msg_init_auto_update_software_failed); } else { app.setCanAutoUpdate(true); // 检查软件更新 if (app.isAutoCheckSoftwareUpdate()) { // 是否开启自动检查更新功能 SoftwareUpgrade.checkNeedUpdateNeedNotify(this); // 弹框提醒更新 } else { SoftwareUpgrade.checkNeedUpdate(); // 不弹框提醒 } } } @Override protected void onDestroy() { // 释放软件更新对象 SoftwareUpgrade.release(); super.onDestroy(); } }SoftwareSetupFragment.java
软件设置界面，包含“自动检查更新”开关配置，关于。
public class SoftwareSetupFragment extends BaseFragment { @Bind(R.id.btn_auto_check_software_update) ButtonSettingLayout btnAutoCheckSoftwareUpdate; @Bind(R.id.btn_about) ButtonSettingLayout btnAbout; @Override protected int getContentLayoutId() { return R.layout.fragment_software_setup; } /** * 自动检查更新的配置key */ public static final String PREF_AUTO_CHECK_SOFTWARE_UPDATE = "auto_check_software_update"; @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { View rootView = super.onCreateView(inflater, container, savedInstanceState); initialize(rootView); return rootView; } @Override protected void initialize(View rootView) { ButterKnife.bind(this, rootView); // 自动检查软件更新 btnAutoCheckSoftwareUpdate.setVisibility(app.isCanAutoUpdate() ? View.VISIBLE : View.GONE); btnAutoCheckSoftwareUpdate.setChecked(app.isAutoCheckSoftwareUpdate()); btnAutoCheckSoftwareUpdate.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() { @Override public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { prefs.edit().putBoolean(PREF_AUTO_CHECK_SOFTWARE_UPDATE, isChecked).commit(); app.setAutoCheckSoftwareUpdate(isChecked); } }); // 关于 if (SoftwareUpgrade.getUpdateInfo() != null && SoftwareUpgrade.getUpdateInfo().hasNewVersion) { btnAbout.setIconColor(Color.RED); } btnAbout.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { parent.startActivityFromFragment(SoftwareSetupFragment.this, new Intent(getActivity(), AboutActivity.class), 0); } }); } @Override protected void release() { ButterKnife.unbind(this); } }AboutActivity.java
关于界面，提供软件升级功能
public class AboutActivity extends BaseActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); btnCheckUpdate.setVisibility(app.isCanAutoUpdate() ? View.VISIBLE : View.GONE); if (SoftwareUpgrade.getUpdateInfo() != null) { if (SoftwareUpgrade.getUpdateInfo().hasNewVersion) { btnCheckUpdate.setText(getString( R.string.layout_update_software_update_now, SoftwareUpgrade.getUpdateInfo().newVersion)); btnCheckUpdate.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { SoftwareUpgrade.startSaveUpdate(AboutActivity.this); } }); } else { btnCheckUpdate.setText(R.string.msg_current_lastest_version_software); } } } @Override protected void onResume() { super.onResume(); SoftwareUpgrade.onResume(); } }- strings.xml
<string name="msg_init_auto_update_software_failed">初始化自动更新功能失败！string> <string name="msg_current_lastest_version_software">当前为最新版本string> <string name="layout_update_software_update_now">更新(%1$s)string> <string name="layout_update_software_notify">软件升级提醒string> <string name="layout_update_software_update_content">新版特性string> <string name="layout_update_software_not_update">暂不更新string> <string name="msg_no_yyb">未安装应用宝，将开始安装应用宝！string> <string name="msg_has_new_version">软件有新版本，是否更新？string> <string name="msg_waiting_install_yyb">等待安装应用宝string> <string name="msg_download_yyb_success">应用宝下载成功，开始安装应用宝string> <string name="msg_download_yyb_failed">下载应用宝失败，请检查网络连接string>
接入省流量更新（获取官方介绍）
进入应用
点击基础服务中的
更多，可进入省流量更新
省流量更新页面中，点击
查看详情，进入省流量更新详情页
