NXP

Makefile写法

2019-07-12 13:58发布

站内文章 / NXP MCU
14277 0 1060
android里makefile的写法
(1)Android.mk文件首先需要指定LOCAL_PATH变量，用于查找源文件,宏函数’my-dir’, 由编译系统提供。由于一般情况下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:指该模块在 所有版本下都编译，默认是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)：
  1. LOCAL_PATH:= $(call my-dir)
  2. include $(CLEAR_VARS)  模块一
  3. ifeq ($(AUDIO_POLICY_TEST),true)
  4.   ENABLE_AUDIO_DUMP := true
  5. endif
  6. LOCAL_SRC_FILES:=
  7.     AudioHardwareGeneric.cpp
  8.     AudioHardwareStub.cpp
  9.     AudioHardwareInterface.cpp
  10. ifeq ($(ENABLE_AUDIO_DUMP),true)
  11.   LOCAL_SRC_FILES += AudioDumpInterface.cpp
  12.   LOCAL_CFLAGS += -DENABLE_AUDIO_DUMP
  13. endif
  14. LOCAL_SHARED_LIBRARIES :=
  15.     libcutils
  16.     libutils
  17.     libbinder
  18.     libmedia
  19.     libhardware_legacy
  20. ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  21.   LOCAL_CFLAGS += -DGENERIC_AUDIO
  22. endif
  23. LOCAL_MODULE:= libaudiointerface
  24. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  25.   LOCAL_SRC_FILES += A2dpAudioInterface.cpp
  26.   LOCAL_SHARED_LIBRARIES += liba2dp
  27.   LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  28.   LOCAL_C_INCLUDES += $(call include-path-for, bluez)
  29. endif
  30. include $(BUILD_STATIC_LIBRARY)  模块一编译成静态库
  31. include $(CLEAR_VARS)  模块二
  32. LOCAL_SRC_FILES:=               
  33.     AudioPolicyManagerBase.cpp
  34. LOCAL_SHARED_LIBRARIES :=
  35.     libcutils
  36.     libutils
  37.     libmedia
  38. ifeq ($(TARGET_SIMULATOR),true)
  39. LOCAL_LDLIBS += -ldl
  40. else
  41. LOCAL_SHARED_LIBRARIES += libdl
  42. endif
  43. LOCAL_MODULE:= libaudiopolicybase
  44. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  45.   LOCAL_CFLAGS += -DWITH_A2DP
  46. endif
  47. ifeq ($(AUDIO_POLICY_TEST),true)
  48.   LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
  49. endif
  50. include $(BUILD_STATIC_LIBRARY) 模块二编译成静态库
  51. include $(CLEAR_VARS) 模块三
  52. LOCAL_SRC_FILES:=               
  53.     AudioFlinger.cpp            
  54.     AudioMixer.cpp.arm         
  55.     AudioResampler.cpp.arm      
  56.     AudioResamplerSinc.cpp.arm  
  57.     AudioResamplerCubic.cpp.arm
  58.     AudioPolicyService.cpp
  59. LOCAL_SHARED_LIBRARIES :=
  60.     libcutils
  61.     libutils
  62.     libbinder
  63.     libmedia
  64.     libhardware_legacy
  65. ifeq ($(strip $(BOARD_USES_GENERIC_AUDIO)),true)
  66.   LOCAL_STATIC_LIBRARIES += libaudiointerface libaudiopolicybase
  67.   LOCAL_CFLAGS += -DGENERIC_AUDIO
  68. else
  69.   LOCAL_SHARED_LIBRARIES += libaudio libaudiopolicy
  70. endif
  71. ifeq ($(TARGET_SIMULATOR),true)
  72. LOCAL_LDLIBS += -ldl
  73. else
  74. LOCAL_SHARED_LIBRARIES += libdl
  75. endif
  76. LOCAL_MODULE:= libaudioflinger
  77. ifeq ($(BOARD_HAVE_BLUETOOTH),true)
  78.   LOCAL_CFLAGS += -DWITH_BLUETOOTH -DWITH_A2DP
  79.   LOCAL_SHARED_LIBRARIES += liba2dp
  80. endif
  81. ifeq ($(AUDIO_POLICY_TEST),true)
  82.   LOCAL_CFLAGS += -DAUDIO_POLICY_TEST
  83. endif
  84. ifeq ($(TARGET_SIMULATOR),true)
  85.     ifeq ($(HOST_OS),linux)
  86.         LOCAL_LDLIBS += -lrt -lpthread
  87.     endif
  88. endif
  89. ifeq ($(BOARD_USE_LVMX),true)
  90.     LOCAL_CFLAGS += -DLVMX
  91.     LOCAL_C_INCLUDES += vendor/nxp
  92.     LOCAL_STATIC_LIBRARIES += liblifevibes
  93.     LOCAL_SHARED_LIBRARIES += liblvmxservice
  94. #    LOCAL_SHARED_LIBRARIES += liblvmxipc
  95. endif
  96. 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