Github开源项目engine-sim(引擎模拟)跑通教程

最近在跑从Github上拉下来的一个项目时遇到了一些问题,踩了很多坑,所幸最后还是跑起来了,在这里分享一下环境的搭建和跑通代码的过程,希望可以在大家跑这个项目的时候可以提供一些帮助。

 

一:开源项目

a413bc78fcd24de39be5575e67baf35e.png

开源项目链接:https://github.com/ange-yaghi/engine-sim

 

二:release

该项目有release版本

07d9eb8e43c24cac8f1b9a71cb301103.png

release版本可自行下载运行游玩,小编接下来带大家搭建开发环境。

 

三:developer

项目运行步骤:

Note: this project currently only builds on Windows!
注意:此项目目前仅在 Windows 上构建!

Step 1 - Clone the repository
步骤 1 - 克隆存储库

git clone --recurse-submodules https://github.com/ange-yaghi/engine-sim

 

Step 2 - Install CMake
第 2 步 - 安装 CMake

Install the latest version of CMake  here if it's not already installed.

如果尚未安装最新版本的 CMake,请在此处安装。

 

Step 3 - Install Dependencies
步骤 3 - 安装依赖项

You will need to install the following dependencies and CMake will need to be able to locate them (ie. they need to be listed on your PATH):

您将需要安装以下依赖项,并且 CMake 需要能够找到它们(即,它们需要在您的 PATH 上列出):

1. SDL2
2. SDL2_image
3. Boost (make sure to build the optional dependencies)
4. Flex and Bison

 

Step 4 - Build and Run
步骤 4 - 生成并运行

From the root directory of the project, run the following commands:

在项目的根目录下,运行以下命令:

build
cd build
cmake ..
cmake --build .

If these steps are successful, a Visual Studio solution will be generated in build. You can open this project with Visual Studio and then run the engine-sim-app project. If you encounter an error telling you that you're missing DLLs, you will have to copy those DLLs to your EXE's directory.
如果这些步骤成功,将在 build .可以使用 Visual Studio 打开此项目,然后运行该项目 engine-sim-app 。如果遇到错误,提示您缺少 DLL,则必须将这些 DLL 复制到 EXE 的目录中。

 

四:环境搭建

接下来我们将严格按照作者给的步骤去做。

需要下载安装配置的有:

Visual Studio 2022,注意一定要勾选中“使用 C++ 进行桌面开发”!!具体安装见网上教程。

Git,Cmake,Python,按照我的方式或者网上的方式下载安装最新版本即可。

SDL2,SDL2_image,Boost ,Flex and Bison,我的这几个依赖的版本如下图:

52e81fea923a4de8a9e51cdee9997b02.png

1.首先安装Git

Git下载链接:https://git-scm.com/download

3ca3428368ed48e9806363d220bed879.png

653545dacfd343d5958bfce86d257e40.png

下载好之后双击Git-2.45.0-64-bit.exe,开始安装,可以选择安装路径之后无脑next,我们在跑通engine-sim时用不到其他的配置,当然如果有其他需求可以在网上搜索详细的安装配置教程进行自定义安装,我在这里就不多赘述了。

b93e850d5dfe4c1f8dd01dc1a6730340.png 79562941ee494006bf06129c619323af.png

安装成功之后,右键点击桌面空白处或文件夹空白处会发现多了两行git选项,可以通过win+r,输入cmd打开命令行输入git -v的方式查看自己的git的环境变量有没有配置好,如图是已经配置好了的。

45f365c3d5ca47bfb53b58e0bfc99e7b.png

2.安装Cmake

Cmake下载链接:https://cmake.org/download/

Cmake的版本要求在3.5以上,注意3.29的版本是大于3.5的。

bcdf5f6e7b984d15af16513f3ed1e7aa.png

我的电脑是win 64位的,我下载的这个版本。

下载好后双击安装,一路默认选项安装即可,如果有自定义需求可自行上网查阅安装教程。

安装好之后,可在命令行中输入 cmake -version,查看是否已经安装好了cmake。5864a05aa14d44e2aa1e0a5155992563.png

3.安装Python

Python下载链接:https://www.python.org/

5edf3da3422346ba8df0a533f944d144.png

点击下载Python最新版本

44c3d4b058704382b3a16c56ddc6a818.png

点进去之后往下拉到最下面,找到files,

c72f14230d884915b1f2add59b0682b6.png

小编的电脑是64位,所以我选择这个版本,大家根据自己的需求选择相应版本即可。        

下载好之后安装,一路默认next即可,有自定义需求可自行查阅相关教程。

安装好之后,打开命令行输入python可查看版本信息,检查自己的python是否已经安装配置好了环境。

8094a920a3f640b1bd0ce3599531fcdf.png

4.下载配置SDL2

SDL2下载链接:https://www.libsdl.org/

跟随下图点击        

0dd89d4b77ee4cf792b534cda73102ea.png

3d0b04912cfe4aeb9c0eece1adf20910.png

 下载开发者的VC版本,解压后,根据其解压路径配置环境变量,如下图(包含所有剩下的依赖的环境变量配置):

右键点击计算机点击属性

7d4410f181e444dfbbea7ac428589c67.png

一路点进去

