Android.mk解析

https://developer.android.com/ndk/guides/android_mk.html#over

LOCAL_STATIC_LIBRARIES

PREBUILT_STATIC_LIBRARY 与PREBUILT_SHARED_LIBRARY

---

静态库可生成共享库

Android.mk  文件必须首先定义  LOCAL_PATH  变量：

LOCAL_PATH := $(call my-dir)

此变量表示源文件在开发树中的位置。在这里，构建系统提供的宏函数  my-dir  将返回当前目录（包含  Android.mk  文件本身的目录）的路径。

下一行声明  CLEAR_VARS  变量，其值由构建系统提供。

include $(CLEAR_VARS)

CLEAR_VARS  变量可为您清除许多  LOCAL_XXX  变量，例如  LOCAL_MODULE 、 LOCAL_SRC_FILES  和  LOCAL_STATIC_LIBRARIES 。 不会清除  LOCAL_PATH 。

枚举源文件，以 空格分隔 多个文件：

LOCAL_SRC_FILES := hello-jni.c

LOCAL_SRC_FILES  变量必须包含要构建到模块中的 C 和/或 C++ 源文件列表。

定义自己的变量，建议在名称前附加  MY_ 。

PREBUILT_SHARED_LIBRARY:

这里的  LOCAL_SRC_FILES  值 不能是源文件 ，而必须是指向预建共享库的单一路径，例如  foo/libfoo.so

也可使用  LOCAL_PREBUILTS  变量引用另一个模块中的预建库。

务必使用 Unix 样式的正斜杠 (/)

---

LOCAL_CPP_FEATURES:  建议使用此变量，而不要直接在  LOCAL_CPPFLAGS  定义中启用  -frtti  和  -fexceptions 。使用此变量可让构建系统对 每个模块 使用适当的标志。使用  LOCAL_CPPFLAGS  会导致编译器对 所有模块 使用所有指定的标志

指明您的代码依赖于特定 C++ 功能。对于预构建的库，此变量还可声明二进制文件依赖哪些功能

描述值的 顺序不重要 。

---

LOCAL_C_INCLUDES:  include 搜索路径

在通过  LOCAL_CFLAGS  或  LOCAL_CPPFLAGS  设置任何对应的 include 标志之前定义此变量。

LOCAL_CFLAGS

在构建 C  和  C++ 源文件时要传递的编译器标志

在 android-ndk-1.5_r1 中，相应的标志只适用于 C 源文件，而不适用于 C++ 源文件。

使用  LOCAL_CPPFLAGS  只为 C++ 源文件指定标志

指定其他 include 路径：

LOCAL_CFLAGS += -I<path>, 但使用  LOCAL_C_INCLUDES  更好

---

LOCAL_STATIC_LIBRARIES

当前模块依赖的静态库模块列表

如果当前模块是共享库或可执行文件，此变量将强制这些库链接到生成的二进制文件

如果当前模块是静态库，表示依赖当前模块的模块 也会依赖 列出的库。

LOCAL_SHARED_LIBRARIES

模块在运行时依赖的共享库 模块 列表

LOCAL_WHOLE_STATIC_LIBRARIES

  LOCAL_STATIC_LIBRARIES  的变体，表示链接器应将相关的库模块视为 整个存档 。 如需了解有关整个存档的详细信息，请参阅 GNU 链接器关于  --whole-archive  标志的 文档 。

当多个静态库之间具有循环相依关系时，此变量很有用。 使用此变量构建 共享库 时，将会强制构建系统将所有对象文件从静态库添加到最终二进制文件。 但在生成可执行文件时不会发生这样的情况。

LOCAL_LDLIBS

构建 共享库 或可执行文件时的链接器标志列表，可让您使用  -l  前缀传递特定系统库的名称。 例如，以下示例指示链接器生成在加载时链接到  /system/lib/libz.so  的模块：

LOCAL_LDLIBS := -lz

如需了解此 NDK 版本中可以链接的 已公开系统库 列表，请参阅  Android NDK 原生 API 。

LOCAL_LDFLAGS

构建 共享库 或可执行文件时供构建系统使用的其他链接器标志列表

如果为静态库定义此变量，构建系统会忽略它，并且 ndk-build 会显示一则警告。

---

并非所有基于 ARMv7 的 CPU 都支持 NEON 指令集扩展。因此，必须执行运行时检测以便在运行时安全地使用此代码。 如需了解详细信息，请参阅  NEON 支持 和  cpufeatures 库 。

NDK 提供的函数宏

使用  $(call <function>)  对它们估值；它们返回文本信息。

all-subdir-makefiles

返回位于当前  my-dir  路径所有子目录中的  Android.mk  文件列表。

import-module

用于按模块的名称查找和 包含模块的  Android.mk  文件 的函数。 典型的示例如下所示：

$(call import-module,<name>)

在此示例中，构建系统查找  NDK_MODULE_PATH  环境变量引用的目录列表中以  <name>  标记的模块，并且 自动为您包含其 Android.mk  文件 。

http://android.mk/