虚幻4随笔4 从project開始



前文说到UE3開始。虚幻就使用了UnrealBuildTool（下面简称UBT）来编译和生成代码。

为什么这么做而不是使用VS是非常好理解的：由于VS跨平台会比較麻烦。像虚幻这样体量的project，单为project做一次VS配置就基本是一天的时间

并且UE4还不像UE3那样就十几个project，把全部uproject都看做project的话，得几十了。依赖关系复杂度几何增长，用VS的工具去维护……并且要维护各个平台和配置……再加上维护完后Mac、Linux还得维护一遍……

可是为什么不使用成熟的CMAKE呢。私以为可能是由于UBT里有一系列错综复杂的规则，用CMAKE制作出来，即便可读性OK，调试也比較麻烦。并且CMAKE对引擎使用者提出了一定的要求，而UBT则相对简单——仅仅要你不纠结它怎样实现。

官网的这篇文章详解了为什么要做一个Build Tool出来：

https://docs.unrealengine.com/latest/INT/Programming/UnrealBuildSystem/ProjectFileGenerator/index.html

What are the advantages of generating project files?

能够先看看UBT的基本规则：

https://docs.unrealengine.com/latest/INT/Programming/UnrealBuildSystem/index.html

眼下说来，虚幻的全部代码集中在以下几个目录里：

<Root>的Source，这个目录里主要是引擎代码。

当中：

Source/Runtime里主要是引擎的核心代码。

Source/Developer里似乎主要是一些工具project。

Source/Editor里是编辑器相关代码。

Source/Programs里是引擎使用中须要用到的工具。比方UBT、UnrealHeaderTool、Swarm（分布式光照计算系统）等等。

Source/ThirdParty里是各种第三方库。

<Root>的Plugin，这个目录里有各式各样的Plugin实现。特殊的是Plugin的组织中须要多一个uplugin。可能是Plugin下可能会有一些资源什么的吧。

我们后面再来看uplugin。

<project项目>的Source。假设是代码project的话。

UBT眼下仅仅认这几个目录。也就是说，假设你要为引擎扩展功能，您仅仅能在这些目录里创建自己的project。这一点是在UBT里写死的，有代码的能够关注一下UBTproject的FindAllRulesSourceFiles这种方法。

在这些目录里，您能够搜索到大量的*.Build.cs文件，这些Build.cs就是虚幻的project组织核心，基本上，每一个Build文件都能够被视为一个project文件，而Build文件所在的目录能够被视为此project的根目录。接下来，我们最好还是称这些拥有Build.cs的目录为project。

UBT一開始会先去找全部的Build.cs。把它们放在一起生成一个暂时的dll。

然后基于它们逐个进行一系列的代码分析工作，最后调用命令行进行编译和连接过程。

对于每一个project而言，代码一般都散落在以下几个目录：

Classes：假设你在project根文件夹下写了个Classes，就相当于告诉UBT这些文件是要用UnrealHeaderTool来生成执行时反射信息的。

所以。这个文件夹里头文件的写法必须符合可反射类的写法规范。

还记得虚幻的哪些类是可反射的吗？对了。全部UObject的派生类包含AActor的派生类。

详细是否有所验证还没看，只是最好是依照这个节奏来。

规范上无非主要就是USTRUCT、UCLASS这些宏，抄几个就能找到感觉。或者用编辑器的类生成功能也可。

看起来，虚幻引擎公布时（不是通过编译生成，而是通过Launcher下载的那种），这些Classes文件是随引擎公布的，方便不具备全代码的Mod爱好者和BluePrint开发人员们来制作游戏。

Public：公共头文件，跟Classes一样随着引擎公布而公布，所以这里一般都是些比較开放的接口。比方模块入口、功能核心接口什么的。

基本上这些接口没有废话，非常清晰。跟实现相关的细节隐藏得非常好。与Classes同样。假设你的project里有Public，那么里面的.h就会被当作Public来。

Private：这个目录似乎不是虚幻定死的。也就是似乎能够不用Private的名字。或者多来几个目录什么的。除了UHT中有一段代码与之有一定关联之外，UBT里是全然没有跟这个有关的东西。它里面基本上就是各种实现代码，以及要在实现间共享的头文件。你也能够创建其它类似的目录，仅仅须要Build.cs里写上对应的目录名就可以：

此外还有须要注意的地方是Source根文件夹下的Target.cs文件，Target的终于目标一般都是可运行文件。能够说，Target是整个生成期的入口，生成会首先从找到Target開始。假设没有Target或者找不到。就会直接失败。

此外。须要注意的是。Target.cs里面写的类的类名，必须是Target.cs的文件名称加Target，比如：Sample.Target.cs，其类名必须是SampleTarget。

UBT的GetTargetTypeAndRulesInstance方法里印证了这一点。

UBT里面还是有不少限定使用方法的，Target就是当中之中的一个。虚幻是一个比較强调命名的引擎，改名有非常多麻烦。最好是可以一步到位。

今天抽出时间看了看文档，大概跟了跟UBT的流程，明天继续。