当前位置 : 主页 > 编程语言 > 其它开发 >

[Lua游戏AI开发指南] 笔记零 - 框架搭建

来源:互联网 收集:自由互联 发布时间:2022-05-30
一、图书详情 《Lua游戏AI开发指南》,原作名: Learning Game AI Programming with Lua。 豆瓣:https://book.douban.com/subject/30268009/ 出版社图书详情:https://www.ptpress.com.cn/shopping/buy?bookId=23e4c970-5ad8-4
一、图书详情

《Lua游戏AI开发指南》,原作名: Learning Game AI Programming with Lua。

豆瓣:https://book.douban.com/subject/30268009/

出版社图书详情:https://www.ptpress.com.cn/shopping/buy?bookId=23e4c970-5ad8-4dfa-a850-8da889927e89

二、前言

本文为此书的学习笔记,笔记顺序不与书籍内容一一对应。大概是记录碰到的问题及衍生的学习资料,以作备忘。

各种第三方模块的编译和集成是一件很繁琐的事情,作者为了便于教学,预先组装了一个相对容易构建的“沙箱”,以使读者能够专注于游戏AI开发。但书籍出版于2014年,“沙箱”本身的构建也因为运行环境的变动而出现了各种编译错误。

本节记录一些环境搭建过程中碰到的构建错误,主要是书本第一章的内容。

三、运行环境
  1. Windows 10
  2. Visual Studio 2019
四、生成 Visual Studio 解决方案 (一)随书代码获取

从“出版社图书详情”链接可下载随书代码资源,解压后目录结构如下:

├── bin
├── decoda
├── media
├── premake
├── src
├── tools
├── CHANGES.txt
├── LICENSE.txt
├── README.txt
├── vs2008.bat
├── vs2010.bat
├── vs2012.bat
└── vs2013.bat
(二)premake 替换

运行 vs20xx.bat 文件会调用的主要命令行如下,4个bat文件的区别只是 premake 的参数不同:

// vs2013.bat
...
// 调用 premake5 程序
// 使用 premake/premake.lua 作为构建配置清单,生成 vs2013 项目
tools\premake\premake5 --os=windows --file=premake/premake.lua vs2013 %ARGUMENTS%
...

要生成 vs2019 的解决方案,需要从 premake 官网 下载最新的 premake5,替换掉 tools\premake\premake5。

然后拷贝创建一份 vs2019.bat 文件:

// vs2019.bat
...
tools\premake\premake5 --os=windows --file=premake/premake.lua vs2019 %ARGUMENTS%
...

运行 vs2019.bat,将在 build 目录下生成 Learning Game AI Programming.sln 及一系列项目文件。

五、各种编译错误解决

使用 vs2019 打开 Learning Game AI Programming.sln,可以从解决方案资源管理器看到整体的项目结构。

生成解决方案,提示各种编译错误:
图片1

(一)编译器错误 C2220

C2220 - 警告被视为错误

右键属性 - 配置属性 - C/C++ - 常规 - "将警告视为错误"

图片2

但教学解决方案中包含了十几个项目文件,不可能一个一个修改,所以要修改的是前面提到的构建配置清单:premake/premake.lua

注释掉 premake.lua 中的 “FatalWarnings”,运行 vs2019.bat 重新生成解决方案,编译错误数量从 321 -> 161。

(二)编译器错误 C2440

C2440 无法从"type1"转换为"type2"

Unicode 字符问题,同样在项目右键属性 - 配置属性 - 高级 - "字符集",可进行修改,从 Unicode 改为 多字节字符集

对应到 premake.lua 中,添加 characterset 配置:

...
solution( "Learning Game AI Programming" )
	location( "../build/" )
	configurations( { "Debug", "Release" } )
	platforms( { "x32", "x64" } )
	characterset ("MBCS")
