android java 静态库_Android.mk 中的静态库和共享库

有些类似的问题碰到过很多次，但大脑里总是各种碎片化的记忆，长时间记住这些碎片并不是人类大脑的强项，所以有事没事就要捋捋，知道前因后果才

能记忆深刻。

Android.mk

Android.mk 只是GNU Makefile的一小部分，用来编译module，这个module可以是app，也可以是library。Android.mk可能会被编译系统解析多次，所以

要谨慎定义变量，建议尽量不要在其中定义变量。

静态库与共享库的区别

简单来讲，静态库是在连接阶段直接拷贝到代码中使用的，而共享库是由加载器加载到内存，在运行时使用的。编译出来的静态库(这里指jar包)里每

个java文件对应的class文件都单独存在，可以直接导入Eclipse等IDE使用，而编译出来的共享库(jar包)，内部是Android字节码Dex格式的文件，

一般无法导入Eclipse等IDE使用。Android.mk中由BUILD_JAVA_LIBRARY指定生成共享库，BUILD_STATIC_JAVA_LIBRARY指定生成静态库。

编译静态库和共享库

下面是两个生成静态库和动态库的例子。

生成静态库的mk文件：

// 返回Android.mk所在的当前路径

LOCAL_PATH:= $(call my-dir)

// 清理除LOCAL_PATH变量以外的LOCAL_XXX

include $(CLEAR_VARS)

// 生成静态库的name

LOCAL_MODULE := simple_game

// 设置在那个版本下编译，user, eng, tests, optional(全版本编译)

LOCAL_MODULE_TAGS := optional

// 签名类型 testkey, media, platform, shared, 默认为testkey

LOCAL_CERTIFICATE := platform

// 生成静态库使用的源文件

LOCAL_SRC_FILES := $(call all-java-files-under, src)

LOCAL_SRC_FILES += $(call all-Iaidl-files-under, src)

// 设置生成静态库

include $(BUILD_STATIC_JAVA_LIBRARY)

生成共享库的mk文件：

LOCAL_PATH:= $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := simple_game

LOCAL_MODULE_TAGS := optional

LOCAL_CERTIFICATE := platform

LOCAL_SRC_FILES := $(call all-java-files-under, src)

LOCAL_SRC_FILES += $(call all-Iaidl-files-under, src)

// 安装时需要一起安装的模块

LOCAL_REQUIRED_MODULES := simple_game.xml

// 设置生成共享库

include $(BUILD_JAVA_LIBRARY)

################################################################

include $(CLEAR_VARS)

LOCAL_MODULE := simple_game.xml

// 定制LOCAL_MODULE_PATH变量的值

LOCAL_MODULE_CLASS := ETC

// 设置安装的路径

LOCAL_MODULE_PATH := $(TARGET_OUT)/etc/permissions

LOCAL_MODULE_TAGS := optional

LOCAL_SRC_FILES := simple_game.xml

// 将文件预置进系统

include $(BUILD_PREBUILT)

共享库需要一个xml文件配置安装的信息，LOCAL_REQUIRED_MODULES设置了该文件，当共享库安装时，LOCAL_REQUIRED_MODULES制定的模块也会安装到系

统中。

安装的位置由LOCAL_MODULE_PATH指定，当LOCAL_MODULE_PATH没有设置时，系统将会根据LOCAL_MODULE_CLASS的值来判断安装的位置，

LOCAL_MODULE_CLASS变量将通过/build/core/base_rules.mk文件设置默认的安装目录，常用的值有:

apk文件: APPS

so文件: SHARED_LIBRARIES

bin文件: EXECUTABLES

其他文件: ETC

当LOCAL_MODULE_PATH和LOCAL_MODULE_CLASS均没有设置时，系统会根据编译生成的不同模块(根据include$()判断)来自动设置LOCAL_MODULE_CLASS的值，

但遇到include $(BUILD_PREBUILT)编译选项时，系统不会设置模块的LOCAL_MODULE_CLASS，需要显示设置。

最后针对单一文件进行预编译需要设置BUILD_PREBUILT，对于多文件需要设置BUILD_MULTI_PREBUILT宏。

静态库和共享库的使用

完成了库的编译，接下来看看库的使用方法。

静态库很多情况来自第三方，包括jar包和第三方工程。首先，获得到jar后需要导入项目代码，一般放在libs目录下，接下来需要修改项目的mk，加入

编译静态库的代码，类似一下XML:

LOCAL_PATH:= $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := optional

// 依赖静态库的名称，可以随便起名

LOCAL_STATIC_JAVA_LIBRARIES := simple_game

// 预编译静态库，冒号之前名称要和LOCAL_STATIC_JAVA_LIBRARIES一致，冒号后面是静态库路径

LOCAL_PREBUILT_STATIC_JAVA_LIBRARIES := simple_game:libs/simple_game.jar

include $(BUILD_MULTI_PREBUILT)

include $(CLEAR_VARS)

LOCAL_SRC_FILES := $(call all-java-files-under, src)

LOCAL_SRC_FILES += $(call all-Iaidl-files-under, src)

// 定义生成apk名称

LOCAL_PACKAGE_NAME := game

// 定义app是否要放在/system/priv-app

LOCAL_PRIVILEGED_MODULE := true

LOCAL_CERTIFICATE := platform

// 定义是否需要代码混淆

LOCAL_PROGUARD_ENABLED := disabled

// 编译MODULE为apk

include $(BUILD_PACKAGE)

include $(BUILD_PACKAGE) 会结合LOCAL_PRIVILEGED_MODULE判断生成的apk是最终安装在/system/app下还是/system/priv-app下。

LOCAL_PROGUARD_ENABLED定义了编译apk时是否进行代码混淆，默认为full，将工程代码全部混淆，也可以用LOCAL_PROGUARD_FLAG_FILES配置混淆规则。

静态库的使用比较简单，下面来看看共享库的使用。

LOCAL_PATH:= $(call my-dir)

include $(CLEAR_VARS)

LOCAL_SRC_FILES := $(call all-java-files-under, src)

LOCAL_SRC_FILES += $(call all-Iaidl-files-under, src)

LOCAL_PACKAGE_NAME := game

LOCAL_PRIVILEGED_MODULE := true

LOCAL_MODULE_TAGS := optional

LOCAL_CERTIFICATE := platform

LOCAL_PROGUARD_ENABLED := disabled

// MODULE 依赖的共享库

LOCAL_JAVA_LIBRARIES += simple_game

// 安装时module时，共享库需要一起安装。

LOCAL_REQUIRED_MODULES := simple_game

include $(BUILD_PACKAGE)

上面是一个简单使用共享库的例子，LOCAL_JAVA_LIBRARIES定义了依赖的共享库，全编译时检查到该选项系统会先编译simple_game库，然后检查

LOCAL_REQUIRED_MODULES，决定是否安装该库(即是否在/system/framework下生成该库)，注意，单编时mm, mm -B, mmm均不会编译module

使用的依赖文件，需要使用m+module(如: m game)来编译。

app在使用时千万别忘了在AndroidManifest.xml中添加该共享库:

有很多同学不注意就忘了，然后查了半天才恍然大悟，切记切记!

最后，类似$(call my-dir)宏函数的定义，可以在/build/core/definitions.mk中找到，其他变量定义可以在/build/core/base_rules.mk中找到。有

兴趣的同学可以去查看。