见证过博客园的多次升级,你也希望你的软件通过更新发布新特性通知用户吧,是的。
这篇文章是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
|
class updateRunnable implements Runnable {
Message message = updateHandler.obtainMessage();
public void run() {
message.what = DOWNLOAD_COMPLETE;
try {
//增加权限;
if (!updateDir.exists()){
updateDir.mkdirs();
}
if (!updateFile.exists()){
updateFile.createNewFile();
}
//下载函数,以QQ为例子
//增加权限;
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);
}
}
}
|
下载函数的实现有很多,我这里把代码贴出来,而且我们要在下载的时候通知用户下载进度:
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
27
28
|
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);
//停止服务
stopSelf();
break ;
case DOWNLOAD_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();
} |
谢谢大家!!!!