Makefile写法

谁践踏了优雅 2022-03-12 20:06 249阅读 0赞

android里makefile的写法  
(1)[Android][].mk文件首先需要指定LOCAL\_PATH变量，用于查找源文件,宏函数’my-dir’, 由[编译系统][Link 1]提供。由于一般情况下Android.mk和需要编译的源文件在同一目录下，所以定义成如下形式：  
LOCAL\_PATH:=$(call my-dir)  
上面的语句的意思是 将LOCAL\_PATH变量定义成 本文件所在 目录路径。

一个 Android.mk中 可以 定义 多个编译模块，每个编译模块 都是 以include $(CLEAR\_VARS)开始  
以include $(BUILD\_XXX)结束。

BUILD\_PACKAGE 建立一个APK

include $(CLEAR\_VARS)  
CLEAR\_VARS由编译系统提供，指的是clear\_vars.mk，指定让GNU MAKEFILE为你 清除 除LOCAL\_PATH以外 的所有LOCAL\_XXX变量，  
如LOCAL\_MODULE，LOCAL\_SRC\_FILES，LOCAL\_SHARED\_LIBRARIES，LOCAL\_STATIC\_LIBRARIES等。

LOCAL\_MODULE:=xxx

生成的模块的名称(注意应用程序名称用LOCAL\_PACKAGE\_NAME，而不是LOCAL\_MODULE)，当 编译 动态库 或者 静态库 时，此变量 标示 库名称；

LOCAL\_SRC\_FILES，app的所有源码，可以 指定 具体的 文件，如果是java源码的话，可以调用all-java-files-under得到。  
LOCAL\_PACKAGE\_NAME，package的名字，这个名字在脚本中将标识这个app或package。

LOCAL\_MODULE\_TAGS := user eng tests optional

user: 指该模块只在user版本下才编译

eng: 指该模块只在eng版本下才编译

tests: 指该模块只在tests版本下才编译

optional:指该模块在 所有版本[下都][Link 2]编译，默认是optional

LOCAL\_CERTIFICATE := platform //指定  使用的哪种key 来给apk签名，platform 就是 指 用 platform.pk8和platform.x509.pem两个文件 来 签名。用这两个key签名后apk才真正可以放入系统进程中；  
  
LOCAL\_C\_INCLUDES:=include 这个是用来指定在编译时即将使用的c头文件的位置，以当前目录为起点。

include $(BUILD\_STATIC\_LIBRARY)表示编译成静态库，后缀为.a。  
include $(BUILD\_SHARED\_LIBRARY)表示编译成动态库，用来指示将当前模块编译为共享库，前缀为lib，后缀为.so。  
include $(BUILD\_EXECUTABLE)表示编译成可执行程序

（2）定义多个Android.mk文件。

有的时候，需要编译的模块比较多，我们可能会将对应的模块放置在相应的目录中，这样，我们可以在每个目录中定义对应的Android.mk文件（类似于上面的写法），最后，在根目录放置一个Android.mk文件，内容如下：  
　　include $(call all-subdir-makefiles)  
　　只需要这一行就可以了，它的作用就是包含所有子目录中的Android.mk文件

另一种 方法就是可以在一个Android.mk文件里包含多个模块。  
　　很直观的想法就是将第一个Android.mk文件的内容复制一份，然后修改。我最开始也是这样做的，但是后来出现问题了，在第二个模块中的源码找不到，最后还是看文档，发现里面已经有示例解释了：  
　　LOCAL\_PATH := $(call my-dir)  
　　大意是：在这个Android.mk里面只需要调用一次$(call my-dir)就够了，否则 会出错，如果所有的源文件都在一个目录中。  
　　如果需要的话，可以在第一次调用call my-dir的时候，将值保存下来，比如：  
　　MY\_LOCAL\_PATH := $(call my-dir)  
　　LOCAL\_PATH := $(MY\_LOCAL\_PATH)  
　　然后，在另外一个模块中，继续如下定义：  
　　LOCAL\_PATH := $(MY\_LOCAL\_PATH)

(3)简单 例子1 ，编译一个 普通apk

