SRC软件算法组开发环境搭建教程¶

Abstract

本教程旨在帮助新成员快速搭建开发环境，并熟悉SRC项目的基本结构。

---by 陶涵 23.11.15

1.必要软件安装¶

Git Bash与Github注册

为什么要使用git

采用git进行代码管理,同时注册github账号
- 参考Git Bash教程进行配置
- 全部完成后可以输入ssh -T git@github.com命令行后看是否能够正常连入你的Github
Cmake安装

为什么要使用Cmake

gcc将源文件编译成可执行文件或者库文件；而当需要编译的东西很多时， 需要说明先编译什么，后编译什么 ，这个过程称为构建，常用的工具是make。而我们的代码体系较为庞大，需要通过CMake软件更加简单的定义构建的流程。代码从Github上pull下来后需要通过Cmake进行编译

CMake官网进入官网后找到合适自己电脑对应的(1)Cmake版本即可，可以选择3.28。
Visual Studio

我们的项目需要通过Visual Studio进行编辑运行，建议下载Visual Studio 2022

VS官网，安装过程所需项目勾选含有本地cpp开发的选项即可，(1)注意更改安装路径（占用空间很大）
1. 完成界面

重要提醒

如果你的电脑有invida显卡，将会选择安装CUDA（参见第3节），那么在安装Visual Studio时需要考虑与CUDA的版本适配问题，参考

因此我们建议安装时注意安装17.9.2以前的版本，参考解决方案

否则cmake编译时会报错

如果不选择安装CUDA则应该不用考虑版本问题

Qt:

输入以下命令（使用清华镜像源下载比较快）

.\qt-unified-windows-x64-4.5.1-online.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt

Windows :

修改 cmake/GetThirdParty.cmake 中的 QT 部分，输入自己电脑上的 QT 路径，例如：
```
set(CMAKE_PREFIX_PATH "D:/QT/5.15.2/msvc2019_64/lib/cmake/Qt5")
```
使用 CMake Gui，输入源代码所在目录和编译目录，如：
点击 Configure
如图选择，点击Finish
完成后无报错，点击 Generate，再点击 Open Project
在 vs 中选择 Release x64 模式
点击生成解决方案，没有报错则完成
运行 bin/package.bat，首次编译或更换 QT 路径时需删除 package.txt 重新输入路径,如：
```
Where is QT QML : D:\QT\5.15.2\msvc2019_64\qml
Where is Client QML : D:\Falcon_2023\Client\src\qml
```
如果发现 cmake 载入路径有误，则先点击菜单栏中的 File/Delete Cache，做有必要的调整后再重新 Configure 和 Generate
如果觉得生成过慢，可以更改 cmake/Utils.cmake，之后重新 Configure 和 Generate。下述用了4核并行编译，可以查看电脑有几核，适当设置多些，但不建议给满
```
ProcessorCount(N)
if(N GREATER_EQUAL 4)

        set(N 4)
endif()
```
ubuntu :
- 具体编译方法见B站，搜索"Rocos环境配置"

CUDA下载
- 首先电脑得有NVIDIA显卡，然后命令行输入nvidia-smi查看当前驱动支持的最高CUDA版本如果低于12.0就需要升级显卡驱动
- 推荐下载CUDA12，安装教程网上多的是，不再赘述了
- CUDA下载官网
- 交大云盘备份