Majorsilence.Forms

අගෝස්තුවේ සිට පැමිණි දේ: 26.9.0, නව backends හතරක්, CSS තේමා සහ හැසිරීම් විගණනය

2026-10-08T14:30:00+00:00

මෙහි අවසාන ලිපිය ලියා තිබුණේ 26.0.30 අනුවාදය අනුවය. 2026-08-17 සිට repository එකට commits 557 ක් එක් වී ඇති අතර වත්මන් නිකුතුව 26.9.0 වේ. මෙය දැනට සිටින පරිශීලකයින් සහ ඇගයීම් කරන්නන් සඳහා සාරාංශයකි: වෙනස් වූයේ කුමක්ද, එක් එක් කොටස කෙතරම් පරිණතද, සහ උත්ශ්‍රේණි කිරීමේදී ඔබ අනිවාර්යයෙන්ම කළ යුතු එකම දෙය.

නව backends හතරක්

ධාරක (hosts) තුනක් තිබුණි — Avalonia, Uno, Headless. දැන් හතක් ඇති අතර, සියල්ලම එකම පාලක කට්ටලය ධාවනය කරයි; වෙනස වන්නේ කවුළුව නිර්මාණය කර Skia surface එක ඉදිරිපත් කරන්නේ කවුද යන්න පමණි.

GTK 4 (Majorsilence.Forms.Gtk4) යනු gir.core මත ගොඩනගා ඇති, Linux වලට මුල්තැන දෙන ධාරකයකි: එක් පෝරමයකට එක් සැබෑ Gtk.Window එකක්, GLib main loop, තවද GTK 4 runtime සමඟ Windows සහ macOS මතද භාවිත කළ හැකිය. Application.Run ට පෙර Gtk4Application.Use (); සමඟ එය පැහැදිලිවම තෝරන්න. කාවැද්දීම (embedding) දෙපැත්තටම ක්‍රියා කරයි (ToGtkWidget(), ToGtkWindow()), GTK 4 එක් render tree එකක් සංයුක්ත කරන බැවින් NativeControlHost හට “airspace” ගැටලුවක් නැත, තවද WebBrowser WebKitGTK 6.0 මඟින් සහාය දක්වයි. Wayland මත තහවුරු කර ඇත. දන්නා හිඩැස්: තිර-පිහිටීම් පාලනයක් නැත (GTK 4 එම API එක ඉවත් කළේය), SetIcon(byte[]) යනු no-op (කිසිවක් නොකරයි) එකකි, native file pickers හිස්ව ආපසු එන බැවින් විකල්ප (fallback) සංවාද කවුළු භාවිත වේ, පූර්ණ සංඛ්‍යා scale factor පමණි, AOT-විශ්ලේෂණය කර නැත.

Terminal (Majorsilence.Forms.Terminal, 2026-10-04) පෝරමයක් console එකක් තුළ තනි-දර්ශන (single view) ලෙස ධාරණය කරයි — දුරකථනයක මෙන්, පෝරමය terminal එක පුරා පිරී යයි, title bar එකක් නැත. ලබා ගත හැකි තැන්වල එය සැබෑ pixel විභේදනයෙන් Kitty graphics හෝ Sixel භාවිත කරයි, එසේ නොමැති නම් Unicode block elements; හඳුනාගැනීම සිදු වන්නේ terminal එකෙන් විමසීමෙනි, තවද MF_TERMINAL_GRAPHICS=halfblock|kitty|sixel මඟින් ප්‍රකාරයක් ස්ථිර කරයි. Mouse සහ keyboard ක්‍රියා කරයි; Ctrl+C සෑම විටම පිටවෙයි. TerminalApplication.Use (options); සමඟ තෝරනු ලැබේ. xterm සහ WezTerm මත පමණක් තහවුරු කර ඇත. Native pickers, NativeControlHost හෝ webview නැත.

WinForms (Majorsilence.Forms.WinForms) යනු Windows-පමණක් වූ සංක්‍රමණ backend එකකි: Win32 pump මත සැබෑ System.Windows.Forms කවුළු, GDI bitmap එකක් හරහා ඉදිරිපත් කරන Skia. එය පවතින්නේ ඔබට පවතින WinForms යෙදුමක් තුළ Majorsilence.Forms පාලක වරකට එක පාලකය බැගින් කාවැද්දීමට හැකි වන පරිදිය — myMfControl.ToWinFormsControl(), myForm.ToWinFormsForm(), MajorsilenceFormsPresenter — ඉන්පසු සියල්ල port කළ පසු ධාරකය Avalonia හෝ Uno වෙත මාරු කරන්න. Gestures නැත, IWebViewFactory නැත. එය Avalonia ධාරකය මත සම්පූර්ණ පෝරම සම්බන්ධ කරන පැරණි WindowsFormsInterop ට වඩා වෙනස් ය.

