Android应用更新库

android-upgrade

这是一个安卓软件升级库。

简介:

1.升级模式支持普通升级、强制升级、灰度升级。

2.下载支持断点续传、分流下载、动态网络监听下载。

2.安装支持自动安装申请sd卡和安装权限、自动安装(root权限)、自动清除安装包。

3.支持更新模板或自定义更新模板(json或xml)或下载链接

4.支持通知栏显示和对话框显示(自定义主题)

5.支持android 4.2以上设备







依赖:

Or use Gradle:

Add it in your root build.gradle at the end of repositories:

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

Add the dependency

dependencies {
	        compile 'com.github.itsnows:android-upgrade:release'
	}

Or Maven:

Add the JitPack repository to your build file

<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add the dependency

<dependency>
	    <groupId>com.github.itsnows</groupId>
	    <artifactId>android-upgrade</artifactId>
	    <version>1.1.4</version>
	</dependency>

使用:

1.更新文档(xml)

<?xml version="1.0" encoding="utf-8"?>
<android>

    <!--稳定版-->
        <stable>
            <!--date:更新日期-->
            <date>2018-02-09</date>
            <!--mode:更新模式 1普通 2强制-->
            <mode>1</mode>
            <!--log:更新说明-->
            <log>
                <item>#升级模式支持普通升级、强制升级、灰度升级</item>
                <item>#下载支持断点续传、分流下载、动态网络监听下载</item>
                <item>#安装支持自动安装申请sd卡和安装权限、自动安装(root权限)、自动清除安装包</item>
                <item>#支持通知栏显示和对话框显示(自定义主题)</item>
                <item>#支持自定义对话框</item>
                <item>#支持android 4.2以上设备</item>
            </log>
            <!--versionCode:新版App版本号-->
            <versionCode>5</versionCode>
            <!--versionCode:新版App版本名称-->
            <versionName>1.0.0.5</versionName>
            <!--downloadUrl:新版App下载链接-->
            <downloadUrl>http://gdown.baidu.com/data/wisegame/16f98e07f392294b/QQ_794.apk
            </downloadUrl>
            <!--md5:新版App安装包完整性-->
            <md5></md5>
        </stable>

        <!--测试版-->
        <beta>
            <!--device:测试版设备序列号-->
            <device>
                <sn>JGB9K17928918126</sn>
            </device>
            <!--date:更新日期-->
            <date>2018-02-09</date>
            <!--mode:更新模式 1普通 2强制-->
            <mode>1</mode>
            <!--log:更新说明-->
            <log>
                <item>#内侧版本</item>
            </log>
            <!--versionCode:新版App版本号-->
            <versionCode>5</versionCode>
            <!--versionCode:新版App版本名称-->
            <versionName>1.0.0.5</versionName>
            <!--downloadUrl:新版App下载链接-->
            <downloadUrl>http://gdown.baidu.com/data/wisegame/16f98e07f392294b/QQ_794.apk
            </downloadUrl>
            <!--md5:新版App安装包完整性-->
            <md5></md5>
        </beta>

</android>

2.更新文档(json)

{
  "android": {
    "stable": {
      "date": "2018-02-09",
      "mode": 1,
      "log": [
        "#升级模式支持普通升级、强制升级、灰度升级",
        "#下载支持断点续传、分流下载、动态网络监听下载",
        "#安装支持自动安装申请sd卡和安装权限、自动安装(root权限)、自动清除安装包",
        "#支持更新模板或自定义更新模板(json或xml)或下载链接",
        "#支持通知栏显示和对话框显示(自定义主题)",
        "#支持自定义对话框",
        "#支持android 4.2以上设备"
      ],
      "versionCode": 20,
      "versionName": "1.2.0",
      "downloadUrl": "http://gdown.baidu.com/data/wisegame/16f98e07f392294b/QQ_794.apk",
      "md5": null
    },
    "beta": {
      "device": [
        "JGB9K17928918126"
      ],
      "date": "2018-02-09",
      "mode": 1,
      "log": [
        "#内侧版本"
      ],
      "versionCode": 20,
      "versionName": "1.2.0",
      "downloadUrl": "http://gdown.baidu.com/data/wisegame/16f98e07f392294b/QQ_794.apk",
      "md5": null
    }
  }
}

