Xposed框架编译选项：Android.mk中LOCAL_MODULE的配置详解

原创 于 2025-09-16 07:32:18 发布 · 728 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

Xposed框架编译选项：Android.mk中LOCAL_MODULE的配置详解

【免费下载链接】Xposed The native part of the Xposed framework (mainly the modified app_process binary). 【免费下载链接】Xposed 项目地址: https://gitcode.com/gh_mirrors/xp/Xposed

引言：你是否还在为Xposed模块编译适配不同Android版本而头疼？

Android应用开发中，Xposed框架（Xposed Framework）作为强大的Hook工具，允许开发者在不修改APK（Android Package，安卓应用程序包）的情况下改变系统和应用的行为。然而，其编译系统的配置复杂性常让开发者望而却步——不同Android版本（API Level）需要适配不同的编译选项，32位/64位架构切换时模块命名规则迥异，ART（Android Runtime，安卓运行时）与Dalvik虚拟机的兼容性配置更是容易出错。本文将深入解析Xposed框架核心编译脚本Android.mk中LOCAL_MODULE相关配置的底层逻辑，帮助你彻底掌握跨版本、跨架构的编译适配方案。

读完本文你将获得：

  • 理解LOCAL_MODULE在Xposed编译系统中的核心作用
  • 掌握基于Android SDK版本的条件编译技巧
  • 学会32位/64位架构的模块命名与输出控制
  • 精通ART/Dalvik虚拟机的编译配置切换
  • 规避常见的编译错误与兼容性问题

一、Xposed编译系统架构概览

Xposed框架的编译系统基于Android NDK（Native Development Kit，原生开发工具包）的Android.mk构建脚本，通过模块化设计实现对不同Android版本和架构的支持。其核心输出包含两类组件：

1.1 核心可执行文件与库

模块类型主要文件作用
可执行文件app_main.cpp/app_main2.cpp修改版app_process，负责启动Zygote进程并加载Xposed框架
运行时库libxposed_art.cppART虚拟机专用Hook实现
运行时库libxposed_dalvik.cppDalvik虚拟机专用Hook实现
公共库libxposed_common.cpp跨虚拟机的通用工具函数

1.2 编译脚本依赖关系

mermaid

Android.mk作为主编译脚本，根据Android SDK版本条件包含ART.mk或Dalvik.mk，分别构建适用于ART和Dalvik虚拟机的运行时库。

二、LOCAL_MODULE基础：编译目标的核心定义

LOCAL_MODULE是Android.mk中最基础也最重要的变量，用于定义编译输出的模块名称。在Xposed框架中，其配置逻辑直接决定了编译产物的命名规则、架构支持和版本兼容性。

2.1 基础语法与默认行为

# 定义可执行文件模块
LOCAL_MODULE := xposed
include $(BUILD_EXECUTABLE)  # 生成可执行文件

# 定义共享库模块
LOCAL_MODULE := libxposed_art
include $(BUILD_SHARED_LIBRARY)  # 生成共享库(.so)

默认情况下，编译系统会根据LOCAL_MODULE的值生成对应的输出文件：

  • 可执行文件：直接使用LOCAL_MODULE值作为文件名
  • 共享库：自动添加lib前缀，如libxposed_art

2.2 Xposed中的基础配置分析

在Xposed的Android.mk中，核心可执行文件的模块定义如下：

LOCAL_MODULE := xposed
LOCAL_MODULE_TAGS := optional
LOCAL_STRIP_MODULE := keep_symbols

这里的关键配置：

  • LOCAL_MODULE_TAGS := optional：标记为可选模块，不会在默认编译中构建
  • LOCAL_STRIP_MODULE := keep_symbols：保留调试符号表，便于问题定位（在正式发布版本中通常设为true以减小体积）

三、跨Android版本的条件编译配置

Android系统版本迭代带来了虚拟机架构（Dalvik→ART）、系统API和安全机制的重大变化，Xposed通过条件编译实现对不同版本的支持。

3.1 SDK版本判断逻辑

Xposed使用expr工具进行SDK版本比较，实现条件编译分支：

# 判断SDK版本是否≥21（Android 5.0，ART虚拟机首次引入）
ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 21)))
  LOCAL_SRC_FILES := app_main2.cpp  # ART架构使用新版入口
  LOCAL_MULTILIB := both           # 同时编译32/64位版本
else
  LOCAL_SRC_FILES := app_main.cpp   # Dalvik架构使用旧版入口
endif

核心语法解析：

  • $(PLATFORM_SDK_VERSION)：Android编译系统提供的SDK版本变量
  • expr $(PLATFORM_SDK_VERSION) \>= 21：使用expr工具进行数值比较
  • strip：去除字符串首尾空格，确保比较结果准确

