LOCAL_WHOLE_STATIC_LIBRARIES与LOCAL_STATIC_LIBRARIES的区别

在分析Jelly Bean Audio Subsystem的时候，发现HAL层的库audio_policy.xxx.so与其依赖的静态库libaudiopolicy_legacy.a都有audio_policy_hal.cpp这个源文件而且两者都定义了一个HMI。当调用者引用HMI的时候，调用的究竟是哪个呢？

首先看audio_policy.xxx.so的Android.mk文件，在定义编译audio_policy.xxx.so的段落里面有这么一句：

LOCAL_STATIC_LIBRARIES :=
     libaudiohw_legacy
     libmedia_helper
     libaudiopolicy_legacy

说明libaudiopolicy_legacy是以静态库的形式为audio_policy.xxx.so所用，而在通用的audio_policy库（也可以说是谷歌提供给厂商参考用的policy库）audio_policy.default.so的库里面是这么用的：

LOCAL_WHOLE_STATIC_LIBRARIES :=
    libaudiopolicy_legacy

而audio_policy.default.so的源码里面就没有audio_policy_hal.cpp这个源文件，所以玄机应该就在LOCAL_WHOLE_STATIC_LIBRARIES和LOCAL_STATIC_LIBRARIES这两个宏的差异上面。先看下谷歌在build/core/build-system.html里面是怎么说的：

LOCAL_STATIC_LIBRARIES

These are the static libraries that you want to include in your module. Mostly, we use shared libraries, but there are a couple of places, like executables in sbin and host executables where we use static libraries instead.

LOCAL_WHOLE_STATIC_LIBRARIES

These are the static libraries that you want to include in your module without allowing the linker to remove dead code from them. This is mostly useful if you want to add a static library to a shared library and have the static library's content exposed from the shared library.

总的来说LOCAL_WHOLE_STATIC_LIBRARIES在连接静态连接库的时候不会移除"daed code"，何谓dead code呢，就是调用者模块永远都不会用到的代码段和变量，下面用几个小源码来说明。

Android.mk如下

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)

LOCAL_SRC_FILES := 
    libstone_1.cpp

LOCAL_MODULE := libstone_1
LOCAL_MODULE_TAGS := optional

include $(BUILD_STATIC_LIBRARY)

# =========================================
include $(CLEAR_VARS)

LOCAL_SRC_FILES := 
    libstone_2.cpp

LOCAL_STATIC_LIBRARIES := libstone_1
#<span style="color:#ff0000;"> LOCAL_WHOLE_STATIC_LIBRARIES := libstone_1</span>
LOCAL_MODULE := libstone_2
LOCAL_MODULE_TAGS := optional

include $(BUILD_SHARED_LIBRARY)

静态库源文件（libstone_1.cpp）：

char hello[] = "this is a string in libstone_1";
char str_2[] = "non static string 1";
char str_3[] = "non static string 2";
void func_1(){hello[0]+=1;}

调用者源文件（libstone_2.cpp）：

char hello[] = "this is a string in libstone_2";

case 1，按照上述的代码make之后，libstone_1的所有东西都没有被连接到动态库libstone_2里面：

readelf -Ws system/lib/libstone_2.so 
Symbol table '.dynsym' contains 11 entries:
   Num:    Value  Size Type    Bind   Vis      Ndx Name
     0: 00000000     0 NOTYPE  LOCAL  DEFAULT  UND 
     1: 00002000    31 OBJECT  GLOBAL DEFAULT   13 hello2
     2: 000002e8    12 FUNC    GLOBAL DEFAULT    7 __on_dlclose
     3: 00000000     0 FUNC    GLOBAL DEFAULT  UND __cxa_finalize
     4: 00000000     0 FUNC    GLOBAL DEFAULT  UND __aeabi_unwind_cpp_pr0
     5: 00002020     0 NOTYPE  GLOBAL DEFAULT   14 __dso_handle
     6: 00001ee4     0 NOTYPE  GLOBAL DEFAULT    9 __INIT_ARRAY__
     7: 00001eec     0 NOTYPE  GLOBAL DEFAULT   10 __FINI_ARRAY__
     8: 0000201f     0 NOTYPE  GLOBAL DEFAULT  ABS _edata
     9: 0000201f     0 NOTYPE  GLOBAL DEFAULT  ABS __bss_start
    10: 00002030     0 NOTYPE  GLOBAL DEFAULT  ABS _end

case 2，修改Android.mk使用LOCAL_WHOLE_STATIC_LIBRARIES 宏，这个时候libstone_2.cpp中的hello要改成hello2，因为libstone_1里面的东西全部链接进来了：

