86Box项目在Termux环境下的构建问题分析与解决方案

问题背景

86Box是一款开源的IBM PC模拟器，支持模拟多种经典计算机硬件配置。近期有开发者在Android Termux环境下尝试构建86Box时遇到了链接阶段的符号重复定义问题。本文将详细分析该问题的成因，并提供完整的解决方案。

问题现象

在Termux环境下构建86Box时，链接器报告了多个线程相关函数的重复定义错误。具体表现为：

1. 线程创建函数(thread_create_named)重复定义
2. 线程等待函数(thread_wait)重复定义
3. 事件相关函数(thread_create_event等)重复定义
4. 互斥量相关函数(thread_create_mutex等)重复定义

这些错误导致构建过程失败，无法生成可执行文件。

问题分析

通过分析构建日志和源代码，可以确定问题根源在于：

1. 86Box项目提供了两套线程实现：

   • 基于C++11标准库的实现(src/thread.cpp)
   • 基于Unix系统调用的实现(unix/unix_thread.c)

2. 在Unix/Linux环境下，这两套实现同时被编译并链接到最终的可执行文件中，导致符号冲突。

3. 特别是当构建系统未正确配置CPPTHREADS选项时，系统会同时编译这两套实现。

解决方案

方法一：禁用C++11线程实现

最直接的解决方案是明确禁用C++11线程实现，强制使用Unix系统调用实现：

cmake -D CPPTHREADS=OFF ..

这种方法简单有效，适合大多数Unix-like系统，包括Termux环境。

方法二：源代码条件编译

对于需要保留C++11实现的特殊情况，可以通过修改源代码添加条件编译指令：

// 在src/thread.cpp文件开头添加
#if !defined(__unix__)
// C++11线程实现代码
#endif

这种方法更加灵活，但需要维护额外的条件编译代码。

构建建议

对于Termux环境下的86Box构建，推荐以下最佳实践：

1. 确保构建环境完整：

   pkg install git cmake make gcc
   

2. 明确指定构建选项：

   cmake -D CPPTHREADS=OFF -D FLUIDSYNTH=OFF ..
   

3. 对于资源受限的移动设备，建议禁用动态重编译：

   cmake -D CPU_DYNAREC=OFF ..
   

验证结果

应用上述解决方案后，86Box应能在Termux环境下成功构建并运行。测试时可以使用以下基本配置：

[Machine]
machine = ibmpc
cpu_family = 8088
mem_size = 64

[Video]
gfxcard = mda

这种配置对系统资源需求较低，适合在移动设备上测试基本功能。

总结

86Box在非标准Unix环境(如Termux)下的构建问题主要源于线程实现的冲突。通过合理配置构建选项或修改源代码，可以解决符号重复定义的问题。本文提供的解决方案已在Android 11+Cortex-A55平台上验证通过，开发者可根据实际需求选择适合的方法。