以上程式碼透過重寫 ExecuteStartupTaskAsync 方法實現在呼叫具體的啟動任務項傳入業務相關的 StartupContext 引數

如果應用有更多的需求，可以重寫 StartupManagerBase 更多方法，包括匯出所有的啟動項的 ExportStartupTasks 方法，重寫此方法可以讓應用定義如何匯出所有的啟動任務項。重寫 AddStartupTaskMetadataCollector 方法可以讓應用定義如何加入被管理的程式集中的啟動資訊等

以上幾步完成之後，還有一項需要完成的是，剛才新建的 WPFDemo。Api 專案其實沒有加上 WPF 的依賴，而在應用裡面，是有啟動任務項需要依賴在 UI 執行緒執行，於是就在加上 WPF 的依賴的 WPFDemo。App 上完成定義

class MainThreadDispatcher ： IMainThreadDispatcher { public async Task InvokeAsync（Action action） { await Application。Current。Dispatcher。InvokeAsync（action）； } }

以上的基礎完成之後，就可以在 Program。cs 的主函式將啟動框架跑起來，進入到 WPFDemo。App 專案的 Program 型別，在主函數里面先解析命令列，然後再建立 App 再跑起啟動框架

［STAThread］ static void Main（string［］ args） { var commandLine = CommandLine。Parse（args）； var app = new App（）； //開始啟動任務 StartStartupTasks（commandLine）； app。Run（）； }

在 StartStartupTasks 方法裡面使用 Task。Run 的方式在後臺執行緒跑起來啟動框架，如此可以讓主執行緒也就是此應用的 UI 執行緒開始跑起來介面相關邏輯

private static void StartStartupTasks（CommandLine commandLine） { Task。Run（（） => { // 1。 讀取應用配置 // 應用將會根據配置決定啟動的行為 var configFilePath = “App。coin”； var repo = ConfigurationFactory。FromFile（configFilePath）； // 2。 對接預編譯模組，獲取啟動任務項 var assemblyMetadataExporter = new AssemblyMetadataExporter（BuildStartupAssemblies（））； // 3。 建立啟動框架和跑起來 var startupManager = new StartupManager（commandLine， repo， HandleShutdownError， new MainThreadDispatcher（）） // 3。1 匯入預設的應用啟動節點，這是必要的步驟，業務方的各個啟動任務項將會根據此決定啟動順序 。UseCriticalNodes （ StartupNodes。Foundation， StartupNodes。CoreUI， StartupNodes。UI， StartupNodes。AppReady， StartupNodes。StartupCompleted ） // 3。2 匯出程式集的啟動項 。AddStartupTaskMetadataCollector（（） => // 這是預編譯模組收集的應用的所有的啟動任務項 assemblyMetadataExporter。ExportStartupTasks（））； startupManager。Run（）； }）； }

以上的例子應用裡面，有業務是需要根據配置決定啟動過程，因此需要先讀取應用配置。應用配置選取 dotnetCampus。Configurations 高效能配置檔案庫 可以極大減少因為讀取配置而佔用太多啟動時間。以上的例子裡，還對接了預編譯模組。預編譯模組的功能是收集應用裡的所有啟動任務項，如此可以極大提升收集啟動任務項的耗時，也不需要讓上層業務開發者需要手工註冊啟動任務項

以上程式碼即可實現在 Main 函式啟動之後，跑起來啟動框架。不過上面程式碼編譯還不能透過，因為還沒有完成 AssemblyMetadataExporter 的邏輯，這個預編譯模組相關邏輯

這不等價於這套啟動框架強依賴於預編譯模組，而是說可選接入預編譯模組。只需要有任何的邏輯，能對接 AddStartupTaskMetadataCollector 方法，在此方法裡面能傳入獲取應用所需的啟動任務項即可。無論使用任何的方式，包括反射等都是可以的。接入預編譯模組只是為了最佳化效能，減少收集啟動任務項的耗時

接下來就是預編譯模組的接入邏輯，本文不涉及 Telescope 預編譯模組的原理部分，只包含如何接入的方法

和 。NET 的其他庫一樣，為了接入預編譯模組，就需要先安裝 NuGet 庫。透過 NuGet 安裝 dotnetCampus。Telescope 庫，如果是新 SDK 風格的專案檔案，可以編輯 csproj 專案檔案，新增如下程式碼安裝

不同於其他的庫，由於 dotnetCampus。Telescope 預編譯框架是對專案程式碼本身進行處理的，需要每個用到預編譯都安裝此庫，因此需要為以上三個專案都安裝，而不能靠引用依賴自動安裝

安裝完成之後，在專案上新建一個 AssemblyInfo。cs 的檔案，給程式集新增特性。按照約定，需要將 AssemblyInfo。cs 檔案放入到 Properties 資料夾裡面。這個 Properties 資料夾算是一個特別的資料夾，在 Visual Studio 裡新建就可以看到此資料夾的圖示和其他資料夾不相同

在 AssemblyInfo。cs 檔案裡面新增如下程式碼

［assembly： dotnetCampus。Telescope。MarkExport（typeof（WPFDemo。Api。StartupTaskFramework。StartupTask）， typeof（dotnetCampus。ApplicationStartupManager。StartupTaskAttribute））］

以上就是對接預編譯框架的程式碼，十分簡單。透過給程式集加上

dotnetCampus。Telescope。MarkExportAttribute

可以標記程式集的匯出預編譯的型別，傳入的兩個引數分別是匯出的型別的基型別以及所繼承的特性

以上程式碼表示匯出所有繼承

WPFDemo。Api。StartupTaskFramework。StartupTask

型別，且標記了

dotnetCampus。ApplicationStartupManager。StartupTaskAttribute

特性的型別

標記之後，重新構建程式碼，將會在 obj 資料夾找到 AttributedTypesExport。g。cs 生成檔案，如在本文的例子專案裡面，生成檔案的路徑如下

C：\lindexi\Code\ApplicationStartupManager\demo\WPFDemo\WPFDemo。Api\obj\Debug\net6。0\TelescopeSource。GeneratedCodes\AttributedTypesExport。g。cs

假設有一個叫 Foo1Startup 的啟動任務項定義如下

［StartupTask（BeforeTasks = StartupNodes。CoreUI， AfterTasks = StartupNodes。Foundation）］ public class Foo1Startup ： StartupTask { protected override Task RunAsync（StartupContext context） { context。Logger。LogInfo（“Foo1 Startup”）； return base。RunAsync（context）； } }

那麼生成的 AttributedTypesExport。g。cs 將包含以下程式碼

using dotnetCampus。ApplicationStartupManager；using dotnetCampus。Telescope；using System；using System。Collections。Generic；using System。Linq；using System。Text；using System。Threading。Tasks；using WPFDemo。Api。StartupTaskFramework；namespace dotnetCampus。Telescope{ public partial class __AttributedTypesExport__ ： ICompileTimeAttributedTypesExporter { AttributedTypeMetadata［］ ICompileTimeAttributedTypesExporter。ExportAttributeTypes（） { return new AttributedTypeMetadata［］ { new AttributedTypeMetadata（ typeof（WPFDemo。Api。Startup。Foo1Startup）， new StartupTaskAttribute（） { BeforeTasks = StartupNodes。CoreUI， AfterTasks = StartupNodes。Foundation }， （） => new WPFDemo。Api。Startup。Foo1Startup（） ）， }； } }}

也就是自動收集了程式集裡面的啟動項，生成收集的程式碼

可以在啟動框架模組裡面，新建一個叫 AssemblyMetadataExporter 的型別來從 AttributedTypesExport。g。cs 拿到收集的型別。從 Telescope 拿到

__AttributedTypesExport__

生成型別的方法是呼叫 AttributedTypes 的 FromAssembly 方法，程式碼如下

IEnumerable> collection = AttributedTypes。FromAssembly（_assemblies）；

以上程式碼傳入的

_assemblies

引數就是需要獲取收集的啟動任務項程式集列表，呼叫以上程式碼，將會從傳入的各個程式集裡獲取預編譯收集的型別

將此收集的返回值封裝為 StartupTaskMetadata 即可返回給啟動框架

using System。Reflection；using dotnetCampus。ApplicationStartupManager；using dotnetCampus。Telescope；namespace WPFDemo。Api。StartupTaskFramework{ public class AssemblyMetadataExporter { public AssemblyMetadataExporter（Assembly［］ assemblies） { _assemblies = assemblies； } public IEnumerable ExportStartupTasks（） { var collection = Export（）； return collection。Select（x => new StartupTaskMetadata（x。RealType。Name。Replace（“Startup”， “”）， x。CreateInstance） { Scheduler = x。Attribute。Scheduler， BeforeTasks = x。Attribute。BeforeTasks， AfterTasks = x。Attribute。AfterTasks， //Categories = x。Attribute。Categories， CriticalLevel = x。Attribute。CriticalLevel， }）； } public IEnumerable> Export（） where TAttribute ： Attribute { return AttributedTypes。FromAssembly（_assemblies）； } private readonly Assembly［］ _assemblies； }}

回到 Program。cs 裡面，新建一個 BuildStartupAssemblies 方法，此方法裡面，寫明需要收集啟動任務項的程式集列表，交給 AssemblyMetadataExporter 去獲取

class Program { private static void StartStartupTasks（CommandLine commandLine） { Task。Run（（） => { var assemblyMetadataExporter = new AssemblyMetadataExporter（BuildStartupAssemblies（））； // 忽略其他邏輯 }）； } private static Assembly［］ BuildStartupAssemblies（） { // 初始化預編譯收集的所有模組。 return new Assembly［］ { // WPFDemo。App typeof（Program）。Assembly， // WPFDemo。Lib1 typeof（Foo2Startup）。Assembly， // WPFDemo。Api typeof（Foo1Startup）。Assembly， }； } }

透過 StartupManager 的 AddStartupTaskMetadataCollector 即可將匯出的啟動任務項加入到啟動框架

var assemblyMetadataExporter = new AssemblyMetadataExporter（BuildStartupAssemblies（））； var startupManager = new StartupManager（/*忽略程式碼*/） // 匯出程式集的啟動項 。AddStartupTaskMetadataCollector（（） => assemblyMetadataExporter。ExportStartupTasks（））； startupManager。Run（）；

如此即可完成所有的應用的啟動框架配置邏輯，接下來就是各個業務模組編寫啟動邏輯

透過新增各個業務模組的啟動任務項演示啟動框架的使用方法

在 WPFDemo。App 新增 MainWindowStartup 用來做主視窗的啟動，程式碼如下

using System。Threading。Tasks；using dotnetCampus。ApplicationStartupManager；using WPFDemo。Api。StartupTaskFramework；namespace WPFDemo。App。Startup{ ［StartupTask（BeforeTasks = StartupNodes。AppReady， AfterTasks = StartupNodes。UI， Scheduler = StartupScheduler。UIOnly）］ internal class MainWindowStartup ： StartupTask { protected override Task RunAsync（StartupContext context） { var mainWindow = new MainWindow（）； mainWindow。Show（）； return CompletedTask； } }}

以上程式碼透過 StartupTask 特性標記了啟動任務項需要在 AppReady 之前執行完成，需要在 UI 之後執行，要求排程到主執行緒執行。對於主視窗顯示，自然是需要等待其他的 UI 相關邏輯執行完成，如 ViewModel 註冊和樣式字典初始化等才能顯示的。而只有在主視窗準備完成之後，才能算 AppReady 應用完成，因此可以如此編排啟動任務項

接下來再新增一個和業務相關的啟動任務項，新增 BusinessStartup 實現業務，業務要求在主介面新增一個按鈕。因此如需求，需要讓 BusinessStartup 在 MainWindowStartup 執行完成之後才能啟動，程式碼如下

［StartupTask（BeforeTasks = StartupNodes。AppReady， AfterTasks = “MainWindowStartup”， Scheduler = StartupScheduler。UIOnly）］ internal class BusinessStartup ： StartupTask { protected override Task RunAsync（StartupContext context） { if （Application。Current。MainWindow。Content is Grid grid） { grid。Children。Add（new Button（） { HorizontalAlignment = HorizontalAlignment。Center， VerticalAlignment = VerticalAlignment。Bottom， Margin = new Thickness（10， 10， 10， 10）， Content = “Click” }）； } return CompletedTask； } }

可以看到，在 BusinessStartup 裡，透過 AfterTasks 設定了

MainWindowStartup

字串，也就表示了需要在 MainWindowStartup 執行完成之後才能執行

此外，依賴關係是可以跨多個專案的，例如在基礎設施裡面有 WPFDemo。Lib1 程式集的 LibStartup 表示某個元件的初始化，這個元件屬於基礎設施，透過 BeforeTasks 指定要在 Foundation 預設啟動節點啟動

［StartupTask（BeforeTasks = StartupNodes。Foundation）］ class LibStartup ： StartupTask { protected override Task RunAsync（StartupContext context） { context。Logger。LogInfo（“Lib Startup”）； return base。RunAsync（context）； } }

如上可以看到，在此框架設計上，給了 StartupTask 型別的 RunAsync 作為虛方法，方便業務對接時，做同步邏輯，可以透過呼叫基類方法返回 Task 物件

以上程式碼只是標記了 BeforeTasks 而沒有標記 AfterTasks 那麼將會預設給 AfterTasks 賦值為虛擬的啟動點，也就是不需要等待其他啟動項

在 WPFDemo。Api 程式集裡面有一個 OptionStartup 表示根據命令列決定執行的邏輯，這個也屬於基礎設施，但是依賴於 LibStartup 的執行完成，程式碼如下

［StartupTask（BeforeTasks = StartupNodes。Foundation， AfterTasks = “LibStartup”）］ class OptionStartup ： StartupTask { protected override Task RunAsync（StartupContext context） { context。Logger。LogInfo（“Command ” + context。CommandLineOptions。Name）； return CompletedTask； } }

如此即可實現讓 OptionStartup 在 LibStartup 之後執行，且在 Foundation 之前執行

以上的程式碼的啟動圖如下，其中 LibStartup 和 OptionStartup 沒有要求一定要在 UI 執行緒，預設是排程到執行緒池裡執行

在 BeforeTasks 和 AfterTasks 都是可以傳入多個不同的啟動項列表，多個之間使用分號分割。也可以換成使用 BeforeTaskList 和 AfterTaskList 使用陣列的方式，例如有 WPFDemo。Api 程式集的 Foo1Startup 和在 WPFDemo。Lib1 的 Foo2Startup 和 Foo3Startup 啟動任務項，其中 Foo3Startup 需要依賴 Foo1Startup 和 Foo2Startup 的執行完成，可以使用如下程式碼

［StartupTask（BeforeTasks = StartupNodes。CoreUI， AfterTaskList = new［］ { nameof（WPFDemo。Lib1。Startup。Foo2Startup）， “Foo1Startup” }）］ public class Foo3Startup ： StartupTask { protected override Task RunAsync（StartupContext context） { context。Logger。LogInfo（“Foo3 Startup”）； return base。RunAsync（context）； } }

以上就是應用接入 ApplicationStartupManager 啟動流程框架的方法，以及業務方編寫啟動任務項的例子。以上的程式碼放在 https：//github。com/dotnet-campus/dotnetCampus。ApplicationStartupManager 的例子專案

本作品採用知識共享署名-非商業性使用-相同方式共享 4。0 國際許可協議進行許可。歡迎轉載、使用、重新發布，但務必保留文章署名［林德熙］（http：//blog。csdn。net/lindexi_gd）（包含連結：http：//blog。csdn。net/lindexi_gd ），不得用於商業目的，基於本文修改後的作品務必以相同的許可釋出。如有任何疑問，請與我［聯絡］（mailto：lindexi_gd@163。com）。

TAG: 啟動任務應用框架邏輯