GNSS-SDR项目在Ubuntu和MacOS系统下的编译安装指南

前言

GNSS-SDR是一个开源的全球导航卫星系统(GNSS)软件定义无线电接收机项目。本文主要介绍在Ubuntu 22.04和MacOS 15.2系统下编译安装GNSS-SDR v0.0.19版本时可能遇到的问题及解决方案。

Ubuntu系统安装

系统环境准备

在Ubuntu 22.04系统上，首先需要安装以下依赖包：

sudo apt-get install build-essential cmake git pkg-config libboost-dev libboost-date-time-dev \
       libboost-system-dev libboost-filesystem-dev libboost-thread-dev libboost-chrono-dev \
       libboost-serialization-dev liblog4cpp5-dev libuhd-dev gnuradio-dev gr-osmosdr \
       libblas-dev liblapack-dev libarmadillo-dev libgflags-dev libgoogle-glog-dev \
       libgnutls-openssl-dev libpcap-dev libmatio-dev libpugixml-dev libgtest-dev \
       libprotobuf-dev protobuf-compiler python3-mako

常见编译问题及解决

在编译过程中，最常见的错误是libfmt和libspdlog库版本不兼容的问题。这是由于spdlog v1.11.0需要依赖fmt v9.1.0版本，而系统默认安装的可能不是这个版本。

解决方法是从源码安装fmt v9.1.0：

git clone --branch 9.1.0 https://github.com/fmtlib/fmt.git
cd fmt
mkdir build && cd build
cmake ..
make -j$(nproc)
sudo make install

安装完成后，重新编译GNSS-SDR：

cd gnss-sdr/build
rm -rf *
cmake ..
make -j$(nproc)
sudo make install

安装验证

安装完成后，可以通过以下命令验证安装是否成功：

gnss-sdr --version

如果显示"gnss_sdr version 0.0.19"，则表示安装成功。

MacOS系统安装

系统环境准备

在MacOS 15.2系统上，首先需要安装Xcode开发工具。然后可以选择使用Macports或Homebrew来安装依赖包。需要注意的是，Macports的安装速度较慢。

常见编译问题及解决

在MacOS系统上编译时，可能会遇到以下问题：

1. Boost库版本不兼容：需要确保安装的Boost库版本与GNSS-SDR兼容。

2. gtest问题：可能需要手动安装或配置gtest库。

安装后配置

安装完成后，需要执行以下命令进行优化配置：

cd gnss-sdr/install
volk_profile
volk_gnsssdr_profile

注意事项

1. 在安装依赖包前，确保退出conda环境（如果使用conda）：

conda deactivate

2. 编译过程中如果出现错误，可以尝试以下步骤：

   • 对于cmake错误：删除build目录重新开始
   • 对于make错误：先执行make clean再重新make

3. 项目维护者推荐使用'next'分支，因为该分支的文档始终保持最新。

总结

GNSS-SDR作为一个复杂的软件定义无线电项目，其编译安装过程可能会遇到各种依赖和版本兼容性问题。本文总结了在Ubuntu和MacOS系统下的常见问题及解决方案，希望能帮助开发者顺利完成安装。对于更高级的使用和配置，建议参考项目的官方文档和社区讨论。