android进阶java语言Android知识

高仿友盟自动更新支持自定义接口的自动更新

2016-08-25  本文已影响1124人  jjdxmashl

感谢作者shelwee,本项目是基于UpdateHelper项目,并参考了友盟自动更新SDK的应用交互方式而开发的一个支持自定义接口的自动更新类库。

简介

应用内更新,实现类似友盟自动更新sdk的更新模式,用户使用前只需要配置自己的服务器更新检查接口即可(必须接口),也可以拓展加入一个接口作为在线参数配置来实现(可选接口)可实现以下四种方式更新和是否强制更新组合使用,支持get、post方式请求网络,默认是使用get方式,支持接口返回数据自定义解析。
项目地址:http://www.github.com/jjdxmashl/jjdxm_update

更新检查

1.手动更新:手动检测更新(所有网络类型环境检测并提示主要用于点击检测使用)
2.自动更新:自动检测更新(所有网络类型环境检测并提示)
3.仅WiFi自动检测更新(只有WiFi网络类型环境检测并提示)
4.静默更新:仅WiFi自动检测下载(只有WiFi网络类型环境检测、下载完才提示)

强制更新

强制更新(配合在线参数使得当前版本无法使用)结合以上几种方式组合使用,主要使用场景是当上一个版本的APP有重大bug或漏洞时,修改在线参数统一控制所有的APP用户,使得之前的所有版本必须要升级才能正常使用。主要原理:服务器上修改参数的数值,APP端获取后进行判断,如果为强制更新,则在打开应用是提示有新版APP更新,更新完成才能使用,提示框不消失,用户如果选择不更新则退出应用。

特性

1.更新数据接口用户可自定义
2.在线参数接口用户可自定义
3.参数结构返回可以让用户自定义解析

截图###







demo下载##

demo apk下载

代码混淆###

根据你的混淆器配置和使用,您可能需要在你的proguard文件内配置以下内容:

后续加上

快速开始

step1:

依赖本项目类库

该项目已经打包到jcenter中心了,可以通过compile命令直接依赖,在主程序目录build.gradle中,添加以下代码:

compile 'com.dou361.update.jjdxm-update:1.0.3' 

类库中添加了以下的依赖

compile 'com.dou361.download.jjdxm-download:1.0.1' 
compile 'com.android.support:support-v4:23.3.0' 

如果你的项目中已经有依赖了v4包并且使用的版本不一样可能会造成冲突,可以类似下面的方式进行引入依赖

compile ('com.dou361.update:jjdxm-update:1.0.3'){
    exclude group: 'com.android.support',module:'support-v4'
}

更多关于冲突问题可看这里:架包的打包引用以及冲突解决

step2:

需要权限
<!--jjdxm_update更新 start-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!--jjdxm_update更新 end-->

清单文件中需要配置一个activity和一个服务

<!--jjdxm_update更新 start-->
<activity
    android:name="com.dou361.update.view.UpdateDialogActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar" >
</activity>

<service android:name="com.dou361.update.server.DownloadingService"/>
<!--jjdxm_update更新 end-->

step3:

在Application中配置,初始化配置接口和解析参数

这里必须配置一个在线更新接口及其的数据返回结构的解析,可选的是在线参数接口及其数据返回结构的解析,在线参数可以随机定义零个或多个不同意义的参数来达到在线修改apk的部分特性。

(1)创建一个自动更新的配置文件

public class UpdateConfig {

    private static String checkUrl = "你的更新接口";
    private static String onlineUrl = "你的在线参数接口";

    public static void init(Context context) {
        UpdateHelper.init(context);
        UpdateHelper.getInstance()
                // 必填:数据更新接口
                .setCheckUrl(checkUrl)
                // 可填:在线参数接口
                .setOnlineUrl(onlineUrl)
                // 必填:用于从数据更新接口获取的数据response中。解析出Update实例。以便框架内部处理
                .setCheckJsonParser(new ParseData() {
                    @Override
                    public Update parse(String response) {
                        return null;
                    }
                })
                // 可填:在线参数接口
                .setOnlineJsonParser(new ParseData() {
                    @Override
                    public String parse(String httpResponse) {
                        return null;
                    }
                });
    }
}

(2)配置接口和解析数据,UpdateConfig文件中的,get请求,默认为get请求

private static String checkUrl = "你的更新接口";
private static String onlineUrl = "你的在线参数接口";

public static void init(Context context) {
    UpdateHelper.init(context);
    UpdateHelper.getInstance()
            // 必填:数据更新接口
            .setCheckUrl(checkUrl)
            // 可填:在线参数接口
            .setOnlineUrl(onlineUrl)
            // 必填:用于从数据更新接口获取的数据response中。解析出Update实例。以便框架内部处理
            .setCheckJsonParser(new ParseData() {
                @Override
                public Update parse(String response) {
                        // 此处模拟一个Update对象
                        Update update = new Update();
                        // 此apk包的下载地址
                        update.setUpdateUrl(apkFile);
                        // 此apk包的版本号
                        update.setVersionCode(2);
                        update.setApkSize(12400000);
                        // 此apk包的版本名称
                        update.setVersionName("2.0");
                        // 此apk包的更新内容
                        update.setUpdateContent("测试更新");
                        // 此apk包是否为强制更新
                        UpdateSP.setForced(false);
                        return update;
                }
            })
            // 可填:在线参数接口
            .setOnlineJsonParser(new ParseData() {
                @Override
                public String parse(String httpResponse) {
                    return null;
                }
            });
}