3.代码调用

UpgradeManager manager = new UpgradeManager(this);

// 自动检测更新
manager.checkForUpdates(new UpgradeOptions.Builder()
       // 对话框主题(可选)
       .setTheme(ContextCompat.getColor(this, R.color.colorPrimary))
       // 通知栏图标(可选)
       .setIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher_round))
       // 通知栏标题(可选)
       .setTitle("腾讯QQ")
       // 通知栏描述(可选)
       .setDescription("更新通知栏")
       // 下载链接或更新文档链接
       .setUrl("https://gitee.com/itsnows/android-upgrade/raw/master/doc/app-update.json")
       // 下载文件存储路径(可选)
       .setStorage(new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Download/com.upgrade.apk"))
       // 是否支持多线性下载(可选)
       .setMultithreadEnabled(true)
       // 线程池大小(可选)
       .setMultithreadPools(10)
       // 文件MD5(可选)
       .setMd5(null)
       // 是否自动删除安装包(可选)
       .setAutocleanEnabled(false)
       // 是否自动安装安装包(可选)
       .setAutomountEnabled(false)
       // 是否自动检测更新
       .build(), true);
		
// 手动检测更新
manager.checkForUpdates(new UpgradeOptions.Builder()
       .setIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher_round))
       .setTitle("腾讯QQ")
       .setDescription("更新通知栏")
       .setUrl("https://gitee.com/itsnows/android-upgrade/raw/master/doc/app-update.json")
       .setStorage(new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Download/com.upgrade.apk"))
       .setMultithreadEnabled(true)
       .setMultithreadPools(1)
       .build(), true);

// 自定义下载更新
manager.checkForUpdates(new UpgradeOptions.Builder()
       .setIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher_round))
       .setTitle("腾讯QQ")
       .setDescription("更新通知栏")
       .setUrl("https://gitee.com/itsnows/android-upgrade/raw/master/doc/app-update.json")
       .setStorage(new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Download/com.upgrade.apk"))
       .setMultithreadEnabled(true)
       .setMultithreadPools(1)
       .setMd5(null)
       .setAutocleanEnabled(true)
       .setAutomountEnabled(true)
       .build(), new OnUpgradeListener() {

            // 安装包下载(无需更新文档)
            @Override
            public void onUpdateAvailable(UpgradeClient client) {

            }

            // 发布版本
            @Override
            public void onUpdateAvailable(Upgrade.Stable stable, UpgradeClient client) {
            }

            // 测试版本
            @Override
            public void onUpdateAvailable(Upgrade.Beta beta, UpgradeClient client) {

            }

            // 没有可用的更新
            @Override
            public void onNoUpdateAvailable(String message) {
                Toast.makeText(MainActivity.this, message, Toast.LENGTH_SHORT).show();
            }
        });
		
// 下载安装包(无需更新文档)
manager.checkForUpdates(new UpgradeOptions.Builder()
       .setIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher_round))
       .setTitle("腾讯QQ")
       .setDescription("更新通知栏")
       .setUrl("http://gdown.baidu.com/data/wisegame/16f98e07f392294b/QQ_794.apk")
       .setStorage(new File(Environment.getExternalStorageDirectory().getAbsolutePath() + "/Download/com.upgrade.apk"))
       .setMultithreadEnabled(true)
       .setMultithreadPools(1)
       .setMd5(null)
       .build(), false);

// 取消检测
manager.cancel();

源码地址