WPF (Majorsilence.Forms.Wpf) WPF යෙදුම් සඳහා එම හැඩයම සහ අරමුණම ඇත: සැබෑ WPF Window එකක්, WriteableBitmap ඉදිරිපත් කිරීම, ToWpfElement() සහ ToWpfWindow(). Platform.Backend = new Majorsilence.Forms.Wpf.WpfPlatformBackend (); සමඟ එය තෝරන්න.

Avalonia, WinForms සහ GTK 4 සැබෑ OS-මට්ටමේ modal සංවාද කවුළු ලබා දෙයි; Uno ස්වාධීන කවුළුවක් විවෘත කරයි, එබැවින් එහිදී Form.ShowDialog(parent) භාවිත කරන්න.

.NET Framework 4.8 සහ netstandard2.0

මූලික packages — Majorsilence.Forms, .Drawing.Common, .Telerik — දැන් net8.0, net10.0 සහ netstandard2.0 බහු-ඉලක්ක (multi-target) කරන අතර, WinForms සහ WPF backends net48 එක් කරයි. එබැවින් .NET Framework 4.8 යෙදුමකට පළමුව නවීන .NET වෙත මාරු නොවී Majorsilence.Forms පාලක ධාරණය කළ හැකි අතර, එමඟින් බොහෝ සංක්‍රමණවලට තිබූ අනුපිළිවෙල පිළිබඳ ගැටලුවක් ඉවත් වේ.

හැසිරීම්-හිඩැස් විගණනය

API-මතුපිට හිඩැස් සැලසුම් දෙක (WinForms සහ GDI+) ශුන්‍යයේ පවතී: upstream හි ඇති සෑම member එකක්ම ප්‍රකාශ කර ඇත. එය සෑම විටම අඩු සිත්ගන්නා භාගය විය. පවතින නමුත් කිසිවෙකු කියවන්නේ නැති අගයක් ගබඩා කරන, හෝ කිසිවෙකු fire නොකරන event එකක් ඇති member එකක් ඔබේ සංක්‍රමණය කළ යෙදුම compile කරයි, ඉන්පසු නිහඬවම කිසිවක් නොකරයි.

එබැවින් 2026-08-25 දින ක්ෂේත්‍ර දොළහක විගණනයක් එක් එක් ක්ෂේත්‍රය upstream ක්‍රියාත්මක කිරීම සමඟ සංසන්දනය කර, හැසිරීම වෙනස් වූ සොයාගැනීම් 483 ක් වාර්තා කළේය. එතැන් සිට අදියර 0–4 සහ බොහෝ පාලක-පවුල් පැමිණ ඇත. දැන් සැබෑ වී ඇති නිශ්චිත අයිතම: ProcessCmdKey පූර්ව-සැකසුම් දාමය, තනි focus/validation පාලන ලක්ෂ්‍යයක්, client area එකෙන් පිටත title bar එක, AutoScaleMode.Font සැබවින්ම පරිමාණනය කිරීම, සජීවී data binding (CurrencyManager, BindingNavigator), ListView.View = Details, upstream අනුපිළිවෙලින් පෝරම ජීවන චක්‍රය (Load → VisibleChanged → Activated, Shown post කෙරේ), DataGridView තීරු නැවත පිළියෙල කිරීම, පෙළ පාලකවල Ctrl+Z, system tray හි NotifyIcon, Application.AddMessageFilter, සහ පෝරමයක් dispose කිරීමේදී එහි පාලක dispose කිරීම.

හිස් මතුපිට දැන් මනිනු ලැබේ: baseline ගොනු මඟින් දන්නා no-op methods, අක්‍රිය events සහ ගබඩා-පමණක් properties ස්ථිර කරයි, එබැවින් ඒවාට එකතු කිරීම අහම්බයක් නොව සවිඥානික ක්‍රියාවකි. Stub ප්‍රතිපත්තිය වෙනස් නොවේ — no-op හෝ පෙරනිමි අගය ආපසු දීම, කිසිදා NotImplementedException නොවේ.

තාර්කික ඒකක: ඔබ අනිවාර්යයෙන්ම කළ යුතු එකම දෙය

2026-10-01 දින ClientRectangle, ClientSize සහ paint canvas (OnPaint, Paint, e.ClipRectangle, e.Canvas) තාර්කික ඒකක (logical units) බවට පත් විය; එය Width/Height/Bounds සහ MouseEventArgs සමඟ ගැළපේ. Framework එක ඔබ වෙනුවෙන් canvas එක display එකට පරිමාණනය කරයි.

