下载虚幻引擎源代码

访问GitHub上的虚幻引擎源代码

虚幻引擎提供完整的C++源代码访问权限，以便用户研究、定制、扩展和调试整个虚幻引擎，并毫无阻碍地完成项目。

随着我们在主线上持续开发新功能，我们位于GitHub上的源代码库也会持续更新。因此你甚至无需等到下一个产品版本就能获得最新的代码。

要访问虚幻引擎源代码，请按以下步骤操作：

1. 前往GitHub并注册账号。

2. 使用经过验证的Epic Games账号登录UnrealEngine.com。要打开账号操作面板，请将鼠标悬停到 用户名 上，并在下拉菜单中选择 个人（Personal）。

3. 打开账号操作面板后，在侧边栏中选择 关联 （Connections） 选项卡。选择 账号（Accounts） 选项卡，然后选择GitHub图标下方的 关联（Connect） 按钮。

4. 如果你没有签署过《虚幻引擎终端用户许可协议》，需要先浏览协议条款并勾选复选框，然后选择 关联账号（Link Account）。如果你登出了GitHub账号，在点击"关联账号"按钮后将会被跳转到GitHub登录。

5. 要完成OAuth应用程序授权流程，请点击 授权EpicGames（Authorize EpicGames） 按钮。如需详细了解此流程，请参阅GitHub关于授权OAuth应用程序的概述。

6. GitHub会发送邮件邀请你加入GitHub上的@EpicGames组织。你必须在7天内点击邮件内的 加入@EpicGames（Join @EpicGames） 按钮，才能完成GitHub与Epic Games账号的关联流程。

完成上述步骤后，你将收到来自Epic Games的邮件，确认你的GitHub和Epic Games账号关联成功。如果你没有收到确认邮件，或账号遇到问题，请向客服求助。现在，你就可以前往我们的GitHub页面（需要登录）下载完整源代码了。

源代码分支

你应该已经注意到，我们已将UE源代码发布在若干个分支中。

名字中含有dev、staging和test字样的分支是典型的Epic内部工作分支，对终端用户基本没有用处。在我们稳定新版本或进行在线修正时，可能会时不时出现一些短暂存在的分支。

版本分支

版本（Release） 分支始终代表当前官方版本。这些分支已经过我们QA团队的充分测试，非常适合用来学习虚幻引擎以及开放项目。我们会努力保证版本的稳定与可靠，并争取每隔几个月就发布一个新版本。

主分支

UE大部分活跃的开发工作都发生在ue5-main分支上。此分支代表着最新的引擎版本，可能存在错误或未经过编译。我们将其开放给渴望测试最新功能或与我们同步进行开发的开发者。

在本地机器上设置 Perforce 服务器

运行 Perforce 服务器又两种方式，P4D 和 P4S。P4D 运行时是一个命令行命令，因此它通常被用来做维护工作时使用。P4S 是一个和 P4D 相同功能的服务，这能让服务器程序在后台运行。 当安装 Perforce 服务器工具后，P4S 通常都会被安装并在后台启动。

一旦服务运行后，可以通过 P4Admin 连接到服务器上。这是该服务器上第一个链接，然后就可以在初始连接对话框中创建新用户了。

将服务器的连接信息填入，并点击 OK。一旦在 P4Admin 中连接道服务器后，就可以很容易的创建新的 Depot，用户，用户组。 然后就能在 P4V 或者虚幻编辑器中使用新创建的认证信息来连接服务器。

P4 Typemap

在向新的 Depot 添加文件前，应当先设置 P4 Typemap 来让 Perforce 了解如何对待虚幻文件类型。typemap 的设置能够在 Perforce 中控制文件的只读和可写的形式。 然后要做这件事情，需要先在命令行下设置 P4 的环境变量。

	p4 set P4USER=your.username
	p4 set P4PORT=localhost:1666

Copy full snippet

将上面相应的部分替换为你的用户名和连接地址，并用下面的命令打开 typemap 设置。

	p4 -P YourPassword typemap

Copy full snippet

然后将会看到一个文本窗口，这就是当前服务器的 typemap。下面是我们以前用过的 typemap 示例：

	# Perforce File Type Mapping Specifications.
	#
	#  TypeMap:             a list of filetype mappings; one per line.
	#                       Each line has two elements:
	#
	#                       Filetype: The filetype to use on 'p4 add'.
	#
	#                       Path:     File pattern which will use this filetype.
	#
	# See 'p4 help typemap' for more information.

	TypeMap:
					binary+w //depot/....exe
					binary+w //depot/....dll
					binary+w //depot/....lib
					binary+w //depot/....app
					binary+w //depot/....dylib
					binary+w //depot/....stub
					binary+w //depot/....ipa
					binary //depot/....bmp
					text //depot/....ini
					text //depot/....config
					text //depot/....cpp
					text //depot/....h
					text //depot/....c
					text //depot/....cs
					text //depot/....m
					text //depot/....mm
					text //depot/....py
					binary+l //depot/....uasset
					binary+l //depot/....umap
					binary+l //depot/....upk
					binary+l //depot/....udk
					binary+l //depot/....ubulk

Copy full snippet

完成编辑后，点击键盘上的 Ctrl+S 保存并退出。命令行应该会提示 Typemap saved。

局域网的服务器

可以在本地局域网中设置一个服务器便于团队成员协同工作。只需要遵循上述的过程搭建服务并在客户端使用该服务器的连接信息即可。

云服务商

