Android Small框架增量升级方案

Posted 何以诚

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android Small框架增量升级方案相关的知识,希望对你有一定的参考价值。

背景

随着业务的发展,安装包的体积也在不断的增大,这时候,如果要版本更新,用户不得不去下载完整的安装包。但是如果使用增量升级方案,用户只需要下载新旧版本的差异包,然后在本地合成就行,这样省时省力。我们可以看下某产品使用增量升级时的数据:

  • xxx.2.4.0000.apk 32MB
  • xxx.2.5.0000.apk 28MB
  • 差异包 6.3MB

其中增量包就是上文提到的差异包,可见用户每次升级只需下载差异包就行,省时省力。

原理

其原理就是,我们在服务器端先拿新版本安装包和旧版本安装包进行对比,在生成差异包之后下发,之后客户端根据对应的差异包和本地旧版本安装包合成,便生成了新版本安装包

实现

0x01 下载编译差分合并工具:
apk文件的差分和合并都是使用的开源的二进制比较工具 bsdiff实现,值得注意的是,该工具依赖bizp2这个库。在下载完毕后,直接make便可以编译工具,不过我在一台苹果机器上编译的时候出现了一点问题,那时候make文件没法正确的读取,所以我修改了make文件,读者编译的时候(仅限mac, linux)只需要运行install.sh脚本就行。这部分的代码我已经单独抽出来作为一个repo,读者喜欢可以自行star,然后下载编译 repo

0x02 生成差异包
如果你刚刚编译成了bsdiff,在命令行里面输入bsdiff或者bspatch就会出现如下的信息:

其中bsdiff用于比较新旧文件的差异部分并生成差异包,bspatch根据之前差异包和旧文件生成新文件,我们可以从这两个可执行文件的报错信息看出该命令如何使用。我们这里有两个文件:new.so 和 old.so

之后我们运行 diff old.so new.so patch.so便生成了差异包patch.so

0x03 合成新版本
通过刚刚的介绍,我们已经在android端实现了相关的库,只需要简单的调用

YPatch.patch(oldFilePath, newFilePath, patchFilePatch)

便可以将新版本存放到newFilePath指定的目录下

结合Small框架

上面好像都是在讲原理,没有具体的实践讲解的话,估计读者还是不懂,我们现在就结合Small框架来看看如何做到增量更新。
对于我们的Small框架,我们要知道,它把每个插件都编译成.so文件,然后存放到app的native目录下,不过,如果它发现自己的download目录有新的插件,那么就会去加载download目录下的插件,并且这种加载优先权是最大的,也就是说它会优先加载download目录下的插件。所以,如果我们要做增量更新,旧文件就从app的native目录进行读取,然后从服务器端下载增量包,最后合成的文件存放到download目录下,这样每次插件启动都会到download目录下加载新的插件。

实现:

        //其中pluginUri对应的是bundle.json中插件对应的uri
        //下文有介绍
        String packageName = parsePackageName(context, pluginUri);
        if (TextUtils.isEmpty(packageName)) 
            Log.e(TAG, "can't parse plugin's package name, check if assets/bundle.json is deleted");
            return;
        

        // small框架的约定就是,插件名字是以lib+包名.so明明的
        // 比如如果我们插件的包名是com.chan.app.setting
        // 那么对于插件名就是libcom_chan_app_setting.so
        final String soName = "lib" + packageName.replaceAll("\\\\.", "_") + ".so";

        //找到旧版本的插件安装包
        final File oldPlugin = new File(context.getApplicationInfo().nativeLibraryDir, soName);
        //新版本都存放到small指定的download目录下
        final File newPlugin = new File(FileUtils.getDownloadBundlePath(), soName);

        //开始下载patch
        OkHttpClient okHttpClient = new OkHttpClient();
        Request request = new Request.Builder().url(uri).build();

        Call call = okHttpClient.newCall(request);
        call.enqueue(new Callback() 
            @Override
            public void onFailure(Request request, IOException e) 

            

            @Override
            public void onResponse(Response response) throws IOException 

                //保存从服务器端下载的增量包
                File patch = new File(FileUtils.getDownloadBundlePath(), "patch.so");
                FileOutputStream fileOutputStream = new FileOutputStream(patch);
                byte[] content = response.body().bytes();
                fileOutputStream.write(content);
                fileOutputStream.flush();
                fileOutputStream.close();

                //合成的新插件安装包存放文职有new Plugin指定
                YPatch.patch(oldPlugin.getAbsolutePath(), newPlugin.getAbsolutePath(), patch.getAbsolutePath());
            
        );

可以看到这个函数中出现的pluginUri,它其实对应的是bundle.json中插件的uri:


  "version": "1.0.0",
  "bundles": [
    
      "uri": "main",
      "pkg": "com.chan.app.main",
      "rules": 
        "item": ".ItemActivity"
      
    ,
    
      "uri": "setting",
      "pkg": "com.chan.app.setting",
      "rules": 
        "index": ".MainActivity"
      
    
  ]

也就是这里的main, setting

而这个bundle.json就是宿主中asset下的small配置文件:

示例代码:

OkSmall.merge(LaunchActivity.this, "setting", "http://192.168.1.100:8080/patch.so");
                Toast.makeText(LaunchActivity.this, "重启应用后更新生效", Toast.LENGTH_SHORT).show();

至此,所有的内容已经介绍完毕

要踩的坑

更新插件的时候要记得把插件的versionCode加大,比如 我们这里的setting插件:

修改它的build.gradle文件:

要记得加大11行的数值,不然加载还是不成功的

引用

以上是关于Android Small框架增量升级方案的主要内容,如果未能解决你的问题,请参考以下文章

Android增量升级(结合small框架)

Android增量升级(结合small框架)

Android Small插件化框架源码分析

基于Small及Weex的定制化APP方案

基于Small及Weex的定制化APP方案

android黑科技系列——应用市场省流量更新(增量升级)原理解析