අභිරුචි පාලකයක් e.Graphics.ScaleTransform (e.Scaling, e.Scaling) call කළේ නම්, එය ඉවත් කරන්න — දැන් ඇඳීම දෙවරක් පරිමාණනය වේ. උපාංග පික්සල (device pixels) තවමත් Scaled* පවුල (ScaledWidth, ScaledBounds, …), PaintEventArgs.Scaling සහ LogicalToDeviceUnits හරහා ලබා ගත හැකිය. එකම ව්‍යතිරේකය owner-draw events (DrawItem, DrawNode, CellPainting) වන අතර, ඒවා තවමත් ඔබට උපාංග-පික්සල සීමා ලබා දෙයි. පැරණි හැසිරීම මත රඳා පවතින ඕනෑම දෙයක් අල්ලා ගැනීමට ඔබේ පරීක්ෂණ MF_HEADLESS_SCALE=2 සමඟ ධාවනය කරන්න.

Browser සහ mobile

net10.0-browser, -android සහ -ios මත Avalonia backend එක CanRunModalLoop = false වාර්තා කරයි, තවද අවහිර කරන calls — Form.ShowDialog, MessageBox.Show, file pickers, TaskDialog.ShowDialog, VbInteraction.MsgBox/InputBox, RadMessageBox.Show — දැන් එල්ලී සිටිනවා වෙනුවට, කිසිවක් පෙන්වීමට පෙර async සහෝදර method එක නම් කරමින් PlatformNotSupportedException විසි කරයි. Async ආකාර (ShowDialogAsync, MessageBox.ShowAsync, FileDialog.ShowDialogAsync, …) සෑම ධාරකයකම ක්‍රියා කරයි, එබැවින් සම්මත රටාව වන්නේ await සහිත async void handler එකකි. මූලික package එකේ ඇති Roslyn analyzer එකක් මේවා කලින්ම සොයා ගනී — MFB001 අවහිර කරන modal call, MFB002 Task එකක් මත සමමුහුර්ත රැඳී සිටීම, MFB003 Thread.Sleep, එක් එක් සඳහා code fix එකක් සමඟ — browser TFMs සඳහා හෝ .editorconfig හි majorsilence_forms.browser_target = true සමඟ සක්‍රිය වේ.

Browser ඉලක්කය canvas එක අසලම ප්‍රවේශ්‍යතා DOM (accessibility DOM) එකක් ද තබා ගනී: framework එකේම ස්වයංක්‍රීයකරණ ගසයෙන් (automation tree) ගොඩනගන, ARIA role, නම, තත්ත්වය සහ සීමා සහිත, එක් පාලකයකට එක් විනිවිද පෙනෙන, click-through element එකක්. තිර කියවන (screen readers), find-in-page සහ DOM-පාදක පරීක්ෂණ මෙවලම්වලට දැන් UI එක දැකිය හැකිය.

Android සහ iOS මත TextBox focus වූ විට තිරයේ keyboard එක මතු වේ, TextBoxBase.InputKind keyboard වර්ගය තෝරයි, safe-area insets Form.SafeAreaPadding හරහා යෙදේ, සහ WindowBase.BackRequested Android back බොත්තම හසුරුවයි. අවංක තත්ත්වය: Android හි මූලික සැබෑ-උපාංග පරීක්ෂාවක් සිදු කර ඇත (boot, taps, render scaling, touch scroll දෘඩාංග මත තහවුරු කර ඇත); keyboard, safe-area සහ භ්‍රමණය unit-test කර ඇත්තේ පමණි. iOS CI සැබෑ head එක compile කර simulator smoke check එකක දියත් කරයි, නමුත් කිසිවෙකු එය අන්තර්ක්‍රියාකාරීව ධාවනය කර නැති අතර job එක තවමත් continue-on-error වේ.

දුරකථන-ශෛලියේ පිරිසැලසුම් පාලක ද ඒ සමඟම පැමිණියේය: StackPanel, Card, RichListBox (බහු-පේළි සැකිලිගත පේළි) සහ NavigationHost (back බොත්තමක් සහිත පිටු තොගයක්).

CSS තේමා සහ Theme Studio

තේමා දැන් දැඩි, ලේඛනගත CSS උප කුලකයක් ලෙස ලිවිය හැකිය: @theme "Ocean" extends Dark;, එක් Theme property එකකට එක් :root token එක බැගින්, Button:hover { … } වැනි පාලක-වර්ග නීති, Type::part හරහා කොටස්. Parser එක කිසිදා නිහඬව අසාර්ථක නොවේ — ThemeStyleSheet.Parse diagnostics එකතු කරයි. Theme.LoadFromCssFile සමඟ, හෝ Theme.RegisterThemeCssFromFile + Theme.ApplyTheme ("Ocean") සමඟ පූරණය කරන්න; Theme.ExportCss සමඟ අපනයනය කරන්න. Telerik compat ස්තරය ඇතුළුව සෑම පාලකයකටම selector එකක් ඇති අතර, පැරණි <Theme> XML තවමත් ක්‍රියා කරයි.