1 ifeq ($(BOARD\_USE\_DEFAULT\_APPINSTALL),true)   // 这一行 和 最后 一行 是 定义了 一个 开关BOARD\_USE\_DEFAULT\_APPINSTALL ，如果 这个 开关 为 true，那么就 执行 这个 makefile，这个开关 定义在 我的项目 device/amlogic/xxx/BoardConfig.mk 里， 如BOARD\_USE\_DEFAULT\_APPINSTALL := false  
  
  2 LOCAL\_PATH:= $(call my-dir) //LOCAL\_PATH必须位于Android.mk文件的最开始。它是用来定位源文件的位置，$(call my-dir)的作用就是返回当前目录的路径。  
  3 include $(CLEAR\_VARS) //作用是清除一些变量的值，但是LOCAL\_PATH除外  
  4 LOCAL\_MODULE\_TAGS := optional // optional:指该模块在 所有版本下都编译  
  5 LOCAL\_SRC\_FILES := $(call all-subdir-java-files) //用来指定参与编译的源代码文件  
  6 LOCAL\_PACKAGE\_NAME := AppInstaller //package的名字  
  7 LOCAL\_CERTIFICATE := platform //指定  使用的哪种key 来给apk签名，platform 就是 指 用 platform.pk8和platform.x509.pem两个文件 来 签名。用这两个key签名后apk才真正可以放入系统进程中；  
  8 include $(BUILD\_PACKAGE) //建立一个APK  
  9 endif

\-----------------------------------------------------

简单 例子 2，把 c文件 编译 为 共享库

一个简单的"hello world"，比如下面的文件：

sources/helloworld/helloworld.c

sources/helloworld/Android.mk

相应的Android.mk文件会象下面这样：

\---------- cut here ------------------

LOCAL\_PATH := $(call my-dir)

include $(CLEAR\_VARS)

LOCAL\_MODULE := helloworld

LOCAL\_SRC\_FILES := helloworld.c

include $(BUILD\_SHARED\_LIBRARY)

\---------- cut here ------------------

解释：

LOCAL\_MODULE变量必须定义，以标识你在Android.mk文件中描述的每个模块。名称必须是唯一的，而且不包含任何空格。注意编译系统会自动产生合适的前缀和后缀，换句话说，一个被命名为'foo'的共享库模块，将会生成'libfoo.so'文件。

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

====================================

举例如下(frameworks/base/libs/audioflinger/Android.mk)：

