##Introduction
android lib - autoupdater
##Demo
Github
Google Play
##Specifications Android Autoupdate Specification V1.0
##System requirements Android 2.2+
##Permission requirements
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
##Dependencies
- Google Gson https://code.google.com/p/google-gson/
- http-request https://github.com/kevinsawicki/http-request
- android-autoupdater https://github.com/snowdream/android-autoupdater
- android-downloader https://github.com/snowdream/android-downloader
- android-multithread https://github.com/snowdream/android-multithread
Check this for more informaion. build.gradle
##Download Download the latest aar or grab via Maven:
<dependency>
<groupId>com.github.snowdream.android.app</groupId>
<artifactId>updater</artifactId>
<version>1.0</version>
<type>aar</type>
</dependency>
or Gradle:
compile ('com.github.snowdream.android.app:updater:1.0@aar'){
transitive=true
}
##Usage 1、upload the new apk to the webserver,get the apk url,as follows.
https://raw.github.com/snowdream/android-autoupdate/master/docs/test/android-autoupdater-v2.0-release.apk
2、read Android Autoupdate Specification V1.0 then touch the file update.xml
<?xml version="1.0" encoding="UTF-8"?>
<updateInfo>
<appName>android-autoupdater</appName>
<appDescription>android autoupdater</appDescription>
<packageName>com.github.snowdream.android.apps.autoupdater</packageName>
<versionCode>2</versionCode>
<versionName>2.0</versionName>
<forceUpdate>false</forceUpdate>
<autoUpdate>false</autoUpdate>
<apkUrl>https://raw.github.com/snowdream/android-autoupdate/master/docs/test/android-autoupdater-v2.0-release.apk</apkUrl>
<updateTips>
<default>update tips</default>
<en>update tips</en>
<zh>升级提示\n1.版本检查\n2.版本维护\n3.版本更新</zh>
<zh_CN>升级提示</zh_CN>
<zh_TW>升级提示</zh_TW>
<zh_HK>升级提示</zh_HK>
</updateTips>
</updateInfo>
3、upload the update.xml to the webserver,get the file url,as follows.
https://raw.github.com/snowdream/android-autoupdate/master/docs/test/updateinfo.xml
4、get the lib in you project. write this into the build.gradle.
compile 'com.github.snowdream.android.app:updater:1.0@aar'
5、where you want to check update,write as follows.
UpdateManager manager = new UpdateManager(this);
UpdateOptions options = new UpdateOptions.Builder(this)
.checkUrl("https://raw.github.com/snowdream/android-autoupdate/master/docs/test/updateinfo.xml")
.updateFormat(UpdateFormat.XML)
.updatePeriod(new UpdatePeriod(UpdatePeriod.EACH_TIME))
.checkPackageName(true)
.build();
manager.check(this, options);
or
UpdateManager manager = new UpdateManager(this);
UpdateOptions options = new UpdateOptions.Builder(this)
.checkUrl("https://raw.github.com/snowdream/android-autoupdate/master/docs/test/updateinfo.xml")
.updateFormat(UpdateFormat.XML)
.updatePeriod(new UpdatePeriod(UpdatePeriod.EACH_TIME))
.checkPackageName(true)
.build();
manager.check(this, options,new AbstractUpdateListener() {
/**
* Exit the app here
*/
@Override
public void ExitApp() {
}
/**
* show the update dialog
*
* @param info the info for the new app
*/
@Override
public void onShowUpdateUI(UpdateInfo info) {
}
/**
* It's the latest app,or there is no need to update.
*/
@Override
public void onShowNoUpdateUI() {
}
/**
* show the progress when downloading the new app
*
* @param info
* @param task
* @param progress
*/
@Override
public void onShowUpdateProgressUI(UpdateInfo info, DownloadTask task, int progress) {
}
/**
* show the checking dialog
*/
@Override
public void onStart() {
super.onStart();
}
/**
* hide the checking dialog
*/
@Override
public void onFinish() {
super.onFinish();
}
});
##License
Copyright (C) 2014 Snowdream Mobile <[email protected]>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.