සහායක packages දෙකක් එකම sheet එක වෙනත් ධාරකවලට යොදයි: Majorsilence.Forms.Theming.WinForms සැබෑ System.Windows.Forms පාලක නැවත හැඩගන්වයි (Windows පමණි) සහ Majorsilence.Forms.Theming.Avalonia native Avalonia Fluent පාලක නැවත හැඩගන්වයි, එබැවින් එක් CSS ගොනුවකට මිශ්‍ර සංක්‍රමණ යෙදුමකට තේමාවක් දිය හැකිය. samples/ThemeStudio යනු පෙරදසුන සහ diagnostics සහිත සජීවී සංස්කාරකයකි; පෙර-ගොඩනගන ලද binaries GitHub Releases වෙත අමුණා ඇත.

MVVM, Essentials, සජීවීකරණය

Majorsilence.Forms.Mvvm යනු INotifyPropertyChanged සහ ICommand මත trim- සහ AOT-ආරක්ෂිත සම්බන්ධ කිරීමකි; reflection නැත, toolkit පරායත්තතාවයක් නැත: viewModel.Observe (nameof (VM.Count), vm => vm.Count, …), ද්වි-මාර්ග BindText/BindChecked/BindSelectedIndex/BindValue, BindCommand, සහ ඒ සියල්ල dispose කිරීමට BindingScope එකක්. එය CommunityToolkit.Mvvm සමඟ එකට ක්‍රියා කරයි.

Majorsilence.Forms.Essentials වේදිකාවට-විශේෂිත හැකියාවන් core එකෙන් පිටත තබා ගනී: SecureStorage, Speech text-to-speech, Launcher.OpenAsync (http/https/mailto/tel/sms) සහ FileSystem.OpenAppPackageFileAsync. සියල්ල no-op එකකට පහත් වේ; IsSupported පරීක්ෂා කරන්න.

control.RequestAnimationFrame සහ Majorsilence.Forms.Animation (Tween<T>, Easing, Animator) Avalonia මත display-සමපාත සජීවීකරණයක් ද Headless මත අතින් පාලනය කරන ඔරලෝසුවක් ද ලබා දෙයි.

මෙවලම්

MCP server එක ප්‍රකාශිත dotnet tool එකකි: dotnet tool install -g Majorsilence.Forms.Mcp, ඉන්පසු claude mcp add majorsilence-ui -- majorsilence-mcp --port 4444. එය ඔබේ යෙදුමේ WebDriverServer සමඟ සන්නිවේදනය කරමින් ui_snapshot, ui_find, ui_click, ui_type, ui_wait_for සහ ui_screenshot නිරාවරණය කරයි.
samples/AutomationTarget යනු මෙවලම් ඉගෙනීම සඳහා හිතාමතාම අපහසු කළ කුඩා යෙදුමකි (clicks ප්‍රතික්ෂේප කරන පාලක, එකක් නම් නොකළ). අභිරුචි-ලෙස අඳින පාලක IAutomationStateProvider හරහා අගය සහ තත්ත්වය ප්‍රකාශ කරයි.
සංක්‍රමණ මෙවලම (migrator) දැන් dotnet tool එකක් ලෙස පමණක් නිකුත් වේ (dotnet tool install -g Majorsilence.Forms.Migrator); ස්වයං-අන්තර්ගත binaries තවදුරටත් නිකුතුවලට අමුණන්නේ නැත. නව switches: --map, --dual-build, --strict, --dry-run --diff.
Majorsilence.Forms.WinFormsShims.Compat යනු Majorsilence.Forms මඟින් සහාය දක්වන System.Windows.Forms සහ System.Drawing namespaces නිකුත් කරන සංකල්ප-සාධන (proof-of-concept) source generator එකකි, එබැවින් වෙනස් නොකළ WinForms මූලාශ්‍ර — Designer.cs ඇතුළුව — compile වේ. පොදු API එක WinForms වෙත type කර ඇති පාලක පුස්තකාල සඳහා. PoC තත්ත්වය; samples/WinFormsCompatDemo බලන්න.

උත්ශ්‍රේණි කිරීමේ සටහන්

