Android MK文件

写在前面的，可以先阅读这块

https://developer.android.google.cn/ndk/guides/android_mk

https://blog.csdn.net/zhandoushi1982/article/details/5316669

1、什么是Android.mk文件？

一个Android.mk file用来向编译系统描述你的源代码。具体来说：该文件是GNU Makefile的一小部分，会被编译系统解析一次或多次。你可以在每一个Android.mk file中定义一个或多个模块。每个模块属下列类型之一：
  1）APK程序，一般的Android程序，编译打包生成apk文件
  2）JAVA库，java类库，编译打包生成jar文件
  3)  C\C++应用程序，可执行的C\C++应用程序
  4）C\C++静态库，编译生成C\C++静态库，并打包成.a文件
  5）C\C++共享库， 编译生成共享库（动态链接库），并打包成.so， 有且只有共享库才能被安装/复制到您的应用软件（APK）包中

2、Android.mk基础知识

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE
:= helloworld
LOCAL_SRC_FILES := helloworld.c
include $(BUILD_SHARED_LIBRARY)

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

LOCAL_PATH := $(call my-dir)

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

     2.include$（CLEAR_VARS） ：这块主要是清除一些多余的LOCAL_XXX变量，这是必要的，因为所有的编译控制文件都在同一个GNU MAKE执行环境中，所有的变量都是全局的。具体请看android官网解释

     3. LOCAL_MODULE: 这个模块叫啥名字，必须唯一

     4.LOCAL_SRC_FILES: 需要编译的源文件，包含将要编译打包进模块中的C或C++源代码文件

     5.最后一行帮助系统将一切连接到一起：BUILD_SHARED_LIBRARY 变量指向一个 GNU Makefile 脚本，该脚本会收集自最近 include 以来在 LOCAL_XXX 变量中定义的所有信息

3、Android.mk文件样式

3.1、vendor/mediatek/proprietary/hardware/mtkcam/main/hal/devicemgr/Android.mk

$(info devicemgr: HAL Version=$(CAMERA_HAL_VERSION))
ifneq ($(CAMERA_HAL_VERSION), 3)
LOCAL_PATH := $(call my-dir)

################################################################################
#
################################################################################
include $(CLEAR_VARS)

#-----------------------------------------------------------
-include $(TOP)/$(MTK_PATH_SOURCE)/hardware/mtkcam/mtkcam.mk

#-----------------------------------------------------------
LOCAL_SRC_FILES += CameraDeviceManagerBase.cpp
LOCAL_SRC_FILES += CameraDeviceManagerBase_utils.cpp
LOCAL_SRC_FILES += CameraDeviceManagerBase_torch.cpp
LOCAL_SRC_FILES += CameraDeviceManagerBase_camera.cpp

#-----------------------------------------------------------
LOCAL_C_INCLUDES += $(MTKCAM_C_INCLUDES)
LOCAL_C_INCLUDES += $(MTK_PATH_SOURCE)/hardware/mtkcam/include
#

#-----------------------------------------------------------
LOCAL_CFLAGS += $(MTKCAM_CFLAGS)
#
LOCAL_CFLAGS += -DLOG_TAG='"mtkcam-devicemgr"'
#

#-----------------------------------------------------------
LOCAL_WHOLE_STATIC_LIBRARIES +=
#
LOCAL_STATIC_LIBRARIES +=
#
#-----------------------------------------------------------
LOCAL_SHARED_LIBRARIES += libhidlbase

#-----------------------------------------------------------
LOCAL_EXPORT_C_INCLUDE_DIRS := $(LOCAL_PATH)

#-----------------------------------------------------------
LOCAL_MODULE := libmtkcam_devicemgrbase
LOCAL_MODULE_OWNER := mtk
LOCAL_PROPRIETARY_MODULE := true

#-----------------------------------------------------------
include $(MTK_STATIC_LIBRARY)


################################################################################
#
################################################################################
include $(call all-makefiles-under,$(LOCAL_PATH))
endif

 3.2、三种模板