3.2 主要SDK版本分支及特性

SDK版本范围Android版本虚拟机主要编译特性
<174.2以下Dalvik基础Hook实现，无SELinux支持
17-204.2-4.4Dalvik新增SELinux支持，libselinux依赖
21-225.0-5.1ART首次支持ART，引入libsigchain异常处理
≥236.0+ART新增libwilhelm音频库依赖，Valgrind调试支持

3.3 条件编译实战：SELinux支持的添加

# 当SDK版本≥17时添加SELinux支持
ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 17)))
  LOCAL_SHARED_LIBRARIES += libselinux  # 添加SELinux库依赖
  LOCAL_CFLAGS += -DXPOSED_WITH_SELINUX=1  # 定义编译宏
endif

在代码中使用对应的条件编译宏：

#ifdef XPOSED_WITH_SELINUX
  // SELinux相关的安全上下文处理代码
  selinux_android_setcontext(...)
#endif

四、32位/64位架构的编译控制

随着Android设备从32位向64位架构的迁移，Xposed需要同时支持两种架构，LOCAL_MODULE相关变量提供了灵活的控制机制。

4.1 架构控制核心变量

变量取值含义
LOCAL_MULTILIBboth/32/64指定编译架构，both表示同时编译32/64位
LOCAL_MODULE_STEM字符串基础文件名，不含架构后缀
LOCAL_MODULE_STEM_32字符串32位架构专用文件名
LOCAL_MODULE_STEM_64字符串64位架构专用文件名

4.2 Xposed中的架构适配实现

# SDK≥21时启用多架构支持
ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 21)))
  LOCAL_SRC_FILES := app_main2.cpp
  LOCAL_MULTILIB := both
  LOCAL_MODULE_STEM_32 := app_process32_xposed  # 32位文件名
  LOCAL_MODULE_STEM_64 := app_process64_xposed  # 64位文件名
else
  LOCAL_SRC_FILES := app_main.cpp
  LOCAL_MODULE_STEM := app_process_xposed       # 仅32位
endif

编译输出结果：

  • SDK≥21且64位设备：同时生成app_process32_xposed和app_process64_xposed
  • SDK<21：仅生成app_process_xposed（32位）

4.3 强制构建双架构的保障机制

为确保在64位目标设备上同时构建32位版本，Xposed使用以下机制：

# 如果目标是64位设备，确保同时构建32位版本
ifeq ($(TARGET_IS_64_BIT),true)
  $(LOCAL_MODULE): $(LOCAL_MODULE)$(TARGET_2ND_ARCH_MODULE_SUFFIX)
endif

这里$(TARGET_2ND_ARCH_MODULE_SUFFIX)会自动扩展为32位架构的后缀（通常是_32），确保主模块依赖于32位版本，从而触发两者的同时构建。

五、ART/Dalvik虚拟机的编译配置切换

Android 5.0（API 21）是一个重要分水岭，从Dalvik虚拟机切换到ART虚拟机，带来了彻底的运行时架构变革。Xposed通过分离的编译脚本来支持这两种截然不同的虚拟机。

5.1 编译脚本的条件包含

# 根据SDK版本选择包含ART.mk或Dalvik.mk
ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 21)))
  include frameworks/base/cmds/xposed/ART.mk  # ART架构
else
  include frameworks/base/cmds/xposed/Dalvik.mk  # Dalvik架构
endif

5.2 ART架构编译配置（ART.mk）

ART架构的核心编译配置：

include $(CLEAR_VARS)

# 引入ART运行时的编译变量
include art/build/Android.common_build.mk
$(eval $(call set-target-local-clang-vars))
$(eval $(call set-target-local-cflags-vars,ndebug))

LOCAL_SRC_FILES += \
  libxposed_common.cpp \
  libxposed_art.cpp  # ART专用实现

LOCAL_C_INCLUDES += \
  art/runtime  # ART运行时头文件

LOCAL_SHARED_LIBRARIES += \
  libart  # 链接ART运行时库

LOCAL_MODULE := libxposed_art  # ART库模块名
LOCAL_MULTILIB := both        # 同时构建32/64位

include $(BUILD_SHARED_LIBRARY)

5.3 Dalvik架构编译配置（Dalvik.mk）

Dalvik架构的核心编译配置：

include $(CLEAR_VARS)

LOCAL_SRC_FILES := \
  libxposed_common.cpp \
  libxposed_dalvik.cpp  # Dalvik专用实现

LOCAL_C_INCLUDES += \
  dalvik \
  dalvik/vm  # Dalvik虚拟机头文件

LOCAL_SHARED_LIBRARIES += \
  libdvm  # 链接Dalvik虚拟机库