26.9.0 ස්ථිර කරන්න. ව්‍යාපෘතිය තවමත් බීටා අවධියේ ඇති අතර තවමත් දෘශ්‍ය designer එකක් නැත.
අභිරුචි paint කේතයේ ඇති ඕනෑම ScaleTransform (e.Scaling, e.Scaling) ඉවත් කරන්න (ඉහත බලන්න).
සැකිලි package id එක Majorsilence.Forms.Templates වන අතර, dotnet new install Majorsilence.Forms.Templates සමඟ ස්ථාපනය කෙරේ. dotnet new majorsilenceforms දැන් බෙදාගත් UI පුස්තකාලයක් සහ desktop head එකක් සහිත solution එකක් සකසයි; --IncludeAndroid, --IncludeiOS සහ --IncludeWasm heads එක් කරයි.
බිඳ දමන වෙනස්කම් (breaking changes) MIGRATION.md හි ලැයිස්තුගත කර ඇත: SplitContainer.Orientation, TreeViewDrawMode.OwnerDrawContent, event delegate types දැන් WinForms සමඟ ගැළපේ, සහ gradient/hatch brushes GDI+ සමඟ ගැළපෙන පරිදි මාරු කර ඇත.
Browser, Android සහ iOS මත, අවහිර කරන සංවාද කවුළු calls ඒවායේ async සහෝදරයන් සමඟ ප්‍රතිස්ථාපනය කරන්න; ඒවා සොයා ගැනීමට MFB001–MFB003 ට ඉඩ දෙන්න.

වැඩිදුර කියවීමට

Majorsilence.Forms හඳුන්වා දීම

2026-07-21T15:00:00+00:00

WinForms යෙදුමක් Windows-පමණක් desktop එකෙන් ඉවතට ගෙන යාම යනු සාම්ප්‍රදායිකව මුල සිටම නැවත ලිවීමකි (rewrite): XAML, බලහත්කාරයෙන් MVVM ව්‍යුහයකට වෙනස් කිරීම, නැතහොත් web. එය මිල අධිකයි, අවදානම් සහිතයි, තවද බොහෝ විට අලුත් පෙනුමක් පමණක් අවශ්‍ය codebase එකක් වෙනුවෙන් වසර ගණනාවක් තිස්සේ ක්‍රියා කළ ව්‍යාපාරික තර්කනය (business logic) සහ UX ඉවත දමයි.

Majorsilence.Forms වෙනස් ප්‍රවේශයක් ගනී: එය WinForms API මතුපිට පිළිබිඹු කරයි — Form, පාලක (controls), සිදුවීම් හසුරුවන (event handlers), *.Designer.cs code-behind පවා — තවද පවතින පෝරම සහ පාලක ඉතා අඩු වෙනස්කම් ප්‍රමාණයකින් ගෙන යා හැකි වන පරිදි ගැළපුම් ස්තරයක් (compatibility layer) සපයයි. ක්‍රමලේඛන ආකෘතිය වෙනස් නොවේ; වෙනස් වන්නේ එය ධාවනය වන ස්ථානය පමණි.

එය ගොඩනගා ඇති ආකාරය

සෑම පාලකයක්ම SkiaSharp භාවිතයෙන් SKSurface එකකට ඇඳ ඇත්තේ, මාරු කළ හැකි ධාරක (host) backend එකක් මතය:

Avalonia (පෙරනිමි) — Windows, macOS, Linux desktop කිසිදු සැකසීමකින් තොරව, තවද mobile සහ web වෙත ද මාර්ගයක් ලෙස එයටම ආවේණික Android, iOS සහ Browser (WebAssembly) ඉලක්ක සමඟ.
Uno Platform — පුළුල්ම ආවරණය: desktop, iOS, Android සහ WebAssembly.
Headless — CI සහ ස්වයංක්‍රීය පරීක්ෂණ සඳහා කිසිදු පරායත්තතාවයකින් තොර, තිරයෙන් පිටත (offscreen) විදැහුම්කරණය.

මූලික Majorsilence.Forms assembly එක කිසිදු windowing toolkit එකක් reference නොකරයි — SkiaSharp පමණි. Backends යනු IPlatformBackend සහ IWindowBackend යන කුඩා interfaces දෙකට සම්බන්ධ වන වෙනම assemblies ය. එම සන්ධිය (seam) නිසා, යෙදුම් කේතයේ කිසිදු වෙනසක් නොමැතිව හරියටම එකම යෙදුමට අද Avalonia ද හෙට Uno ද ඉලක්ක කළ හැකිය. වැඩිදුර Platform backends හි කියවන්න.

එය කා සඳහාද

