增量升级(省流量更新)的Android客户端实现
转载与
zhouhuiah的专栏 http://blog.csdn.net/zhouhuiah/article/details/16939937
本文在以上两篇博客的基础上再增加了异常处理,并将生成的so库和Native代码一起打包。
1、准备工具
(1)bspatch源码(点击下载)、某个应用的两个不同版本。或者直接下载上面提到的第一个博主提供的工具和素材。点击打开链接 这里面包括了我们需要用到的bsdiff源码和apk等。
(2)除此之外,还需要下载bzip2。点击打开链接
2、编译环境
Linux、Windows均可,但必须有NDK,Windows下的NDK版本需在R7以上,否则还需要安装cygwin。Windows下搭建NDK环境请参考:NDK配置
3、编码实现
(1)创建Native方法类
先看代码:
- public class PatchClient{
- //定义Native方法
- static private native int applyPatchToOldApk(String oldapk_filepath, String newapk_savepath , String patchpath);
- public static void loadLib(){
- System.loadLibrary("PatchDroid");
- }
- /**
- *
- * @param oldApkPath 旧版apk文件的路径
- * @param newApkPath 新版apk文件的路径
- * @param patchPath 增量包的路径
- * @throws IOException
- */
- public static void applyPatch(String oldApkPath, String newApkPath, String patchPath) throws IOException{
- applyPatchToOldApk(oldApkPath, newApkPath, patchPath);
- }
- /**
- * 根据context获取本app的旧版apk文件,与增量包合并生成新版apk
- * @param context
- * @param newApkPath 新版apk文件路径
- * @param patchPath 增量包路径
- * @throws IOException
- */
- public static void applyPatchToOwn(Context context, String newApkPath, String patchPath) throws IOException{
- String old = context.getApplicationInfo().sourceDir;
- applyPatchToOldApk(old, newApkPath, patchPath);
- }
- }
重点在代码的第三行,其他几个方法在后面介绍。编译之后,会在项目的bin/classes下生成.class文件,打开cmd,切到该目录,输入
- javah cn.sgwhp.PatchDroid(包名.类名)
此时会生成头文件cn_sgwhp_patchdroid_PatchClient.h,在项目的根目录下创建jni文件夹,并把刚才生成的.h文件剪切过去。
(2)实现Native方法
解压下载的bzip2包以及bspatch源码到jni目录下,将bspatch.c命名为cn_sgwhp_patchdroid_PatchClient.c,实现其中的Java_cn_sgwhp_patchdroid_PatchClient_applyPatchToOldApk方法。这里只简单地调用源码的main方法来实现:
- #include "cn_sgwhp_patchdroid_PatchClient.h"
- #include "bzlib_private.h"
- JNIEXPORT jint JNICALL Java_cn_sgwhp_patchdroid_PatchClient_applyPatchToOldApk(JNIEnv *env,
- jobject obj, jstring old, jstring new , jstring patch){
- int argc=4;
- char * argv[argc];
- argv[0]="bspatch";
- argv[1]=(char*)((*env)->GetStringUTFChars(env,old, 0));
- argv[2]=(char*)((*env)->GetStringUTFChars(env,new, 0));
- argv[3]=(char*)((*env)->GetStringUTFChars(env,patch, 0));
- int ret=applypatch(argc, argv, env); //将源码中的main方法改成applypatch即可
- (*env)->ReleaseStringUTFChars(env,old,argv[1]);
- (*env)->ReleaseStringUTFChars(env,new,argv[2]);
- (*env)->ReleaseStringUTFChars(env,patch,argv[3]);
- return ret;
- }
(3)异常处理
源码中只有c的err异常,java是没有办法在控制台输出这些异常信息的,我们将它改造一下,利用JNIEnv的ThrowNew方法来抛出IOException。在cn_sgwhp_patchdroid_PatchClient.c中添加throwIOException方法,并把env参数从Java_cn_sgwhp_patchdroid_PatchClient_applyPatchToOldApk传入applypatch:
- void throwIOException(JNIEnv* env,const char* msg)
- {
- //找到指定名称的类的class类型
- jclass cls=(*env)->FindClass(env,"java/io/IOException");
- (*env)->ThrowNew(env,cls,msg);
- (*env)->DeleteLocalRef(env,cls);
- }
- int applypatch(int argc,char * argv[],JNIEnv* env)
- { ...}
把applypatch方法中所有调用err方法的代码注释掉,改成:
- throwIOException(env, "can not open the patch file");
- return 0
此时,Native方法类中的applyPatch和applyPatchToOwn要 申明抛出IOException,避免程序因为异常而退出。
(4)编译
在jni目录下创建Android.mk文件,并复制以下代码:
- LOCAL_PATH:= $(call my-dir)
- include $(CLEAR_VARS)
- # This is the target being built.
- LOCAL_MODULE:= PatchDroid
- # All of the source files that we will compile.
- # 具体到底需要哪些c代码,没有仔细研究过
- LOCAL_SRC_FILES:= cn_sgwhp_patchdroid_PatchClient.c \
- bzlib.c \
- blocksort.c \
- compress.c \
- crctable.c \
- decompress.c \
- huffman.c \
- randtable.c \
- bzip2.c \
- ifeq ($(HOST_OS),windows)
- #NDK环境下
- LOCAL_LDLIBS := -llog
- else
- #完整源码环境下
- LOCAL_SHARED_LIBRARIES := libutils
- endif
- LOCAL_SHARED_LIBRARIES := \
- libandroid_runtime
- # No static libraries.
- LOCAL_STATIC_LIBRARIES := \
- libbz
- # Also need the JNI headers.
- LOCAL_C_INCLUDES += \
- $(JNI_H_INCLUDE) external/bzip2
- # No special compiler flags.
- LOCAL_CFLAGS +=
- include $(BUILD_SHARED_LIBRARY)
刷新项目NDK就会自动帮我们编译了。
4、打包
右击项目,选择properties,选择Android,勾选Is Library,保存之后Clean项目,在bin目录下会生成一个jar包。其他项目需要用到时,把jar包导入,并把libs目录下的armeabi目录复制到新项目的libs目录下即可。
5、后话
有关applyPatchToOwn(Context context, String newApkPath, String patchPath)方法:程序安装后,apk文件会存在于/data/app目录下,名字是“包名-数字.apk”,其中“数字”一般是1或2,不清楚规则是怎样的。不过没关系,我们可以通过ApplicationInfo的sourceDir来获得目前版本的apk绝对路径,这样只要将增量包下载到sd卡就可以合成新版的apk了。记得要添加外部存储设备的读写权限。