簡(jiǎn)介面向 UE4 開發(fā)者的 C 實(shí)戰(zhàn)資源包解決在藍(lán)圖中調(diào)用外部 exe 程序的常見需求。通過 FPlatformProcess 模塊的 ExecuteAndWait 接口示例展示了帶參數(shù)啟動(dòng)外部工具、等待進(jìn)程結(jié)束并記錄日志的完整調(diào)用鏈適合需要集成輔助編輯器、數(shù)據(jù)分析腳本或外部工具的虛幻引擎開發(fā)者。rar 壓縮包共 31 個(gè)文件包含 4 個(gè) cpp 與 4 個(gè) h 源碼、3 個(gè) cs 項(xiàng)目配置、UE4 工程配置 ini 與 umap/uasset 場(chǎng)景資源以及 pdb/dll 調(diào)試與依賴文件整體約 37.79MB源碼工程結(jié)構(gòu)清晰從 C 類實(shí)現(xiàn)、藍(lán)圖事件圖表調(diào)用到 VS 工程文件生成均涵蓋可直接對(duì)照學(xué)習(xí)已有 3517 人學(xué)習(xí)下載。通過研究打包的 OpenExe 示例讀者能夠掌握 FPlatformProcess 模塊常用 API、自定義類暴露藍(lán)圖的函數(shù)設(shè)計(jì)方式以及修改源碼后重新生成 Visual Studio 工程文件的標(biāo)準(zhǔn)流程。1. UE4 C 打開外部 exe一個(gè)讓新手卡半天的功能源碼工程直接拆給你看打開 Mac 版 UE4 項(xiàng)目的同學(xué)應(yīng)該都知道引擎默認(rèn)帶的「打開外部程序」這類工具鏈集成功能幾乎為零。但實(shí)際做項(xiàng)目時(shí)啟動(dòng)一個(gè)輔助編輯器、調(diào)起數(shù)據(jù)分析腳本、甚至按一下按鈕就拉起 DCC 工具比如 Substance Painter 或 Houdini都是剛需。這篇筆記要拆的就是 OpenExe 這個(gè)直接可用的 UE4 源碼工程它用 C 封裝了 FPlatformProcess 的進(jìn)程調(diào)用邏輯并暴露成藍(lán)圖節(jié)點(diǎn)讓策劃也能在事件圖表里拉一個(gè)節(jié)點(diǎn)就啟動(dòng)外部 exe。適合剛?cè)腴T UE4 C 的開發(fā)者、需要集成外部工具的獨(dú)立開發(fā)者也適合想知道 FPlatformProcess 到底怎么用才不翻車的進(jìn)階用戶。注意一點(diǎn)這篇不是泛講 API 用法而是對(duì)著源碼工程逐文件拆直到你能自己改參數(shù)、加命令行、處理路徑坑為止。2. FPlatformProcess 選型與調(diào)用方式先看清三條岔路再動(dòng)手2.1 為什么是 FPlatformProcess 而不是 Windows 原生 API很多從傳統(tǒng) C 轉(zhuǎn)過來(lái)的開發(fā)者第一反應(yīng)是直接用CreateProcessW或者system()。system()在 UE4 里不是不能用但它會(huì)阻塞調(diào)用線程、沒法拿進(jìn)程句柄、返回值解析也麻煩更致命的是它依賴 cmd.exe 做一層解釋路徑帶空格時(shí)經(jīng)常莫名翻車。而CreateProcessW必須自己處理寬字符轉(zhuǎn)換還要在項(xiàng)目里引入 Windows.h直接破壞了 UE4 的跨平臺(tái)編譯體系——你一旦寫了#include Windows.h這個(gè)模塊就只有 Windows 能編藍(lán)圖側(cè)不受影響但編輯器在 Linux 或 Mac 上就編不過了。UE4 提供的FPlatformProcess就是來(lái)解決這個(gè)問題的。它是一層跨平臺(tái)抽象底層在 Windows 上會(huì)走CreateProcess在 Linux 上走fork/exec在 Mac 上走NSTask。也就是說你的 C 代碼只需要寫一遍換平臺(tái)時(shí)引擎自動(dòng)切換底層實(shí)現(xiàn)。更關(guān)鍵的是FPlatformProcess返回的是FProcHandle這個(gè)句柄可以配合FPlatformProcess::IsProcRunning()輪詢進(jìn)程狀態(tài)也可以配合FPlatformProcess::GetProcReturnCode()拿到 exe 的退出碼。對(duì)于「打開外部 exe 并且要感知它是否跑完」這個(gè)場(chǎng)景這個(gè)設(shè)計(jì)非常順。我一般會(huì)建議只要不是極端性能敏感的場(chǎng)景一律優(yōu)先用FPlatformProcess不要在 UE4 工程里直接混入操作系統(tǒng)原生 API。原因很實(shí)際——后期如果項(xiàng)目要出 Mac 或 Linux 版本你不需要回頭重寫一遍邏輯。2.2 Execute、ExecuteAndWait、CreateProc 的區(qū)別與參數(shù)逐項(xiàng)解析FPlatformProcess里跟啟動(dòng)外部程序相關(guān)的函數(shù)有三個(gè)摘錄常用簽名如下static FProcHandle CreateProc(const TCHAR* URL, const TCHAR* Parms, bool bLaunchDetached, bool bLaunchHidden, bool bLaunchReallyHidden, uint32* OutProcessID, int32 PriorityModifier, const TCHAR* OptionalWorkingDirectory, void* PipeWrite, void* PipeRead nullptr); static bool ExecProcess(const TCHAR* URL, const TCHAR* Parms, int32* OutReturnCode, FString* OutStdOut, FString* OutStdErr); static bool ExecuteAndWait(const TCHAR* Filename, const TCHAR* Parms, bool bLaunchDetached, bool bLaunchHidden, FProcHandle* OutProcHandle);先說ExecuteAndWait。它在藍(lán)圖工程里最常見因?yàn)樗闷饋?lái)最直白——傳一個(gè) exe 路徑和參數(shù)字符串函數(shù)會(huì)啟動(dòng)進(jìn)程并一直等到它退出?！傅却顺觥惯@一點(diǎn)既是優(yōu)點(diǎn)也是坑如果你啟動(dòng)的是一個(gè)常駐程序比如一個(gè)后臺(tái)服務(wù)或者一個(gè)不自動(dòng)退出的工具藍(lán)圖節(jié)點(diǎn)會(huì)一直卡在那里整條事件鏈都被堵死。后面避坑章節(jié)會(huì)再展開。ExecProcess的優(yōu)勢(shì)是能拿到退出碼和標(biāo)準(zhǔn)輸出/錯(cuò)誤輸出。它的典型用法是執(zhí)行命令行工具比如我們項(xiàng)目里拿它調(diào)起自定義的批處理腳本去處理貼圖然后把腳本的輸出打回 UE 日志。這個(gè)函數(shù)也是等進(jìn)程退出的但它額外給了你兩個(gè)FString*參數(shù)接收子進(jìn)程的輸出。CreateProc是里面最靈活的。它可以立刻返回啟動(dòng)后進(jìn)程在后臺(tái)跑你手里握著FProcHandle想什么時(shí)候輪詢都行。它還多給了幾個(gè)控制參數(shù)bLaunchDetached表示是否脫離父進(jìn)程獨(dú)立跑bLaunchHidden是否隱藏窗口PriorityModifier可以調(diào)進(jìn)程優(yōu)先級(jí)OptionalWorkingDirectory可以指定工作目錄——這個(gè)參數(shù)后面會(huì)講到它是很多 exe 閃退問題的根源。三個(gè)函數(shù)的取舍我總結(jié)如下要阻塞等結(jié)果選ExecProcess要簡(jiǎn)單粗暴選ExecuteAndWait要異步控制選CreateProc。OpenExe 工程里默認(rèn)用的是ExecuteAndWait代碼量最少理解成本最低適合做起點(diǎn)。2.3 拿到 OpenExe 工程先看哪幾個(gè)文件壓縮包解壓后的目錄結(jié)構(gòu)我直接列出來(lái)對(duì)照著看源碼效率更高OpenExe/ ├── Config/ │ ├── DefaultEditor.ini │ ├── DefaultEngine.ini │ └── DefaultGame.ini ├── Source/ │ └── OpenExe/ │ ├── OpenExe.Build.cs │ ├── OpenExe.cpp │ ├── OpenExe.h │ ├── OpenExeEditor.Target.cs │ └── OpenExe.Target.cs ├── Binaries/Win64/ ├── Content/ │ ├── Developers/Collections/ │ ├── Untitled_BuiltData.uasset │ ├── Untitled.umap │ └── 1_BuiltData.uasset └── OpenExe.uprojectOpenExe.uproject是 UE4 工程入口雙擊它會(huì)打開編輯器。Source目錄是核心核心類在OpenExe.Build.cs里的依賴聲明決定。讀這個(gè)工程的順序我建議是先看OpenExe.Build.cs里模塊依賴再找 C 類的頭文件和 .cpp 實(shí)現(xiàn)最后回頭看 Content 里哪個(gè) map 掛了演示藍(lán)圖。因?yàn)樗{(lán)圖資產(chǎn)在代碼沒編譯通過前打不開所以落地順序一定是先代碼后藍(lán)圖。Binaries/Win64里是編譯產(chǎn)物如果解壓后發(fā)現(xiàn)打開工程報(bào)「模塊缺失」多半是引擎版本和編譯用的 UE4 版本不匹配直接右鍵OpenExe.uproject選擇「Generate Visual Studio project files」重新生成一遍再編譯不要硬用現(xiàn)成的 dll。3. 從源碼實(shí)現(xiàn)到藍(lán)圖暴露C 函數(shù)是怎么變成藍(lán)圖節(jié)點(diǎn)的3.1 創(chuàng)建一個(gè)繼承自 AActor 的 C 類并聲明函數(shù)模塊結(jié)構(gòu)先不展開直接看實(shí)操。在Source/OpenExe目錄下新建類常見命名是UOpenExeFunctionLibrary藍(lán)圖函數(shù)庫(kù)或AOpenExeActorActor 子類。OpenExe 工程里是用 Actor 子類做的因?yàn)檫@樣可以直接拖進(jìn)關(guān)卡、可以配置默認(rèn)參數(shù)。頭文件我按工程風(fēng)格補(bǔ)一個(gè)標(biāo)準(zhǔn)聲明// OpenExeActor.h #pragma once #include CoreMinimal.h #include GameFramework/Actor.h #include OpenExeActor.generated.h UCLASS() class OPENEXE_API AOpenExeActor : public AActor { GENERATED_BODY() public: AOpenExeActor(); // 暴露給藍(lán)圖的函數(shù)啟動(dòng)外部 exe 并等待退出 UFUNCTION(BlueprintCallable, Category ExternalProcess) bool OpenExternalExe(const FString ExePath, const FString Params TEXT()); // 暴露給藍(lán)圖的函數(shù)異步啟動(dòng)立即返回 UFUNCTION(BlueprintCallable, Category ExternalProcess) bool OpenExternalExeAsync(const FString ExePath, const FString Params TEXT()); };UFUNCTION(BlueprintCallable)是核心裝飾器沒有它藍(lán)圖事件圖表里就找不到這個(gè)函數(shù)。Category參數(shù)決定在藍(lán)圖右鍵菜單里搜什么關(guān)鍵詞能搜到。OpenEXE_API這個(gè)宏是模塊導(dǎo)出宏在OpenExe.Build.cs里定義缺了它其他模塊引用會(huì)報(bào)鏈接錯(cuò)誤。類名加A前綴是 Actor 的命名約定不加會(huì)觸發(fā) UE4 的編譯警告。BlueprintCallable還有一個(gè)變體是BlueprintPure如果你希望藍(lán)圖里像 Get 節(jié)點(diǎn)一樣不產(chǎn)生執(zhí)行線可以用后者——但打開 exe 是帶副作用的操作建議用前者逼著調(diào)用者顯式連執(zhí)行線。3.2 實(shí)現(xiàn) OpenExternalExe 函數(shù)三行關(guān)鍵代碼實(shí)現(xiàn)文件是重頭戲直接貼可編譯版本// OpenExeActor.cpp #include OpenExeActor.h #include HAL/PlatformProcess.h bool AOpenExeActor::OpenExternalExe(const FString ExePath, const FString Params) { if (ExePath.IsEmpty()) { UE_LOG(LogTemp, Error, TEXT(OpenExternalExe: ExePath is empty.)); return false; } if (!FPaths::FileExists(ExePath)) { UE_LOG(LogTemp, Error, TEXT(OpenExternalExe: File does not exist: %s), *ExePath); return false; } FProcHandle ProcessHandle; const bool bSuccess FPlatformProcess::ExecuteAndWait( *ExePath, *Params, false, true, ProcessHandle ); if (bSuccess) { UE_LOG(LogTemp, Log, TEXT(OpenExternalExe: executed successfully.)); } else { UE_LOG(LogTemp, Error, TEXT(OpenExternalExe: failed to execute.)); } return bSuccess; }邏輯拆開講。先做空路徑和文件存在性檢查這個(gè)不是多余的防御——藍(lán)圖里傳錯(cuò)路徑是最高頻的誤操作提前返回 false 能把日志錯(cuò)誤定位到「路徑錯(cuò)了」而不是「進(jìn)程啟動(dòng)失敗」。FPaths::FileExists是 UE4 自帶的文件檢查底層走的操作系統(tǒng)文件查詢性能開銷可忽略。關(guān)鍵調(diào)用是FPlatformProcess::ExecuteAndWait那一段。四個(gè)參數(shù)依次說明第一個(gè)是 exe 路徑注意要用*ExePath解引用FString轉(zhuǎn)成const TCHAR*第二個(gè)是命令行參數(shù)字符串沒有參數(shù)時(shí)傳空第三個(gè)false表示不脫離父進(jìn)程這個(gè)參數(shù)別設(shè)成 true設(shè)成 true 后子進(jìn)程會(huì)脫離 UE 進(jìn)程生命周期管理打包后可能出現(xiàn)「UE 退出了 exe 還在跑」的詭異情況第四個(gè)true表示隱藏子進(jìn)程窗口如果你要啟動(dòng)一個(gè)可視化工具比如打開一個(gè) GUI這里要改成false否則窗口彈不出來(lái)但進(jìn)程在后臺(tái)跑策劃會(huì)以為功能壞了。函數(shù)返回的FProcHandle存到ProcessHandle變量里ExecuteAndWait返回后進(jìn)程已退出句柄其實(shí)沒有更多用途但留著它方便后續(xù)調(diào)試打印 PID。3.3 異步版本用 CreateProc 避免阻塞主線程上一節(jié)寫的是同步版本接著實(shí)現(xiàn)OpenExternalExeAsyncbool AOpenExeActor::OpenExternalExeAsync(const FString ExePath, const FString Params) { if (ExePath.IsEmpty()) { UE_LOG(LogTemp, Error, TEXT(OpenExternalExeAsync: ExePath is empty.)); return false; } FProcHandle ProcessHandle FPlatformProcess::CreateProc( *ExePath, *Params, false, // bLaunchDetached false, // bLaunchHidden false, // bLaunchReallyHidden nullptr, // OutProcessID不需要時(shí)可以傳空 0, // PriorityModifier0 表示默認(rèn)優(yōu)先級(jí) nullptr, // OptionalWorkingDirectory暫時(shí)用默認(rèn) nullptr, // PipeWrite nullptr // PipeRead ); if (ProcessHandle.IsValid()) { UE_LOG(LogTemp, Log, TEXT(OpenExternalExeAsync: process started.)); return true; } UE_LOG(LogTemp, Error, TEXT(OpenExternalExeAsync: failed to start process.)); return false; }注意CreateProc的返回值是FProcHandle判斷是否啟動(dòng)成功用IsValid()不要拿句柄去和 nullptr 比句柄內(nèi)部封裝了平臺(tái)相關(guān)的指針或 HANDLE直接比會(huì)帶來(lái)跨平臺(tái)兼容問題。兩個(gè)版本的區(qū)別一句話講透同步版適合「exe 跑完才能繼續(xù)做事」的流程異步版適合「啟動(dòng)完就不管了」的交互。后續(xù)進(jìn)階章節(jié)我會(huì)說怎么在異步基礎(chǔ)上加完成回調(diào)那才是真正的工程級(jí)做法。3.4 重新生成 VS 工程文件與編譯流程寫完了代碼接下來(lái)是新手最容易卡住的一步。在 UE4 編輯器里點(diǎn)File - Generate Visual Studio Project Files這一步生成的不是編譯代碼而是刷新.sln解決方案文件里的模塊索引和源碼列表。然后打開生成的.sln解決方案配置切到 Development Editor平臺(tái)選 Win64直接CtrlShiftB編譯。編譯完成后回到編輯器點(diǎn)Compile按鈕會(huì)更快編輯器會(huì)熱加載新代碼。這一步有兩個(gè)高頻報(bào)錯(cuò)先給你排掉報(bào)Cannot open include file: CoreMinimal.h說明 Build.cs 里模塊依賴缺了Core或Engine報(bào)Unresolved external symbol FPlatformProcess::ExecuteAndWait說明你所在的 UE4 版本里函數(shù)名或所在頭文件有變化去Engine/Source/Runtime/Core/Public/HAL/PlatformProcess.h確認(rèn)一下版本差異即可。4. 藍(lán)圖中接線與驗(yàn)證讓策劃也能一拖節(jié)點(diǎn)就啟動(dòng) exe4.1 在事件圖表中找到自定義函數(shù)節(jié)點(diǎn)編譯通過后回到藍(lán)圖編輯器在事件圖表空白處右鍵搜索Open External Exe你會(huì)看到剛寫的兩個(gè)函數(shù)節(jié)點(diǎn)出現(xiàn)在列表里。點(diǎn)擊放置后Target引腳需要一個(gè)AOpenExeActor類型的對(duì)象引用。有三種方式獲取直接把OpenExeActor拖進(jìn)關(guān)卡然后在藍(lán)圖里通過Get Actor Of Class節(jié)點(diǎn)拿引用在藍(lán)圖中Spawn Actor動(dòng)態(tài)生成適合運(yùn)行時(shí)才確定要不要啟動(dòng)外部程序的場(chǎng)景訂閱關(guān)卡Actor OnClicked事件拿到點(diǎn)擊對(duì)象后 Cast 成AOpenExeActor最常見的做法是第一種把 Actor 拖進(jìn)關(guān)卡然后在關(guān)卡藍(lán)圖的BeginPlay里調(diào)用函數(shù)。這樣做的好處是關(guān)卡里能直接看到 Actor 的位置排障時(shí)一眼知道功能掛在哪個(gè)物體上。4.2 路徑參數(shù)怎么傳變量、拼接還是硬編碼藍(lán)圖側(cè)的ExePath引腳接收的是FString類型。最粗野的做法是用Make Literal String節(jié)點(diǎn)硬編碼路徑比如C:\Tools\MyHelper.exe但硬編碼的問題是打包后路徑十有八九對(duì)不上。更穩(wěn)的做法是用變量存路徑在Class Defaults面板里配置默認(rèn)值策劃不用打開藍(lán)圖就能改。如果你要把可變內(nèi)容拼進(jìn)去比如把當(dāng)前關(guān)卡名作為參數(shù)傳給 exe用Make String From Path或者Append節(jié)點(diǎn)拼接字符串注意拼接時(shí)統(tǒng)一斜杠方向。路徑里帶空格比如C:\Program Files\...時(shí)不要額外加引號(hào)FPlatformProcess內(nèi)部會(huì)對(duì)路徑做一次命令重組傳原始路徑即可。如果出現(xiàn)啟動(dòng)失敗且錯(cuò)誤日志里路徑被截?cái)嘣偃ゼ右?hào)——這個(gè)坑在避坑章節(jié)單獨(dú)講。4.3 驗(yàn)證是否真的啟動(dòng)成功三個(gè)檢查點(diǎn)藍(lán)圖層接好線后驗(yàn)證要分三步走看輸出日志。OpenExternalExe執(zhí)行成功后會(huì)在 LogTemp 里打印executed successfully失敗打印failed to execute按~打開控制臺(tái)直接搜OpenExternalExe關(guān)鍵詞即可過濾?？催M(jìn)程是否存活。打開任務(wù)管理器搜 exe 進(jìn)程名確認(rèn)目標(biāo)進(jìn)程在 UE 編輯器運(yùn)行時(shí)確實(shí)存在。如果進(jìn)程一閃而過大概率是 exe 自身崩潰或者工作目錄不對(duì)往避坑章節(jié)的方向查?？捶祷刂?。讓藍(lán)圖里的Return Value接一個(gè)Print String把 bool 結(jié)果打出來(lái)這樣不查日志也能第一時(shí)間看到失敗。有人問為什么不做成插件一鍵裝好因?yàn)槊總€(gè)項(xiàng)目的模塊依賴和啟動(dòng)流程差異很大直接復(fù)制源碼進(jìn)自己的工程改Build.cs加依賴比做插件更可控。你只需要把OpenExeActor.h/.cpp兩個(gè)文件拷進(jìn)自己工程的 Source 目錄刷新 VS 工程后就能用這是最輕量的集成方式。5. 避坑記錄打開 exe 最常見的五個(gè)翻車現(xiàn)場(chǎng)5.1 路徑斜杠方向與轉(zhuǎn)義問題現(xiàn)象ExecuteAndWait返回 false日志里路徑看起來(lái)沒問題但 exe 就是沒起來(lái)。原因C 字符串里反斜杠是轉(zhuǎn)義符C:\Tools\my.exe實(shí)際存儲(chǔ)的是C:Toolsmy.exe\T\m都被轉(zhuǎn)義成別的字符了。寫代碼時(shí)如果你不按 UE4 慣例用TEXT(C:\\Tools\\my.exe)就會(huì)踩這個(gè)坑。解決在 C 源碼里統(tǒng)一用雙反斜杠或正斜杠C:/Tools/my.exe。在藍(lán)圖層拼接字符串時(shí)不存在轉(zhuǎn)義問題但要注意從 Windows 資源管理器復(fù)制路徑后 UE4 會(huì)自動(dòng)處理手動(dòng)輸入時(shí)別把反斜杠漏成單斜杠。另外建議函數(shù)內(nèi)部先FPaths::ConvertRelativePathToFull把相對(duì)路徑轉(zhuǎn)絕對(duì)路徑再傳給 FPlatformProcess這一步能避開很多當(dāng)前工作目錄引發(fā)的詭異問題。5.2 ExecuteAndWait 卡死主線程現(xiàn)象點(diǎn)擊按鈕后整個(gè) UE 編輯器假死鼠標(biāo)轉(zhuǎn)圈直到目標(biāo) exe 退出才恢復(fù)響應(yīng)。原因ExecuteAndWait是等子進(jìn)程結(jié)束才返回的如果啟動(dòng)的是一個(gè) GUI 工具或常駐服務(wù)子進(jìn)程不退出調(diào)用線程就永遠(yuǎn)等下去。UE 的主線程被占住后渲染循環(huán)、輸入響應(yīng)全部阻塞。解決啟動(dòng) GUI 工具或常駐進(jìn)程務(wù)必用異步版本CreateProc。判斷標(biāo)準(zhǔn)很簡(jiǎn)單這個(gè) exe 是「跑完就退」還是「開著不走」。前者可以用 ExecuteAndWait后者一律走 CreateProc。如果既要異步又要感知結(jié)束需要在 GameThread 上每幀輪詢FPlatformProcess::IsProcRunning(Handle)或者用FProcHandle配合FPlatformProcess::WaitForProc放進(jìn)單獨(dú)線程。5.3 工作目錄不對(duì)導(dǎo)致 exe 閃退現(xiàn)象exe 被成功啟動(dòng)了但是立刻閃退任務(wù)管理器里能看到進(jìn)程出現(xiàn)又消失且沒有任何錯(cuò)誤彈窗。原因很多外部工具會(huì)讀取相對(duì)路徑的配置文件或資源文件啟動(dòng)時(shí)工作目錄不在它自己所在的目錄文件找不到就崩潰。比如 exe 在C:\Tools\bin\app.exe它默認(rèn)找C:\Tools\config.ini但你的 UE 進(jìn)程工作目錄是C:\MyGame\Binaries\Win64\子進(jìn)程繼承了這個(gè)目錄配置找不到就炸了。解決CreateProc的第 7 個(gè)參數(shù)OptionalWorkingDirectory傳入 exe 所在目錄比如FString ExeDir FPaths::GetPath(ExePath); FProcHandle Handle FPlatformProcess::CreateProc(*ExePath, *Params, false, false, false, nullptr, 0, *ExeDir, nullptr, nullptr);FPaths::GetPath會(huì)把C:\Tools\bin\app.exe截成C:\Tools\bin傳進(jìn)去后子進(jìn)程的工作目錄就對(duì)了。這個(gè)參數(shù)在ExecuteAndWait簽名里是沒有的所以你如果堅(jiān)持用同步版就需要在調(diào)用前用FPlatformProcess::SetCurrentWorkingDirectory臨時(shí)切全局工作目錄用完切回來(lái)——這個(gè)操作非常危險(xiǎn)多線程場(chǎng)景下會(huì)影響其他模塊不建議在生產(chǎn)項(xiàng)目里用。5.4 打包后路徑失效與文件缺失現(xiàn)象編輯器里功能正常打包出來(lái)的游戲一啟動(dòng)外部 exe 就失敗。原因打包后 UE 的目錄結(jié)構(gòu)是GameName/Content/、GameName/Binaries/你在編輯器里配的絕對(duì)路徑在打包機(jī)或玩家機(jī)器上不存在。另一個(gè)原因是打包時(shí)沒有把外部 exe 作為一個(gè)附加資源打進(jìn)包里Content 目錄里根本沒有那個(gè) exe。解決把目標(biāo) exe 放進(jìn)工程Content/External/目錄下然后用FPaths::Combine(FPaths::ProjectContentDir(), TEXT(External/xxx.exe))拼路徑。打包時(shí)這個(gè)文件會(huì)被自動(dòng)歸檔到 pak 或 loose 文件里運(yùn)行時(shí)路徑永遠(yuǎn)是對(duì)的。如果 exe 依賴一堆 dll 和資源文件建議不要直接打進(jìn) pak而是發(fā)布時(shí)和游戲安裝包一起平鋪復(fù)制用相對(duì)路徑從ProjectSavedDir或ProjectDir往外找。5.5 運(yùn)行庫(kù)缺失導(dǎo)致的靜默失敗現(xiàn)象exe 能啟動(dòng)但立刻彈窗VCRUNTIME140.dll missing或MSVCP140.dll missing甚至什么都不提示就消失。原因目標(biāo)程序依賴 Microsoft Visual C Redistributable而玩家機(jī)器上沒裝對(duì)應(yīng)版本。這是打包外發(fā)最容易被忽略的一條因?yàn)殚_發(fā)機(jī)裝了整套 VS運(yùn)行時(shí)庫(kù)齊全換到干凈機(jī)器就現(xiàn)形。解決要么在發(fā)布說明里要求玩家安裝對(duì)應(yīng)版本的 VC Redistributable要么在打包腳本里把 vc_redist.x64.exe 一起帶上并在首次啟動(dòng)時(shí)靜默安裝。如果 exe 是你自己寫的改用靜態(tài)鏈接/MT模式規(guī)避外部依賴如果是第三方工具只能通過包管理器或程序集把運(yùn)行庫(kù)帶上。6. 進(jìn)階一步從「能打開」變成「?jìng)鲄?shù)、拿退出碼、加完成回調(diào)」如果你已經(jīng)跑通了上面全部?jī)?nèi)容下面這個(gè)技巧能讓這個(gè)功能真正進(jìn)生產(chǎn)環(huán)境異步啟動(dòng) 線程輪詢 退出回調(diào)回到 GameThread。核心代碼片段// 啟動(dòng)后立即返回另開線程等待退出 FProcHandle Handle FPlatformProcess::CreateProc(*ExePath, *Params, false, false, false, nullptr, 0, *WorkingDir, nullptr, nullptr); if (Handle.IsValid()) { AsyncTask(ENamedThreads::AnyBackgroundThreadNormalTask, [Handle, this]() { FPlatformProcess::WaitForProc(Handle); uint32 ExitCode 0; FPlatformProcess::GetProcReturnCode(Handle, ExitCode); AsyncTask(ENamedThreads::GameThread, [ExitCode, this]() { OnExternalExeFinished(ExitCode); }); }); }WaitForProc是阻塞函數(shù)放在后臺(tái)線程里等進(jìn)程退出退出后把退出碼拿回來(lái)再用AsyncTask切回 GameThread 執(zhí)行藍(lán)圖中綁定的完成事件。這樣即使 exe 跑半小時(shí)游戲本體也不卡一幀。實(shí)踐里我習(xí)慣把啟動(dòng)函數(shù)、工作目錄檢查、完成回調(diào)做成三個(gè)獨(dú)立的私有函數(shù)這樣復(fù)制到新工程時(shí)只需要改函數(shù)頭和事件委托聲明。從那以后我每次接這類需求都強(qiáng)制自己走一遍「目標(biāo) exe 是常駐還是短命」的判斷再?zèng)Q定同步還是異步路徑獲取永遠(yuǎn)用FPaths家族函數(shù)而不是手工拼字符串。這套習(xí)慣在后面的多個(gè) UE4 項(xiàng)目里從沒出過事希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取