LOCAL_PATH:= $(call my-dir)
    include $(CLEAR_VARS)  模块一
    ifeq ($(AUDIO_POLICY_TEST),true)
      ENABLE_AUDIO_DUMP := true
    endif
    LOCAL_SRC_FILES:= \
        AudioHardwareGeneric.cpp \
        AudioHardwareStub.cpp \
        AudioHardwareInterface.cpp
    ifeq ($(ENABLE_AUDIO_DUMP),true)
      LOCAL_SRC_FILES += AudioDumpInterface.cpp
      LOCAL_CFLAGS += -DENABLE_AUDIO_DUMP
    endif
    LOCAL_SHARED_LIBRARIES := \
        libcutils \
        libutils \
        libbinder \
        libmedia \
        libhardware_legacy
    ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
      LOCAL_CFLAGS += -DGENERIC_AUDIO
    endif
    LOCAL_MODULE:= libaudiointerface
    ifeq ($(BOARD_HAVE_BLUETOOTH),true)
      LOCAL_SRC_FILES += A2dpAudioInterface.cpp
      LOCAL_SHARED_LIBRARIES += liba2dp
      LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
      LOCAL_C_INCLUDES += $(call include-path-for, bluez)
    endif
    include $(BUILD_STATIC_LIBRARY)  模块一编译成静态库
    include $(CLEAR_VARS)  模块二
    LOCAL_SRC_FILES:=               \
        AudioPolicyManagerBase.cpp
    LOCAL_SHARED_LIBRARIES := \
        libcutils \
        libutils \
        libmedia
    ifeq ($(TARGET_SIMULATOR),true)
    LOCAL_LDLIBS += -ldl
    else
    LOCAL_SHARED_LIBRARIES += libdl
    endif
    LOCAL_MODULE:= libaudiopolicybase
    ifeq ($(BOARD_HAVE_BLUETOOTH),true)
      LOCAL_CFLAGS += -DWITH_A2DP
    endif
    ifeq ($(AUDIO_POLICY_TEST),true)
      LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
    endif
    include $(BUILD_STATIC_LIBRARY) 模块二编译成静态库
    include $(CLEAR_VARS) 模块三
    LOCAL_SRC_FILES:=               \
        AudioFlinger.cpp            \
        AudioMixer.cpp.arm          \
        AudioResampler.cpp.arm      \
        AudioResamplerSinc.cpp.arm  \
        AudioResamplerCubic.cpp.arm \
        AudioPolicyService.cpp
    LOCAL_SHARED_LIBRARIES := \
        libcutils \
        libutils \
        libbinder \
        libmedia \
        libhardware_legacy
    ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
      LOCAL_STATIC_LIBRARIES += libaudiointerface libaudiopolicybase
      LOCAL_CFLAGS += -DGENERIC_AUDIO
    else
      LOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
    endif
    ifeq ($(TARGET_SIMULATOR),true)
    LOCAL_LDLIBS += -ldl
    else
    LOCAL_SHARED_LIBRARIES += libdl
    endif
    LOCAL_MODULE:= libaudioflinger
    ifeq ($(BOARD_HAVE_BLUETOOTH),true)
      LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
      LOCAL_SHARED_LIBRARIES += liba2dp
    endif
    ifeq ($(AUDIO_POLICY_TEST),true)
      LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
    endif
    ifeq ($(TARGET_SIMULATOR),true)
        ifeq ($(HOST_OS),linux)
            LOCAL_LDLIBS += -lrt -lpthread
        endif
    endif
    ifeq ($(BOARD_USE_LVMX),true)
        LOCAL_CFLAGS += -DLVMX
        LOCAL_C_INCLUDES += vendor/nxp
        LOCAL_STATIC_LIBRARIES += liblifevibes
        LOCAL_SHARED_LIBRARIES += liblvmxservice
    #    LOCAL_SHARED_LIBRARIES += liblvmxipc
    endif
    include $(BUILD_SHARED_LIBRARY) 模块三编译成动态库

(4)编译一个应用程序(APK)

1.  LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# Build all java files in the java subdirectory-->直译（建立在java子目录中的所有Java文件）
5.    LOCAL\_SRC\_FILES := $(call all-subdir-java-files)
6.     
7.    \# Name of the APK to build-->直译（创建APK的名称）
8.    LOCAL\_PACKAGE\_NAME := LocalPackage
9.     
10.   \# Tell it to build an APK-->直译（告诉它来建立一个APK）
11.   include $(BUILD\_PACKAGE)

(5)编译一个依赖于静态Java库(static.jar)的应用程序

1.  LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# List of static libraries to include in the package
5.    LOCAL\_STATIC\_JAVA\_LIBRARIES := static-library
6.     
7.    \# Build all java files in the java subdirectory
8.    LOCAL\_SRC\_FILES := $(call all-subdir-java-files)
9.     
10.   \# Name of the APK to build
11.   LOCAL\_PACKAGE\_NAME := LocalPackage
12.    
13.   \# Tell it to build an APK
14.   include $(BUILD\_PACKAGE)

(6)编译一个需要用平台的key签名的应用程序

1.  LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# Build all java files in the java subdirectory
5.    LOCAL\_SRC\_FILES := $(call all-subdir-java-files)
6.     
7.    \# Name of the APK to build
8.    LOCAL\_PACKAGE\_NAME := LocalPackage
9.     
10.   LOCAL\_CERTIFICATE := platform
11.    
12.   \# Tell it to build an APK
13.   include $(BUILD\_PACKAGE)

(7)编译一个需要用特定key前面的应用程序

1.    LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# Build all java files in the java subdirectory
5.    LOCAL\_SRC\_FILES := $(call all-subdir-java-files)
6.     
7.    \# Name of the APK to build
8.    LOCAL\_PACKAGE\_NAME := LocalPackage
9.     
10.   LOCAL\_CERTIFICATE := vendor/example/certs/app
11.    
12.   \# Tell it to build an APK
13.   include $(BUILD\_PACKAGE)

(8)添加一个预编译应用程序