ඔබ අද Windows-පමණක් ධාවනය වන WinForms codebase එකක් සතුව සිටිමින්, වසර ගණනාවක නැවත ලිවීමක් ආරම්භ කරනවා වෙනුවට ගම්‍යතාවය රඳවා ගැනීමට — ඔබේ පාලක, ඔබේ කණ්ඩායමේ හුරුපුරුදු දැනුම, ඔබේ ව්‍යාපාරික තර්කනය නැවත භාවිත කිරීමට — කැමති නම්, මෙය ඔබ සඳහාම ගොඩනගා ඇත.

මෙම ව්‍යාපෘතිය මුල් අවධියක පවතී: API ස්ථාවර වෙමින් පවතින අතර සෑම WinForms කොටසක්ම තවමත් ආවරණය වී නැත. නව බහු-වේදිකා ව්‍යාපාරික (LOB) යෙදුම් සඳහා එය දැනටමත් හොඳ තේරීමකි, තවද ඔබ අනුවාදය ස්ථිර කරන්නේ නම් (pin your version) සැබෑ production යෙදුම් සංක්‍රමණය කිරීමටද සුදුසුය. අද ක්‍රියාත්මක කර ඇත්තේ මොනවාද, stub ලෙස පමණක් ඇත්තේ මොනවාද යන්න හරියටම දැනගැනීමට ගැළපුම් න්‍යාසය (compatibility matrix) බලන්න.

උත්සාහ කර බලන්න

dotnet new --install MajorsilenceForms.Templatesdotnet new majorsilenceformsdotnet run

නැතහොත් සැබෑ යෙදුමක් ගවේෂණය කරන්න — samples/Explorer යනු සම්පූර්ණ Windows Explorer ප්‍රතිනිර්මාණයක් වන අතර, samples/Outlaw යනු Outlook ප්‍රතිනිර්මාණයකි; දෙකම එකම පාලක කට්ටලය මත වේදිකා හරහා කිසිදු වෙනසකින් තොරව ධාවනය වේ.

ඔබේ පළමු යෙදුම සකස් කිරීමට Getting Started බලන්න.

Platform backends: Avalonia, Uno සහ Headless

2026-07-21T11:00:00+00:00

Majorsilence.Forms තමන්ගේම සියලු ඇඳීම් SkiaSharp සමඟ සිදු කරයි. සෑම පාලකයක්ම SKSurface/SKCanvas එකකට අඳියි; යටින් ඇති windowing toolkit එක ධාරකයක් (host) පමණි — එය native කවුළු නිර්මාණය කරයි, message loop එක ධාවනය කරයි, ආදානය (input) ලබා දෙයි, සහ Skia surface එක තිරයට ඉදිරිපත් කරයි. එම වෙන්කිරීම නිසා අද හරියටම එකම පාලක කට්ටලයට එකිනෙකට බෙහෙවින් වෙනස් toolkits තුනක් මත ධාවනය විය හැකිය.

සන්ධිය (seam)

ධාරකයක් සැපයිය යුතු සියල්ල interfaces දෙකකින් නිර්වචනය වේ:

IPlatformBackend යෙදුම්-මට්ටමේ සේවා ආවරණය කරයි — dispatcher (Post/Invoke), timers, clipboard, තිර ගණනය කිරීම (screen enumeration), සහ modal loop එක. IWindowBackend තනි native කවුළුවක් ආවරණය කරයි — ප්‍රමාණය සහ පිහිටීම, show/hide/close, cursor, decorations, ගොනු සංවාද කවුළු (file dialogs). ආදාන සහ paint ඉල්ලීම් ගලා යන්නේ අනෙක් දිශාවටය: backend එක කවුළුවේ මධ්‍යස්ථ RenderFrame(SKCanvas, …) සහ Handle* methods සෘජුවම call කරයි. කිසිදු වේදිකා type එකක් — Avalonia type එකක් හෝ WinUI type එකක් — කිසි විටෙක මූලික Majorsilence.Forms කේතයට ඇතුළු නොවේ.

අද ඇති backends තුන

Majorsilence.Forms.Avalonia පෙරනිමියයි — Avalonia 12, කිසිදු සැකසීමකින් තොරව Windows, macOS සහ Linux desktop ලබා දෙයි. එය reference කරන්න, Application.Run(new MyForm()) සරලවම ක්‍රියා කරයි. එය desktop වලට පමණක් සීමා නොවේ: Avalonia එයටම ආවේණික Android, iOS සහ Browser (WASM) ඉලක්ක සපයන බැවින්, පහත විස්තර කරන කැපවූ Uno backend එකට අමතරව, මෙම backend එකම mobile සහ web වෙත දෙවන මාර්ගයකි.