readelf -Ws system/lib/libstone_2.so 
Symbol table '.dynsym' contains 16 entries:
   Num:    Value  Size Type    Bind   Vis      Ndx Name
     0: 00000000     0 NOTYPE  LOCAL  DEFAULT  UND 
     1: 0000037d    20 FUNC    GLOBAL DEFAULT    7 _Z6func_3v
     2: 0000201f    31 OBJECT  GLOBAL DEFAULT   13 hello
     3: 00000000     0 FUNC    GLOBAL DEFAULT  UND __aeabi_unwind_cpp_pr0
     4: 00002000    31 OBJECT  GLOBAL DEFAULT   13 hello2
     5: 00000390    12 FUNC    GLOBAL DEFAULT    7 __on_dlclose
     6: 00000000     0 FUNC    GLOBAL DEFAULT  UND __cxa_finalize
     7: 00002070     0 NOTYPE  GLOBAL DEFAULT   14 __dso_handle
     8: 00001ee0     0 NOTYPE  GLOBAL DEFAULT    9 __INIT_ARRAY__
     9: 00001ee8     0 NOTYPE  GLOBAL DEFAULT   10 __FINI_ARRAY__
    10: 000003a1    16 FUNC    GLOBAL DEFAULT    7 _Z6func_1v
    11: 00002052    20 OBJECT  GLOBAL DEFAULT   13 str_3
    12: 0000203e    20 OBJECT  GLOBAL DEFAULT   13 str_2
    13: 00002066     0 NOTYPE  GLOBAL DEFAULT  ABS _edata
    14: 00002066     0 NOTYPE  GLOBAL DEFAULT  ABS __bss_start
    15: 00002080     0 NOTYPE  GLOBAL DEFAULT  ABS _end

case 2，仍使用LOCAL_STATIC_LIBRARIES宏，libstone_2.cpp的代码修改为：

char hello2[] = "this is a string in libstone_2";

extern char str_2[];

void func_3(){str_2[0]+=1;}

这个时候readelf的结果是：

readelf -Ws system/lib/libstone_2.so 
Symbol table '.dynsym' contains 16 entries:
   Num:    Value  Size Type    Bind   Vis      Ndx Name
     0: 00000000     0 NOTYPE  LOCAL  DEFAULT  UND 
     1: 0000037d    20 FUNC    GLOBAL DEFAULT    7 _Z6func_3v
     2: 0000201f    31 OBJECT  GLOBAL DEFAULT   13 hello
     3: 00000000     0 FUNC    GLOBAL DEFAULT  UND __aeabi_unwind_cpp_pr0
     4: 00002000    31 OBJECT  GLOBAL DEFAULT   13 hello2
     5: 00000390    12 FUNC    GLOBAL DEFAULT    7 __on_dlclose
     6: 00000000     0 FUNC    GLOBAL DEFAULT  UND __cxa_finalize
     7: 00002070     0 NOTYPE  GLOBAL DEFAULT   14 __dso_handle
     8: 00001ee0     0 NOTYPE  GLOBAL DEFAULT    9 __INIT_ARRAY__
     9: 00001ee8     0 NOTYPE  GLOBAL DEFAULT   10 __FINI_ARRAY__
    10: 000003a1    16 FUNC    GLOBAL DEFAULT    7 _Z6func_1v
    11: 00002052    20 OBJECT  GLOBAL DEFAULT   13 str_3
    12: 0000203e    20 OBJECT  GLOBAL DEFAULT   13 str_2
    13: 00002066     0 NOTYPE  GLOBAL DEFAULT  ABS _edata
    14: 00002066     0 NOTYPE  GLOBAL DEFAULT  ABS __bss_start
    15: 00002080     0 NOTYPE  GLOBAL DEFAULT  ABS _end
可以看到，不仅仅是被引用到的str_2，所有在libstone_1中的global变量都被链接到libstone_2中。

所以可以得到如下的结论：

是否链接到调用者模块	使用了静态库的global变量	不使用
LOCAL_STATIC_LIBRARIES	Y	N
LOCAL_WHOLE_STATIC_LIBRARIES	Y	Y

至于android的编译系统是怎么处理这两个宏的，在./build目录发现其实使用了gcc的参数来区分(in core/definitions.mk )：

1161         -Wl,--whole-archive 
1162         $(call normalize-host-libraries,$(PRIVATE_ALL_WHOLE_STATIC_LIBRARIES))
1163         -Wl,--no-whole-archive 
1164         $(if $(PRIVATE_GROUP_STATIC_LIBRARIES),-Wl$(comma)--start-group)

综上所述，audio_policy.xxx.so这个policy库使用的是自己的audio_policy_hal.cpp源文件。

原文地址：http://blog.csdn.net/darkengine/article/details/9720131#