LOCAL_MODULE := libxposed_dalvik  # Dalvik库模块名

include $(BUILD_SHARED_LIBRARY)

5.4 虚拟机适配的关键差异对比

特性ART配置（ART.mk）Dalvik配置（Dalvik.mk）
核心源文件libxposed_art.cpplibxposed_dalvik.cpp
虚拟机库依赖libartlibdvm
头文件路径art/runtimedalvik/vm
架构支持默认32/64位（LOCAL_MULTILIB=both）仅32位
STL依赖系统STLexternal/stlport

六、高级编译选项与最佳实践

6.1 编译标志（CFLAGS）优化

Xposed使用严格的编译标志确保代码质量：

# 基础警告选项
LOCAL_CFLAGS += -Wall -Werror -Wextra -Wunused

# 特定版本的宏定义
LOCAL_CFLAGS += -DPLATFORM_SDK_VERSION=$(PLATFORM_SDK_VERSION)

各标志含义：

  • -Wall：启用所有警告
  • -Werror：将警告视为错误
  • -Wextra：额外警告选项
  • -Wunused：检测未使用的变量和函数

6.2 库依赖管理

Xposed根据不同Android版本动态调整依赖库：

# 基础依赖库
LOCAL_SHARED_LIBRARIES := \
  libcutils \
  libutils \
  liblog \
  libbinder \
  libandroid_runtime \
  libdl

# 条件依赖：Android 6.0+需要链接libwilhelm音频库
ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 23)))
  LOCAL_SHARED_LIBRARIES += libwilhelm
endif

6.3 常见编译问题解决方案

问题1：SELinux相关编译错误

症状：undefined reference to selinux_android_setcontext

解决方案：确保在SDK≥17时添加SELinux依赖：

ifeq (1,$(strip $(shell expr $(PLATFORM_SDK_VERSION) \>= 17)))
  LOCAL_SHARED_LIBRARIES += libselinux
  LOCAL_CFLAGS += -DXPOSED_WITH_SELINUX=1
endif
问题2：32位/64位架构冲突

症状：error: target pattern contains no '%'

解决方案：确保在使用LOCAL_MODULE_STEM_32和LOCAL_MODULE_STEM_64时，正确设置LOCAL_MULTILIB := both

问题3：ART运行时版本不匹配

症状：art/runtime/mirror/class.h: No such file or directory

解决方案：验证art/runtime是否在LOCAL_C_INCLUDES中，且编译环境包含完整的ART源码。

七、总结与展望

Xposed框架的Android.mk通过LOCAL_MODULE及其相关变量的灵活配置，实现了对不同Android版本、架构和虚拟机的全面支持。核心要点包括：

  1. 条件编译：基于PLATFORM_SDK_VERSION的分支控制，适配不同Android版本
  2. 架构管理：使用LOCAL_MULTILIB和LOCAL_MODULE_STEM_32/64控制32/64位输出
  3. 模块化设计：通过Android.mk条件包含ART.mk/Dalvik.mk，隔离不同虚拟机实现
  4. 严格编译检查：通过-Wall -Werror等标志确保代码质量

随着Android系统的不断演进，Xposed的编译系统也需要持续适配新的变化。未来可能的发展方向包括：

  • 支持Android 12+的ELF（Executable and Linkable Format，可执行与可链接格式）库加载机制
  • 适配Rust编写的Android组件
  • 集成Android.bp构建系统（替换传统的Android.mk）

掌握这些编译配置知识，不仅能帮助你更好地理解Xposed框架的底层实现，还能为你构建自己的Android原生模块提供宝贵的参考。建议收藏本文，在实际编译遇到问题时对照查阅。

鼓励与互动

如果本文对你理解Xposed编译系统有帮助，请点赞、收藏并关注作者，后续将带来更多Android底层开发的深入解析。下期预告：《Xposed模块开发实战：从Hook方法到应用发布》

附录：Xposed编译配置速查表

变量作用关键取值
LOCAL_MODULE定义模块名称xposed, libxposed_art, libxposed_dalvik
LOCAL_MODULE_STEM基础文件名app_process_xposed
LOCAL_MODULE_STEM_3232位文件名app_process32_xposed
LOCAL_MODULE_STEM_6464位文件名app_process64_xposed
LOCAL_MULTILIB架构支持both, 32, 64
LOCAL_MODULE_TAGS模块标签optional, eng, user
LOCAL_STRIP_MODULE符号表剥离keep_symbols, true
PLATFORM_SDK_VERSIONSDK版本17, 21, 23等

【免费下载链接】Xposed The native part of the Xposed framework (mainly the modified app_process binary). 【免费下载链接】Xposed 项目地址: https://gitcode.com/gh_mirrors/xp/Xposed

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值