ET 框架構(gòu)建指南從 dotnet build 到 Proto 導(dǎo)出、服務(wù)器啟動(dòng)與發(fā)布的完整工作流【免費(fèi)下載鏈接】ETUnity3D Client And C# Server Framework項(xiàng)目地址: https://gitcode.com/GitHub_Trending/et/ET導(dǎo)讀本文是 ETUnity3D Client And C# Server Framework開(kāi)源倉(cāng)庫(kù)中et-build技能文檔及其參考手冊(cè) et-build-commands.md 的完整解讀與源碼級(jí)擴(kuò)充。你將掌握 ET 項(xiàng)目中四類(lèi)高頻構(gòu)建操作的標(biāo)準(zhǔn)入口——編譯與分析器驗(yàn)證dotnet build ET.sln、Proto 消息導(dǎo)出ET.Proto2CS.dll、服務(wù)器啟動(dòng)ET.App.dll --Console1與版本發(fā)布Publish.ps1并理解每條命令背后的實(shí)現(xiàn)原理、前置條件與常見(jiàn)排錯(cuò)路徑。讀完即可按統(tǒng)一規(guī)范獨(dú)立完成 ET 項(xiàng)目的構(gòu)建、驗(yàn)證與發(fā)布閉環(huán)。et-build 技能定位與使用邊界et-build是 ET 倉(cāng)庫(kù) harness 包中面向構(gòu)建與導(dǎo)出場(chǎng)景的 Agent 技能入口其定義位于 SKILL.md并在技能索引 index.md 中被歸類(lèi)為構(gòu)建與導(dǎo)出分組。它只負(fù)責(zé)四件事編譯項(xiàng)目唯一命令dotnet build ET.sln導(dǎo)出 Proto 文件.proto→ C#啟動(dòng)服務(wù)器發(fā)布版本與之相對(duì)技能文檔明確劃定了不應(yīng)加載本技能的場(chǎng)景只是改代碼、寫(xiě)測(cè)試還沒(méi)到編譯或?qū)С霏h(huán)節(jié) → 用et-code/et-async等開(kāi)發(fā)技能只是導(dǎo)出 Luban 配置 → 用et-luban技能只是查詢(xún)架構(gòu)規(guī)范或包依賴(lài) → 用et-code技能這種職責(zé)劃分與索引文檔中的組合場(chǎng)景一致et-build通常處于開(kāi)發(fā)鏈路的末端如et-tdd→et-test-write→et-code→et-build→et-test-run只在需要真正編譯、運(yùn)行或發(fā)布時(shí)才介入。四條默認(rèn)動(dòng)作原則在動(dòng)手執(zhí)行任何命令之前et-build技能要求遵守四條全局原則它們是整個(gè)構(gòu)建工作流的行為基線(xiàn)編譯和分析器驗(yàn)證統(tǒng)一使用dotnet build ET.sln不單獨(dú)編譯某個(gè)包也不用 IDE 私有方案。這樣保證全倉(cāng)庫(kù)的編譯語(yǔ)義一致且所有 Roslyn 分析器見(jiàn)下文編譯與分析器驗(yàn)證在每次構(gòu)建中都被真實(shí)執(zhí)行。服務(wù)器必須在 Unity 項(xiàng)目根目錄啟動(dòng)不在Bin/目錄內(nèi)啟動(dòng)——因?yàn)?ET.App 啟動(dòng)時(shí)需要以項(xiàng)目根目錄為工作目錄來(lái)定位Packages/、Config/、Logs/等相對(duì)路徑。運(yùn)行服務(wù)器前先清理舊Logs/避免新日志與舊日志混在一起導(dǎo)致排查困難。Model / Hotfix 程序集不能用 IDE 編譯必須走項(xiàng)目規(guī)定的 Unity / ET 編譯入口即dotnet build ET.sln。這背后是 ET 的代碼模式CodeMode設(shè)計(jì)運(yùn)行時(shí)程序集按 Model / Hotfix / Loader 分層組織只有經(jīng)統(tǒng)一構(gòu)建入口生成才能保證源生成器與分析器的輸出一致。對(duì)應(yīng)的高頻命令與默認(rèn)動(dòng)作一一映射參考手冊(cè) et-build-commands.md 中把它們整理成了四組優(yōu)先入口下一節(jié)逐一展開(kāi)。唯一編譯入口dotnet build ET.sln命令與適用前提dotnet build ET.sln這是 ET 項(xiàng)目唯一被認(rèn)可的編譯與分析器驗(yàn)證命令。技能文檔反復(fù)強(qiáng)調(diào)不單獨(dú)編譯包或 IDE 私有方案原因在于 ET.sln 聚合了全部cn.etetet.*包的程序集項(xiàng)目如 loader 包的DotNet~/ET.Loader.csproj只有從解決方案級(jí)別構(gòu)建包間依賴(lài)、源生成器注入與分析器檢查才能在一個(gè)完整的編譯圖中生效。從源碼看loader 包的工程文件 ET.Loader.csproj 聲明了net10.0目標(biāo)框架與ET.Loader程序集名并通過(guò)AppendTargetFrameworkToOutputPathfalse將產(chǎn)物直接輸出到Bin/目錄——這正是后續(xù)Bin/ET.App.dll、Bin/ET.Proto2CS.dll等命令能夠直接以相對(duì)路徑調(diào)用的基礎(chǔ)。編譯時(shí)被觸發(fā)的分析器構(gòu)建并非簡(jiǎn)單的語(yǔ)法編譯。harness 包的DotNet~/SourceGenerator/目錄中存放著多款 Roslyn 分析器它們?cè)赿otnet build ET.sln時(shí)隨編譯運(yùn)行用于在 CI/Agent 場(chǎng)景下即時(shí)校驗(yàn)架構(gòu)約束例如AwaitEntityAnalyzer.cs檢查async/await/ETTask用法是否符合 ET 異步規(guī)范DiableNewAnalyzer.cs禁止用new直接創(chuàng)建本應(yīng)由對(duì)象池/工廠(chǎng)管理的對(duì)象并受AnalyzerGlobalSetting.EnableAnalyzer開(kāi)關(guān)控制DisableSingletonInstanceAccessAnalyzer.cs阻止繞過(guò)框架直接訪(fǎng)問(wèn)單例實(shí)例分析范圍限定在AnalyzeAssembly.AllModelHotfix對(duì)應(yīng)的 Model / Hotfix 程序集NamespaceAnalyzer.cs、NetMessageAnalyzer.cs、MessageObjectReferenceAnalyzer.cs、TestCaseNamingAnalyzer.cs 等分別約束命名空間、網(wǎng)絡(luò)消息、MessageObject 引用與測(cè)試命名。這也是分析器結(jié)果異常時(shí)先確認(rèn)是否單獨(dú)編譯了某個(gè)包這一排查項(xiàng)的根源一旦繞過(guò) ET.sln 單獨(dú)編譯分析器集合不完整報(bào)錯(cuò)或漏報(bào)都會(huì)失真。Proto 導(dǎo)出ET.Proto2CS.dll命令dotnet ./Bin/ET.Proto2CS.dll該命令把各包Proto/目錄下的.proto消息定義批量轉(zhuǎn)換為 C# 代碼。技能文檔給出的關(guān)鍵約束有三條全部能在源碼中找到對(duì)應(yīng)實(shí)現(xiàn)入口 Program.cs核心邏輯 Proto2CS.cs生成文件落在 proto 包中代碼寫(xiě)死輸出目錄為Packages/cn.etetet.proto/CodeMode/Model/下的Client、Server、ClientServer三個(gè)子目錄對(duì)應(yīng) Proto2CS.cs 中的clientMessagePath/serverMessagePath/clientServerMessagePath并在導(dǎo)出前先清理這些目錄里的舊.cs文件CleanGeneratedFiles。Proto 文件名帶的編號(hào)必須唯一通常是 100 的倍數(shù)導(dǎo)出器要求.proto文件名遵循名字_類(lèi)型_起始Opcode.proto的約定——例如 Login_C_10000.proto 表示 Login 包、Client 側(cè)_C_、起始 Opcode 10000Login_S_20000.proto 對(duì)應(yīng) Server 側(cè)_S_。代碼通過(guò)fileName.Split(_)拆出protoName、csClient/Server/ClientServer與startOpcode三個(gè)段每條message聲明會(huì)讓 opcode 自增msgOpcode.Add(..., Opcode startOpcode)因此編號(hào)必須全局唯一且通常取 100 的倍數(shù)為后續(xù)增量預(yù)留空間。生成結(jié)果會(huì)被寫(xiě)入Opcode枚舉與[Message(Opcode.xxx)]特性。導(dǎo)出后必要時(shí)用git diff --stat確認(rèn)生成范圍因?yàn)閷?dǎo)出會(huì)先清空目標(biāo)目錄再全量重寫(xiě)用 git diff 可以快速核對(duì)本次改動(dòng)是否超出預(yù)期例如誤改了某個(gè) proto 導(dǎo)致大面積重生成。導(dǎo)出流程的源碼視角Program.cs 展示了完整鏈路讀取項(xiàng)目根目錄下的MainPackage.txt若不存在或?yàn)榭談t跳過(guò)導(dǎo)出并打印提示把其中列出的包名集合傳給Proto2CS.Export(packages)Proto2CS.cs 掃描Packages/下所有cn.etetet.*包過(guò)濾出目標(biāo)包收集其Proto/*.proto文件對(duì)每個(gè) proto 文件逐行解析注釋///會(huì)轉(zhuǎn)成 XML 文檔注釋message聲明會(huì)生成帶[MemoryPackable]、[Message(Opcode.X)]、[ResponseType(...)]特性的partial class繼承MessageObject并自動(dòng)補(bǔ)出Create工廠(chǎng)方法與Dispose回收邏輯除非標(biāo)注// no dispose最后打印Generated N proto files.?？梢钥吹綄?dǎo)出不僅是文本翻譯還涉及 Opcode 分配、對(duì)象池接入、MemoryPack 序列化標(biāo)記等 ET 運(yùn)行時(shí)約定因此用 IDE 手工改生成代碼是嚴(yán)格禁止的——一切以重新執(zhí)行導(dǎo)出為準(zhǔn)。服務(wù)器啟動(dòng)ET.App.dll命令Remove-Item ./Logs -Recurse -Force -ErrorAction SilentlyContinue dotnet ./Bin/ET.App.dll --Console1兩行命令配套使用先清理舊日志再以控制臺(tái)模式啟動(dòng)服務(wù)器。技能文檔給出的啟動(dòng)前提包括需要管理員權(quán)限ET.App 啟動(dòng)時(shí)涉及端口綁定監(jiān)聽(tīng) RPC / 網(wǎng)關(guān)等端口等敏感操作必須在 Unity 項(xiàng)目根目錄執(zhí)行不在Bin/下執(zhí)行這與參考手冊(cè)當(dāng)前工作目錄應(yīng)位于 Unity 項(xiàng)目根目錄的原則一致因?yàn)檫\(yùn)行時(shí)會(huì)按相對(duì)路徑加載Packages/、Config/、Logs/等資源啟動(dòng)前清理舊Logs/避免新舊日志混淆方便確認(rèn)啟動(dòng)是否真正成功。--Console1以控制臺(tái)模式運(yùn)行日志直接輸出到終端同時(shí)框架也會(huì)落盤(pán)到Logs/目錄這也是找不到日志時(shí)確認(rèn)Logs/是否生成最新文件這一排查項(xiàng)的由來(lái)。發(fā)布Publish.ps1命令pwsh -ExecutionPolicy Bypass -File ./Scripts/Publish.ps1發(fā)布入口統(tǒng)一為 Publish.ps1。技能文檔要求發(fā)布前先完成必要編譯、配置導(dǎo)出與測(cè)試驗(yàn)證即發(fā)布是構(gòu)建鏈路的最后一步而不是替代編譯的手段。注意技能文檔與參考手冊(cè)都強(qiáng)調(diào)所有命令必須使用pwshPowerShell 7不要使用 Windows 自帶的powershell.exe這一約定同時(shí)寫(xiě)在技能索引 index.md 中-ExecutionPolicy Bypass用于規(guī)避腳本執(zhí)行策略限制。發(fā)布腳本做了什么以 Publish.ps1 為例發(fā)布流程本質(zhì)上是編譯 目錄組裝dotnet publish ET.sln -r linux-x64 --framework net10.0 --no-self-contained --no-dependencies -c Debug針對(duì) linux-x64 運(yùn)行時(shí)發(fā)布解決方案產(chǎn)物輸出到Bin/linux-x64/publish/清空并重建Publish/Bin/把發(fā)布產(chǎn)物整體搬入拷貝運(yùn)行期資源到發(fā)布目錄的約定位置loader 包的NLog.config日志配置→Publish/Packages/cn.etetet.loader/CodeMode/Loader/Server/Bson資源 →Publish/Packages/cn.etetet.wow/Bundles/Bson/服務(wù)端 Luban 配置 →Publish/Packages/cn.etetet.config/Bundles/Luban/Config/Server/發(fā)布用 StartConfig →Publish/Packages/cn.etetet.startconfig/Bundles/Luban/Release/可見(jiàn)發(fā)布產(chǎn)物是一個(gè)自包含的目錄樹(shù)Publish/Bin/存放服務(wù)器程序集Publish/Packages/下按包路徑擺放配置文件。這也解釋了為什么服務(wù)器要求在項(xiàng)目根目錄啟動(dòng)——運(yùn)行時(shí)對(duì)Packages/下配置路徑的引用是相對(duì)項(xiàng)目根目錄的。常見(jiàn)問(wèn)題排查速查表參考手冊(cè) et-build-commands.md 給出了五個(gè)高頻問(wèn)題的標(biāo)準(zhǔn)排查路徑現(xiàn)象排查方向編譯報(bào)錯(cuò)確認(rèn)使用的是dotnet build ET.sln而不是局部方案或 IDE 編譯分析器結(jié)果異常確認(rèn)沒(méi)有單獨(dú)編譯某個(gè)包、沒(méi)用 IDE 私有編譯分析器只在 ET.sln 完整構(gòu)建時(shí)全量生效NuGet 還原失敗檢查網(wǎng)絡(luò)與代理設(shè)置服務(wù)器啟動(dòng)失敗依次檢查管理員權(quán)限、運(yùn)行目錄是否為 Unity 項(xiàng)目根目錄、端口是否被占用找不到日志確認(rèn)Logs/目錄是否生成了最新文件啟動(dòng)前清理舊日志會(huì)清空該目錄與其他技能的協(xié)作邊界et-build在 harness 技能體系中不是孤立入口索引 index.md 定義了清晰的協(xié)作關(guān)系Luban 配置導(dǎo)出走et-luban技能文檔 et-luban/SKILL.md不要在et-build中處理測(cè)試執(zhí)行與排查走et-test-run并以 cn.etetet.test/AGENTS.md 為路由依據(jù)改代碼、寫(xiě)測(cè)試等尚未到編譯環(huán)節(jié)的任務(wù)不加載本技能典型完整鏈路為開(kāi)發(fā)et-code/et-async→ 測(cè)試et-tdd→ 構(gòu)建et-build→ 提交et-gitet-build承擔(dān)其中編譯 / Proto / 運(yùn)行 / 發(fā)布的純構(gòu)建職責(zé)。這種按場(chǎng)景加載、按需補(bǔ)讀的設(shè)計(jì)讓 Agent 在編譯、導(dǎo)出、啟動(dòng)、發(fā)布等任務(wù)上始終走統(tǒng)一入口避免出現(xiàn)局部編譯、錯(cuò)誤目錄啟動(dòng)、手工拼長(zhǎng)命令等偏離項(xiàng)目規(guī)范的執(zhí)行方式。小結(jié)et-build把 ET 項(xiàng)目的四條關(guān)鍵構(gòu)建動(dòng)作收斂為四個(gè)標(biāo)準(zhǔn)入口dotnet build ET.sln編譯 分析器驗(yàn)證、dotnet ./Bin/ET.Proto2CS.dllProto 導(dǎo)出、dotnet ./Bin/ET.App.dll --Console1服務(wù)器啟動(dòng)、pwsh -ExecutionPolicy Bypass -File ./Scripts/Publish.ps1發(fā)布。它們共同依賴(lài)兩條底層約束統(tǒng)一從 Unity 項(xiàng)目根目錄以 ET.sln 為唯一構(gòu)建圖執(zhí)行、生成的程序集與代碼全部遵循項(xiàng)目的目錄與 Opcode 約定。理解這些約束就能在遇到編譯、分析器、啟動(dòng)或日志問(wèn)題時(shí)快速定位到技能文檔給出的標(biāo)準(zhǔn)排查路徑?！久赓M(fèi)下載鏈接】ETUnity3D Client And C# Server Framework項(xiàng)目地址: https://gitcode.com/GitHub_Trending/et/ET創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考