有一些云服务商提供了 Perforce 的云端架设服务以便于远程协作。可以先快速浏览以下搜索引擎中的 Perforce Hosting 结果。 每个主机服务商都有些不同，但总的来说都是会提供一组验证信息供你连接。查看下面的 从虚幻编辑器中连接 的部分来了解连接到 Perforce 云服务的信息。

设置本地的 Workspace

要在 Perforce 管理下的文件进行工作，需要在本机设置一个 Workspace 这样 Perforce 才能管理这些文件。 可以在 P4V 界面的主菜单中，View 菜单下的打开 Workspace 分页然后便能创建 Workspace 了：

要创建一个新的 Workspace，右键点击 Workspace 窗口空白处，选择 新建 Workspace 选项。然后输入要创建的 Workspace 的名称，以及你希望文件存储在本机的位置目录，即 Workspace 的根目录。

一旦有了服务器以及一个本地的 workspace 设定，便可以开始添加文件了。目前这必须在编辑器外，通过 P4V 来完成。 如果 workspace 中已经有了其他成员设置过的文件，则可以先跳过这一步。在创建一个新项目时，可以选择是 C++ 项目还是纯蓝图项目。 如果选择了 C++ 项目，则可以在项目目录中可以看到有 Source/ 目录。下面这些项目目录初始就应当被添加到版本管理中：

被高亮为 绿色 的目录和文件应该被添加到项目的 Depot 中。Binaries 目录高亮为 黄色，可以选择是否要加入到版本管理中，这取决于团队自生的工作需要。 如果团队中每个人都准备自己来编译引擎和游戏的话，那么 Binaries 则无需加入到版本管理中，但如果团队中有人只是想获取一个版本就能直接在编辑器中工作的话，则需要把 Binaries 添加上去。 请留意先前的 server typemap 的设置，能够让程序员们直接重新编译版本而不受在默认的 Perforce 管理配置下这些文件只读属性的限制。

向 Perforce 添加文件

向 Perforce 添加文件可以通过以下几个步骤完成。

1. 要添加文件/目录到 Perforce的话，先在 P4V 中选择这些文件/目录，然后点击右键并选择 标记为添加 Mark For Add 选项。

   

2. 这将会在默认的 changelist 中添加这些文件。所有添加的文件都可以在待上传 Changelist 分页中查看到：

   

3. 要提交文件的话，首先在 changelist 上 点击右键并选择 Submit。然后就可以填写上传的描述信息，并点击 Submit 按钮完成提交。

   

如果要在一个其他人已经开始的项目中工作，可以直接在 P4V 中从 Perforce 上获取最新版本。 只需要在 P4V 的 Depot 视图中找到相应的项目目录，然后再该项目上 点击右键 并选择 获取最新版本。 然后将会根据当前 workspace 的根目录设置来获取该项目的所有文件到本地硬盘中。

从虚幻编辑器中连接

可以在编辑器中直接连接 Perforce 服务器，只需点击 工具栏 的 版本控制 按钮：

打开后，选择 Perforce 作为软件版本管理软件的提供商，并输入登录验证信息。 如果已经设置过 workspace 的话（当前项目正在该 Workspace 内），登录信息将会自动填上。

对于有些服务器，也包括很多云端的服务，可能会需要手动输入主机和密码信息才能在编辑器中访问 Depot。可以在 Perforce 的登录对话框中打开高级选项即能看到：

下载源代码

请按照如下说明下载虚幻引擎的源代码。

其他目标平台

• 如果你安装过Android NDK，可以通过设置脚本下载 安卓 支持。详情请参见安卓快速入门指南。

• iOS 开发需要使用Mac。相关指南请见iOS快速入门指南。

• 诸如Sony PlayStation、Microsoft Xbox和Nintendo Switch主机和其他平台的开发有权限限制。你必须拥有这些第三方平台的注册开发者账号才能进行相关开发。

如需关于这些平台的额外文档或指南，请访问虚幻开发者网络支持站点，或前往虚幻引擎论坛 的各平台板块下载对应的存档文件。

如果你没有访问这些资源的权限，请先前往这些第三方平台网站注册一个开发者账号，然后联系你的Epic Games账号管理员（如有），如果没有管理员，请填写并提交虚幻引擎主机开发申请表并。Epic会联系你并发送可电子签名的正式协议。完成此步骤后，你就将收到如何访问目标平台源代码、二进制文件及其他内容指南。

许可和贡献

你对GitHub上的Unreal Engine的访问和使用受虚幻引擎最终用户许可协议的约束。如果你不同意这些条款（我们会不时对它们加以修订），你将不会被获准访问或使用虚幻引擎。

我们欢迎你通过GitHub上的拉取请求，为虚幻引擎的开发做出贡献。我们大部分的积极开发都在 主 分支中进行，所以我们更喜欢在那里接受拉取请求（对于新功能而言尤其如此）。我们尽力确保所有新代码都遵守Epic编码标准。所有贡献均受EULA条款的约束。

后续步骤

现在你已经下载并设置了虚幻引擎，你可以随时从源代码构建引擎。

注意事项

当你首次编译源代码并启动编辑器时，加载时间可能会比较长。 引擎会针对你的平台优化内容并将信息保存为 派生数据缓存（derived data cache），这种优化应该只会进行一次。

你为虚幻引擎代码设置的Fork分支会与你的GitHub账号权限关联。 如果你取消了订阅或切换了GitHub用户名，则需要重新创建Fork分支并从本地副本上传改动内容。