如何将iperf3编译为lib.so以集成到Android 9+应用中？

基于你使用的android-iperf3仓库，按以下步骤即可将iperf3编译为共享库，直接集成到Android应用中：

1. 修改编译配置，切换目标为共享库 #

找到仓库内的Android.mk文件，将原本的BUILD_EXECUTABLE替换为BUILD_SHARED_LIBRARY。例如原代码行：

include $(BUILD_EXECUTABLE)

修改为：

include $(BUILD_SHARED_LIBRARY)

同时在LOCAL_CFLAGS中添加-fvisibility=default，确保核心函数能被外部调用；也可以直接在需要导出的函数声明前显式添加__attribute__((visibility("default")))标记。

2. 导出iperf3核心API #

打开src/iperf_api.h文件，给你需要在Android应用中调用的核心函数添加可见性标记。比如常用的测速相关函数：

__attribute__((visibility("default")))
struct iperf_test *iperf_new_test(void);

__attribute__((visibility("default")))
int iperf_run_client(struct iperf_test *test);

__attribute__((visibility("default")))
void iperf_free_test(struct iperf_test *test);

这样这些函数会被导出到共享库的符号表中，方便后续JNI调用。

3. 编译生成libiperf3.so #

在仓库根目录执行ndk-build命令，指定需要适配的CPU架构：

ndk-build APP_ABI=armeabi-v7a,arm64-v8a,x86,x86_64

编译完成后，libs目录下会生成对应架构的libiperf3.so文件。

4. 集成到Android应用 #

• 将libs目录下的各架构文件夹（如armeabi-v7a）复制到你的Android项目app/src/main/jniLibs目录下。
• 在app模块的build.gradle（Module级别）中添加ABI过滤，匹配你编译的架构：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }
}

• 编写JNI层代码，或者直接在Java中通过System.loadLibrary("iperf3")加载库，再调用iperf3的核心函数实现测速逻辑。

注意事项 #

• 确保你的Android项目配置了兼容版本的NDK环境，与android-iperf3仓库要求匹配。
• 应用需要申请网络权限，在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

• 若编译时遇到依赖问题，检查仓库内libcrypto相关配置，确保依赖库正确编译链接。

内容的提问来源于stack exchange，提问作者Sacroknight