【第一节】android增量升级之生成so文件

该篇文章从eoeAndroid搬迁过来的，原文地址：【第一节】android增量升级之生成so文件

前言

对于android项目，我们常常会遇到这样一种情况，比如某一版本的线上应用，突然发现了一个BUG，修改后发现不值当为这个BUG进行一次版本升级，那么怎么去解决在同一版本上修改线上应用的BUG呢，Google给了我们一种解决方案 Smart App update，也就是应用增量升级。

那么，何谓增量升级呢？简单的来说，也就是把同一版本的新旧两个apk进行差分，得到一个差异包，然后在旧的应用中下载该差异包和旧的apk进行合并成新的apk，然后去安装新的apk，该合成的apk和差分前新apk是一样的，这样就可以做到应用的增量升级。一般来说，获取到的差异包较之新的apk来说小了很多，这样就可以减少用户的下载流量。

增量升级需要用到jni开发，所以我们需要去生成合并差异包的so文件，这里我们需要准备的工具有：eclipse，NDK环境（这里用的是ndk9以上的版本），bsdiff文件，bzip2文件（这两个文件在下面附件中给出）。

第一步

创建一个android项目，比如SmartAppUpdateSo，设定好包名（此处为以后引用so文件的方法做准备），例如com.smartapp.update。右键点击项目 -> Android tools -> Add Native Support…，在弹出窗里填写你要生成的so文件名称，如SmartAppUpdate，这样我们就能在项目中看到jni和obj两个文件夹了，删除jni文件夹下的SmartAppUpdate.cpp文件。

第二步

新建BatchUtils工具类，在类中增加方法

private native static int patchApk(String oldApkPath, String newApkPath, String patchPath);

打开cmd界面，进入到项目的bin\classes路径下，执行javah com.smartapp.update.BatchUtils命令，我们就能在bin\classes路径下发现一个命名为com_smartapp_update_BatchUtils.h的文件，打开该文件，里面的内容为

/* DO NOT EDIT THIS FILE - it is machine generated */
#include <jni.h>
/* Header for class com_smartapp_update_BatchUtils */

#ifndef _Included_com_smartapp_update_BatchUtils
#define _Included_com_smartapp_update_BatchUtils
#ifdef __cplusplus
extern "C" {
#endif
/*
 * Class:     com_smartapp_update_BatchUtils
 * Method:    patchApk
 * Signature: (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)I
 */
JNIEXPORT jint JNICALL Java_com_smartapp_update_BatchUtils_patchApk
  (JNIEnv *, jclass, jstring, jstring, jstring);

#ifdef __cplusplus
}
#endif
#endif

第三步

将com_smartapp_update_BatchUtils.h文件拷贝到项目的jni文件夹下，然后将bzip2文件中的相关文件也拷贝到项目的jni文件夹下，需要拷贝的文件有：

blocksort.c
bzip2.c
bzip2recover.c
bzlib_private.h
bzlib.c
bzlib.h
compress.c
crctable.c
decompress.c
dlltest.c
huffman.c
mk251.c
randtable.c
spewG.c
unzcrash.c

第四步

将bsdiff中的bspatch.c文件拷贝到项目的jni文件夹中，并将其重命名为com_smartapp_update_BatchUtils.c，打开该文件，修改其中的内容：

1.将头文件替换掉，原内容为：

#if 0
__FBSDID("$FreeBSD: src/usr.bin/bsdiff/bspatch/bspatch.c,v 1.1 2005/08/06 01:59:06 cperciva Exp [        DISCUZ_CODE_3        ]quot;);
#endif

#include <bzlib.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <err.h>
#include <unistd.h>
#include <fcntl.h>

替换后的内容为：

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <err.h>
#include <unistd.h>
#include <fcntl.h>
#include <android/log.h>
#include <jni.h>

#include "bzlib.c"
#include "crctable.c"
#include "compress.c"
#include "decompress.c"
#include "randtable.c"
#include "blocksort.c"
#include "huffman.c"

#include "com_smartapp_update_BatchUtils.h"

2.将main方法名称替换成applypatch

3.在文件内添加方法

JNIEXPORT jint JNICALL Java_com_smartapp_update_BatchUtils_patchApk(JNIEnv *env,
                jobject obj, jstring old, jstring new, jstring patch) {

        char * ch[4];
        ch[0] = "bspatch";
        ch[1] = (char*) ((*env)->GetStringUTFChars(env, old, 0));
        ch[2] = (char*) ((*env)->GetStringUTFChars(env, new, 0));
        ch[3] = (char*) ((*env)->GetStringUTFChars(env, patch, 0));

        __android_log_print(ANDROID_LOG_INFO, "ApkPatchLibrary", "old = %s ", ch[1]);
        __android_log_print(ANDROID_LOG_INFO, "ApkPatchLibrary", "new = %s ", ch[2]);
        __android_log_print(ANDROID_LOG_INFO, "ApkPatchLibrary", "patch = %s ", ch[3]);

        int ret = applypatch(4, ch);

        __android_log_print(ANDROID_LOG_INFO, "ApkPatchLibrary", "applypatch result = %d ", ret);

        (*env)->ReleaseStringUTFChars(env, old, ch[1]);
        (*env)->ReleaseStringUTFChars(env, new, ch[2]);
        (*env)->ReleaseStringUTFChars(env, patch, ch[3]);

        return ret;
}

第五步

修改Android.mk文件内容

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE    := SmartAppUpdate
LOCAL_SRC_FILES := com_smartapp_update_BatchUtils.c

LOCAL_LDLIBS     := -lz -llog

include $(BUILD_SHARED_LIBRARY)

第六步

右键点击项目 -> properties，在弹出窗中点击Buiders，选择New…，在新弹出窗中选择Program，点击OK，此时弹出一个Edit Configuration弹窗。

1.Name中填写SmartAppUpdateBuilder

2.选择Main标签，在Location一栏中点击Browse File System，选择你NDK安装路径下的ndk-build.cmd文件，Working Directory一栏中点击Browse Workspace，选择该项目的jni文件夹

3.选择Refresh标签，勾选Refresh resources upon completion，选择The entire workspace，勾选上Recursively include sub-folders

4.选择BuildOptions，勾选Allocte Console，After a “Clean”，During manual builds，During auto builds，Specify working set of relevant resources ，点击Specify Resources，在弹出窗中勾选该项目jni文件夹，点击Apply，点击OK，这样我们就能在Buiders列表中看见新建的SmartAppUpdateBuilder，点击OK

第七步

等待片刻，我们会发现在obj文件夹下自动编译出一些文件，而其中obj\local\armeabi下的libSmartAppUpdate.so文件就是我们需要的so文件，那么生成增量升级的so文件的教程到此为止。

如何去使用该so文件进行增量升级，请看 【第二节】android增量升级之使用so文件进行增量升级

下载地址：项目文件及工具（bsdiff-4.3，bzip2-1.0.6，SmartAppUpdateSo）