6c2431e618e6400baf4cf3658c7d6f2e.png        

778e67eeb0624ef3886c1d6666e565f0.png

        e8720f0c947d4838b20a8844d54f8f1b.png

68be28e5bc724e73bad5d2e7182332a4.png

5.下载配置SDL2_image

SDL2_image下载链接:https://github.com/libsdl-org/SDL_image/releases

我下载的版本如下图:

738921287aff4943988a291b09b2a884.png

下载完后解压,按照https://img-blog.csdnimg.cn/direct/e8720f0c947d4838b20a8844d54f8f1b.png

配置方式配置环境变量即可。

6.下载配置Boost

Boost下载链接:https://www.boost.org/

打开链接后

7498a182d1f94666b16af760072f1927.png

78085bfe954c4fd194c3345404ac39e5.png

选择win版本压缩包下载,解压之后打开文件夹。双击bootstrap.bat 进行批处理。

b63be6ad48e5442aa6ae5b4654f42eb9.png908009b2bf6844788195d7aad640d82b.png

221ed4c16216409cbf132d07b8bbb73a.png

处理结束之后文件夹会生成一个b2.exe的文件,双击他,并等待其执行结束

4562e098697944a69e18be305c67423a.png

21b2a089f9cb4c858053467191e3b1ec.png

结束之后按照https://img-blog.csdnimg.cn/direct/e8720f0c947d4838b20a8844d54f8f1b.png的配置方式配置环境变量即可。

7.下载配置Flex and Bison

Flex and Bison下载链接:https://github.com/lexxmark/winflexbison/releases/tag/v2.5.25

76adb805e2874432a99ecec1efe9d8d4.png

下载完成后解压,并且按照https://img-blog.csdnimg.cn/direct/e8720f0c947d4838b20a8844d54f8f1b.png的配置方式配置环境变量即可。

至此我们已经将所有的依赖全部配置完成。

五:编译

1.Git Clone项目

新建文件夹并在文件夹内右键空白区域,选择下图红框内点击Git Bash。

9a8fff8b97e744258a108283edf72b22.png

10ef83d3c3ee4ef29dcbe931f843a557.png

打开gui之后,接下来严格按照作者给的git克隆链接复制(否则可能子项目下载不全,给自己埋坑):

git clone --recurse-submodules https://github.com/ange-yaghi/engine-sim

在git命令行内右键选择Paste粘贴

d1ea23a09673472ba32a9b4d0c6ecde3.png

然后回车执行命令,你可能会遇到下图错误,不要沮丧,多试几次就好了。

cf92e3a4f22743ec9d12ad2ed8d1f3b8.png

小编试了大概有十分钟,终于成功了。

8f85c6930689479ba0836b2a681e91da.png

所有的submodules都下载好了之后。打开项目。

c96505235cf049bea21c6750bc071f68.png

6988bc9f699a427599629a812ffc49c2.png

可以在该路径下查看自己的子项目都有没有下载成功,打开自己的子项目查看里面有没有内容,如果都有内容,就是下载好了。

2.生成项目构建文件

然后在该路径内输入cmd,并敲回车打开命令行。

1bdecc587e5340849b4051fed170e321.png

然后按照作者给的命令输入:

build
cd build
cmake ..
cmake --build .

5cd2800021204f879376f4ea5ef2867f.png

cf9846454962420495fee408202107d9.png

如图,cmake ..   命令没有报错。

如果在执行该命令时报错了,可能是依赖的版本过低或者没有配置好环境变量,可以将依赖版本换成我用的版本,在cmake命令行中我们可以看到自己安装的依赖的版本,可以和下图我下载的依赖版本进行对照并修改。

e463bbf024c249ac845df8094b9999d6.png

3.build!

我们接着下一步命令cmake -build .    注意build后面有一个点别漏了

5acbb08987944512b95fac5bbf1c7142.png

cc4a850a73ab4ab08dfbd4998fa4e6a2.png

编译完成之后,在如下文件夹路径中可看到.sln解决方案已经生成。

9a1620bf04f14efaa5088358afad7e94.png

用VC打开engine-sim.sln,设置一下VC启动项目。53c8a1185f254b1fb6fa9059e5f5343a.png

1a64ab17ca104a2cbc38675000a0f096.png

配置切换成release,然后启动。

447fec1231ed4119aa5be5f74d63f73e.png

如果提示缺少下图dll,

b39ff1339baa405dbdcdc53cc3e3c034.png

bf2be9ec36f14ca495e466dc920a280a.png

可以在build文件内

0d01ad19be844133b48e1200598cfac9.png

601f158c7f824ae48f6d99ff532c8760.png

找到相应的库,复制到D:\ESE\engine-sim\build\Release目录下即可。

a87c894bf02f40358548f1b678815223.png

如果提示还缺少其他库,可以在网上自行搜索下载到该目录下。

然后再次运行。

7ef206e380c944208abf1829968d4c2d.png

大功告成!

如果依赖依旧是下载配置不对正确的版本,可以联系我要我的依赖库,我会打包发给你。

有任何问题都可以联系我分享交流学习。

 

 

 

  • 32
    点赞
  • 33
    收藏
    觉得还不错? 一键收藏
  • 4
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值