【Android】Android程序自己主动更新
App自己主动更新的步骤可分为三步:
- 检查更新(假设有更新进行第2步,否则返回)
- 下载新版的APK安装包
- 安装APK
以下对这三步进行解释。当中会穿插相应代码。App自己主动更新的这三步所有被封装到了一个单独的Updater类中,能够直接拿来使用,我会在文章最后贴出源代码github地址。
Updater 使用演示样例
通过单一的类Updater
能够方便的实现自己主动检查更新、下载安装包和自己主动安装。能够监听下载进度,能够自己定义更新提示等。保存路径能够自由书写,假设路径中某个文件夹不存在会自己主动创建。流式API接口易于使用。以下是使用演示样例。一行代码搞定自己主动更新:
String savePath = Environment.getExternalStorageDirectory()
+ "/whinc/download/whinc.apk";
String updateUrl = "http://192.168.1.168:8000/update.xml";
Updater.with(mContext)
.downloadListener(mListener)
.update(updateUrl)
.save(savePath)
.create()
.checkUpdate();
第一步:检查更新
这一步须要服务端的配合。服务端存放一个XML格式的配置文件(也能够用JSON或其它格式)提供给client检查更新。update.xml 格式例如以下:
<?xml version="1.0" encoding="utf-8"?>
<info>
<version>
<code>4</code>
<name>1.0.4</name>
</version>
<url>http://192.168.1.168:8000/test.apk</url>
<description>更新 - 吧啦吧啦;修复 - 吧啦吧啦;添加 - 巴拉巴拉巴</description>
</info>
<version>
标签指定服务端的版本号号和版本号名称,该版本号号和版本号名称相应Android项目配置里的versionCode
和versionName
(Eclipse ADT项目可在 AndroidManifest.xml中的标签中找到。Android Studio项目在module的build.gradle中的defaultConfig中找到)。<url>
标签指定APK的下载地址,<description>
标签指定更新内容。
client通过 HTTP 请求服务端的 update.xml文件。然后解析 update.xml,比較服务端的版本号号与本地版本号号,假设服务端版本号号大于本地版本号号说明有更新,则依据 update.xml中指定的APK下载地址下载最新的APK,以下将会具体说明。
以下是检查更新的代码:
/**
* 检查 App 版本号号
*
* @return 假设有新版本号返回true。否则返回false
*/
private boolean checkVersion() {
URL url;
HttpURLConnection httpConn = null;
try {
url = new URL(mCheckUpdateUrl);
httpConn = (HttpURLConnection) url.openConnection();
httpConn.setConnectTimeout(200000);
httpConn.setReadTimeout(200000);
httpConn.setUseCaches(false); // disable cache for current http connection
httpConn.connect();
if (httpConn.getResponseCode() == HttpURLConnection.HTTP_OK) {
InputStream inputStream = httpConn.getInputStream();
// 解析 XML 数据
if (!parseXml(inputStream)) {
return false;
}
// 比較本地版本号号与服务器版本号号
PackageInfo packageInfo = mContext.getPackageManager()
.getPackageInfo(mContext.getPackageName(), 0);
if (packageInfo.versionCode < mRemoteVersionCode) {
return true;
}
} else {
return false;
}
} catch (MalformedURLException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} catch (PackageManager.NameNotFoundException e) {
e.printStackTrace();
} finally {
httpConn.disconnect();
}
return false;
}
首先创建HTTPURLConnection訪问服务端update.xml文件,然后解析服务端返回的update.xml文件,并保存版本号信息、APK下载地址和更新日志。解析完后通过获取当前client的版本号号与服务端版本号号比較。假设服务端版本号号更大,说明服务端有更新的版本号。checkVersion() 方法返回true,否则返回false。
以下时检查更新的代码。须要注意的是。Android中不同意在主线程(UI线程)中发起网络请求,所以checkVersion()
的调用须要放在非主线程中。实现异步请求的方式有多种,这里我使用 AsyncTask。
public void checkUpdate() {
new AsyncTask<Void, Void, Boolean>() {
@Override
protected Boolean doInBackground(Void... params) {
boolean hasNewVersion = checkVersion();
return hasNewVersion;
}
@Override
protected void onPostExecute(Boolean hasNewVersion) {
super.onPostExecute(hasNewVersion);
if (mCheckUpdateListener == null
|| !mCheckUpdateListener.onCompleted(hasNewVersion, mRemoteVersionCode,
mRemoteVersionName, mUpdateLog, mApkDownloadUrl)) {
if (hasNewVersion) {
showUpdateDialog();
}
}
}
}.execute();
}
下载新版的APK安装包
showUpdateDialog()
调用后显示更新提示对话框,在对话框确认button点击事件中,首先创建DownloadManager.Request对象,然后设置该对象的各种属性例如以下载保存路径、通知栏标题等,最后将该下载请求放到系统服务DownloadManager的下载队列中。交给系统去处理下载逻辑。 为了监听下载完毕事件,代码里注冊了广播DownloadManager.ACTION_DOWNLOAD_COMPLETE
。下载进度通过注冊ContentObserver来监听。
/**
* 显示更新对话框
*/
private void showUpdateDialog() {
AlertDialog.Builder builder = new AlertDialog.Builder(mContext);
builder.setTitle(mTitle);
builder.setMessage(mUpdateLog);
builder.setPositiveButton(mDialogOkBtnTxt, new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.dismiss();
// 后台下载
mDownloadMgr = (DownloadManager) mContext.getSystemService(Context.DOWNLOAD_SERVICE);
DownloadManager.Request request = new DownloadManager.Request(Uri.parse(mApkDownloadUrl));
if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
// 假设保存路径包括子文件夹,须要先递归创建文件夹
if (!createDirIfAbsent(mSavePath)) {
Log.e("TAG", "apk save path can not be created:" + mSavePath);
return;
}
request.setDestinationUri(Uri.fromFile(new File(mSavePath)));
request.setTitle(mNotificationTitle);
request.setTitle(mNotificationMessage);
// 注冊广播,监听下载完毕事件
mContext.registerReceiver(mCompleteReceiver,
new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
// 注冊监听下载进度
mContext.getContentResolver().registerContentObserver(Uri.parse("content://downloads/my_downloads"),
true, mContentObserver);
mDownloadId = mDownloadMgr.enqueue(request);
} else {
Log.e("TAG", "can not access external storage!");
return;
}
Toast.makeText(mContext, "正在后台下载...", Toast.LENGTH_SHORT).show();
}
});
builder.setNegativeButton(mDialogCancelBtnTxt, new DialogInterface.OnClickListener() {
@Override
public void onClick(DialogInterface dialog, int which) {
dialog.cancel();
}
});
builder.create().show();
}
/**
* 假设參数 path 指定的路径中的文件夹不存在就创建指定文件夹
*
* @param path 绝对路径(包括文件名称,比如 '/sdcard/storage/download/test.apk')
* @return 假设成功创建文件夹返回true,否则返回false
*/
private boolean createDirIfAbsent(String path) {
String[] array = path.trim().split(File.separator);
List<String> dirNames = Arrays.asList(array).subList(1, array.length - 1);
StringBuilder pathBuilder = new StringBuilder(File.separator);
for (String d : dirNames) {
pathBuilder.append(d);
File f = new File(pathBuilder.toString());
if (!f.exists() && !f.mkdir()) {
return false;
}
pathBuilder.append(File.separator);
}
return true;
}
安装APK
一旦Apk下载完毕就会收到广播消息,此时能够运行安装APK的动作,只是要先通过下载Id推断该广播事件是否是由于我们的APK下载完毕发出的,由于系统可能同一时候有多个下载任务,通过下载id区分。
mCompleteReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
if (downloadId == mDownloadId) {
installApk();
release();
}
}
};
以下是 installApk() 方法,首先通过下载Id从DownloadManager中检索到下载的APK存储路径,然后通过Intent安装下载的APK,代码很easy。注意,Intent设置标识为Intent.FLAG_ACTIVITY_NEW_TASK
。否则不能正常启动安装程序。
/**
* 替换安装当前App。注意:签名一致
*/
private void installApk() {
// 获取下载的 APK 地址
Uri apkUri = mDownloadMgr.getUriForDownloadedFile(mDownloadId);
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.setDataAndType(apkUri, "application/vnd.android.package-archive");
mContext.startActivity(intent);
}
github 源代码
比較好的參考资料:
DownloadManager | Android Developers
Android系统下载管理DownloadManager功能介绍及使用演示样例
posted on 2017-06-24 14:21 gavanwanggw 阅读(423) 评论(0) 编辑 收藏 举报