| - | - |
|---|---|
| 文章 | UE4入门学习4：C++编程介绍 |
| 作者 | 游蓝海( http://blog.csdn.net/you_lan_hai ) |
UE4直接使用C++作为逻辑层语言，这样引擎层与逻辑层语言统一，不需要胶水代码去转发，消除了逻辑层和引擎层的交互成本。为了便于开发，UE4对C++做了一些包装，比如反射和垃圾回收，大大减轻C++开发的难度。本文结合UE4官方C++编程指南文档，对C++相关特性做一些描述和总结。
反射
C++本来是不支持反射的，只有一个基本的RTTI（运行时类型信息）特性，仅能在运行时获取对象的类型信息，无法得到成员变量和函数列表信息。如果我们要对成员变量进行序列化（存档/读档），需要自己写很多辅助的读取和写入方法，非常麻烦。
UE4在C++编译开始前，使用工具UnrealHeaderTool，对C++代码进行预处理，收集出类型和成员等信息，并自动生成相关序列化代码。然后再调用真正的C++编译器，将自动生成的代码与原始代码一并进行编译，生成最终的可执行文件。这个过程类似于Qt的qmake预处理机制。
拿出我们之前工程的代码来分析：
// Fill out your copyright notice in the Description page of Project Settings.
#pragma once
#include "GameFramework/Actor.h"
#include "MyActor.generated.h"
UCLASS()
class HELLOUE4_API AMyActor : public AActor
{
GENERATED_BODY()
public:
// 默认构造函数，初始化一些成员属性。
AMyActor();
protected:
// 游戏开始或者被创建出来后调用。
virtual void BeginPlay() override;
public:
// 每帧都会被调用
virtual void Tick(float DeltaTime) override;
// 这个变量会出现在编辑器编辑界面。
UPROPERTY(EditAnywhere)
int32 MyID;
private:
// 这是个内部变量。不会出现在编辑器界面。
float RunningTime;
};这个代码文件包含了一些特殊的头文件和宏，下面逐一介绍：
| 名称 | 描述 |
|---|---|
| MyActor.generated.h | 这个文件是UE4自动生成的，里面存贮了UE4收集的类型信息。 |
| UCLASS | 告诉UE4这个类需要收集类型信息 |
| UPROPERTY | 告诉UE4这个成员变量的信息需要被收集 |
| GENERATED_BODY | 告诉UE4自动生成的代码注入在这里 |
以下是MyActor.generated.h中的部分代码：
#define HelloUE4_Source_HelloUE4_MyActor_h_9_INCLASS_NO_PURE_DECLS
private:
static void StaticRegisterNativesAMyActor();
friend HELLOUE4_API class UClass* Z_Construct_UClass_AMyActor();
public:
DECLARE_CLASS(AMyActor, AActor, COMPILED_IN_FLAGS(0), 0, TEXT("/Script/HelloUE4"), NO_API)
DECLARE_SERIALIZER(AMyActor)
/** Indicates whether the class is compiled into the engine */
enum {IsIntrinsic=COMPILED_IN_INTRINSIC};实际上，GENERATED_BODY这个宏最终展开后就对应了宏HelloUE4_Source_HelloUE4_MyActor_h_9_INCLASS_NO_PURE_DECLS，也就是说自动生成的代码会在C++编译的时候注入到了类AMyActor中。
注意，如果声明变量或类型不加上前缀，是不会生成类型信息的。下面是一些基本的类型标记：
- UCLASS() - 告诉UE4生成类的反射数据。类必须派生自 UObject。
- USTRUCT() - 告诉UE4生成结构体的反射数据。
- UENUM() - 告诉UE4生成枚举的反射数据。
- GENERATED_BODY() - UE4 使用它替代为类型生成的所有必需样板文件代码。
- UPROPERTY() - 使 UCLASS 或 USTRUCT 的成员变量可用作 UPROPERTY。UPROPERTY 用途广泛。它允许变量被复制、被序列化，并可从蓝图中进行访问。垃圾回收器还使用它们来追踪对 UObject 的引用数。
- UFUNCTION() - 使 UCLASS 或 USTRUCT 的类方法可用作 UFUNCTION。UFUNCTION 允许类方法从蓝图中被调用，并在其他资源中用作 RPC。
序列化
有了反射功能之后，成员变量的序列化也就更方便了。UE4收集了每个类成员的类型信息，这样存档和读档时，根据名称和类型就可以自动完成了，整个过程不需要人工干预。
需要序列化的成员变量，需要在变量声明的时候在前面加上UPROPERTY()宏，宏参数有很多，分别表示变量的详细属性，下面列举一些常用的：
| UPROPERTY参数 | 说明 |
|---|---|
| EditAnywhere | 表示该属性可从编辑器内的属性窗口编辑。 |
| Category | 定义属性的分类。使用方法: Category=CategoryName. （分类=分类名称） |
| Const | 编辑器中不能修改该值 |
| BlueprintReadOnly | 在蓝图中只读，不可修该。 |
| BlueprintReadWrite | 在蓝图中可读写。 |
| BlueprintCallable | 仅能用于Multicast代理。该代理可被蓝图调用。 |
与UPROPERTY对应的还有一个用于修饰函数的宏UFUNCTION，该宏常用于描述如何从蓝图中访问C++的函数。
| UFUNCTION参数 | 说明 |
|---|---|
| BlueprintCallable | 这种类型的函数，只能在C++中实现和重写。可以理解为蓝图“只读”函数。 |
| BlueprintImplementableEvent | 只能在蓝图中实现的函数。类似于C++的纯虚函数 |
| BuleprintNativeEvent | C++可以提供默认实现，蓝图可以重写。 |
热重载
在编辑器模式下，UE4将工程代码编译成动态链接库，这样编辑器可以动态的加载和卸载某个动态链接库。UE4为工程自动生成一个cpp文件（本工程为HelloUE4.generated.cpp），cpp文件包含了当前工程中所有需要反射的类信息，以及类成员列表和每个成员的类型信息。在动态链接库被编辑器加载的时候，自动将类信息注册到编辑器中。反之，卸载的时候，这样类信息也会被反注册。
在开发的过程中，当我们编译完成工程的时候，UE4编辑器会自动检测动态链接库的变化，然后自动热重载这些动态链接库中的类信息。
垃圾回收
有了反射机制，UE4也能够知道哪些类型是指针类型，以及哪些变量需要被垃圾收集系统管理。被垃圾收集系统管理的对象，不需要手动调用delete，只需要正确的维持变量的引用即可。我没有看过UE4垃圾收集系统实现源码，姑且将UE4的垃圾收集系统看成是一个使用了“标记-清扫”算法的一个沙盒，当不需要使用某个指针变量的时候，我们只需要把他置为NULL，在下个垃圾回收阶段中，系统会自动回收。
使用垃圾回收的时候，需要遵从一定的规范：
- 所有需要被托管的成员变量需要用宏
UPROPERTY()标记 - 所有从UObject派生的类，才能被系统托管。非UObject派生的类可以考虑从类FGCObject派生，并实现
AddReferencedObjects方法，或者使用智能指针 - 数组TArray的UObject类型指针元素，可以被自动托管
- Actor类型对象在不用的时候，需要手动调用Destroy。调用Destroy后不会立即消耗，也会等待下个垃圾回收阶段
编码规范
类名前缀
UE4的类名必须遵从命名规范，需要在类名前面加上正确的前缀，与之对应的C++文件名则不加前缀。否则会编译报错。
- 派生自 Actor 的类前缀为 A，如 AController。
- 派生自 UObject 的类前缀为 U，如 UComponent。
- 枚举 的前缀为 E，如 EFortificationType。
- 接口 类的前缀通常为 I，如 IAbilitySystemInterface。
- 模板 类的前缀为 T，如 TArray。
- 派生自 SWidget(Slate UI)的类前缀为 S，如 SButton。
- 其余类的前缀均为 字母 F ，如 FVector。
其他类型命名
bool类型变量需要加上b前缀，如 bCallable。
参考
- UE4 中的 C++ 编程介绍
https://docs.unrealengine.com/latest/CHN/Programming/Introduction/index.html - UE4 编码规范
https://docs.unrealengine.com/latest/CHN/Programming/Development/CodingStandard/index.html
本系列文章会和我的个人公众号同步更新，感兴趣的朋友可以关注下我的公众号：游戏引擎学习。扫下面的二维码加关注：
