TIC-80 在树莓派3上的裸机构建问题解析与解决方案

背景介绍

TIC-80 是一款开源的虚拟游戏主机，支持多种脚本语言开发游戏。在树莓派3上进行裸机构建时，开发者遇到了链接器无法找到多个语言库文件的问题。本文将详细分析问题原因并提供完整的解决方案。

问题现象

当开发者按照构建流程操作时，在最后链接阶段出现以下错误：

arm-none-eabi-ld: cannot find ../../build/lib/liblpeg.a: No such file or directory
arm-none-eabi-ld: cannot find ../../build/lib/libmoon.a: No such file or directory
...

这些错误表明链接器无法找到TIC-80支持的各种脚本语言的静态库文件。

问题根源分析

1. 构建配置不完整：虽然使用了-DBUILD_WITH_ALL=ON参数，但在裸机环境下需要显式启用各个语言模块的构建。

2. 依赖关系不明确：裸机构建的特殊性要求所有需要的库都必须预先构建并正确链接。

3. 构建顺序问题：某些库需要在主构建之前完成编译。

完整解决方案

1. 准备工作

首先需要获取并构建circle-stdlib库：

cd vendor
git clone --recursive https://github.com/smuehlst/circle-stdlib
cd circle-stdlib
git checkout db053a32c165c1b22423a47ed6cb5bddc72b51f2
git submodule update --recursive
./configure -r 3
make -j$(nproc)

2. 构建附加组件

构建声音、视频等附加组件：

cd libs/circle/addon/vc4/sound/
make -j$(nproc)
cd ../vchiq
make -j$(nproc)
cd ../../linux
make -j$(nproc)

3. 主项目构建

应用必要的补丁并配置构建环境：

git apply build/baremetalpi/circle.patch
cd build

使用完整的CMake配置命令：

cmake -DCMAKE_BUILD_TYPE=Release \
      -DCMAKE_TOOLCHAIN_FILE=baremetalpi/toolchain.cmake \
      -DBUILD_WITH_ALL=ON \
      -DBUILD_WITH_PYTHON=ON \
      -DBUILD_WITH_WASM=ON \
      -DBUILD_WITH_MOON=ON \
      -DBUILD_WITH_FENNEL=ON \
      -DBUILD_WITH_JANET=ON \
      -DBUILD_WITH_WREN=ON \
      -DBUILD_WITH_RUBY=ON \
      -DBUILD_WITH_SCHEME=ON \
      -DBUILD_WITH_SQUIRREL=ON \
      -DBUILD_WITH_JS=ON ..

4. 执行构建

完成主构建和裸机特定构建：

make tic80studio -j$(nproc)
cd baremetalpi
make -j$(nproc)
cd ../../vendor/circle-stdlib/libs/circle/boot/
make -j$(nproc)

技术要点

1. 裸机构建特殊性：与常规Linux环境不同，裸机构建需要处理更多底层硬件细节。

2. 交叉编译工具链：确保使用正确的ARM交叉编译工具链版本（如Arm GNU Toolchain 13.2）。

3. 模块化构建：TIC-80支持多种脚本语言，每种语言都需要单独构建为静态库。

常见问题排查

1. 库文件缺失：检查build/lib/目录下是否生成了所有需要的.a文件。

2. 构建顺序：确保按照正确的顺序执行各个构建步骤。

3. 工具链兼容性：验证使用的工具链版本是否与项目要求匹配。

总结

在树莓派3上构建TIC-80裸机版本需要特别注意各个语言模块的显式启用和正确的构建顺序。通过完整的CMake配置参数和分步构建流程，可以成功解决链接器找不到库文件的问题。这种经验也适用于其他嵌入式系统的裸机开发场景。