1.  LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# Module name should match apk name to be installed.
5.    LOCAL\_MODULE := LocalModuleName
6.    LOCAL\_SRC\_FILES := $(LOCAL\_MODULE).apk
7.    LOCAL\_MODULE\_CLASS := APPS
8.    LOCAL\_MODULE\_SUFFIX := $(COMMON\_ANDROID\_PACKAGE\_SUFFIX)
9.     
10.   include $(BUILD\_PREBUILT)

(9)添加一个静态JAVA库

1.    LOCAL\_PATH := $(call my-dir)
2.    include $(CLEAR\_VARS)
3.     
4.    \# Build all java files in the java subdirectory
5.    LOCAL\_SRC\_FILES := $(call all-subdir-java-files)
6.     
7.    \# Any libraries that this library depends on
8.    LOCAL\_JAVA\_LIBRARIES := android.test.runner
9.     
10.   \# The name of the jar file to create
11.   LOCAL\_MODULE := sample
12.    
13.   \# Build a static jar file.
14.   include $(BUILD\_STATIC\_JAVA\_LIBRARY)

(10)Android.mk的编译模块中间可以定义相关的编译内容，也就是指定相关的变量如下：

LOCAL\_AAPT\_FLAGS

LOCAL\_ACP\_UNAVAILABLE

LOCAL\_ADDITIONAL\_JAVA\_DIR   
  
LOCAL\_AIDL\_INCLUDES

LOCAL\_ALLOW\_UNDEFINED\_SYMBOLS

LOCAL\_ARM\_MODE

LOCAL\_ASFLAGS

LOCAL\_ASSET\_DIR

LOCAL\_ASSET\_FILES 在Android.mk文件中编译应用程序(BUILD\_PACKAGE)时设置此变量，表示资源文件，  
                  通常会定义成LOCAL\_ASSET\_FILES += $(call find-subdir-assets)  
  
LOCAL\_BUILT\_MODULE\_STEM    
LOCAL\_C\_INCLUDES 额外的C/C++编译头文件路径，用LOCAL\_PATH表示本文件所在目录  
                 举例如下：  
                 LOCAL\_C\_INCLUDES += extlibs/zlib-1.2.3  
                 LOCAL\_C\_INCLUDES += $(LOCAL\_PATH)/src   
  
LOCAL\_CC 指定C编译器

LOCAL\_CERTIFICATE  签名认证

LOCAL\_CFLAGS 为C/C++编译器定义额外的标志(如宏定义)，举例：LOCAL\_CFLAGS += -DLIBUTILS\_NATIVE=1  
  
LOCAL\_CLASSPATH

LOCAL\_COMPRESS\_MODULE\_SYMBOLS

LOCAL\_COPY\_HEADERS install应用程序时需要复制的头文件，必须同时定义LOCAL\_COPY\_HEADERS\_TO  
  
LOCAL\_COPY\_HEADERS\_TO install应用程序时复制头文件的目的路径

LOCAL\_CPP\_EXTENSION 如果你的C++文件不是以cpp为文件后缀，你可以通过LOCAL\_CPP\_EXTENSION指定C++文件后缀名  
                    如：LOCAL\_CPP\_EXTENSION := .cc  
                    注意统一模块中C++文件后缀必须保持一致。

LOCAL\_CPPFLAGS 传递额外的标志给C++编译器，如：LOCAL\_CPPFLAGS += -ffriend-injection

LOCAL\_CXX 指定C++编译器  
  
LOCAL\_DX\_FLAGS

LOCAL\_EXPORT\_PACKAGE\_RESOURCES

LOCAL\_FORCE\_STATIC\_EXECUTABLE 如果编译的可执行程序要进行静态链接(执行时不依赖于任何动态库)，则设置LOCAL\_FORCE\_STATIC\_EXECUTABLE:=true  
                              目前只有libc有静态库形式，这个只有文件系统中/sbin目录下的应用程序会用到，这个目录下的应用程序在运行时通常  
                              文件系统的其它部分还没有加载，所以必须进行静态链接。  
  
LOCAL\_GENERATED\_SOURCES  
  
LOCAL\_INSTRUMENTATION\_FOR

LOCAL\_INSTRUMENTATION\_FOR\_PACKAGE\_NAME

LOCAL\_INTERMEDIATE\_SOURCES

LOCAL\_INTERMEDIATE\_TARGETS