Majorsilence.Forms.Headless යනු හැකි සරලම backend එක වන අතර, නව එකක් ලිවීම සඳහා යොමු සැකිල්ල (reference template) ලෙසද ක්‍රියා කරයි: work-queue message loop එකක්, මතකය තුළ (in-memory) clipboard එකක්, අතථ්‍ය තිරයක්, සහ තිරයෙන් පිටත (offscreen) විදැහුම්කරණය. එයට display එකක් අවශ්‍ය නොවන බැවින්, unit test suite එක ධාවනය වන්නේ එය මතය, තවද CI pixel-diffing සඳහා ControlGallery නිදසුන සෘජුවම PNG එකකට විදැහුම් කළ හැකිය:

dotnet run --project samples/ControlGallery -- --render-headless out.png 1100 750 --select-row 0

Majorsilence.Forms.Uno Uno Platform හි Skia renderer එක ඉලක්ක කරයි; SKXamlCanvas එකක් ධාරණය කරමින් desktop, iOS, Android සහ WebAssembly වෙත ළඟා වේ. එය macOS මත අන්තයේ සිට අන්තය දක්වා (end-to-end) තහවුරු කර ඇත: Uno ධාරකය දියත් වේ, backend එක කවුළුව නිර්මාණය කරයි, සහ ControlGallery හි සම්පූර්ණ MainForm canvas එකට විදැහුම් වේ. එයට අන්තර්ක්‍රියාකාරී session එකක් අවශ්‍ය නිසා, එය headless CI build එක හරහා නොව, කැපවූ head ව්‍යාපෘතියක් — samples/Gallery.Uno — හරහා ධාවනය වේ.

සඳහන් කළ යුතු එක් විස්තරයක්: Uno හි ක්‍රමලේඛනමය “කවුළු ඇදීමක් ආරම්භ කිරීමේ” (begin a window drag) API එකක් නැත, එබැවින් Majorsilence.Forms හි තමන් විසින්ම අඳින කවුළු chrome එක සඳහා move/resize ඒ වෙනුවට ප්‍රකාශනාත්මකව (declaratively) හසුරුවනු ලැබේ — borderless presenter එකක් OS resize margins නොමිලේ රඳවා ගන්නා අතර, Windows desktop head එක මත title-bar ඇදීම WinUI හි caption-region API එක භාවිත කරයි. macOS මත, ඒ වෙනුවට native decorations ඇදීම/ප්‍රමාණය වෙනස් කිරීම හසුරුවයි.

ඔබේම එකක් එක් කිරීම

නව backend එකක් යනු තවත් assembly එකක් පමණි: මූලික Majorsilence.Forms සහ ඔබේ toolkit එක reference කරන්න, IPlatformBackend සහ IWindowBackend ක්‍රියාත්මක කරන්න, සහ Avalonia/Headless/Uno ත්‍රිත්වය අනුකරණය කරන්න — platform backend එක තුළ dispatcher එක ධාවනය කරන්න, සහ window backend එක තුළ Skia surface එකක් ඉදිරිපත් කර ආදානය පරිවර්තනය කරන්න. සම්පූර්ණ interface ලැයිස්තුව සඳහා Platform backends බලන්න.

majorsilence-migrate සමඟ WinForms යෙදුමක් සංක්‍රමණය කිරීම

2026-07-21T08:00:00+00:00

majorsilence-migrate යනු WinForms solution එකක් Majorsilence.Forms වෙත ගෙන යාම ස්වයංක්‍රීය කරන CLI මෙවලමයි. එහි කේන්ද්‍රීය සැලසුම් තීරණය පහසුවෙන් මගහැරිය හැකි නිසා එය පැහැදිලිව සඳහන් කිරීම වටී: එය syntax tree එකක් parse කිරීම හෝ symbols විසඳීම නොකරයි. එය අමු මූලාශ්‍ර පාඨය (raw source text) මත ක්‍රියා කරන බහු-අදියර (multi-pass) පාඨමය/regex නැවත ලියනයකි (rewriter) — තවද එය හිතාමතාම එසේ කර ඇත.

Roslyn නොව, පාඨමය වන්නේ ඇයි

මෙවලමේම මූලාශ්‍ර comment එකෙන්: “මෙය හිතාමතාම පාඨමය පරිවර්තනයකි — එය syntax tree එක parse නොකරයි — එමඟින් එය වේගවත්ව තබාගන්නා අතර දැනට compile නොවන ගොනු ද ඉවසයි.”

එම වෙළඳාම (trade-off) මඟින් symbol-දැනුවත් මෙවලමකට ලබා දිය නොහැකි දේවල් දෙකක් ලැබේ:

