第四章：源码获取与目录结构

好，咱们正式开始动手了。这一章我带你走一遍最基础但也是最容易踩坑的环节——把代码拿到手，把依赖库备齐，再把目录结构理清楚。你别小看这一步，我在项目里见过太多人因为依赖没配好，卡了整整两天。

4.1 Git仓库克隆：别急着点那个绿色按钮

先说说源码怎么拿。我们用的这个嵌入式语音引擎，托管在GitHub上。我个人习惯用命令行操作，而不是直接下载ZIP包。为什么？因为后续你要切分支、拉更新、看提交历史，命令行方便得多。

git clone https://github.com/example/embedded-voice-engine.git
cd embedded-voice-engine
git checkout v1.2.0

这里有个细节：我建议你直接切到一个稳定版本标签，比如v1.2.0。别用master分支，那个是开发中的，说不定今天能编译，明天就挂了。我曾经在项目里吃过这个亏——早上还能跑，下午拉了更新就报链接错误，查了半天发现是某个头文件改了接口。

4.2 第三方依赖库：FFmpeg、OpenBLAS、libsndfile

这个引擎依赖三个核心库：FFmpeg、OpenBLAS和libsndfile。说白了，一个管音频编解码，一个管矩阵运算加速，一个管音频文件读写。缺一个都跑不起来。

4.2.1 FFmpeg：音频编解码的瑞士军刀

FFmpeg的编译是个大工程。我建议你直接用交叉编译工具链来搞。嵌入式平台嘛，资源有限，我们只取需要的模块。

./configure --prefix=/opt/ffmpeg \
            --enable-cross-compile \
            --cross-prefix=arm-linux-gnueabihf- \
            --target-os=linux \
            --arch=arm \
            --disable-doc \
            --disable-ffplay \
            --disable-ffprobe \
            --enable-small

嗯，这里要注意：--enable-small这个选项能帮你省不少空间。我在一个Flash只有8MB的项目里，全靠这个选项才把FFmpeg塞进去。

4.2.2 OpenBLAS：矩阵运算加速器

OpenBLAS主要是给语音特征提取用的。比如MFCC计算里那些矩阵乘法，没有OpenBLAS的话，CPU得累死。

git clone https://github.com/xianyi/OpenBLAS.git
cd OpenBLAS
make TARGET=ARMV7 HOSTCC=gcc CC=arm-linux-gnueabihf-gcc
make install PREFIX=/opt/openblas

你想想看，同样的算法，用OpenBLAS加速后，推理时间能从200ms降到30ms。这不是优化，这是质变。

4.2.3 libsndfile：音频文件读写的基础设施

libsndfile相对简单，它就是个文件I/O库。支持WAV、FLAC、OGG等格式。编译时基本不需要特殊配置。

./configure --host=arm-linux-gnueabihf --prefix=/opt/libsndfile
make
make install

不过有个坑：libsndfile依赖libogg和libvorbis。如果你只需要WAV格式，可以在configure时加上--disable-external-libs来跳过这些依赖。我曾经在一个项目里忘了加这个，结果交叉编译链里缺了libogg的头文件，折腾了一下午。

4.3 目录结构解析：别迷路

好，现在代码和依赖都准备好了。我们来看看这个引擎的目录结构。我把它画成了一张表，你对照着看。

目录/文件	作用	我的备注
src/	核心算法源码	语音识别、唤醒词、VAD都在这里
include/	公共头文件	API接口定义，外部调用者主要看这里
third_party/	第三方依赖	放你编译好的FFmpeg、OpenBLAS等
platform/	平台适配层	Linux、RTOS、裸机各一套
examples/	示例程序	快速上手用的，我建议先跑这个
tests/	单元测试	改完代码记得跑一遍，别偷懒
docs/	文档	API文档、移植指南
CMakeLists.txt	顶层构建文件	整个项目的构建入口

我个人习惯先看examples/目录。为什么？因为示例程序是最直接的“Hello World”，能帮你快速验证整个工具链是否通顺。你想想看，如果连示例都跑不起来，那肯定是环境没配好，别急着改算法。

4.4 依赖库的集成方式

依赖库准备好了，怎么集成到项目里？我推荐用CMake的find_package机制。在顶层CMakeLists.txt里加上：

set(FFMPEG_DIR /opt/ffmpeg)
set(OpenBLAS_DIR /opt/openblas)
set(LIBSNDFILE_DIR /opt/libsndfile)

find_package(PkgConfig REQUIRED)
pkg_check_modules(FFMPEG REQUIRED libavcodec libavformat libavutil)
pkg_check_modules(OpenBLAS REQUIRED openblas)
pkg_check_modules(SNDFILE REQUIRED sndfile)

这里有个经验：别把依赖库的路径写死在代码里。用CMake变量或者环境变量来传递，这样换平台时只需要改一个地方。我曾经见过有人把路径硬编码在Makefile里，结果换了台机器编译，改了几十个地方，差点崩溃。

4.5 验证环境：跑一个简单的测试

所有东西都配好了？来，验证一下。进入examples/目录，编译一个最简单的音频读取示例：

mkdir build && cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/arm-toolchain.cmake
make
./audio_reader_test /path/to/test.wav

如果能看到音频文件的采样率、通道数、时长等信息，恭喜你，环境通了。如果报错，别慌。先检查依赖库的路径对不对，再检查交叉编译链是否匹配。我遇到过最奇葩的问题，是libsndfile的版本和FFmpeg的版本冲突，导致链接时符号重复。解决办法很简单：统一用同一个编译链重新编译所有依赖。

嗯，这一章的内容就到这里。下一章我们开始真正动手移植——把语音引擎的VAD模块先跑起来。你准备好了吗？