开源一个虚幻引擎启动器UE Launcher

通常在使用UE进行项目开发时，本地会有多个引擎版本，而Epic Game Launcher只支持安装版引擎的启动，不支持源码编译的引擎。
当本地具有多个引擎版本时，切换不方便，并且没有一种便捷地启动引擎工具、项目以及给项目添加启动参数的方式，在执行Commandlet时需要创建很多脚本，管理非常麻烦。基于这些痛点，我开发了一个UE启动器：UELauncher，用来解决这些问题，同时支持UE4和UE5。

UE Launcher是一个基于UE Standalone Application模式开发的一款工具，使用UE作为基础库，UI使用Slate编写，相关的实现机制可以见我之前的一篇文章：Create A Standalone Application in UE4。

UELauncher功能介绍：

能够扫描出系统中安装的所有引擎版本
能够选择引擎工具（如UE4Editor/UnrealFrontEnd/IPhonePackager等）
能够选择uproject项目
对于源码版引擎能便捷地启动VS打开sln
能够添加启动参数
保存引擎、项目、启动参数等配置
支持全局配置，可以添加配置列表，把常用的配置保存，实现便捷地启动
支持命令行启动
支持uproject文件关联
同时支持UE4和UE5

主界面

具体的功能也是比较直观，后面介绍一下进阶用法。

文件关联

当使用“管理员权限”启动该工具之后，会自动往系统注册表添加uproject的文件关联，类似UE默认的文件关联：

会根据当前项目的引擎版本创建出一个uejson文件，双击即可使用UELauncher打开，编辑启动参数：

编辑配置后可以保存。uejson文件同样具有文件关联，能够使用UELauncher编辑，以及直接不启动窗口来启动配置文件：

这样就可以把UE Launcher当作一个调度器，能够基于配置文件来静默启动。在实现一些commandlet时非常方便。

自定义添加引擎工具

在v0.20版本，我默认集成了以下几个引擎工具：

Editor
Editor-cmd
UnrealFrontEnd
IPhonePackager
NetworkProfiler

但是，如果想要添加其他的工具，如UnrealInsight等，我提供了一种配置文件的方法。在程序启动之后，会在exe目录创建出一个LaunchTools.json文件，里面记录了引擎工具的配置：

可以使用以下格式来添加引擎工具：

{
	"ToolName": "NetworkProfiler",
	"PreArgs": "",
	"BinPath": "Engine/Binaries/DotNET"
}

注意：ToolName必须要严格匹配exe的名字，BinPath是exe相对于引擎的根路径。

全局配置

在工具启动时，会自动加载Global的配置，该配置文件默认在exe所在路径，命名为Global.json。

在新增、删除操作时会自动更新，也可以通过Load Global单独加载其他位置的Global.json。

Global.json也是一个文本json文件：

Global.json

{
  "613EF17D49C4B6CD93268D9EC7E2740F":
  {
    "Engine": "C:/build_agent/workspace/FGameEngine/Engine",
    "Project": "D:/UnrealProjects/Client/FGame.uproject",
    "Tool": "Editor",
    "ToolPreArgs": "",
    "Params": []
  },
  "9952A0F144015DC2301F94A82552E378":
  {
    "Engine": "C:/build_agent/workspace/FGameEngine/Engine",
    "Project": "D:/UnrealProjects/Client/FGame.uproject",
    "Tool": "IPhonePackager",
    "ToolPreArgs": "",
    "Params": []
  },
  "98286E134C9D7BE6A91823A2A6880EED":
  {
    "Engine": "D:/UGit/Engine_bin/FEngine",
    "Project": "D:/UGit/Engine_bin/FClient/FGame.uproject",
    "Tool": "Editor",
    "ToolPreArgs": "",
    "Params": []
  },
  "GUIDs": [
    "613EF17D49C4B6CD93268D9EC7E2740F",
    "9952A0F144015DC2301F94A82552E378",
    "98286E134C9D7BE6A91823A2A6880EED"
  ]
}

命令行启动

我为UE Launcher支持了命令行启动，可以把它当作一个调度器，通过配置文件启动，而不用考虑手动指定引擎版本。

具有以下三个参数：

-e：Edit，创建窗口编辑配置
-c：Commandline，通过命令行方式启动配置
-g：Generate Config，通过传递进来的uproject生成uejson

# 编辑配置
UE4Launcher-Win64-Shipping.exe -e LaunchConf_FGame.uejson
# 命令行启动配置
UE4Launcher-Win64-Shipping.exe -c LaunchConf_FGame.uejson
# 生成uejson
UE4Launcher-Win64-Shipping.exe -g D:\UnrealProjects\Client\Client.uproject

基于提供的命令行的方式可以实现基于配置文件启动预设命令。

Update & Download

v0.22

支持拉起UnralBuildTool生成sln（UE4/UE5）
SEditableBoxWraper支持选择文件
支持打开引擎目录

v0.21

支持启动rider打开sln
优化布局

下载地址：UE4Launcher_v0.21

v0.20

将UELauncher扩展为了支持配置列表的工具，能够非常方便地在配置间切换，使用预设功能。

支持添加全局配置
支持启动时自动读取全局配置
自适应宽度
支持单独加载全局配置、刷新、删除
重新设计布局
默认添加IPhonePackager工具

下载地址：UE4Launcher_v0.20

v0.18

支持了UE5引擎和项目的启动

下载链接：v0.18

v0.17

Download Link

添加启动工具的配置化
优化配置的json结构

现在可以不用修改代码来添加UE的其他工具了，第一次启动时会在UE4Launcher.exe所在的目录下生成一个LaunchTools.json的文件：

{
  "LaunchTools": [
    {
      "ToolName": "UE4Editor",
      "PreArgs": "",
      "BinPath": "Engine/Binaries/Win64"
    },
    {
      "ToolName": "UE4Editor-cmd",
      "PreArgs": "",
      "BinPath": "Engine/Binaries/Win64"
    },
    {
      "ToolName": "UnrealFrontend",
      "PreArgs": "",
      "BinPath": "Engine/Binaries/Win64"
    },
    {
      "ToolName": "NetworkProfiler",
      "PreArgs": "",
      "BinPath": "Engine/Binaries/DotNET"
    }
  ]
}

这是默认的四个工具，可以按照相同的格式在这里添加。

参数说明：

ToolName：该工具的exe名，去掉后缀；
PreArgs：启动时默认传递什么参数；
BinPath：相对于引擎的路径；

v0.16

Download Link

Fix bugs
Support launch project sln with Visual Studio

v0.15

Download Link

Fix bugs
Ignore project and launch params when just selected program.
Support Launch UnrealFrontend and NetworkProfiler and custom additional tools

v0.14

Download Links

Fix bugs
Add installer icon.