Android学习系列(2)--App自动更新之通知栏下载

1.设计思路，使用VersionCode定义为版本升级参数。
　　android为我们定义版本提供了2个属性：

1

2

3

4

<manifestpackage="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 {

    //版本信息

    publicstatic int localVersion = 0;

    publicstatic int serverVersion = 0;

    publicstatic 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() {

                 publicvoid onClick(DialogInterface dialog,int which) {

                     //开启更新服务UpdateService

                     //这里为了把update更好模块化，可以传一些updateService依赖的值

                     //如布局ID，资源ID，动态获取的标题,这里以app_name为例

                     Intent updateIntent =newIntent(SubwayActivity.this, UpdateService.class);

                     updateIntent.putExtra("titleId",R.string.app_name);

                     startService(updateIntent);

                 }

             })

             .setNegativeButton("取消",newDialogInterface.OnClickListener(){

                 publicvoid 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

privateIntent updateIntent = null;

privatePendingIntent 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, intflags, 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本身也会阻塞

    newThread(new updateRunnable()).start();//这个是下载的重点，是下载的过程

     

    returnsuper.onStartCommand(intent, flags, startId);

}

上面都是准备工作，如图：

　　从代码中可以看出来，updateRunnable类才是真正下载的类，出于用户体验的考虑，这个类是我们单独一个线程后台去执行的。
　　下载的过程有两个工作：1.从服务器上下载数据；2.通知用户下载的进度。
　　线程通知，我们先定义一个空的updateHandler。

1

2

3

4

5

6

private Handler updateHandler = new  Handler(){

    @Override

    publicvoid 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

class updateRunnable implements Runnable {

        Message message = updateHandler.obtainMessage();

        publicvoid run() {

            message.what = DOWNLOAD_COMPLETE;

            try{

                //增加权限;

                if(!updateDir.exists()){

                    updateDir.mkdirs();

                }

                if(!updateFile.exists()){

                    updateFile.createNewFile();

                }

                //下载函数，以QQ为例子

                //增加权限;

                longdownloadSize = 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);

            }

        }

    }

下载函数的实现有很多，我这里把代码贴出来，而且我们要在下载的时候通知用户下载进度：

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 {

            //这样的下载代码很多，我就不做过多的说明

            intdownloadCount = 0;

            intcurrentSize = 0;

            longtotalSize = 0;

            intupdateTotalSize = 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) {

                    thrownew Exception("fail!");

                }

                is = httpConnection.getInputStream();                  

                fos =new FileOutputStream(saveFile,false);

                bytebuffer[] = new byte[4096];

                intreadsize = 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();

                }

            }

            returntotalSize;

        }

显示下载进度，如图：

下载完成后，我们提示用户下载完成，并且可以点击安装，那么我们来补全前面的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

27

28

private Handler updateHandler = new  Handler(){

    @Override

    publicvoid handleMessage(Message msg) {

        switch(msg.what){

            caseDOWNLOAD_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);

                 

                //停止服务

                stopSelf();

                break;

            caseDOWNLOAD_FAIL:

                //下载失败

                updateNotification.setLatestEventInfo(UpdateService.this,"上海地铁", "下载完成,点击安装。", updatePendingIntent);

                updateNotificationManager.notify(0, updateNotification);

                break;

            default:

                stopSelf();

        }

    }

};

下载完成，如图：

至此，文件下载并且在通知栏通知进度。
发现本人废话很多，其实几句话的事情，来来回回写了这么多，啰嗦了，后面博文我会朝着精简方面努力。
PS：前面说要附上cheanUpdateFile()的代码

1

2

3

4

5

File updateFile = new File(Global.downloadDir,getResources().getString(R.string.app_name)+".apk");

if(updateFile.exists()){

   //当不需要的时候，清除之前的下载文件，避免浪费用户空间

   updateFile.delete();

}