එය බිඳුණු කේතය මත ක්‍රියා කරයි. අර්ධ වශයෙන් සංක්‍රමණය කළ solution එකක්, කිසිවෙකු තවමත් port නොකළ type එකක් reference කරන ගොනුවක්, reference එකක් අස්ථානගත වූ project එකක් — මේ කිසිවක් නැවත ලියනය නතර නොකරයි, මන්ද කේතය compile වීම හෝ සම්පූර්ණයෙන් parse වීම පවා එයට කිසිදා අවශ්‍ය නොවේ. සැබෑ symbol විසඳීමක් සහිත Roslyn-පාදක මෙවලමක් project එක build වන තුරු එය ස්පර්ශ කිරීම ප්‍රතික්ෂේප කරනු ඇත; එය පැරණි codebase එකක් මත පළමු වටයක අරමුණම පරාජය කරයි.
එය වේගවත්ය. Compilation නැත, MSBuildWorkspace නැත, project graph පූරණය කිරීමක් නැත — එය දහස් ගණනක ගොනු තත්පර කිහිපයකින් සකසයි.

මිල: සැබෑ cross-project symbol විසඳීමක් නැත. හිස් Panel reference එකක් යනු System.Windows.Forms.Panel ද නැතහොත් එම නමින්ම ඇති ඔබේම class එකක් ද යන්න නැවත ලියනයට සෑම විටම කිව නොහැක — ඒ වෙනුවට එය namespace-prefix සහ using/Imports සන්දර්භය මත රඳා පවතී. ප්‍රායෝගිකව මෙය කලාතුරකින් අපැහැදිලි වේ (WinForms සහ Telerik type නම් සුවිශේෂී ය), තවද එය හඳුනා නොගන්නා ඕනෑම දෙයක් නිහඬව අනුමාන කරනවා වෙනුවට අතින් සමාලෝචනය සඳහා සලකුණු කරනු ලැබේ.

විකල්ප Roslyn engine එක

සැබවින්ම අපැහැදිලි අවස්ථාව සඳහා — එකම ගොනුවේ WinForms/GDI+ type එකක් සමඟ හිස් නමක් බෙදා ගන්නා අභිරුචි type එකක් — ඔබ විසින් තෝරා ගත යුතු (opt-in) දෙවන engine එකක් ඇත: --engine roslyn. එය regexes වෙනුවට MSBuildWorkspace සහ සැබෑ symbol විසඳීම භාවිත කරයි; එය පාඨමය engine එක ප්‍රතිස්ථාපනය කරනවා වෙනුවට එය මතට ස්තරයක් ලෙස එක් වේ; Roslyn ප්‍රකාරයේදී පවා අදියර කිහිපයක් පාඨමයව පවතී, මන්ද ඒවා කිසිදා symbol-විසඳීමේ ගැටලු නොවූ බැවිනි.

වෙළඳාම් පෙරනිමි engine එකට ප්‍රතිවිරුද්ධ දිශාවට ක්‍රියා කරයි: MSBuild හරහා සැබවින්ම පූරණය වන solution එකක් හෝ project එකක් එයට අවශ්‍ය වේ (හිස් directory එකක් හෝ තනි ගොනුවක් අනතුරු ඇඟවීමක් සමඟ text engine එකට ආපසු යයි), MSBuild ඇගයීම ධාවනයේ වැඩි කාලයක් ගන්නා බැවින් එය විශාලත්ව ගණනාවකින් (orders of magnitude) මන්දගාමී වේ, තවද එක් project එකක් පූරණය වීමට අසමත් වුවහොත්, එම project එකේ ගොනු පමණක් text engine එකට ආපසු යයි — ධාවනය නවතා නොදමයි. MSBuild සොයාගැනීමටම නොහැකි නම්, නිහඬව පහත් මට්ටමකට මාරු වනවා වෙනුවට සම්පූර්ණ ධාවනය දැඩි ලෙස අසාර්ථක වේ.

එය භාවිත කළ යුත්තේ කවදාද: පෙරනිමි --engine text සමඟ පළමු වටයකින් පසුව, දැනටමත් පිරිසිදුව පූරණය වන project එකක, diff එකේ නිශ්චිත, තහවුරු කළ නාම-ගැටුම් (name-collision) අවස්ථාවක් ඔබ දකින්නේ නම්. විශාල, සමහරවිට අර්ධ වශයෙන් බිඳුණු පැරණි codebase එකක් මත මූලික වටය සඳහා, පෙරනිමි පාඨමය engine එක තවමත් නිවැරදි මෙවලමයි.

ඊළඟට කුමක්ද

සම්පූර්ණ අදියරෙන්-අදියර විස්තරය සඳහා repository එකේ MIGRATION.md ද, ඔබේ සංක්‍රමණය කළ කේතය compile වූ පසු සැබවින්ම ක්‍රියාත්මක කර ඇත්තේ මොනවාද යන්න සඳහා COMPATIBILITY_MATRIX.md ද බලන්න.