深入浅出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.