[UE4]GameModule與Plugin

當專案建立的時候，引擎會自動產生一個同名的Game Module在Source資料夾底下。我們當然可以將所有撰寫的C++類別全部放在這個Module中，可是當專案越來越大，若還是將所有的功能都放在同個Module下，不僅僅會造成管理上的混亂，而且編譯時間也會增加。

試著想像當我們隨便改動一個h檔或cpp檔的參數就要編譯幾10分鐘的情況？由於UE4在一個Module中的cpp數量到達32個的時候就會自動啟動編譯檔案合併的機制(Unity Build)，雖然UE4中有參數可以控制這個機制是否啟用，但卻是捨棄掉了整體的編譯時間。因此，如何將功能適當的切到各別Module中，就變成了一件非常重要的程式架構設計問題。

那麼實際上UE4的Module系統是怎麼運作的呢？

每一個獨立的Module基本上是由${MODULE_NAME}.build.cs與其下的C++程式碼所組成，而在UE4中，遊戲中的Module主要被分成以下幾種實作Macro定義：

• IMPLEMENT_PRIMARY_GAME_MODULE
• IMPLEMENT_GAME_MODULE
• IMPLEMENT_MODULE

到底這些實作彼此之間有什麼不同？

其實，這些Macro定義在最後都會被展開成IMPLEMENT_MODULE中的實作，它們之間在本質上並沒有不同，主要是用提供Module初始化Function的實作給UE4中的ModuleManager呼叫，參照Code 2.4.1：

Code 2.4.1 Module的定義Macro，最後都會被展開成IMPLEMENT_MODULE中的實作。其中PER_MODULE_BOILERPLATE讓引擎有機會提供一些額外的功能給這個module，例如把原本C++中的New跟delete做Overriding，並將功能導向UE4中的記憶體管理機制。最後的PER_MODULE_BOILERPLATE_ANYLINK其實並沒有其他特別的功能，就只是用來做標示，用來說明這個Module相關的定義已經完成。

從上面的程式碼中我們可以看出，從Primary Game Module、Game Module到Module總共有三個層級的定義。只是，既然這些Module的定義做的事情都差不多，那為何引擎還要個別提供？

這邊雖然沒辦法完全的掌握設計者的意圖，但至少我們可以推敲出區分出這些Module定義名稱的好處：若以後想要在Primary Game Module或Game Module層級增加功能的時候，就不會影響到最下層的Module層級的實作。

到這裡，或許有人會開始思考這幾個層級到底應該用在哪些地方。其實UE4在架構上把程式碼拆分成以下幾個部份：

• Engine：位於${UE4_ENGINE_ROOT}/Engine/Source/下面的Developer、Editor、Runtime以及ThirdParty這幾個資料夾。
• Engine Plugin：位於${UE4_ENGINE_ROOT}/Engine/Plugin/。
• Game：位於${PROJECT_NAME}/Source/。
• Game Plugin：位於${PROJECT_NAME}/Plugin/。
• Programs：位於${UE4_ENGINE_ROOT}/Engine/Source/Programs，屬於獨立運行的工具類程式，裡面使用C#或C++分別進行不同的實作。

其中只有位於Game中的Module會使用IMPLEMENT_PRIMARY_GAME_MODULE跟IMPLEMENT_GAME_MODULE這2個實作，從名稱中我們可以推測出，作為主要遊戲的入口的Primary Game Module只能有一個，其他則都必需設成Game Module。

其他在Engine、Engine Plugin跟Game Plugin底下的Module則都是直接使用IMPLEMENT_MODULE這個定義。

當然，就目前的引擎版本我們是可以全部都用IMPLEMENT_MODULE來實作出上面Module所有效果，但是為了往後更新引擎版本時的兼容性，建議還是照著UE4所定義出來的流程實作。

最後的Programs跟其他的Module不同，裡面的C++ Module會使用IMPLEMENT_APPLICATION這個定義，參見Code 2.4.2。

Code 2.4.2 在UE4中，Module的Link分成Modular跟Monolithic二種方式：Modular指的是將Module編譯成各別的dynamic library再做連結；Monolithic則是指將所有的Module全部編譯到同一份Library中。其中Editor預設是Modular，而Game預設是Monolithic。

而要不要把該Module放到Plugin或者是當成Game Module，則要看這個Module需不需要用在不同的專案上使用。若是這個Module中的功能需要讓其他專案使用的話，則將該Module製作成Plugin會比單純的當成Game Module會更有彈性。