这是一个用于Android应用程序增量更新的库。包括客户端、服务端两部分代码,其中服务器端又分为c/s、b/s。

• ApkPatchLibrary:客户端使用的apk合成库,用于生成libApkPatchLibrary.so,使用Eclipse开发;
• IncrementalUpdate-Android:一个Sample,手机上安装 jinritoutiao_542.apk,通过与SD卡上预先存放的jinritoutiao_542_jinritoutiao_543.patch文件进行合并,得到jinritoutiao_543.apk,使用AndroidStudio开发。
• IncrementalUpdate-web:基于bsdiff的Web端文件补丁生成与应用工具,使用Eclipse开发。
• PatchUtil-cs:基于bsdiff的C/S版补丁生成与应用工具,使用Visual Studio开发。

智能手机发展到现在,已经有成千上万的APP,这些APP的安装包也越来越大,小则几M,多则几十M甚至上百M。传统方式更新APP需要下载APP的完整包。如果安装包比较大,用户在更新APP的时候不仅等待的时间长,而且很消耗流量(二十一世纪最贵的莫非是流量了)。所以说用户很不愿意将APP更新到最新版本。

1. 对于用户来说下载完整包进行更新费流量,且等待时间长。
2. 对于每次版本迭代本身来说,一般是修复BUG,添加一些新功能,这些所产生的增量很小。
3. 对于APP的所有者来说,希望将用户使用的是最新的APP。

(有需求就有市场)增量更新便解决了这些痛点。

增量更新不是什么黑科技,而是对原有技术的新应用,就像AJAX。

现在越来越多的应用市场开始支持增量更新,比如百度手机助手,小米应用市场,华为应用市场等。

增量更新的原理,就是将手机上已安装apk与服务器端最新apk进行二进制对比,得到增量包,用户更新程序时,只需要下载增量包,并在本地使用增量包与已安装apk,合成新版apk。

例如,当前手机中已安装APPV1,大小为10MB,现在APP发布了最新版V2,大小为12.6MB,我们对两个版本的apk文件增量比对之后,发现差异只有2M,那么用户就只需要要下载一个2M的增量包,使用旧版apk与这个增量包,合成得到一个新版本apk,提醒用户安装即可,不需要整包下载12.6M的APPV2版apk。

apk文件的增量、合成,可以通过 xdelta或开源的二进制比较工具 bsdiff 来实现,本项目主要基于bsdiff来实现增量更新,因为bsdiff依赖bzip2,所以我们还需要用到 bzip2, bsdiff中,bsdiff.c 用于生成增量包,bspatch.c 用于合成文件。

弄清楚原理之后,我们想实现增量更新,共需要做3件事:

• 在服务器端,生成两个版本apk的增量包;

• 在手机客户端,使用已安装的apk与这个增量包进行合成,得到新版的apk;

• 校验新合成的apk文件是否完整,MD5或SHA1是否正确,如正确,则引导用户安装;

这一步需要在服务器端来实现,一般来说,每当apk有新版本需要提示用户升级,都需要运营人员在后台管理端上传新apk,上传时就应该由程序生成与之前所有旧版本们与最新版的增量包。

例如: 你的apk已经发布了3个版,V1.0、V2.0、V3.0,这时候你要在后台发布V4.0,那么,当你在服务器上传最新的V4.0包时,服务器端就应该立即生成以下增量包:

1. V1.0 ——> V4.0的增量包;
2. V2.0 ——> V4.0的增量包;
3. V3.0 ——> V4.0的增量包;

需要在手机客户端实现,ApkPatchLibrary 工程封装了这个过程。

同ApkPatchLibraryServer工程一样,ApkPatchLibrary/jni/bzip2 目录中所有文件都来自bzip2项目。

ApkPatchLibrary/jni/com_jph_utils_PatchUtils.c、ApkPatchLibrary/jni/com_jph_utils_PatchUtils.c实现文件的合并过程,其中com_jph_utils_PatchUtils.c修改自bsdiff/bspatch.c。

我们需要用NDK编译出一个libApkPatchLibrary.so文件,生成的so文件位于libs/armeabi/ 下,其他 Android 工程便可以使用该libApkPatchLibrary.so文件来合成apk(如果需要支持多种CPU架构需要自己配置)。

com_jph_utils_PatchUtils.Java_com_jph_utils_PatchUtils_patch()方法,即为生成增量包的代码:

/*
 * Class: com_jph_utils_PatchUtils
 * Method: patch
 * Signature: (Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)I
 */
JNIEXPORT jint JNICALL Java_com_jph_utils_PatchUtils_patch(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;
}

com.jph.utils包,为调用C语言的Java实现;

调用,com.jph.utils.PatchUtils中patch()方法,可以通过旧apk与增量包,合成为新apk。

/**
 * APK Patch工具类
 * 
 * @author jph
 */
public class PatchUtils {
	/**
	 * native方法 使用路径为oldApkPath的apk与路径为patchPath的补丁包,合成新的apk,并存储于 newApkPath
	 * 
	 * 返回:0,说明操作成功
	 * 
	 * @param oldApkPath 示例:/sdcard/old.apk
	 * @param newApkPath 示例:/sdcard/new.apk
	 * @param patchPath 示例:/sdcard/xx.patch
	 * @return
	 */
	public static native int patch(String oldApkPath, String newApkPath,
			String patchPath);
}

在执行patch之前,需要先读取本地安装旧版本APK的MD5或SHA1,判断当前安装的文件是否为合法版本,同样,patch得到新包之后,也需要对它进行MD5或SHA1校验,校验失败,说明合成过程有问题。

增量更新的前提条件,是在手机客户端能让我们读取到当前应用程序安装后的源apk,如果获取不到源apk,那么就无法进行增量更新了,另外,如果你的应用程序不是很大,比如只有2、3M,那么完全没有必要使用增量更新,增量更新只适用于apk包比较大的情况,比如手机游戏客户端。