前端跨平臺UI組件【免費下載鏈接】PrismPrism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Xamarin Forms, and Uno / Win UI Applications..項目地址https://gitcode.com/gh_mirrors/pri/Prism點擊查看免費下載本指南圍繞倉庫e2e/Uno/HelloWorld中的官方端到端示例README 見 e2e/Uno/HelloWorld/ReadMe.md展開系統(tǒng)講解如何在一個單項目 Uno 應用中組合 Prism 的區(qū)域導航NavigationView 主區(qū)域 嵌套 ContentControl 子區(qū)域、對話框服務、模塊化加載Playground.Module、DryIoc 容器、ILoadableShell啟動加載與InvokeCommandAction交互并完整還原本地 NativeAOT 綁定驗證的構建命令、檢查清單與 CLI 自動化流程。讀完本文你將掌握該 playground 的工程結構、五類目標框架TFM的差異化構建方式以及一套可復用的渲染級綁定回歸 物理設備 NativeAOT 發(fā)布驗證方法。一、示例整體能力概覽該示例是 Prism 面向 Uno Platform 的單項目UnoSingleProject演示集中覆蓋以下能力區(qū)域RegionsNavigationView作為主內容區(qū)域容器頁面內嵌套ContentControl作為二級DetailRegion對話框Dialogs基于IDialogService與 UnoDialogWindow的通知/確認對話框模塊化Modularity獨立項目Playground.Module作為IModule加載依賴注入常規(guī)構建使用DryIoc適配器Prism.DryIoc.Uno啟動加載通過ILoadableShell配合 Uno Toolkit 的ExtendedSplashScreen實現(xiàn)初始化期間的加載態(tài)交互Home 頁面演示InvokeCommandAction事件觸發(fā)命令綁定NativeAOT 綁定實驗室以真實容器、命名區(qū)域導航與普通{Binding}路徑驗證生成的成員保留member preservation行為。從 HelloWorld.csproj 可以看到應用同時面向五個 TFMnet10.0-desktop、net10.0-android、net10.0-ios、net10.0-windows10.0.26100與net10.0-browserwasm應用標題為Prism Playground并啟用了 UnoFeatures 中的 Material、Hosting、Toolkit、Logging 與 LoggingSerilog。二、工程結構與關鍵代碼路徑1. 啟動入口與容器選擇應用根類型HelloWorld.App繼承自 PlaygroundApplication.cs 中定義的抽象類PlaygroundApplication : PrismApplication。這個中間層的關鍵作用是讓 XAML 根保持一致同時通過 GlobalUsings.cs 中的條件別名切換容器#if PRISM_NATIVE_AOT_VALIDATION global using PrismApplication Prism.PrismApplicationBase; #else global using Prism.DryIoc; #endif也就是說普通構建下PrismApplication即 DryIoc 適配器提供的PrismApplicationNativeAOT 驗證構建下則退化為容器無關的 PrismApplicationBase.cs由應用自己提供容器擴展。在 App.xaml.cs 中public partial class App : PlaygroundApplication { protected override UIElement CreateShell() { return Container.ResolveShell(); } protected override void RegisterTypes(IContainerRegistry containerRegistry) { containerRegistry.RegisterForNavigationBindingLabPage, BindingLabViewModel(BindingLab); containerRegistry.RegisterForNavigationBindingLabPage, BindingLabViewModel(BindingLabDetail); } protected override void ConfigureModuleCatalog(IModuleCatalog moduleCatalog) { moduleCatalog.AddModulePlaygroundModule(); } }注意同一對BindingLabPage/BindingLabViewModel被注冊到兩個命名路由BindingLab與BindingLabDetail——這正是 NativeAOT 驗證中命名導航與獨立上下文機制的基礎詳見第五節(jié)。只有開啟PRISM_NATIVE_AOT_VALIDATION條件編譯時CreateContainerExtension()才會返回Prism.Container.Microsoft.MicrosoftContainerExtension即 Microsoft.Extensions.DependencyInjection 適配器從而在驗證路徑中徹底繞開 DryIoc。2. ShellNavigationView 主區(qū)域與啟動加載Shell.xaml 使用 Uno Toolkit 的ExtendedSplashScreen包裹整棵視覺樹內部是一個NavigationViewNavigationView prism:RegionManager.RegionNameContentRegion IsSettingsVisiblefalse PaneDisplayModeLeft NavigationView.MenuItems NavigationViewItem ContentHome TagHomeView / NavigationViewItem ContentRegion lab TagRegionLabView / NavigationViewItem ContentDialog lab TagDialogLabView / NavigationViewItem ContentNativeAOT binding lab TagBindingLab / NavigationViewItem ContentModule TagModuleAboutView / /NavigationView.MenuItems /NavigationView其配套的 Shell.xaml.cs 實現(xiàn)了ILoadableShell構造時創(chuàng)建一個IsExecuting true的CompositeLoadableSource作為 Splash 的 Source直到 Prism 初始化完成才調用FinishLoading()關閉加載態(tài)。ILoadableShell的契約定義在 src/Uno/Prism.Uno/ILoadableShell.cs而調用點位于 PrismApplicationBase.cs 的FinalizeInitialization中——模塊初始化與OnInitialized執(zhí)行完畢后才觸發(fā)loadableShell.FinishLoading()保證了整個 Prism 啟動序列完成前用戶始終看到加載畫面。菜單項的Tag是導航目標NavigationView區(qū)域的適配器 NavigationViewRegionAdapter.cs 在SelectionChanged時讀取選中項Tag中的非空字符串并調用region.RequestNavigate(navigationTarget)同時把BackRequested接到該區(qū)域NavigationService.Journal.GoBack()把region.ActiveViews的第一個活動視圖設置為NavigationView.Content。也就是說NavigationView 的返回按鈕直接驅動ContentRegion的導航日志journal。3. 模塊化Playground.ModulePlaygroundModule.cs 在RegisterTypes中注冊了六個導航頁HomeView、RegionLabView、DialogLabView、ModuleAboutView、RegionDetailAlphaView、RegionDetailBetaView與兩個對話框NotificationDialog、ConfirmDialog并在OnInitialized里解析IRegionManager后執(zhí)行首屏導航public void OnInitialized(IContainerProvider containerProvider) { var regionManager containerProvider.ResolveIRegionManager(); regionManager.RequestNavigate(ContentRegion, HomeView); }模塊項目 Playground.Module.csproj 與宿主應用保持相同的五個 TFM并以ProjectReference直接引用src/Prism.Core與src/Uno/Prism.Uno。這里體現(xiàn)的模塊化邊界是所有 Region/Dialog 注冊都在模塊內部完成宿主應用只負責把模塊加進目錄。4. 嵌套區(qū)域ContentControl 二級 DetailRegionRegionLabView的 RegionLabView.xaml 在頁面內部放了一個命名區(qū)域ContentControl prism:RegionManager.RegionNameDetailRegion HorizontalAlignmentStretch VerticalAlignmentStretch /對應的 RegionLabViewModel.cs 演示了父區(qū)域頁面管理子區(qū)域導航日志的典型做法OnNavigatedTo時訂閱IRegionManager.Regions.CollectionChanged以捕獲DetailRegion的注冊時機將OpenAlphaCommand/OpenBetaCommand的CanExecute與區(qū)域是否存在綁定并通過_detailRegion.NavigationService.Journal.GoBack()實現(xiàn)僅回退二級區(qū)域的獨立返回。這與 Shell 層的NavigationView 返回按鈕走 ContentRegion 日志形成兩級日志協(xié)同。5. 對話框IDialogService 與 IDialogAwareDialogLabViewModel.cs 演示兩種對話框調用無回調的通知與帶回調的結果確認_dialogService.ShowDialog( nameof(NotificationDialog), new DialogParameters { { title, Notification }, { message, This dialog is registered in PlaygroundModule and hosted by Prism’s Uno DialogService. } }); _dialogService.ShowDialog( nameof(ConfirmDialog), new DialogParameters { { message, Discard unsaved playground changes? } }, r LastResult $Confirm dialog closed: {r.Result});ConfirmDialogViewModel實現(xiàn)IDialogAware通過RequestClose.Invoke(new DialogResult(ButtonResult.OK/Cancel))關閉對話框并在OnDialogOpened中讀取參數(shù)。底層實現(xiàn) src/Uno/Prism.Uno/Dialogs/DialogService.cs 揭示了完整生命周期按KnownDialogParameters.WindowName解析IDialogWindow默認ContentDialog→ 設置XamlRoot→ 從IDialogViewRegistry創(chuàng)建視圖并斷言其 DataContext 為IDialogAware→Loaded時初始化DialogCloseListener→Closing時檢查CanCloseDialog()→Closed時回調OnDialogClosed并await callback.Invoke(result)。若異常則直接await callback.Invoke(ex)將異常交給調用方。6. InvokeCommandActionHome 頁 HomeView.xaml 通過行為綁定按鈕事件到命令Button ContentGo to region lab (InvokeCommandAction) i:Interaction.Behaviors ic:EventTriggerBehavior EventNameClick prism:InvokeCommandAction Command{Binding GoToRegionLabCommand} / /ic:EventTriggerBehavior /i:Interaction.Behaviors /Button實現(xiàn)位于 src/Uno/Prism.Uno/Interactivity/InvokeCommandAction.cs除執(zhí)行命令外還提供AutoEnable默認 true根據(jù)命令CanExecute自動啟用/禁用關聯(lián)元素、CommandParameter與TriggerParameterPath支持點分路徑從觸發(fā)器參數(shù)中提取嵌套屬性三個依賴屬性命令本身在 HomeViewModel.cs 中通過IRegionManager.RequestNavigate(ContentRegion, RegionLabView)完成跳轉。三、構建與運行含 WinUI 差異與注意事項README 明確提示Prism 包在本倉庫中均為項目引用project references構建時會按需編譯src/Uno下的源碼因此構建整個 solution 或單獨項目前無需額外還原 Prism 包。1. Skia / workload 說明示例在UnoFeatures中刻意省略了SkiaRenderer這樣dotnet workload restore才能在 Android/iOS 頭head上成功——README 指出這是為避免 Uno 的ReplaceUnoRuntime/RuntimeAssetsSelectorTask在強制為這些 TFM 指定 Skia 時拋錯。2. CLI 友好的 TFMdotnet builddotnet build .\e2e\Uno\HelloWorld\HelloWorld.csproj -f net10.0-desktop dotnet build .\e2e\Uno\HelloWorld\HelloWorld.csproj -f net10.0-browserwasmnet10.0-desktopSkia/桌面與net10.0-browserwasmWebAssembly是命令行直接可構建的目標。3. WinUI TFM必須使用 msbuildnet10.0-windows10.0.26100屬于 WinUI 類庫場景Uno 會阻止對含 XAML 的 WinUI 類庫執(zhí)行dotnet build錯誤UNOB0008因此 Windows TFM 必須交給 Visual Studio 或msbuild構建與Prism.Uno的 CI 方式一致msbuild .\e2e\Uno\HelloWorld\HelloWorld.csproj -restore -p:TargetFrameworknet10.0-windows10.0.261004. 解決方案文件的使用限制e2e/Uno/HelloWorld.slnx同時包含 Prism 庫項目。README 特別警告不要對整套 solution 傳入單個-f否則會把包括Prism.Core在內的所有項目強制壓到同一個 TFM 上。正確做法是像上文那樣按 TFM 單獨構建HelloWorld.csproj。5. Windows TFM 的工程級處理HelloWorld.csproj 對windows10TFM 做了專項配置設置IsWinAppSdktrue、關閉默認 PRI/Page 項生成EnableDefaultPriItems/EnableDefaultPageItemsfalse再顯式列出App.xaml、Views\Shell.xaml、Views\BindingLabPage.xaml、Styles\ColorPaletteOverride.xaml與Strings\en\Resources.resw。原因注釋指出若不這樣做Uno 與 Windows SDK 的默認項會重疊如NETSDK1022重復PRIResource/Page。Playground.Module.csproj采用同樣的模式并在非 Windows TFM 使用Uno.Microsoft.Xaml.Behaviors.WinUI.Managed、Windows TFM 使用Microsoft.Xaml.Behaviors.WinUI.Managed。四、NativeAOT 綁定實驗室功能層面該實驗室位于 BindingLabPage.xamlUI 上全部使用普通{Binding}而非編譯綁定compiled bindings用于專門驗證 NativeAOT 下 Uno 生成的成員保留member preservation是否足以支撐運行時反射綁定。1. 獨立 INPC 模型基類關鍵設計在 BindingContext.cs上下文BindingContext繼承自封閉泛型NotifyingContextstring而NotifyingContextTTitle刻意不繼承BindableBase而是直接實現(xiàn)INotifyPropertyChanged。注釋明確說明這樣做的目的bindings must retain inherited members of other INPC models too——即驗證綁定訪問器對其他 INPC 模型的繼承成員同樣被保留。模型上還有嵌套動作BindingAction攜帶Text/Icon/Command其命令是一個DelegateCommand執(zhí)行后回調UpdateTitle(_actionTitle)。2. ViewModel 與命名路由BindingLabViewModel.cs 實現(xiàn)IRegionAware其IsNavigationTarget只接受自己最初到達的命名路由public bool IsNavigationTarget(NavigationContext navigationContext) string.Equals(_navigationRoute, navigationContext.Uri.ToString(), StringComparison.Ordinal);由于BindingLab與BindingLabDetail注冊了同一個 ViewModel 類型這一判斷保證root 與 detail 各持有獨立的 ViewModel 與上下文實例detail 頁面不會復用 root 的模型而再次導航到同一命名路由時則允許復用README 描述為the view-model accepts reuse only for its original named route。BackCommand直接調用_navigation.Regions[ContentRegion].NavigationService.Journal.GoBack()。3. 15 項渲染綁定檢查清單點擊Run binding checks后BindingLabPage.xaml.cs 通過Expect(...)最多重試 100 次、每次間隔 20ms等待 UI 調度器應用綁定與集合模板逐項斷言真實渲染后的控件。完整覆蓋必須報告PASS: 15 rendered binding checks#檢查場景斷言要點1初始嵌套綁定ContextTitle.Text Initial context且導航指示按鈕Visible2初始集合項ItemsControl 模板內渲染出Initial item3嵌套動作NestedAction.Content Initial action、圖標、Command非空、HasActionButton/HasTitle為 true4繼承屬性通知UpdateTitle后標題更新、ToggleNavigationVisibility后按鈕Collapsed5上下文替換/舊模型脫離替換后新標題生效舊模型再變更不再影響渲染6空上下文全部相關控件回退為空/Collapsed/false依賴TargetNullValue/FallbackValue7上下文恢復重新賦值后標題與可見性恢復8嵌套動作通知UpdateAction后文本/圖標更新9嵌套動作替換/舊動作脫離替換后新文本/圖標生效HasActionButton保持 true10清空嵌套動作文本、圖標、Command 均空11恢復嵌套動作恢復后文本/圖標/Command 與HasActionButton全部恢復12嵌套綁定命令執(zhí)行從控件上取回Command并Execute標題變?yōu)锳ction command invoked13集合項通知Items[0].UpdateTitle后模板文本更新14集合添加Items.Add后行數(shù)變?yōu)?2 且新項渲染15集合移除Items.RemoveAt(0)后行數(shù)為 1、舊項消失、新項保留檢查代碼中的關鍵說明嵌套動作BindingAction派生自BindableBase且未加應用側特性上下文仍測試獨立 INPC 路徑而生成的屬性保留generated property preservation本身不能證明 Uno 為每個獨立 INPC 類型都生成了訪問器——這正是該實驗室存在的意義。4. 命名導航往返驗證點擊Navigate to named detailNavigateCommand→RequestNavigate(ContentRegion, BindingLabDetail)新實驗室頁面必須出現(xiàn)其狀態(tài)欄標識BindingLabDetail在該頁執(zhí)行全部檢查后點Back日志journal必須回到原實驗室頁面并恢復其上下文。README 要求重復該導航往返且 root 與 detail 始終保持獨立上下文。手動按鈕更新、替換/恢復、置空、可見性切換、集合增刪允許逐項獨立檢查替換/恢復在置空后依然可恢復Home、Region、Dialog、Module 頁面在驗證全程保持可訪問。五、本地 NativeAOT 發(fā)布驗證權威流程1. 驗證屬性與工程約束PrismNativeAotValidationtrue僅作用于 Release Android/iOS應用項目在 HelloWorld.csproj 中映射為PropertyGroup Condition$(PrismNativeAotValidation) true and (ios or android) PublishAottrue/PublishAot DefineConstants$(DefineConstants);PRISM_NATIVE_AOT_VALIDATION/DefineConstants UseInterpreterfalse/UseInterpreter /PropertyGroup三點硬性約束由工程內ValidateNativeAotConfiguration/ValidateNativeAotBuild兩個 MSBuild Target 強制不得全局傳PublishAot否則會傳播到被引用的庫項目必須Release且目標為 Android/iOS驗證構建通過CreateContainerExtension選擇真實的Prism.Container.Microsoft適配器直接引用Prism.Uno不引用 DryIoc 適配器不得用容器 shim 或把實現(xiàn)類型拷進示例。中央包配置Directory.Packages.props將 Microsoft 與 Abstractions含共享 analyzer固定到已發(fā)布的10.0.94-pre從配置好的 Prism 包源還原即可基線無需版本覆蓋或本地容器構建只有測試進一步未發(fā)布的容器改動時才用可選屬性PrismNativeAotContainerVersion選擇匹配的真實本地包。2. iOS 與 Android 發(fā)布命令iOS物理設備ios-arm64RIDdotnet publish e2e/Uno/HelloWorld/HelloWorld.csproj \ -c Release -f net10.0-ios -r ios-arm64 \ -p:PrismNativeAotValidationtrueAndroid 使用相同命令改為-f net10.0-android -r android-arm64。前置條件與提醒Uno 6.6 的 NativeAOT 指引覆蓋 .NET 10 的 Android 與 iOSAndroid 需要NDK r27 或更新并會發(fā)出實驗性警告XA1040——需要檢查警告與設備實測結果普通 Android AOT 構建絕不能算作 NativeAOT 驗證發(fā)布命令刻意使用物理設備 RIDios-arm64不要僅憑通用平臺文檔推斷模擬器支持務必先確認所裝 SDK 對所選 RID 的真實支持一次更早的原生發(fā)布、之后的非原生模擬器登錄或已存在的生成元數(shù)據(jù)文件都不能為當前源碼改動背書——必須對當前改動產(chǎn)物執(zhí)行一次全新的原生發(fā)布并跑完渲染檢查驗證前需確認已安裝支持的 SDK/平臺/RID 與已驗證 NativeAOT 兼容的真實容器配置隨后進行本地發(fā)布與真機運行并記錄確切版本與每一個 trimming/AOT 警告云上的源碼/XML 檢查不是 NativeAOT 或設備級通過本倉庫不包含移動端 CI 任務或工作流改動。3. 可選未發(fā)布的本地容器包準備僅當測試未發(fā)布的容器改動時需要。完整流程見 e2e/Maui/PrismMauiDemo/NativeAotValidation.mdMaui 側同套方案對PrismLibrary/Prism.Containers檢出物按正常支持 TFM 執(zhí)行dotnet pack基線為合并提交f3e51fbb生成兩個項目共用的單一本地預發(fā)布版本然后在發(fā)布命令中追加-p:RestoreAdditionalProjectSources$PRISM_CONTAINER_FEED \ -p:PrismNativeAotContainerVersion$PRISM_CONTAINER_VERSIONREADME 特別強調僅用于云生成器/核心單元測試的 net10-only 包不能建立完整的多目標移動端還原或原生執(zhí)行通過本地包必須覆蓋項目正常的全部受支持 TFM。4. CLI 驅動的物理設備自動化檢查在 Release NativeAOT 驗證構建中設置環(huán)境變量PRISM_NATIVEAOT_AUTORUN1啟動應用App.xaml.cs 的OnInitialized會先導航到BindingLab隨后 BindingLabPage.xaml.cs 的AutoRunAsync自動執(zhí)行完整流程輸出[binding-run] dynamic-code...檢查動態(tài)代碼支持狀態(tài)在 root 實驗室運行 15 項渲染斷言并要求PASS通過按鈕上真實綁定的Command導航到命名 detail要求 detail 不復用 root 的 ViewModel在 detail 再跑全部斷言通過 detail 的 Back 返回斷言 root 的 ViewModel、Context與渲染狀態(tài)全部還原Console標記逐項報告結果上述detail 訪問 Back 還原完整重復兩次最終輸出[binding-run] COMPLETE root two named detail / Back visits。Android 側的等價入口是啟動既有主 Activity 時攜帶布爾型 Intent extraprism-nativeaot-autoruntrue它會在 UI 初始化前設置同一 opt-in。README 明確該自動化不取代手動橫豎屏、滾動、輔助功能與觸摸交互檢查。六、核心文件索引示例總覽與全部構建/驗證說明e2e/Uno/HelloWorld/ReadMe.md應用工程五 TFM NativeAOT 開關e2e/Uno/HelloWorld/HelloWorld.csproj應用啟動與注冊e2e/Uno/HelloWorld/App.xaml.cs、e2e/Uno/HelloWorld/App.xamlShell 與啟動加載e2e/Uno/HelloWorld/Views/Shell.xaml、Shell.xaml.cs綁定實驗室BindingLabPage.xaml、BindingLabPage.xaml.cs、BindingLabViewModel.cs、BindingContext.cs模塊示例PlaygroundModule.cs、Playground.Module.csproj框架側實現(xiàn)NavigationViewRegionAdaptersrc/Uno/Prism.Uno/Navigation/Regions/NavigationViewRegionAdapter.cs、DialogServicesrc/Uno/Prism.Uno/Dialogs/DialogService.cs、ILoadableShellsrc/Uno/Prism.Uno/ILoadableShell.cs、PrismApplicationBasesrc/Uno/Prism.Uno/PrismApplicationBase.csMaui 側等價驗證文檔e2e/Maui/PrismMauiDemo/NativeAotValidation.md七、小結與適用前提該 playground 是 Prism 在 Uno Platform 上的活文檔區(qū)域含兩級導航日志、對話框、模塊化、DryIoc 與InvokeCommandAction均可直接對照源碼閱讀與修改運行而 NativeAOT 綁定實驗室則提供了一套以真實容器 普通綁定 渲染斷言為核心的本地驗證基線。使用時請留意兩個前提其一README 中提及的 Uno 入門與 SDK 使用指引、Uno 6.6 NativeAOT 官方指引均來自外部站點本倉庫未內置請以當前安裝的 Uno SDK 實際行為為準其二移動端發(fā)布與真機執(zhí)行未被云端工作區(qū)驗證本文所述發(fā)布命令與警告如 XA1040需要在具備相應 SDK、workload 與真機的本地環(huán)境中實測確認。贊分享前端跨平臺UI組件【免費下載鏈接】PrismPrism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Xamarin Forms, and Uno / Win UI Applications..項目地址https://gitcode.com/gh_mirrors/pri/Prism點擊查看免費下載相關推薦高性能API守護神Hertz請求綁定與驗證實戰(zhàn)指南高性能API守護神Hertz請求綁定與驗證實戰(zhàn)指南 你還在為API數(shù)據(jù)校驗寫重復代碼還在擔心非法輸入導致系統(tǒng)崩潰本文將帶你掌握Hertz框架的請求綁定與驗后端微服務Web框架Apache Beam Release Candidate 驗證實戰(zhàn)指南Java / Python / Go 與 Prism Runner 全流程Apache Beam Release Candidate 驗證實戰(zhàn)指南Java / Python / Go 與 Prism Runner 全流程 Apach大數(shù)據(jù)批處理流處理數(shù)據(jù)工程WPF 業(yè)務層驗證實戰(zhàn)基于 IDataErrorInfo 與 DataErrorValidationRule 的綁定校驗WPF 業(yè)務層驗證實戰(zhàn)基于 IDataErrorInfo 與 DataErrorValidationRule 的綁定校驗 本文圍繞 WPF Samples 倉示例工程創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考