框架内部支持中/英文(其他语言只需要在对应的string.xml中取相同的名字即可)内部对话框背景图片、按钮支持自定义了查看版本中的Log只需要过滤AppUpdate开头的Tag重点: 如果没有设置downloadPath则默认为getExternalCacheDir()目录,同时不会申请[存储]权限!目录编译问题效果图功能介绍DownloadManagerUpdateConfiguration使用步骤Demo下载体验版本更新记录结语编译问题因为适配了Android O的通知栏,所以依赖的v7包版本比较高appcompat-v7:26.1.0使用的gradle版本为gradle-4.1-all,所以建议使用Android Studio 3.0及以上的版本打开此项目效果图     功能介绍 支持断点下载 支持后台下载 支持自定义下载过程 支持 设备 >= Android M 动态权限的申请 支持通知栏进度条展示(或者自定义显示进度) 支持Android N 支持Android O 支持中/英文双语 支持自定内置对话框的样式 使用HttpURLConnection下载,未集成其他第三方框架更加详细的文档参阅此处《AppUpdate API文档》DownloadManager:配置文档初始化使用DownloadManager.getInstance(this)属性描述默认值是否必须设置context上下文nulltrueapkUrlapk的下载地址nulltrueapkNameapk下载好的名字nulltruedownloadPathapk下载的位置getExternalCacheDir()falseshowNewerToast是否提示用户 "当前已是最新版本"falsefalsesmallIcon通知栏的图标(资源id)-1trueconfiguration这个的额外配置nullfalseapkVersionCode更新apk的versionCode (如果设置了那么中将会进行版本判断下面的属性也就需要设置了)1falseapkVersionName更新apk的versionNamenullfalseapkDescription更新描述nullfalseapkSize新版本的安装包大小(单位M)nullfalseauthorities兼容Android N uri授权应用包名falseUpdateConfiguration:配置文档属性描述默认值notifyId通知栏消息id1011notificationChannel适配Android O的渠道通知详情查阅源码httpManager设置自己的下载过程nullbreakpointDownload是否需要支持断点下载trueenableLog是否需要日志输出trueonDownloadListener下载过程的回调nulljumpInstallPage下载完成是否自动弹出安装页面trueshowNotification是否显示通知栏进度(后台下载提示)trueforcedUpgrade是否强制升级falseonButtonClickListener按钮点击事件回调nulldialogImage对话框背景图片资源(图片规范参考demo)-1dialogButtonColor对话框按钮的颜色-1dialogButtonTextColor对话框按钮的文字颜色-1所有版本:点击查看使用步骤第一步: app/build.gradle进行依赖implementation 'com.azhon:appupdate:1.7.3'第二步:创建DownloadManager,更多用法请查看这里示例代码DownloadManager manager = DownloadManager.getInstance(this); manager.setApkName("appupdate.apk")         .setApkUrl("https://raw.githubusercontent.com/azhon/AppUpdate/master/apk/appupdate.apk")         .setSmallIcon(R.mipmap.ic_launcher)         //可设置,可不设置         .setConfiguration(configuration)         .download();第三步:兼容Android N 及以上版本,在你应用的Manifest.xml添加如下代码<--! android:authorities="${applicationId}"  这个值必须与DownloadManager中的authorities一致(不设置则为应用包名)--> <provider     android:name="android.support.v4.content.FileProvider"     android:authorities="${applicationId}"     android:exported="false"     android:grantUriPermissions="true">     <meta-data         android:name="android.support.FILE_PROVIDER_PATHS"         android:resource="@xml/file_paths_public" /> </provider>第四步:资源文件res/xml/file_paths_public.xml内容<?xml version="1.0" encoding="utf-8"?> <paths>     <external-path         name="app_update_external"         path="/" />     <external-cache-path         name="app_update_cache"         path="/" /> </paths>兼容Android O及以上版本,需要设置NotificationChannel(通知渠道);中已经写好可以前往查阅NotificationUtil.java温馨提示:升级对话框中的内容是可以上下滑动的哦!如果需要实现自己一套下载过程,只需要继承BaseHttpDownloadManager 并使用listener更新进度public class MyDownload extends BaseHttpDownloadManager {}
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值