Android.mk文件解析



一、一个简单的Android.mk文件如下:

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := native-interface

LOCAL_SRC_FILES := video.c \

adpcm.c \

audio.c \

sip.c \

network.c \

circular_queue.c \

native_interface.c

LOCAL_SHARED_LIBRARIES := libosip \

libexosip \

libavcodec \

libavutil \

libswscale

# LOCAL_SHARED_LIBRARIES := libavcodec \

# libavutil \

# libswscale

#需要链接的系统默认库

LOCAL_LDLIBS += -llog

LOCAL_LDLIBS += -lOpenSLES

LOCAL_LDLIBS += -landroid

include $(BUILD_SHARED_LIBRARY)

#添加外部导入库目录

$(call import-add-path, $(LOCAL_PATH))

#添加到入库

$(call import-module, libffmpeg)

$(call import-module, libosip)

$(call import-module, libexosip)

二、Android.mk文件作用

Android.mk文件是针对Android的Makefile文件.具体来说:该文件是GNU Makefile的一小部分,会被编译系统解析一次或多次。你可以在每一个Android.mk
file中定义一个或多个模块,你也可以在几个模块中使用同一个源代码文件。编译系统为你处理许多细节问题。

三、解析:

每一个编译模块都是由include
$(CLEAR_VARS)开始,到include $(BUILD_SHARED_LIBRARY)结束

1、include可以理解为执行

2、LOCAL_PATH
:= $(call my-dir) 设置LOCAL_PATH变量;my-dir为宏函数,由编译系统提供

类似的函数有:

  • $(call my-dir):获取当前文件夹路径。
  • $(call all-java-files-under,
    <src>)
    :获取指定目录下的所有 Java 文件。
  • $(call all-c-files-under,
    <src>)
    :获取指定目录下的所有 C 语言文件。
  • $(call all-Iaidl-files-under,
    <src>)
     :获取指定目录下的所有 AIDL 文件。
  • $(call all-makefiles-under,
    <folder>)
    :获取指定目录下的所有 Make 文件。
  • $(call intermediates-dir-for,
    <class>, <app_name>, <host or target>, <common?> )
    :获取 Build 输出的目标文件夹路径。

3、$(call <function>)

GNU Make‘功能’宏,必须通过使用‘$(call <function>)‘来求值,他们返回文本化的信息。

    1)my-dir

返回当前Android.mk所在的目录路径,相对于NDK编译系统的顶层。这是有用的,在Android.mk文件的开头如此定义:

LOCAL_PATH := $(call my-dir)

    2)all-subdir-makefiles

返回一个位于当前‘my-dir‘路径的子目录列表。例如,看下面的目录层次:

sources/foo/Android.mk

sources/foo/lib1/Android.mk

sources/foo/lib2/Android.mk

如果sources/foo/Android.mk包含一行:

include $(call all-subdir-makefiles)

那么它就会自动包含sources/foo/lib1/Android.mk 和sources/foo/lib2/Android.mk

