Android.mk的用法
前言
Android.mk文件是 Android 编译系统中用于描述项目源文件、库和模块的 Makefile。它采用 GNU Make 的语法，但也包含了一些特定于 Android 编译系统的规则和变量。以下是对其语法和使用方法的详细解释及示例。
一：模块种类
一个Android.mk file用来向编译系统描述你的源代码。具体来说：该文件是GNU Makefile的一小部分，会被编译系统解析一次或多次。你可以在每一个Android.mk file中定义一个或多个模块（具体类型取决于模块的功能和构建输出）。按类型主要有以下种类：
-
共享库 (Shared Libraries)：
- 模块输出一个共享库（动态链接库），可以被其他模块在运行时动态加载。
- 使用
include $(BUILD_SHARED_LIBRARY)包含构建规则。
-
静态库 (Static Libraries)：
- 模块输出一个静态库，编译时将其链接到其他模块。
- 使用
include $(BUILD_STATIC_LIBRARY)包含构建规则。
-
可执行文件 (Executables)：
- 模块输出一个可执行文件。
- 使用
include $(BUILD_EXECUTABLE)包含构建规则。
-
预编译库 (Prebuilt Libraries)：
- 模块使用预编译的库，而不是源代码编译的库。
- 预编译共享库使用
include $(PREBUILT_SHARED_LIBRARY)。 - 预编译静态库使用
include $(PREBUILT_STATIC_LIBRARY)。
-
Java 库 (Java Libraries)：
- 模块输出一个 Java 库（.jar 文件）。
- 使用
include $(BUILD_STATIC_JAVA_LIBRARY)或include $(BUILD_SHARED_JAVA_LIBRARY)。
-
Android 应用 (Android Applications)：
- 模块输出一个 Android 应用（.apk 文件）。
- 使用
include $(BUILD_PACKAGE)。
-
多媒体插件 (Multimedia Plugins)：
- 模块输出一个多媒体插件，通常用于媒体框架中。
- 使用
include $(BUILD_PLUGIN)。
-
静态预编译头文件 (Static Prebuilt Headers)：
- 模块使用预编译的头文件。
- 使用
include $(BUILD_PREBUILT)。
-
测试模块 (Test Modules)：
- 模块输出用于测试的可执行文件或库。
- 例如 Google Test 使用
include $(BUILD_NATIVE_TEST)。
二：各模块示例
共享库
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_shared_lib
LOCAL_SRC_FILES := my_shared_lib.cpp
include $(BUILD_SHARED_LIBRARY)
静态库
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_static_lib
LOCAL_SRC_FILES := my_static_lib.cpp
include $(BUILD_STATIC_LIBRARY)
可执行文件
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_executable
LOCAL_SRC_FILES := main.cpp
include $(BUILD_EXECUTABLE)
预编译共享文件
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := prebuilt_shared_lib
LOCAL_SRC_FILES := $(LOCAL_PATH)/libs/$(TARGET_ARCH_ABI)/libprebuilt.so
include $(PREBUILT_SHARED_LIBRARY)
java静态库
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_java_lib
LOCAL_SRC_FILES := $(call all-java-files-under, src)
include $(BUILD_STATIC_JAVA_LIBRARY)
Android应用
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_app
LOCAL_SRC_FILES := $(call all-subdir-java-files)
LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res
include $(BUILD_PACKAGE)
多媒体插件
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_plugin
LOCAL_SRC_FILES := plugin.cpp
include $(BUILD_PLUGIN)
静态预编译头文件
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := prebuilt_header
LOCAL_SRC_FILES := $(LOCAL_PATH)/include/prebuilt_header.h
include $(BUILD_PREBUILT)
Google Test模块
LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)
LOCAL_MODULE := my_test
LOCAL_SRC_FILES := test.cpp
LOCAL_STATIC_LIBRARIES := gtest
include $(BUILD_NATIVE_TEST)
通过这些示例，可以看到 Android.mk 文件可以配置各种类型的模块，每种类型都有其特定的构建规则和变量配置。根据项目需求选择合适的模块类型，配置相应的构建规则，可以有效地管理和构建 Android 项目。
下面是一个综合示例（包含一些不常用的语法）：
# 获取当前目录
LOCAL_PATH := $(call my-dir) # 获取当前 Android.mk 文件所在的路径# ========== 模块 1: 共享库 ==========
include $(CLEAR_VARS) # 清除以前定义的所有 LOCAL_ 变量
LOCAL_MODULE := mysharedlibrary # 定义共享库模块名称为 mysharedlibrary
LOCAL_SRC_FILES := main.cpp util.cpp # 指定共享库的源文件列表
LOCAL_C_INC