Android.mk 详解

最新推荐文章于 2024-09-10 23:26:18 发布

byte轻骑兵

最新推荐文章于 2024-09-10 23:26:18 发布

阅读量989

点赞数 30

分类专栏： Android实战指南文章标签： android

本文链接：https://blog.csdn.net/weixin_37800531/article/details/142006168

版权

Android实战指南专栏收录该内容

7 篇文章 0 订阅

订阅专栏

Android.mk 文件是 Android 平台上的 Makefile 文件，用于定义 Android 应用或库中模块的编译方式。它是 Android NDK（Native Development Kit）的一部分，允许开发者使用 C 或 C++ 等原生语言来编写应用或库的某些部分。本文将简要介绍如何入门学习 Android.mk 文件的编写。

1. 基本结构

一个基本的 Android.mk 文件包含了对模块的定义，包括模块类型、源文件、包含的库等。其基本结构如下：

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

LOCAL_PATH：指定当前文件的路径。
include $(CLEAR_VARS)：清除之前定义的变量，准备定义新的模块。
LOCAL_MODULE：定义模块的名称，该名称是唯一的，且不包括文件扩展名。
LOCAL_SRC_FILES：指定模块的源文件列表，可以是一个或多个源文件。
include $(BUILD_SHARED_LIBRARY)：指定编译的模块类型，这里是编译为共享库（.so 文件）。

2. 指定模块类型

通过包含不同的 GNU Makefile 片段来指定模块的编译类型。常见的模块类型包括：

include $(BUILD_SHARED_LIBRARY)：编译为共享库（.so 文件）。
include $(BUILD_STATIC_LIBRARY)：编译为静态库（.a 文件）。
include $(BUILD_EXECUTABLE)：编译为可执行文件。

3. 变量赋值

在 Android.mk 文件中，变量用于存储配置信息，如源文件列表、模块名称、编译选项等。变量赋值使用 := 操作符，例如：

LOCAL_MODULE    := hello-jni  
LOCAL_SRC_FILES := hello-jni.c

这里，LOCAL_MODULE 被赋值为 hello-jni，LOCAL_SRC_FILES 被赋值为 hello-jni.c。

4. 清除变量

在定义新的模块之前，通常需要使用 include $(CLEAR_VARS) 来清除之前定义的变量，以避免变量之间的干扰。

include $(CLEAR_VARS)

5. 引入其他库

如果模块需要链接其他库（静态库或系统库），可以在 Android.mk 中使用 LOCAL_STATIC_LIBRARIES 或 LOCAL_SHARED_LIBRARIES 变量指定，或者通过 LOCAL_LDLIBS 变量指定系统库。

LOCAL_STATIC_LIBRARIES := libfoo libbar  
LOCAL_SHARED_LIBRARIES := libbaz  
LOCAL_LDLIBS += -llog

6. 定义条件编译

可以使用 ifeq、ifneq、else、endif 等条件语句来控制编译过程，根据条件包含或排除某些源文件或编译选项。

ifeq ($(TARGET_ARCH_ABI),armeabi-v7a)  
    LOCAL_SRC_FILES += arm_specific.c  
endif

7. 编译选项

可以在 Android.mk 文件中设置编译选项，如 C/C++ 标志、包含路径等：

LOCAL_C_INCLUDES：指定额外的 C/C++ 包含路径。
LOCAL_CFLAGS：指定 C 编译器标志。
LOCAL_CPPFLAGS：指定 C++ 编译器标志。

8. 链接选项

对于需要链接系统库或其他非标准库的情况，可以使用 LOCAL_LDLIBS 变量指定链接器选项：

LOCAL_LDLIBS += -llog

9. 导出变量

在某些情况下，可能需要在一个 Android.mk 文件中定义的变量在另一个 Android.mk 文件中也可见（例如在包含的子目录中）。这可以通过使用 include $(BUILD_XXX) 之前导出变量来实现，但更常见的是使用 include $(CLEAR_VARS) 后立即设置 include $(PREBUILT_XXX) 或其他特殊类型的模块，这些模块可能支持导出变量。

10. 编译多个源文件

如果模块包含多个源文件，可以在 LOCAL_SRC_FILES 中一次性列出所有文件。

LOCAL_SRC_FILES := main.c \  
                   helper.c \  
                   another_helper.c

11. 调试

使用 NDK 编译的应用或库可以在 Android 设备或模拟器上调试。可以通过 ndk-build 命令配合 gdbserver 和 gdb 客户端进行调试。

12. 示例

这是一个包含多个元素的 Android.mk 示例：

LOCAL_PATH := $(call my-dir)  
  
include $(CLEAR_VARS)  
  
LOCAL_MODULE    := hello-jni  
LOCAL_SRC_FILES := hello-jni.c  
LOCAL_SHARED_LIBRARIES := libfoo  
LOCAL_LDLIBS += -llog  
  
include $(BUILD_SHARED_LIBRARY)

在这个示例中，我们定义了一个名为 hello-jni 的共享库，它依赖于名为 libfoo 的另一个共享库，并且链接了 Android 的日志库。