Android学习系列(2)--App自动更新之通知栏下载
见证过博客园的多次升级，你也希望你的软件通过更新发布新特性通知用户吧，是的。
这篇文章是android开发人员的必备知识，是我特别为大家整理和总结的，不求完美，但是有用。
1.设计思路，使用VersionCode定义为版本升级参数。
android为我们定义版本提供了2个属性：
|
1
2
3
4
|
<manifest package="com.cnblogs.tianxia.subway" android:versionCode="1" <!--Integer类型，系统不显示给用户--> android:versionName="1.0"<!--String类型，系统显示用户-->></manifest> |
谷歌建议我们使用versionCode自增来表明版本升级，无论是大的改动还是小的改动，而versionName是显示用户看的软件版本，作为显示使用。所以我们选择了VersionCode作为我们定义版本升级的参数。
2.工程目录
为了对真实项目或者企业运用有实战指导作用，我模拟一个独立的项目，工程目录设置的合理严谨一些，而不是仅仅一个demo。
假设我们以上海地铁为项目，命名为"Subway",工程结构如下,
3.版本初始化和版本号的对比。
首先定义在全局文件Global.java中定义变量localVersion和serverVersion分别存放本地版本号和服务器版本号。
|
1
2
3
4
5
6
|
public class Global { //版本信息 public static int localVersion = 0; public static int serverVersion = 0; public static String downloadDir = "app/download/";} |
因为本文只是重点说明升级更新,为了防止其他太多无关代码冗余其中，我直接在SubwayApplication中定义方法initGlobal()方法。
|
1
2
3
4
5
6
7
8
9
10
11
12
|
/** * 初始化全局变量 * 实际工作中这个方法中serverVersion从服务器端获取，最好在启动画面的activity中执行 */public void initGlobal(){ try{ Global.localVersion = getPackageManager().getPackageInfo(getPackageName(),0).versionCode; //设置本地版本号 Global.serverVersion = 1;//假定服务器版本为2，本地版本默认是1 }catch (Exception ex){ ex.printStackTrace(); }} |
如果检测到新版本发布，提示用户是否更新，我在SubwayActivity中定义了checkVersion()方法:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
/** * 检查更新版本 */public void checkVersion(){ if(Global.localVersion < Global.serverVersion){ //发现新版本，提示用户更新 AlertDialog.Builder alert = new AlertDialog.Builder(this); alert.setTitle("软件升级") .setMessage("发现新版本,建议立即更新使用.") .setPositiveButton("更新", new DialogInterface.OnClickListener() { public void onClick(DialogInterface dialog, int which) { //开启更新服务UpdateService //这里为了把update更好模块化，可以传一些updateService依赖的值 //如布局ID，资源ID，动态获取的标题,这里以app_name为例 Intent updateIntent =new Intent(SubwayActivity.this, UpdateService.class); updateIntent.putExtra("titleId",R.string.app_name); startService(updateIntent); } }) .setNegativeButton("取消",new DialogInterface.OnClickListener(){ public void onClick(DialogInterface dialog, int which) { dialog.dismiss(); } }); alert.create().show(); }else{ //清理工作，略去 //cheanUpdateFile(),文章后面我会附上代码 }} |
如下图:
好，我们现在把这些东西串一下：
第一步在SubwayApplication的onCreate()方法中执行initGlobal()初始化版本变量。
|
1
2
3
4
|
public void onCreate() { super.onCreate(); initGlobal();} |
第二步在SubwayActivity的onCreate()方法中检测版本更新checkVersion()。
|
1
2
3
4
5
|
public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); checkVersion();} |
现在入口已经打开，在checkVersion方法的第18行代码中看出，当用户点击更新，我们开启更新服务，从服务器上下载最新版本。
4.使用Service在后台从服务器端下载，完成后提示用户下载完成，并关闭服务。
定义一个服务UpdateService.java,首先定义与下载和通知相关的变量：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
//标题private int titleId = 0;//文件存储private File updateDir = null; private File updateFile = null;//通知栏private NotificationManager updateNotificationManager = null;private Notification updateNotification = null;//通知栏跳转Intentprivate Intent updateIntent = null;private PendingIntent updatePendingIntent = null; |
在onStartCommand()方法中准备相关的下载工作：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
@Overridepublic int onStartCommand(Intent intent, int flags, int startId) { //获取传值 titleId = intent.getIntExtra("titleId",0); //创建文件 if(android.os.Environment.MEDIA_MOUNTED.equals(android.os.Environment.getExternalStorageState())){ updateDir = new File(Environment.getExternalStorageDirectory(),Global.downloadDir); updateFile = new File(updateDir.getPath(),getResources().getString(titleId)+".apk"); } this.updateNotificationManager = (NotificationManager)getSystemService(NOTIFICATION_SERVICE); this.updateNotification = new Notification(); //设置下载过程中，点击通知栏，回到主界面 updateIntent = new Intent(this, SubwayActivity.class); updatePendingIntent = PendingIntent.getActivity(this,0,updateIntent,0); //设置通知栏显示内容 updateNotification.icon = R.drawable.arrow_down_float; updateNotification.tickerText = "开始下载"; updateNotification.setLatestEventInfo(this,"上海地铁","0%",updatePendingIntent); //发出通知 updateNotificationManager.notify(0,updateNotification); //开启一个新的线程下载，如果使用Service同步下载，会导致ANR问题，Service本身也会阻塞 new Thread(new updateRunnable()).start();//这个是下载的重点，是下载的过程 return super.onStartCommand(intent, flags, startId);} |
上面都是准备工作，如图：
从代码中可以看出来，updateRunnable类才是真正下载的类，出于用户体验的考虑，这个类是我们单独一个线程后台去执行的。
下载的过程有两个工作：1.从服务器上下载数据；2.通知用户下载的进度。
线程通知，我们先定义一个空的updateHandler。
|
1
2
3
4
5
6
|
private Handler updateHandler = new Handler(){ @Override public void handleMessage(Message msg) { }}; |
再来创建updateRunnable类的真正实现：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
class updateRunnable implements Runnable { Message message = updateHandler.obtainMessage(); public void run() { message.what = DOWNLOAD_COMPLETE; try{ //增加权限<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE">; if(!updateDir.exists()){ updateDir.mkdirs(); } if(!updateFile.exists()){ updateFile.createNewFile(); } //下载函数，以QQ为例子 //增加权限<uses-permission android:name="android.permission.INTERNET">; long downloadSize = downloadUpdateFile("http://softfile.3g.qq.com:8080/msoft/179/1105/10753/MobileQQ1.0(Android)_Build0198.apk",updateFile); if(downloadSize>0){ //下载成功 updateHandler.sendMessage(message); } }catch(Exception ex){ ex.printStackTrace(); message.what = DOWNLOAD_FAIL; //下载失败 updateHandler.sendMessage(message); } } }</uses-permission></uses-permission> |
下载函数的实现有很多，我这里把代码贴出来，而且我们要在下载的时候通知用户下载进度：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
public long downloadUpdateFile(String downloadUrl, File saveFile) throws Exception { //这样的下载代码很多，我就不做过多的说明 int downloadCount = 0; int currentSize = 0; long totalSize = 0; int updateTotalSize = 0; HttpURLConnection httpConnection = null; InputStream is = null; FileOutputStream fos = null; try { URL url = new URL(downloadUrl); httpConnection = (HttpURLConnection)url.openConnection(); httpConnection.setRequestProperty("User-Agent", "PacificHttpClient"); if(currentSize > 0) { httpConnection.setRequestProperty("RANGE", "bytes=" + currentSize + "-"); } httpConnection.setConnectTimeout(10000); httpConnection.setReadTimeout(20000); updateTotalSize = httpConnection.getContentLength(); if (httpConnection.getResponseCode() == 404) { throw new Exception("fail!"); } is = httpConnection.getInputStream(); fos = new FileOutputStream(saveFile, false); byte buffer[] = new byte[4096]; int readsize = 0; while((readsize = is.read(buffer)) > 0){ fos.write(buffer, 0, readsize); totalSize += readsize; //为了防止频繁的通知导致应用吃紧，百分比增加10才通知一次 if((downloadCount == 0)||(int) (totalSize*100/updateTotalSize)-10>downloadCount){ downloadCount += 10; updateNotification.setLatestEventInfo(UpdateService.this, "正在下载", (int)totalSize*100/updateTotalSize+"%", updatePendingIntent); updateNotificationManager.notify(0, updateNotification); } } } finally { if(httpConnection != null) { httpConnection.disconnect(); } if(is != null) { is.close(); } if(fos != null) { fos.close(); } } return totalSize; } |
显示下载进度，如图：
下载完成后，我们提示用户下载完成，并且可以点击安装，那么我们来补全前面的Handler吧。
先在UpdateService.java定义2个常量来表示下载状态：
|
1
2
3
|
//下载状态private final static int DOWNLOAD_COMPLETE = 0;private final static int DOWNLOAD_FAIL = 1; |
根据下载状态处理主线程：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
private Handler updateHandler = new Handler(){ @Override public void handleMessage(Message msg) { switch(msg.what){ case DOWNLOAD_COMPLETE: //点击安装PendingIntent Uri uri = Uri.fromFile(updateFile); Intent installIntent = new Intent(Intent.ACTION_VIEW); installIntent.setDataAndType(uri, "application/vnd.android.package-archive"); updatePendingIntent = PendingIntent.getActivity(UpdateService.this, 0, installIntent, 0); updateNotification.defaults = Notification.DEFAULT_SOUND;//铃声提醒 updateNotification.setLatestEventInfo(UpdateService.this, "上海地铁", "下载完成,点击安装。", updatePendingIntent); updateNotificationManager.notify(0, updateNotification); //停止服务 stopService(updateIntent); case DOWNLOAD_FAIL: //下载失败 updateNotification.setLatestEventInfo(UpdateService.this, "上海地铁", "下载完成,点击安装。", updatePendingIntent); updateNotificationManager.notify(0, updateNotification); default: stopService(updateIntent); } }}; |
下载完成，如图：
至此，文件下载并且在通知栏通知进度。
发现本人废话很多，其实几句话的事情，来来回回写了这么多，啰嗦了，后面博文我会朝着精简方面努力。
PS：前面说要附上cheanUpdateFile()的代码
File updateFile = new File(Global.downloadDir,getResources().getString(R.string.app_name)+".apk");if(updateFile.exists()){ //当不需要的时候，清除之前的下载文件，避免浪费用户空间 updateFile.delete(); }
