深入浅出Android makefile(4)--LOCAL_STATIC_LIBRARIES

上文我们讲完LOCAL_SRC_FILES,下面我们就一步步来梳理下LOCAL_STATIC_LIBRARIES。

一、 初识LOCAL_STATIC_LIBRARIES
我们首先看看该变量在NDK文档中的定义:
LOCAL_STATIC_LIBRARIES
     应该链接到这个模块的静态库列表(使用 BUILD_STATIC_LIBRARY 生成),这仅仅对共享库模块才有意义。
    The list of static libraries modules (built with BUILD_STATIC_LIBRARY) that should be linked to this module. This only makes sense in shared library modules.
最后一句“这仅仅对共享库模块才有意义”我们先不管,从上述定义中我们知道,LOCAL_STATIC_LIBRARIES肯定是描述了编译当前模块需要的静态库。

在acp模块的编译文件Android.mk中有LOCAL_STATIC_LIBRARIES的定义:LOCAL_STATIC_LIBRARIES := libhost,也就是描述了要编译本模块,必须已经先编译了libhost.a静态库。
但是如果我没有编译出libhost.a静态库,为什么会报 *** No rule to make target `out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates/libhost.a', needed by `out/host/linux-x86/obj/EXECUTABLES/acp_intermediates/acp'.  Stop .这个错误?它又是如何知道,或者说它就是去out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates/目录下查找libhost.a呢?

二、 built_static_libraries
我们先从找一下在何处使用到了LOCAL_STATIC_LIBRARIES这个变量入手,通过查找,我们发现build/core/binary.mk文件中定义built_static_libraries变量时使用到LOCAL_STATIC_LIBRARIES。
built_static_libraries的定义如下:
built_static_libraries := \
    $(foreach lib,$(LOCAL_STATIC_LIBRARIES), \
      $(call intermediates-dir-for, \
        STATIC_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE))/$(lib)$(a_suffix)) 
我们猜测,编译系统是通过这个变量将LOCAL_STATIC_LIBRARIES中定义的libhost转换为完整的host静态库的地址,下面看我们猜测的对不对。

built_static_libraries 主要调用了foreach函数,取出LOCAL_STATIC_LIBRARIES列表中的每项,然后执行后面的函数并返回最后的结果:
 $(foreach lib,$(LOCAL_STATIC_LIBRARIES), funcX)
具体执行的函数则是 $(call intermediates-dir-for, STATIC_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE))/$(lib)$(a_suffix)
注意,此处是先执行 $(call intermediates-dir-for, STATIC_LIBRARIES,$(lib),$(LOCAL_IS_HOST_MODULE)) 函数,然后再添加上 /$(lib)$(a_suffix) 后缀

其实 intermediates-dir-for这个函数我们之前已经详细分析过,它就是根据$(1) target class, $(2) target name, $(3) HOST or TARGET以及$(4) COMMON or not这4个参数,返回这个组装的路径,在本例中,返回的是out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates。其中out/*/linux-x86/obj/*/*_intermediates这个是根据初始参数形成的框架,
host部分 ,根据$(LOCAL_IS_HOST_MODULE)来确定,此处为什么是$(LOCAL_IS_HOST_MODULE)返回true,原因还是include $(BUILD_HOST_EXECUTABLE)中明确说明,这个模块编译的是HOST,当然$(LOCAL_IS_HOST_MODULE)为true,需要的静态库肯定也是在out/host目录下面。
STATIC_LIBRARIES部分 ,intermediates-dir-for函数第一个参数应明确指出这是个静态库。
libhost部分 ,在本例中$(LOCAL_STATIC_LIBRARIES)只描述一个静态库LOCAL_STATIC_LIBRARIES := libhost

因此,整个built_static_libraries 变量的通过展开会返回 out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates/libhost.a 字符串,即编译本模块时所需要的静态库全路径。
如果使用mmm build/tools/acp/直接编译acp,out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates/目录下查找libhost.a文件失败,所以会报如下错误:
*** No rule to make target `out/host/linux-x86/obj/STATIC_LIBRARIES/libhost_intermediates/libhost.a', needed by `out/host/linux-x86/obj/EXECUTABLES/acp_intermediates/acp'.  Stop.

猜你喜欢

转载自nfer-zhuang.iteye.com/blog/1758157