LOCAL\_IS\_HOST\_MODULE

LOCAL\_JAR\_MANIFEST

LOCAL\_JARJAR\_RULES

LOCAL\_JAVA\_LIBRARIES 编译java应用程序和库的时候指定包含的java类库，目前有core和framework两种  
                     多数情况下定义成：LOCAL\_JAVA\_LIBRARIES := core framework  
                     注意LOCAL\_JAVA\_LIBRARIES不是必须的，而且编译APK时不允许定义(系统会自动添加)  
  
LOCAL\_JAVA\_RESOURCE\_DIRS

LOCAL\_JAVA\_RESOURCE\_FILES

LOCAL\_JNI\_SHARED\_LIBRARIES

LOCAL\_LDFLAGS 传递额外的参数给连接器(务必注意参数的顺序)  
  
LOCAL\_LDLIBS 为可执行程序或者库的编译指定额外的库，指定库以"-lxxx"格式，举例：  
             LOCAL\_LDLIBS += -lcurses -lpthread  
             LOCAL\_LDLIBS += -Wl,-z,origin   
  
LOCAL\_MODULE 生成的模块的名称(注意应用程序名称用LOCAL\_PACKAGE\_NAME而不是LOCAL\_MODULE)

LOCAL\_MODULE\_PATH 生成模块的路径  
  
LOCAL\_MODULE\_STEM   
  
LOCAL\_MODULE\_TAGS 生成模块的标记   
  
LOCAL\_NO\_DEFAULT\_COMPILER\_FLAGS

LOCAL\_NO\_EMMA\_COMPILE

LOCAL\_NO\_EMMA\_INSTRUMENT

LOCAL\_NO\_STANDARD\_LIBRARIES

LOCAL\_OVERRIDES\_PACKAGES

LOCAL\_PACKAGE\_NAME //APK应用程序的名称

LOCAL\_POST\_PROCESS\_COMMAND  
  
LOCAL\_PREBUILT\_EXECUTABLES 预编译including $(BUILD\_PREBUILT)或者$(BUILD\_HOST\_PREBUILT)时所用,指定需要复制的可执行文件

LOCAL\_PREBUILT\_JAVA\_LIBRARIES

LOCAL\_PREBUILT\_LIBS 预编译including $(BUILD\_PREBUILT)或者$(BUILD\_HOST\_PREBUILT)时所用, 指定需要复制的库.

LOCAL\_PREBUILT\_OBJ\_FILES

LOCAL\_PREBUILT\_STATIC\_JAVA\_LIBRARIES    
  
LOCAL\_PRELINK\_MODULE 是否需要预连接处理(默认需要，用来做动态库优化)

LOCAL\_REQUIRED\_MODULES 指定模块运行所依赖的模块(模块安装时将会同步安装它所依赖的模块)  
  
LOCAL\_RESOURCE\_DIR

LOCAL\_SDK\_VERSION

LOCAL\_SHARED\_LIBRARIES 可链接动态库  
  
LOCAL\_SRC\_FILES 编译源文件

LOCAL\_STATIC\_JAVA\_LIBRARIES

LOCAL\_STATIC\_LIBRARIES 可链接静态库   
  
LOCAL\_UNINSTALLABLE\_MODULE

LOCAL\_UNSTRIPPED\_PATH  
  
LOCAL\_WHOLE\_STATIC\_LIBRARIES 指定模块所需要载入的完整静态库(这些精通库在链接是不允许链接器删除其中无用的代码)  
  
LOCAL\_YACCFLAGS  
  
OVERRIDE\_BUILT\_MODULE\_PATH

转自[https://blog.csdn.net/heng615975867/article/details/78874764][https_blog.csdn.net_heng615975867_article_details_78874764]

[Android]: http://www.apkbus.com/
[Link 1]: https://www.baidu.com/s?wd=%E7%BC%96%E8%AF%91%E7%B3%BB%E7%BB%9F&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[Link 2]: https://www.baidu.com/s?wd=%E4%B8%8B%E9%83%BD&tn=24004469_oem_dg&rsv_dl=gh_pl_sl_csd
[https_blog.csdn.net_heng615975867_article_details_78874764]: https://blog.csdn.net/heng615975867/article/details/78874764