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 ; //通知栏跳转Intent private 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

@Override public 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(); }