UE4入门学习2:工程结构分析

- -
文章 UE4入门学习2:工程结构分析
作者 游蓝海( http://blog.csdn.net/you_lan_hai )

最近又开始996加班了,业余时间更少了,以后文章更细的速度可能也会较慢了。

接上一节《UE4入门学习1:环境搭建》,我把工程整理了一下,工程名称改为“HelloUE4”,放到了github上(https://github.com/youlanhai/LearnUE4)。本文的目的是详细分析上一节中建立的工程结构,从宏观上认识UE4。

文件目录结构

根目录

UE4入门学习2:工程结构分析_第1张图片

上图是UE4工程在Windows系统上的工程目录截图。下面用表格说明每个目录的含义:

文件名称 说明
.vs/ Vistual Studio生成的临时目录,版本库中可忽略
Binaries/ C++代码编译输出的动态链接库文件,编辑器会自动检测和加载这些动态链接库(热重载)。版本库中可忽略
Config/ 工程的配置文件。可以手动打开修改,也可以在UE4编辑器中通过图形界面来修改
Content/ 资源目录。UE4的资源都是以专用的二进制格式存贮的,只能通过编辑器导入。不能手动将资源拷贝到此目录中。
Intermediate/ 存放临时文件的路径。版本库中可忽略
Saved/ 编辑器自动存贮的一些文件,以及日志信息等。版本库可忽略
Source/ C++代码存放路径。
HelloUE4.sln 自动生成的Visual Studio工程文件,可以点击UE4编辑器的文件菜单下“生成Visual Studio工程”来生成,也可以在工程文件(*.uproject)的鼠标右键菜单中选择“Generate Visual Studio Project files”来生成。版本库中可忽略
HelloUE4.uproject UE4项目的工程文件,是json格式的文件。

Source目录

UE4入门学习2:工程结构分析_第2张图片

Source目录比较重要,这里单独说一下。目前Source目录下只有一个文件夹HelloUE4,和两个C#文件。这里的C#文件仅用于描述工程的编译构建信息,类似与Makefile或CMakeLists.txt,文件的格式为“工程名”+ “.Target.cs”。

一个UE4工程可包含若干个“子工程”(Module),子工程在工程文件(*.uproject)文件中定义:

{
    "FileVersion": 3,
    "EngineAssociation": "4.15",
    "Category": "",
    "Description": "",
    "Modules": [
        {
            "Name": "HelloUE4",
            "Type": "Runtime",
            "LoadingPhase": "Default",
            "AdditionalDependencies": [
                "Engine"
            ]
        }
    ]
}

当前的工程只有一个子工程HelloUE4,如果需要多个子工程,可以在这里Modules属性下添加上引用,然后在Source目录里添加上工程文件夹和编译文件(*.Target.cs)。

需要注意的是,Source目录下还有一个”HelloUE4Editor.Target.cs”文件,该文件用于构建编辑器相关的代码。如果工程中存在扩展编辑的代码(也就是存在依赖UnrealEd的代码),需要放到Editor模块下,不能跟Runtime代码放一块,否则无法打包。关于Editor模块如何建立和使用,我们后面专门用一个章节来说明。

场景结构

静态结构

UE4入门学习2:工程结构分析_第3张图片

在场景树的最顶层是关卡Actior——Home,其他的都Actor都必须方到关卡Actor内部。UE4的Actor也支持嵌套,而且场景树支持文件夹过滤器,可以将一组相似的Actor放到一个过滤器中。

运行时结构

UE4入门学习2:工程结构分析_第4张图片

点击“播放”按钮,进入运行模式时,场景树会多出来很多东西。黄色名称的Actor是动态创建出来的。下面大致说一下动态创建出来的对象:

名称 描述
DefaultPawn 默认代表玩家的Actor
PlayerController 玩家的控制器。这里用于接收键盘输入而移动和旋转
PlayerCameraManager 玩家的相机管理器
PlayerState 存贮玩家的游戏内数据
GameModeBase 游戏模式。用于处理游戏玩法的逻辑
GameStateBase 游戏状态。用于记录游戏玩法相关数据
HUD 管理UI

Visual Studio 工程结构

UE4入门学习2:工程结构分析_第5张图片

VS项目分为两个项目:UE4和HelloUE4。UE4是引擎源码,HelloUE4是我们自己创建的工程。这里,我们主要看我们自己工程的结构。

名称 描述
HelloUE4.h 预编译头文件,用于加快编译速度。HelloUE4目录下的所有cpp文件都必须包含该头文件,因此一些比较通用但是不会修改的代码也可以包含在这个文件中。
MyActor.h 我们上一节中创建的Actor类
HelloUE4.Build.cs 构建系统的描述文件。这里主要用于描述当前工程所依赖的库文件。
*.Target.cs 构建系统的描述文件。前面已经说过了
HelloUE4.uproject UE4工程文件。前面也说过了


本系列文章会和我的个人公众号同步更新,感兴趣的朋友可以关注下我的公众号:游戏引擎学习。扫下面的二维码加关注:
游戏引擎学习

你可能感兴趣的:(UE4,游戏引擎学习,ue4)