-- configuration shared between all projects
	language( "C++" )
	includedirs( { "../src/%{prj.name}/include/" } )
    warnings( "Extra" )
	flags( {
--		"FatalWarnings",
...

运行 vs2019.bat,重新生成解决方案

(三)Cannot open include file "d3dx9.h"

Windows 10 不包含D3D9相关的工具库,最新的 D3D12 则似乎是与 Windows Kit一起安装在 Program Files (x86)\Windows Kits\10\。

参考:https://stackoverflow.com/questions/63287230/how-to-find-directx-loctation-for-d3dx9-h-error

在 https://www.microsoft.com/en-us/download/details.aspx?id=6812 下载安装 DirectX SDK,通常会安装在 Program Files (x86)\Microsoft DirectX SDK (June 2010),安装程序会自动设置 $(DXSDK_DIR) 环境变量

(四)#error: Macro definition of snprintf conflicts with Standard Library function declaration

#error 是自抛出的错误,按照错误提示,大意是重复定义了 snprintf 宏,因为在 VS2015 以上版本已经对 snprintf 提供了官方支持。

所以全文搜索 define snprintf _snprintf 进行注释,大约有4处。

(五)LNK2019: 无法解析的外部符号 __vsnprintf

修改完错误(四)后大概会报这个错误,大意是找不到 __vsnprintf 这个函数,因为我们刚把宏定义注释了,而这些静态库又找不到官方支持的内联函数(?),所以我们需要引用依赖 legacy_stdio_definitions.lib 这个库

具体说明可参考:

  1. https://www.cnblogs.com/cnxkey/articles/8319812.html
  2. https://stackoverflow.com/questions/31053670/unresolved-external-symbol-vsnprintf-in-dxerr-lib

如果你是使用 Visual Studio Installer 安装的 VS2019,那么这个库的位置是在“Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\lib\”,这是每个项目会自动搜索的路径,所以不需要填写依赖的绝对路径,只需添加库名字即可。

在项目右键属性 - 配置属性 - 链接器 - 输入 - "附加依赖项" 中添加 “legacy_stdio_definitions.lib”。

可以看到附加依赖项中已经有许多被依赖的库了,你可能会意识到这些是在 premake.lua 中配置的,新增一行即可:

	configuration( { "windows" } )
	buildoptions( { "/I \"$(DXSDK_DIR)/Include/\"" } )
    links( {
        "d3d9",
        "dinput8",
        "dxguid",
        "d3dx9",
        "DxErr",
-- 新增 legacy_stdio_definitions 依赖
        "legacy_stdio_definitions.lib"
    } )

运行 vs2019.bat,重新生成解决方案

(六)LNK2019: 无法解析的外部符号 _WinMain

原因参考:https://www.cnblogs.com/imzhstar/p/4110870.html

_WinMain 是 Windows 程序的入口函数,而教学代码里的只有 main(),说明其实是个控制台程序。

检查项目右键属性 - 配置属性 - 链接器 - 系统 - "子系统",从 "/SUBSYSTEM:WINDOWS" 改成 "SUBSYSTEM:CONSOLE"

修改 premake.lua 的 kind 配置,从 kind( "WindowedApp" ) 改为 kind( "ConsoleApp" )

运行 vs2019.bat,重新生成解决方案

(七)其他

期间有少量函数参数数量不相符的问题,直接简单粗暴地传0或者去掉某个参数进行修复,总之先跑起来再说。

六、运行项目

编译无报错后,设置 chapter_1_introduction 为启动项目,菜单选择调试 - 执行。

图片2

运行成功!

七、后记

说来惭愧,单这些构建错误就花了整一天才处理完毕,对目前阶段的自己来说确实琐碎难解,曾一度望着错误列表想放弃本书。甚至在撰写本文的过程中一度忘记昨日是如何处理的某个错误。

好在最终也算运行成功,赶忙记录,以作备忘。

后续学习中也许会尝试做的事情:

  1. 将教学项目的 Lua5.1 替换为 Lua5.4
  2. 使用 Vscode 替代 Decoda 调试 Lua 代码
  3. 替换 ogre,ogred3d9 为最新的 dx12 版本
  4. 替换 opensteer,Recast 等第三方库为最新版本
网友评论