A，编译C/C++应用程序的模板：

     #Test Exe
     LOCAL_PATH := $(call my-dir)
     include $(CLEAR_VARS)
     LOCAL_SRC_FILES:= main.c
     LOCAL_MODULE:= test_exe
     #LOCAL_C_INCLUDES :=
     #LOCAL_STATIC_LIBRARIES :=
     #LOCAL_SHARED_LIBRARIES :=
     include $(BUILD_EXECUTABLE)

BUILD_EXECUTABLE表示以一个可执行程序的方式进行编译。补充说明：include $(BUILD_PACKAGE)则是编译出一个apk，include $(BUILD_STATIC_JAVA_LIBRARY)则是编译出jar包。
B，编译静态库的模板：

     #Test Static Lib
     LOCAL_PATH := $(call my-dir)
     include $(CLEAR_VARS)
     LOCAL_SRC_FILES:= /
               helloworld.c
     LOCAL_MODULE:= libtest_static
     #LOCAL_C_INCLUDES :=
     #LOCAL_STATIC_LIBRARIES :=
     #LOCAL_SHARED_LIBRARIES :=
     include $(BUILD_STATIC_LIBRARY)

一般的和上面相似，BUILD_STATIC_LIBRARY表示编译一个静态库.a文件。静态库不会复制到的APK包中，但是能够用于编译共享库。
C，编译动态库的模板：

     #Test Shared Lib
     LOCAL_PATH := $(call my-dir)
     include $(CLEAR_VARS)
     LOCAL_SRC_FILES:= /
               helloworld.c
     LOCAL_MODULE:= libtest_shared
     TARGET_PRELINK_MODULES := false
     #LOCAL_C_INCLUDES :=
     #LOCAL_STATIC_LIBRARIES :=
     #LOCAL_SHARED_LIBRARIES :=
      include $(BUILD_SHARED_LIBRARY)

一般的和上面相似，BUILD_SHARED_LIBRARY表示编译一个动态库。
      以上三者的生成结果分别在如下，generic依具体target会变：
out/target/product/generic/obj/EXECUTABLE
out/target/product/generic/obj/STATIC_LIBRARY
out/target/product/generic/obj/SHARED_LIBRARY
      每个模块的目标文件夹分别为：
可执行程序：XXX_intermediates
静态库：      XXX_static_intermediates
动态库：      XXX_shared_intermediates

另外，在Android.mk文件中，还可以指定最后的目标安装路径，用LOCAL_MODULE_PATH和LOCAL_UNSTRIPPED_PATH来指定。不同的文件系统路径用以下的宏进行选择：
TARGET_ROOT_OUT：表示根文件系统out/target/product/xxxxx/root。
TARGET_OUT：表示system文件系统out/target/product/xxxx/system。
TARGET_OUT_DATA：表示data文件系统out/target/product/xxxx/data。

TARGET_OUT_SHARED_LIBRARIES：表示out/target/product/xxxx/system/lib

TARGET_OUT_APPS：表示out/target/product/xxxx/system/app

ANDROID_PRODUCT_OUT：out/target/product/xxxx/

TARGET_OUT_JAVA_LIBRARIES：out/target/product/xxxx/system/framework

PRODUCT_OUT：out\target\product\xxxxxxx\

TARGET_COPY_OUT_PRODUCT:system

TARGET_OUT_PRODUCT:out/target/product/xxxx/system

4、Android 文件在线项目中需要注意的点

代码编译过程中，可能会出现一些问题。这时候需要排查下问题，检查下编写的驱动文件、效果文件是否在mk文件的SRC_FILE里面

$(info "LOCAL_SRC_FILES $(LOCAL_SRC_FILES )")

//TODO 调试技巧，后面会逐步更新

5、参考文档

https://developer.android.google.cn/ndk/guides/android_mk

https://blog.csdn.net/zhandoushi1982/article/details/5316669