Android.mk 中常用“LOCAL_” 变量

编写模块的编译文件,实际就是定义一系列以“LOCAL_”开头的编译变量,因此我们有必要弄明白这些变量的具体含义。下面是一些经常使用的LOCAL_编译变量的说明:

变量名

说明

LOCAL_ASSET_FILES

编译APK文件时用于指定资源列表,通常写成

LOCAL_ASSET_FILES += $(call find-subdir-assets)。

LOCAL_CC

自定义C编译器来代替缺省的编译器。

LOCAL_CXX

自定义C++编译器来代替缺省的编译器。

LOCAL_CFLAGS

定义额外的C/C++编译器的参数。

LOCAL_CPPFLAGS

仅定义额外的C++编译器的参数,不用在C编译器中。

LOCAL_CPP_EXTENSION

自定义C++源文件的后缀。例如:LOCAL_CPP_EXTENSION := .cc

注意:一旦定义,模块中所有的源文件都必须使用该后缀,目前不支持混合后缀。

LOCAL_C_INCLUDES

指定头文件的搜索路径。

LOCAL_FORCE_STATIC_EXECUTABLE

如果编译时候需要链接的库有共享和静态两者共存的情况。设定此变量值为true将会优先链接静态库。通常这种情况只会在编译root/sbin目录下的应用才会用到,因为他们执行的时间比较早,文件系统的其他部分还没有加载。

LOCAL_GENERATED_SOURCES

指定由系统自动生成的文件列表。

LOCAL_MODULE_TAGS

定义模块标签,Build系统根据标签决定哪些模块被安装。

LOCAL_REQUIRED_MODULES

指定依赖的模块。一旦本模块被安装,通过此变量指定的模块也将被安装

LOCAL_JAVACFLAGS

定义额外的javac编译器的参数

LOCAL_JAVA_LIBRARIES

指定模块依赖的java共享库

LOCAL_LDFLAGS

定义链接器ld的参数

LOCAL_LDLIBS

指定模块链接时依赖的库。如果这些库文件不存在,并不会引发对它们的编译。这是此变量和LOCAL_SHARED_LIBRARIES的主要区别。

LOCAL_NO_MANIFEST

在一个资源apk中可以指定此变量为true,表示此apk文件没有AndroidManifest.xml文件。

LOCAL_PACKAGE_NAME

指定APP应用名称。

LOCAL_PATH

指定Android.mk文件所在的目录。

LOCAL_POST_PROCESS_COMMAND

在编译host相关的模块时,可以用此变量定义一条命令在link完成后执行。

LOCAL_PREBUILT_LIBS

指定预编译c/c++动态和静态库列表。用于预编译模块定义中。

LOCAL_PREBUILT_JAVA_LIBRARIES

指定预编译java库列表。用于预编译模块定义中。

LOCAL_SHARED_LIBRARIES

指定模块依赖的c/c++共享库列表。

LOCAL_SRC_FILES

指定源文件列表。

LOCAL_STATIC_LIBRARIES

指定依赖的c/c++静态库列表。

LOCAL_MODULE

除应用(apk)以LOCAL_PACKAGE_NAME指定模块名以外,其余的模块都以LOCAL_MODULE指定模块名。

LOCAL_MODULE_PATH

指定模块在目标系统的安装路径。

LOCAL_UNSTRIPPED_PATH

指定模块的unstripped 版本在out目录下的保存路径。

LOCAL_WHOLE_STATIC_LIBRARIES

这个变量也是定义了模块依赖的静态库列表,和LOCAL_STATIC_LIBRARIES类似。但是通过这个变量定义,链接时链接器不会将静态库中无人调用的代码去掉。

LOCAL_YACCFLAGS

指定yacc的参数。

LOCAL_ADDITIONAL_DEPENDENCIES

指定本模块的依赖。用在不方便使用别的方法来指定依赖关系时。

LOCAL_BUILT_MODULE

指定编译时存放中间文件的目录。

LOCAL_INSTALLED_MODULE

指定模块的安装路径。

LOCAL_MODULE_CLASS

定义模块的分类。根据分类,生成的模块文件会安装到目标系统相应的目录下。例如:APPS:安装到/system/app下;SHARED_LIBRARIES:安装到/system/lib下;EXECUTABLES:安装到/system/bin下;ETC:安装到/system/etc下;但是如果同时用LOCAL_MOULE_PATH定义了路径,则安装到该路径。

LOCAL_MODULE_NAME

指定模块的名称。但是目前系统中用到它的实例。

LOCAL_MODULE_SUFFIX

指定当前模块的后缀。一旦指定,系统在产生目标文件时,会以模块名加后缀来创建目标文件

LOCAL_STRIP_MODULE

指定模块是否需要被strip,该模块是可执行文件或动态库才能使用该变量。

LOCAL_STRIPPABLE_MODULE

此变量的值通常由Build系统设置,一般可执行文件和动态库被设为true。

LOCAL_SYSTEM_SHARED_LIBRARIES

此变量在编译系统的基本库,如:libc,libm,libdl时,用来定义这些库的依赖库。通常在应用模块定义中不应使用该变量。

LOCAL_PRELINK_MODULE

编译.so模块时,定义是否需要prelink。prelink是通过预链接的方式来加快程序启动速度。如果要设置此值为true,要先在build/core/prelink-linux-arm.map文件中定义该库的地址和大小,否则报错。但是在Android4.2以后的代码中找不到文件prelink-linux-arm.map了,在build目录下也搜寻不到这个变量。可能Android已经取消了prelink的功能。

参考:http://blog.sina.com.cn/s/blog_dae890d10101f01f.html

原文地址:https://www.cnblogs.com/tang-skillhunter/p/9133947.html