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

最新推荐文章于 2025-10-29 10:50:10 发布

原创最新推荐文章于 2025-10-29 10:50:10 发布 · 2k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#移动开发

android makefile 专栏收录该内容

5 篇文章

订阅专栏

本文详细探讨了Android构建系统中LOCAL_STATIC_LIBRARIES的使用，揭示了它如何帮助链接静态库到Android应用或库项目中。通过实例解析，解释了配置LOCAL_STATIC_LIBRARIES的过程及其在构建过程中的作用，为Android开发者提供了深入的指导。

上文我们讲完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.