写在前面
这里主要是记录一下Visual Studio和Editor之间的关系和如何使用它们进行UE4协同开发。
一、启动
1. 先启动Visual Studio再启动Editor
(1) 打开项目根目录下的xxx.sln解决方案，即可启动Visual Studio，这个是和普通的C++项目打开方式相同的； (2) 在打开的C++项目中，点击本地Windows调试器编译程序即可启动Editor； 但这样一来，修改的代码就不能在Editor中生效了，需要停止调试再重新编译调试启动Editor才能将修改的代码生效； 所以这种方式不太推荐使用的；
2. 先启动Editor再启动Visual Studio
(1) 启动Editor的方式有四种： 打开已有UE4项目： 如果是已有UE4项目，则可以打开项目根目录的xxx.uproject，即可启动项目对应的Editor； 新建UE4项目或者打开已有UE4项目： 如果之前并没有已经创建的UE4项目，或者需要新建一个UE4项目，则可以点击UE4 Unreal Engine快捷方式（一般按官方途径安装之后在桌面就会有）启动Editor，然后按照指引新建一个UE4项目； [推荐] 当然也可以点击UE4 Epic Games Launcher快捷方式，在库中启动对应版本的引擎，也可以进入Editor新建项目指引，一般是更推荐这种方式，因为可以管理不同版本的引擎； 另外，如果是通过源码编译得到的Unreal Engine，则需要在源码中打开UE4.sln，先调用Visual Studio打开Unreal Engine，然后右键UE4项目->Debug->Start new instance即可调出Editor界面，这样也可以进入Editor新建项目指引； 当然上面的三种方法除了新建UE4项目之外，也可以打开已有的UE4项目，只要启动了Editor基本上就比较容易操作了； (2) 在Editor中新建项目或者打开已有项目之后，在工具栏点击文件->打开Visual Studio即可用Visual Studio打开项目对应的UE4项目代码； 注意，项目的Editor和新建项目时启动的Editor是不一样的，后者可以视为一个引导程序，而前者才是xxx.uproject对应的Editor；
二、目录结构
1. C++项目文件目录结构
一个基本的UE4项目的项目文件结构如下： 各个文件夹对应的含义如下：
Binaries：可执行文件和DLL文件；Config：配置文件，包含了项目设置，键盘输入之类的配置文件；Content：存放引擎或者游戏的内容文件，包括地图、贴图、模型、材质和蓝图等；Intermediate：临时构造文件，包含了在编译引擎或者游戏时生成的临时文件；Saved：保存的内容，包括自动保存的文件、本地配置文件（*.ini文件）、截图和日志文件；Source：源代码，包括项目的所有源代码； 其中最重要的文件夹是Content和Source，前者用于管理各种内容文件，后者用于管理源代码，是C++项目和Editor沟通的桥梁；
2. Editor内容浏览器文件目录结构
一个基本的Editor内容浏览器的文件目录结构如下： (1) 内容文件夹和C++项目中的Content文件夹基本上是完全对应的，里面的资源文件均可以通过文件资源管理器在Content文件夹中找到，而且目录结构一致； (2) C++类文件夹和Source文件夹基本上是完全对应的，所有出现的C++类均可以在文件资源管理器的Source文件夹中找到，而且目录结构一致； 一个简单的示例如下： TestCppGameModeBase这个类在Source文件夹中有对应的.cpp和.h，在内容浏览器中也有对应的映射；
如果发现内容浏览器中少了某些文件夹，可以点击右下角的视图选项勾选需要的内容，就可以在内容浏览器中看到了；
三、C++类和蓝图的相互协作
Visual Studio负责管理C++类源码，Editor则负责蓝图和资源的组织管理，它们之间最重要的沟通桥梁就是C++类和蓝图之间协作；这里将介绍如何创建一个最基本的UObject类，然后在蓝图中调用它；
1. 创建C++类
C++类要在Editor中创建，在内容浏览器的C++类->工程文件夹目录下右键，点击新建C++类即可；勾选显示所有类可显示所有的已有类；
点击下一步，检查当前类是否创建于项目文件夹下；勾选公有按钮，会自动将该类的.h文件放到Public文件夹下，将.cpp文件放到Private文件夹下；修改类的命名，注意要用大驼峰式，所有首字母均大写，不需要加前缀，因为这个是类文件名，真正的类名UE4会自动帮我们加上的；
如果新建类后，在内容浏览器中没有显示，可以：
使用Editor的编译按钮编译；在Visual Studio中生成解决方案编译；或者尝试重新进入对应的目录中，刷新界面显示内容；
2. 创建C++类对应的蓝图类
使用UObject为父类创建的类是最基本的类，类内的内容十分简洁；它的头文件包括类的声明、类成员变量和类成员函数声明，如下：
它的cpp仅包含一行头文件，内容如下：
此时的PrintOnScreenObject类是无法在Editor中创建蓝图类的，需要给它加上Blueprintable说明符，如下：
回到Editor中，在C++类上右键创建基于xxx的蓝图类，即可创建对应的蓝图类，如下：
蓝图是资源的一种，因此创建的蓝图类会在Content文件夹下；创建了蓝图类之后还要把它移动到合适的文件夹中，做好分类，如下：
3. 实现C++成员函数
为了能让PrintOnScreenObject类的成员变量和函数均能在蓝图中可见，需要为它们增加对应的宏说明符，如下：
然后，在.cpp文件中实现打印的功能，参考博客：UE4 C++ 之 打印；(1) UE4打印到日志：
// 日志实现的格式如下
UE_LOG(日志变量名, 日志级别, 日志内容);
// 日志的级别有三种：Log, Warning, Error
// 输出文本
UE_LOG(LogTemp, Log, TEXT("This Log is grey text."));
// 输出含普通类型字符串
int32 ID = 5;
UE_LOG(LogTemp, Warning, TEXT("This Log's id = %d"), ID);
(2) UE4打印到屏幕：
// 打印到屏幕的实现格式如下
GEngine->AddOnScreenDebugMessage(-1, 显示持续时间, 显示颜色, 显示内容);
// 打印文本
GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Red, TEXT("Hello world!"));
// 打印含普通类型的字符串
FString MyName = "Jeremy";
GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Red, FString::Printf(TEXT("My name is: %s."), *MyName));
float Height = 179.0f
GEngine->AddOnScreenDebugMessage(-1, 5.0f, FColor::Red, FString::Printf(TEXT("I am %f cm tall."), Height));
因此，实现的成员函数如下：
4. 构建调用C++类的蓝图
因为只有Actor才能放进地图里面，而前面创建的类是UObject类型的，所以还要额外创建一个Actor蓝图类，如下：
双击Actor蓝图类，打开蓝图编辑界面，并搭建调用蓝图PrintOnScreenObject类的蓝图，如下：
一些注意的点如下：
首先要让当前Actor类有一个PrintOnScreenObject类成员变量，在左下方的我的蓝图->变量中新加即可；蓝图的逻辑是：构建一个PrintOnScreenObject类对象，拥有者是当前Actor类，然后把构造的对象赋给PrintOnScreenObject变量，然后通过该变量调用PrintOnScreenObject类的成员函数PrintToScreen；白色点的连接表示执行过程的传递，其余点的连接表示变量数据的传递；如果在C++代码中修改了成员函数或者变量的名字，则蓝图中的对应气泡需要重新构建；右键气泡节点可以进行快速节点注释；编译C++项目不通过的时候，可以先去Editor进行编译，然后再回到Visual Studio中编译； 搭建好蓝图后，点击左上角的编译按钮；然后回到主面板，将BP_PrintOnScreenActor拖入地图中生成实例，否则蓝图无法生效；
最后点击编译和播放即可；效果是在屏幕上有5秒的内容打印，在日志中有输出warning级别日志信息；
5. 删除类
删除蓝图类：
在内容浏览器中右键选择要删除的蓝图，选择删除即可；删除时，如果选择替换引用，则替换所有的该蓝图类实例，如果选择强制删除，则强制删除所有的该蓝图类实例； 删除C++类要稍微麻烦一点：
关闭所有Editor和Visual Studio窗口；删除类对应的.cpp和.h文件；删除Binaries文件夹；右键.uproject文件，选择Generate Visual Studio project files，重新生成vs项目文件；
四、遇到的问题及处理
1. 调用类成员变量时有红色波浪线报错，但编译能通过
情景：在创建C++类时勾选了公有按钮，.h文件被放到了Public文件夹下，在.cpp中调用类内成员时有大量的红色波浪线报错，Visual Studio无法识别变量类型，也无法给出类的函数提示，虽然编译能够通过，但这样编程就会很难受，既无提示也很难判断是否有拼写错误；原因：代码的目录结构过于复杂，Visual Studio没有将当前代码所需的声明文件包含在搜索路径下；解决方法：
右键项目属性；在NMake中包含搜索路径下，新增声明文件所在的路径，更具体一点的，是当前代码中显示了红色波浪线的变量或者函数所在的声明文件（通常是.h文件）的路径；
2. 调用系统类函数时有红色波浪线报错，但编译能通过
场景：调用别的一些UE4自带的类时，提示找不到该类声明，或者提示不允许指针指向不完整的类类型，无函数提示，但编译能够通过；原因：因为没有引入和该类对应的头文件，但UE4有某些修复机制，导致编译能够通过；解决方法：在代码中右键该类名称，点击转到声明，这时编辑器会给出所有包含该变量声明的头文件位置，选择合适的头文件引入到当前代码中即可；
3. 在Visual Studio中编译不成功但无法定位错误
一种解决方法：可以在Editor中编译，给出的错误信息会比较详细，方便定位错误；其实在Editor中编译等价于在Visual Studio中生成解决方案；
4. 头文件中类提示未定义标识符
场景：如果是需要在头文件中使用一些UE4的类，则有可能提示未定义标识符而报错，因为头文件中确实没有引入这个类对应的头文件，而且也不适合在头文件中引入别的类的头文件，一般只在.cpp文件中才引入，头文件只作声明；解决方法：在类名前增加class关键字，当然也可以在头文件的下面直接将所有用到的类都用class关键字声明一遍，这样就不用每次写类名都声明了；
5. 修改C++类后，在对应的蓝图类面板上没有实时更新信息
场景：用C++类派生蓝图类后，如果修改了C++类的内容，则蓝图类可能不能实时同步更新；解决方法：在类设置->父类中修改为其他类，然后再修改回原来的类，即可刷新C++类中的信息到蓝图类中；
相关文章
您阅读本篇文章共花了：
发表评论