这项功能用于向编译系统提供深层次嵌套的代码目录层次。注意,在默认情况下,NDK将会只搜索在sources/*/Android.mk中的文件。

    3)this-makefile

返回当前Makefile的路径(即这个函数调用的地方)

    4)parent-makefile

返回调用树中父Makefile路径。即包含当前Makefile的Makefile路径。

    5)grand-parent-makefile

4、include
$(CLEAR_VARS)

CLEAR_VARS定义在/build/core/clear_vars.mk中,用以清除许多LOCAL变量。因为这些变量往往都是全局的,故需要对其进行清除;而其通常也被认为是一个便以模块的开始标志。

5、一些重要变量设置

  • LOCAL_SRC_FILES:当前模块包含的所有源代码文件。
  • LOCAL_MODULE:当前模块的名称,这个名称应当是唯一的,模块间的依赖关系就是通过这个名称来引用的。
  • LOCAL_C_INCLUDES:C 或 C++ 语言需要的头文件的路径。
  • LOCAL_STATIC_LIBRARIES:当前模块在静态链接时需要的库的名称。
  • LOCAL_SHARED_LIBRARIES:当前模块在运行时依赖的动态库的名称。
  • LOCAL_CFLAGS:提供给 C/C++ 编译器的额外编译参数。
  • LOCAL_JAVA_LIBRARIES:当前模块依赖的 Java 共享库。
  • LOCAL_STATIC_JAVA_LIBRARIES:当前模块依赖的 Java 静态库。
  • LOCAL_PACKAGE_NAME:当前 APK 应用的名称。
  • LOCAL_CERTIFICATE:签署当前应用的证书名称。
  • LOCAL_MODULE_TAGS:当前模块所包含的标签,一个模块可以包含多个标签。标签的值可能是 debug, eng, user,development 或者 optional。其中,optional 是默认标签。标签是提供给编译类型使用的。不同的编译类型会安装包含不同标签的模块,关于编译类型的说明如表
    7 所示:

6、LOCAL_SRC_FILES

    LOCAL_SRC_FILES变量必须包含将要编译打包进模块中的C或C++源代码文件。注意,你不用在这里列出头文件和包含文件,因为编译系统将会自动为你找出依赖型的文件;仅仅列出直接传递给编译器的源代码文件就好。

7、include
$(BUILD_SHARED_LIBRARY)表示该编译模块希望生成的文件状态。

 
  BUILD_SHARED_LIBRARY
是编译系统提供的变量,指向一个GNU Makefile脚本(应该就是在build/core目录下的shared_library.mk),负责收集自从上次调用‘include
$(CLEAR_VARS)‘以来,定义在LOCAL_XXX变量中的所有信息,并且决定编译什么,如何正确地去做。并根据其规则生成静态库。

类似的BUILD_XXX变量还有:

  • BUILD_SHARED_LIBRARY
  • BUILD_STATIC_LIBRARY
  • BUILD_EXECUTABLE
  • BUILD_PACKAGE
  • BUILD_JAVA_LIBRARY等

8、另外在Android.mk文件中,还可以指定最后的目标安装路径,用LOCAL_MODULE_PATH和LOCAL_UNSTRIPPED_PATH来指定。不同的文件系统路径用以下的宏进行选择:

  • TARGET_ROOT_OUT:表示根文件系统。
  • TARGET_OUT:表示system文件系统。
  • TARGET_OUT_DATA:表示data文件系统。

用法如:

LOCAL_MODULE_PATH:=$(TARGET_ROOT_OUT)

时间: 2024-11-05 23:24:57

Android.mk文件解析的相关文章

基于Android2.3.5系统:Android.mk文件解析

*************************************************************************************************************************** 作者:EasyWave                                                                                                               时间:2

Android下Android.mk文件解析

1 概述 大家都知道在Linux下编辑经常要写一个Makefile文件, 可以把这个Makefile文件理解成一个编译配置文件,它保存着如何编译的配置信息,即指导编译器如何来编译程序,并决定编译的结果是什么.而在Android下的Android.mk文件也是类型的功能,顾名思义,从名字上就可以猜测得到,Android.mk文件是针对Android的Makefile文件.具体来说:该文件是GNU Makefile的一小部分,会被编译系统解析一次或多次.你可以在每一个Android.mk file中

Android.mk文件语法规范及使用模板

Android.mk文件语法规范 根据eoeandroid上的的连载,进行一些更新.修改和加亮. 今天翻译ANDROID-MK.TXT文件(英文原文件在/development/Ndk/Docs/android-mk.txt) Android.mk文件语法规范 Introduction: Android.mk编译文件是用来向Android NDK描述你的C,C++源代码文件的, 这篇文档描述了它的语法.在阅读下面的内容之前,假定你已经阅读了docs/OVERVIEW.TXT文件,了解了它们的脚色

Android.mk文件详解

Android.mk文件是GNU Makefile的一小部分,它用来对Android程序进行编译. 因为所有的编译文件都在同一个 GNU MAKE 执行环境中进行执行,而Android.mk中所有的变量都是全局的.因此,您应尽量少声明变量,不要认为某些变量在解析过程中不会被定义. 一个Android.mk文件可以编译多个模块,每个模块属下列类型之一: 1)APK程序 一般的Android程序,编译打包生成apk文件 2)JAVA库 java类库,编译打包生成jar文件 3)C\C++应用程序 可

Android.mk 文件语法指南

1 前言 本文档描述了c和c++编写的程序用Android NDK编译时,编译文件Android.mk的语法结构.为了便于理解下面的内容,假设你已经阅读了前面OVERVIEW部分,了解了它们的作用和用法. 2 概要 Android.mk是用来描述源文件是如何进行编译的.更具体的:-Android.mk实际上是一个轻量级的Makefile,它会被编译系统解析一次或多次.因此,你应该尽可能少的声明变量,同时不要假定在解析过程中没有定义任何东西.-Android.mk是用来允许你将源文件组织在一个'm

Android.mk文件的语法解析

这是RDA8810(Android4.2.2)的Browser模块的Android.mk文件 LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE_TAGS := optional LOCAL_STATIC_JAVA_LIBRARIES := \ android-common \ guava \ android-support-v13 \ android-support-v4 \ LOCAL_SRC_FILES := \

quick cocos 或者 Cocos2dx 项目下的Android.mk文件的学习

android.mk文件的作用:编译需要的cpp文件,生成.so动态库,供android端调用. 先上一个android.mk文件: 第一次创建项目,在Android平台编译时,都需要通过android.mk文件编译整个cocos2dx的库(第一次编译我们需要等待很长的时间.....). 首先知道$(call import-module,dir_name)的作用,然后顺着lib/proj.android目录继续找对应目录下的android.mk文件 类似于递归一样,把所有目录下的android.

Android.mk文件简单分析

Android.mk文件简单分析 一个Android.mk文件用来向编译系统描述需要编译的源代码.具体来说:该文件是GNUMakefile的一小部分,会被编译系统解析一次或多次.可以在每一个Android.mk中定义一个或多个模块,也可以在几个模块中使用同一个源代码文件. 每个模块属下列类型之一: 1)APK程序,一般的Android程序,编译打包生成apk文件 2)JAVA库,java类库,编译打包生成jar文件 3)  C\C++应用程序,可执行的C\C++应用程序 4)C\C++静态库,编

Android.mk 文件语法详解

转:http://blog.sina.com.cn/s/blog_602f8770010148ce.html ===================================================================================== 0. Android.mk简介: Android.mk文件用来告知NDK Build 系统关于Source的信息. Android.mk将是GNU Makefile的一部分,且将被Build System解析一次或多次