post请求

private static String checkUrl = "你的更新接口";
private static String onlineUrl = "你的在线参数接口";
public static void init(Context context) {
    UpdateHelper.init(context);
    TreeMap<String, Object> params = new TreeMap<String, Object>();
    params.put("pkname", "com.jingwang.eluxue_online");
    params.put("Action", "Apps");
    params.put("SecretId", "d021e4f5tac98U4df5Nb943Odd3a313d9f68");
    params.put("Region", "gz");
    params.put("Nonce", Integer.valueOf((new Random()).nextInt(2147483647)));
    params.put("Timestamp", Long.valueOf(System.currentTimeMillis() / 1000L));
    params.put("RequestClient", "SDK_JAVA_1.0");
    try {
        params.put("Signature", Sign.sign(Sign.makeSignPlainText(params, "POST"), "FDC9BC1AA4B387CEBBF0F9355CEC2086"));
    } catch (Exception var9) {
        var9.printStackTrace();
    }
    UpdateHelper.getInstance()
            // 可填:请求方式
            .setMethod(UpdateHelper.RequestType.post)
            // 必填:数据更新接口
            .setCheckUrl(checkUrl, params)
            // 可填:在线参数接口
            .setOnlineUrl(onlineUrl)
            // 必填:用于从数据更新接口获取的数据response中。解析出Update实例。以便框架内部处理
            .setCheckJsonParser(new ParseData() {
                @Override
                public Update parse(String response) {
                    // 此处模拟一个Update对象
                    Update update = new Update();
                    try {
                        JSONObject jobj = new JSONObject(response);
                        if (!jobj.isNull("data")) {
                            JSONObject job = jobj.optJSONObject("data");
                            if (!job.isNull("v_code")) {
                                // 此apk包的版本号
                                update.setVersionCode(Integer.valueOf(job.optString("v_code")));
                            }
                            if (!job.isNull("v_size")) {
                                // 此apk包的大小
                                update.setApkSize(job.optLong("v_size"));
                            }
                            if (!job.isNull("v_name")) {
                                // 此apk包的版本名称
                                update.setVersionName(job.optString("v_name"));
                            }
                            if (!job.isNull("update_content")) {
                                // 此apk包的更新内容
                                update.setUpdateContent(job.optString("update_content"));
                            }
                            if (!job.isNull("download_url")) {
                                // 此apk包的下载地址
                                update.setUpdateUrl(job.optString("download_url"));
                            }
                        }
                    } catch (Exception e) {
                        e.printStackTrace();
                    }
                    // 此apk包是否为强制更新
                    UpdateSP.setForced(false);
                    return update;
                }
            })
            // 可填:在线参数接口
            .setOnlineJsonParser(new ParseData() {
                @Override
                public String parse(String httpResponse) {
                    return null;
                }
            });
}

(3)在Application的oncreate方法中调用进行sdk的初始化

    UpdateConfig.init(this);

step4:

在mainActivity中oncreate()方法中调用
//默认是自动检测更新
UpdateHelper.getInstance()
            .check(MainActivity.this);

step5:

在需要手动点击的方法中调用
//手动检测更新
UpdateHelper.getInstance()
            .setUpdateType(UpdateHelper.UpdateType.checkupdate)
            .setUpdateListener(new UpdateListener() {
                @Override
                public void noUpdate() {
                    Toast.makeText(mContext, "已经是最新版本了", Toast.LENGTH_LONG).show();
                }

                @Override
                public void onCheckError(int code, String errorMsg) {
                    Toast.makeText(mContext, "检测更新失败:" + errorMsg, Toast.LENGTH_LONG).show();
                }
            })
            .check(MainActivity.this);
几种方式的调用
//有网更新
UpdateHelper.UpdateType.checkupdate,
//自动更新
UpdateHelper.UpdateType.autoupdate,
//只有WiFi更新
UpdateHelper.UpdateType.autowifiupdate,
//只有WiFi下载
UpdateHelper.UpdateType.autowifidown

调用方式这里只举例静默更新,其他方式类似

/静默更新
UpdateHelper.getInstance()
            .setUpdateType(UpdateHelper.UpdateType.autowifidown)
            .check(MainActivity.this);
更新监听回调UpdateListener,主要有四个方法
/**
 * There are a new version of APK on network
 */
public void hasUpdate(Update update) {

}

/**
 * There are no new version for update
 */
public abstract void noUpdate();

/**
 * http check error,
 *
 * @param code     http code
 * @param errorMsg http error msg
 */
public abstract void onCheckError(int code, String errorMsg);

/**
 * to be invoked by user press cancel button.
 */
public void onUserCancel() {

}

项目地址:http://www.github.com/jjdxmashl/jjdxm_update

上一篇下一篇

猜你喜欢

热点阅读