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

一、图书详情《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年，“沙箱”本身的构建也因为运行环境的变动而出现了各种编译错误。
本节记录一些环境搭建过程中碰到的构建错误，主要是书本第一章的内容。
三、运行环境

Windows 10
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，可以从解决方案资源管理器看到整体的项目结构。
生成解决方案，提示各种编译错误：

文章图片

（一）编译器错误 C2220
C2220 - 警告被视为错误
右键属性 - 配置属性 - C/C++ - 常规 - "将警告视为错误"

文章图片

但教学解决方案中包含了十几个项目文件，不可能一个一个修改，所以要修改的是前面提到的构建配置清单：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 这个库
具体说明可参考：

https://www.cnblogs.com/cnxkey/articles/8319812.html
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" )
【[Lua游戏AI开发指南]|[Lua游戏AI开发指南] 笔记零 - 框架搭建】运行 vs2019.bat，重新生成解决方案
（七）其他
期间有少量函数参数数量不相符的问题，直接简单粗暴地传0或者去掉某个参数进行修复，总之先跑起来再说。
六、运行项目编译无报错后，设置 chapter_1_introduction 为启动项目，菜单选择调试 - 执行。

运行成功！
七、后记说来惭愧，单这些构建错误就花了整一天才处理完毕，对目前阶段的自己来说确实琐碎难解，曾一度望着错误列表想放弃本书。甚至在撰写本文的过程中一度忘记昨日是如何处理的某个错误。
好在最终也算运行成功，赶忙记录，以作备忘。
后续学习中也许会尝试做的事情：