深入解析Android .so文件函数调用机制与实战避坑指南

1次阅读

共计 1997 个字符，预计需要花费 5 分钟才能阅读完成。

在 Android NDK 开发中，调用.so 文件中的函数是常见需求，但开发者常常会遇到以下几个典型问题：

符号未找到 ：由于符号导出或链接问题，导致函数无法正确加载和调用
性能瓶颈 ：不合理的调用方式会带来额外的性能开销
ABI 兼容性 ：不同 CPU 架构下的.so 文件需要正确处理

这些问题往往会导致应用崩溃或性能下降，严重影响用户体验。

.so 文件本质上是一个 ELF（Executable and Linkable Format）格式的文件。了解其结构对于解决调用问题至关重要：

+---------------------+
| ELF Header          |
+---------------------+
| Program Headers     |
+---------------------+
| Section Headers     |
+---------------------+
| .text (代码段)      |
+---------------------+
| .data (数据段)      |
+---------------------+
| .symtab (符号表)    |
+---------------------+
| .dynsym (动态符号表)|
+---------------------+
| .strtab (字符串表)  |
+---------------------+

符号表（.symtab 和.dynsym）存储了函数和变量的符号信息，是动态链接的关键。

Android 中主要有两种调用.so 函数的方式：

dlopen/dlsym 方式
运行时动态加载
灵活性高但性能稍差
JNI_OnLoad 方式
在.so 加载时注册函数
性能更好但灵活性较低

Android 支持多种 ABI，常见的有：

armeabi-v7a
arm64-v8a
x86
x86_64

必须确保.so 文件与目标设备的 ABI 匹配，否则会导致加载失败。

// Java 层
public class NativeLib {
    static {System.loadLibrary("mylib");
    }

    public static native void nativeMethod();}

// C++ 层
#include <jni.h>
#include <android/log.h>

#define LOG_TAG "NativeLib"
#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)

extern "C" JNIEXPORT void JNICALL
Java_com_example_NativeLib_nativeMethod(JNIEnv *env, jclass clazz) {LOGI("Native method called");
}

JNIEXPORT jint JNI_OnLoad(JavaVM* vm, void* reserved) {LOGI("JNI_OnLoad called");
    return JNI_VERSION_1_6;
}

cmake_minimum_required(VERSION 3.4.1)

add_library(mylib SHARED
            src/main/cpp/native-lib.cpp)

find_library(log-lib log)

target_link_libraries(mylib
                      ${log-lib})

// 只导出指定函数
__attribute__ ((visibility ("default"))) void exportedFunction() {// 函数实现}

// 不导出
__attribute__ ((visibility ("hidden"))) void internalFunction() {// 内部使用}