Android.mk文件语法规范详解.PDF

2012 年第12 期 Android.mk 文件语法规范详解 文/ 图 mangel 熟悉Linux 的朋友对mk 文件应该不陌生，在Android 系统中的NDK 编程同样涉及到这 个问题。Android.mk 编译文件是用来向Android NDK 描述C/C++源代码文件的，本文将重点 介绍其语法实现。 概述 Android.mk 文件用来向编译系统描述你的源代码。具体来说，该文件是 GNU Makefile 的一部分，会被编译系统解析一次或更多次的build 系统。因此，应尽量减少源码中声明的 变量，不要认为某些变量在解析过程中不会被定义。这个文件的语法允许把源代码组织成模 块，一个模块属于下列类型之一：静态库或共享库。只有共享库能被安装/复制到应用软件 包，静态库能被用于生成共享库。我们可以在每一个 Android.mk 文件中定义一个或多个模 块，也可以在几个模块中使用同一个源代码文件。 NDK 编译系统会自动处理许多细节问题。例如，我们不需要在Android.mk 中列出头文 件和依赖文件，在升级NDK 后，会得到新的toolchain/platform 支持，不需要改变Android.mk 文件。这个语法同公开发布的Android 平台的开源代码很接近，但编译系统实现它们的方式 却是不同的，这是有意这样设计的，可以让程序开发人员重用外部库的源代码更容易。 简单的例子 处 在描述语法细节之前，我们先看一个简单的hello world 的例子，比如下面的文件： 线 出 sources/helloworld/helloworld.c 防 sources/helloworld/Android.mk 明 客 helloworld.c 是一个 JNI 共享库，实现返回 hello world 字符串的原生方法。相应的 Android.mk 文件会像下面这样： 注 黑 请 LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) 载 LOCAL_MODULE:= helloworld LOCAL_SRC_FILES := helloworld.c include $(BUILD_SHARED_LIBRARY) 转 我们解释一下这几行代码。 LOCAL_PATH := $(call my-dir) ：一个Android.mk 文件首先必须定义好LOCAL_PATH 变量， 用于在开发树中查找源文件。在这个例子中，宏函数 my-dir 由编译系统提供，用于返回当 前路径（即包含Android.mk 文件的目录）。 include $( CLEAR_VARS) ：CLEAR_VARS 由编译系统提供，指定让GNU MAKEFILE 清除许多 LOCAL_XXX 变量（例如 LOCAL_MODULE、LOCAL_SRC_FILES、LOCAL_STATIC_LIBRARIES 等）， 除了LOCAL_PATH。这是必要的，因为所有的编译控制文件都在同一个GNU MAKE 执行环境 中，所有的变量都是全局的。 2012 年第12 期 LOCAL_MODULE := helloworld ：LOCAL_MODULE 变量必须定义，以标识在Android.mk 文 件中描述的每个模块。而且名称必须是唯一的，且不包含任何空格。编译系统会自动产生合 适的前缀和后缀，比如一个被命名为foo 的共享库模块，将会生成libfoo.so 文件。如果把库 命名为libhelloworld，编译系统将不会添加任何