GPS工具包(GPSTk)迁移到GNSSTk指导及新手常见问题解答

GPS工具包(GPSTk)迁移到GNSSTk指导及新手常见问题解答

GPS工具包（GPSTk），现已更名为GNSSTk，并且其结构经过拆分，自2021年9月版本v12.0.0起，成为两个独立的仓库——GNSSTk专注于库文件，而GNSSTk-APPS则包含了应用程序部分。此项目原先使用的是C++作为主要编程语言。

新手注意事项及解决方案

1. 项目已迁移问题

问题描述：

新手可能遇到的第一个问题是发现原始GPSTk仓库是归档状态，无法进行最新的提交和 Issue 跟踪。

解决步骤：

• 访问新仓库：GPSTk现为GNSSTk和GNSSTk-APPS，确保使用最新地址。
• 更新您的本地副本指向新的GitLab仓库，或者新建一个克隆链接到新地址。

2. 库和应用分离后的构建问题

问题描述：

新手可能会困惑于如何分别或一起构建库文件和应用程序。

解决步骤：

• 对于库文件（GNSSTk）的构建，参考GNSSTk仓库中的CMakeLists.txt和文档，确保安装了所有必要的依赖项。
• 应用程序部分（GNSSTk-APPS），同样遵循其提供的构建指南，可能需要先构建并安装GNSSTk库。
• 使用CMake进行配置，通过设置BUILD_APPS标志来决定是否同时构建应用。

3. 兼容性和旧代码更新问题

问题描述：

原有基于GPSTk的代码可能不再直接兼容新版本的GNSSTk库。

解决步骤：

• 检查API变更文档，GNSSTk从GPSTk更名和拆分伴随有API的调整。
• 更新代码中任何导入的命名空间和类前缀，例如，从gpstk::更改为相应的GNSSTk命名空间。
• 测试代码以确保逻辑正确性，对不兼容的函数调用进行替换或修正。

---

重要提示：确保在迁移或升级过程中详细阅读项目的官方文档，尤其是迁移指南和版本日志，这将极大帮助平滑过渡到新版本的库和工具集。