Bibliothèque WinForms multiplateforme open source pour .NET — une couche de compatibilité Windows Forms qui exécute vos applications sous Windows, macOS, Linux et dans le navigateur, sans réécriture. https://forms.majorsilence.com/fr/feed.xml 2026-10-08T14:30:00+00:00 Majorsilence MIT https://forms.majorsilence.com/fr/blog/2026/10/08/whats-new-since-august-26-9-0/ 2026-10-08T14:30:00+00:00 2026-10-08T14:30:00+00:00

Majorsilence.Forms 26.9.0 : backends GTK 4, Terminal, WinForms et WPF, net48 et netstandard2.0, thèmes CSS, MVVM, l'audit de comportement et les notes de mise à niveau.

<p>Le dernier billet publié ici a été écrit à partir de la version 26.0.30. Depuis le 2026-08-17, ledépôt a reçu 557 commits et la version actuelle est <strong>26.9.0</strong>. Voici un tour d’horizon pour lesutilisateurs existants et ceux qui évaluent le projet : ce qui a changé, le degré de maturité dechaque élément, et la seule chose que vous devez faire lors de la mise à niveau.</p><h2 id="four-new-backends">Quatre nouveaux backends</h2><p>Il y avait trois hôtes — Avalonia, Uno, Headless. Il y en a maintenant sept, qui exécutent tous lemême jeu de contrôles ; la différence tient à qui crée la fenêtre et présente la surface Skia.</p><p><strong>GTK 4</strong> (<code>Majorsilence.Forms.Gtk4</code>) est un hôte pensé d’abord pour Linux, construit sur gir.core :une vraie <code>Gtk.Window</code> par formulaire, la boucle principale GLib, utilisable aussi sous Windows etmacOS avec le runtime GTK 4. Sélectionnez-le explicitement avec <code>Gtk4Application.Use ();</code> avant<code>Application.Run</code>. L’intégration fonctionne dans les deux sens (<code>ToGtkWidget()</code>, <code>ToGtkWindow()</code>),<code>NativeControlHost</code> n’a pas de problème d’« airspace » parce que GTK 4 compose un seul arbre de rendu,et <code>WebBrowser</code> s’appuie sur WebKitGTK 6.0. Vérifié sous Wayland. Lacunes connues : pas de contrôlede la position à l’écran (GTK 4 a supprimé l’API), <code>SetIcon(byte[])</code> est un no-op, les sélecteurs defichiers natifs renvoient un résultat vide et des boîtes de dialogue de repli sont donc utilisées,facteur d’échelle entier uniquement, non analysé pour l’AOT.</p><p><strong>Terminal</strong> (<code>Majorsilence.Forms.Terminal</code>, 2026-10-04) héberge un formulaire dans une console envue unique — le formulaire remplit le terminal, sans barre de titre, comme sur un téléphone. Ilutilise le protocole graphique Kitty ou Sixel à la résolution réelle en pixels lorsque c’estdisponible, sinon des caractères de bloc Unicode ; la détection se fait en interrogeant le terminal,et <code>MF_TERMINAL_GRAPHICS=halfblock|kitty|sixel</code> fige un mode. La souris et le clavier fonctionnent ;Ctrl+C quitte toujours. Sélectionné avec <code>TerminalApplication.Use (options);</code>. Vérifié uniquementdans xterm et WezTerm. Pas de sélecteurs natifs, ni de <code>NativeControlHost</code>, ni de webview.</p><p><strong>WinForms</strong> (<code>Majorsilence.Forms.WinForms</code>) est un backend de <em>migration</em> réservé à Windows : devraies fenêtres <code>System.Windows.Forms</code> sur la pompe de messages Win32, Skia présenté via un bitmapGDI. Il existe pour que vous puissiez intégrer des contrôles Majorsilence.Forms dans une applicationWinForms existante, un contrôle à la fois — <code>myMfControl.ToWinFormsControl()</code>,<code>myForm.ToWinFormsForm()</code>, <code>MajorsilenceFormsPresenter</code> — puis basculer l’hôte vers Avalonia ou Unoune fois que tout est porté. Pas de gestes, pas d’<code>IWebViewFactory</code>. Il est distinct de l’ancien<code>WindowsFormsInterop</code>, qui fait le pont pour des formulaires entiers sur l’hôte Avalonia.</p><p><strong>WPF</strong> (<code>Majorsilence.Forms.Wpf</code>) a la même forme et le même objectif pour les applications WPF : unevraie <code>Window</code> WPF, une présentation par <code>WriteableBitmap</code>, <code>ToWpfElement()</code> et <code>ToWpfWindow()</code>.Sélectionnez-le avec <code>Platform.Backend = new Majorsilence.Forms.Wpf.WpfPlatformBackend ();</code>.</p><p>Avalonia, WinForms et GTK 4 offrent de véritables boîtes de dialogue modales au niveau du système ;Uno ouvre une fenêtre indépendante, utilisez donc <code>Form.ShowDialog(parent)</code> sur cet hôte.</p><h2 id="net-framework-48-and-netstandard20">.NET Framework 4.8 et netstandard2.0</h2><p>Les paquets cœur — <code>Majorsilence.Forms</code>, <code>.Drawing.Common</code>, <code>.Telerik</code> — ciblent désormais à la fois<code>net8.0</code>, <code>net10.0</code> <strong>et <code>netstandard2.0</code></strong>, et les backends WinForms et WPF ajoutent <code>net48</code>. Uneapplication .NET Framework 4.8 peut donc héberger des contrôles Majorsilence.Forms sans passer d’abordà .NET moderne, ce qui supprime un problème d’ordonnancement que beaucoup de migrationsrencontraient.</p><h2 id="the-behaviour-gap-audit">L’audit des écarts de comportement</h2><p>Les deux plans de couverture de la surface d’API (WinForms et GDI+) sont à <strong>zéro</strong> : chaque membreprésent en amont est déclaré. C’était de toute façon la moitié la moins intéressante. Un membre quiexiste mais stocke une valeur que personne ne lit, ou déclenche un événement que personne ne lève,compile votre application migrée puis ne fait discrètement rien.</p><p>Le 2026-08-25, un audit en douze domaines a donc comparé chaque domaine à l’implémentation en amont etconsigné <strong>483 constats</strong> où le comportement différait. Depuis, les phases 0 à 4 et la plupart desfamilles de contrôles ont atterri. Éléments concrets désormais réels : la chaîne de prétraitement<code>ProcessCmdKey</code>, un point de passage unique pour le focus et la validation, la barre de titre hors dela zone cliente, <code>AutoScaleMode.Font</code> qui met réellement à l’échelle, la liaison de données vivante(<code>CurrencyManager</code>, <code>BindingNavigator</code>), <code>ListView.View = Details</code>, le cycle de vie du formulairedans l’ordre en amont (Load → VisibleChanged → Activated, Shown posté), le réordonnancement descolonnes de DataGridView, Ctrl+Z dans les contrôles de texte, <code>NotifyIcon</code> dans la zone denotification, <code>Application.AddMessageFilter</code>, et la libération d’un formulaire qui libère sescontrôles.</p><p>La surface creuse est en outre <em>mesurée</em> maintenant : des fichiers de référence figent les méthodesno-op connues, les événements inertes et les propriétés simplement stockées, de sorte qu’en ajouterrelève d’un acte conscient et non d’un accident. La politique des stubs est inchangée — no-op ouvaleur par défaut, jamais de <code>NotImplementedException</code>.</p><h2 id="logical-units-the-one-thing-you-must-do">Unités logiques : la seule chose que vous devez faire</h2><p>Le 2026-10-01, <code>ClientRectangle</code>, <code>ClientSize</code> et le canvas de peinture (<code>OnPaint</code>, <code>Paint</code>,<code>e.ClipRectangle</code>, <code>e.Canvas</code>) sont passés en <strong>unités logiques</strong>, à l’image de<code>Width</code>/<code>Height</code>/<code>Bounds</code> et de <code>MouseEventArgs</code>. Le framework met le canvas à l’échelle de l’affichagepour vous.</p><p><strong>Si un contrôle personnalisé appelait <code>e.Graphics.ScaleTransform (e.Scaling, e.Scaling)</code>,supprimez cet appel</strong> — le dessin est maintenant mis à l’échelle deux fois. Les pixels physiquesrestent accessibles via la famille <code>Scaled*</code> (<code>ScaledWidth</code>, <code>ScaledBounds</code>, …),<code>PaintEventArgs.Scaling</code> et <code>LogicalToDeviceUnits</code>. La seule exception concerne les événementsowner-draw (<code>DrawItem</code>, <code>DrawNode</code>, <code>CellPainting</code>), qui vous transmettent toujours des bornes enpixels physiques. Exécutez vos tests avec <code>MF_HEADLESS_SCALE=2</code> pour attraper tout ce qui dépend del’ancien comportement.</p><h2 id="browser-and-mobile">Navigateur et mobile</h2><p>Sur <code>net10.0-browser</code>, <code>-android</code> et <code>-ios</code>, le backend Avalonia signale <code>CanRunModalLoop = false</code>,et les appels bloquants — <code>Form.ShowDialog</code>, <code>MessageBox.Show</code>, les sélecteurs de fichiers,<code>TaskDialog.ShowDialog</code>, <code>VbInteraction.MsgBox</code>/<code>InputBox</code>, <code>RadMessageBox.Show</code> — lèvent désormaisune <code>PlatformNotSupportedException</code> nommant leur jumeau asynchrone <em>avant</em> que quoi que ce soit nesoit affiché, au lieu de se figer. Les formes asynchrones (<code>ShowDialogAsync</code>, <code>MessageBox.ShowAsync</code>,<code>FileDialog.ShowDialogAsync</code>, …) fonctionnent sur tous les hôtes ; l’idiome est donc un gestionnaire<code>async void</code> avec <code>await</code>. Un analyseur Roslyn dans le paquet cœur les repère à l’avance — <code>MFB001</code>appel modal bloquant, <code>MFB002</code> attente synchrone sur une Task, <code>MFB003</code> <code>Thread.Sleep</code>, chacun avec uncorrectif de code — actif pour les TFM navigateur ou avec <code>majorsilence_forms.browser_target = true</code>dans <code>.editorconfig</code>.</p><p>La cible navigateur maintient aussi un <strong>DOM d’accessibilité</strong> à côté du canvas : un élémenttransparent et traversé par les clics par contrôle, avec rôle ARIA, nom, état et bornes, construit àpartir de l’arbre d’automatisation propre au framework. Les lecteurs d’écran, la recherche dans lapage et les outils de test fondés sur le DOM peuvent désormais voir l’interface.</p><p>Sur Android et iOS, le clavier à l’écran apparaît quand une <code>TextBox</code> prend le focus,<code>TextBoxBase.InputKind</code> choisit le type de clavier, les marges de zone sûre s’appliquent via<code>Form.SafeAreaPadding</code>, et <code>WindowBase.BackRequested</code> gère le bouton Retour d’Android. État honnête :Android a eu une première passe sur appareil réel (démarrage, touchers, mise à l’échelle du rendu,défilement tactile confirmés sur matériel) ; le clavier, la zone sûre et la rotation ne sont couvertsque par des tests unitaires. La CI iOS compile la vraie tête et la lance dans un test de fumée sursimulateur, mais personne ne l’a exécutée de manière interactive et le job est toujours en<code>continue-on-error</code>.</p><p>Des contrôles de disposition de type téléphone sont arrivés en même temps : <code>StackPanel</code>, <code>Card</code>,<code>RichListBox</code> (lignes multilignes à modèle) et <code>NavigationHost</code> (une pile de pages avec un boutonRetour).</p><h2 id="css-theming-and-theme-studio">Thèmes CSS et Theme Studio</h2><p>Les thèmes peuvent désormais s’écrire dans un sous-ensemble strict et documenté de CSS :<code>@theme "Ocean" extends Dark;</code>, des jetons <code>:root</code> à raison d’un par propriété de <code>Theme</code>, des règlespar type de contrôle comme <code>Button:hover { … }</code>, des parties via <code>Type::part</code>. L’analyseur n’échouejamais en silence — <code>ThemeStyleSheet.Parse</code> collecte des diagnostics. Chargez avec<code>Theme.LoadFromCssFile</code>, ou <code>Theme.RegisterThemeCssFromFile</code> + <code>Theme.ApplyTheme ("Ocean")</code> ; exportezavec <code>Theme.ExportCss</code>. Chaque contrôle, y compris la couche de compatibilité Telerik, a un sélecteur,et l’ancien XML <code>&lt;Theme&gt;</code> fonctionne toujours.</p><p>Deux paquets compagnons appliquent la <em>même</em> feuille à d’autres hôtes : <code>Majorsilence.Forms.Theming.WinForms</code>restyle de vrais contrôles <code>System.Windows.Forms</code> (Windows uniquement) et <code>Majorsilence.Forms.Theming.Avalonia</code>restyle les contrôles Fluent natifs d’Avalonia, si bien qu’un seul fichier CSS peut thémer uneapplication de migration mixte. <code>samples/ThemeStudio</code> est un éditeur en direct avec aperçu etdiagnostics ; des binaires précompilés sont attachés aux GitHub Releases.</p><h2 id="mvvm-essentials-animation">MVVM, Essentials, animation</h2><p><code>Majorsilence.Forms.Mvvm</code> est un câblage compatible trimming et AOT au-dessus d’<code>INotifyPropertyChanged</code>et d’<code>ICommand</code>, sans réflexion ni dépendance à un toolkit : <code>viewModel.Observe (nameof (VM.Count), vm =&gt; vm.Count, …)</code>,des liaisons bidirectionnelles <code>BindText</code>/<code>BindChecked</code>/<code>BindSelectedIndex</code>/<code>BindValue</code>, <code>BindCommand</code>,et un <code>BindingScope</code> pour tout libérer. Il fonctionne aux côtés de CommunityToolkit.Mvvm.</p><p><code>Majorsilence.Forms.Essentials</code> garde les capacités propres à chaque plateforme hors du cœur :<code>SecureStorage</code>, la synthèse vocale <code>Speech</code>, <code>Launcher.OpenAsync</code> (http/https/mailto/tel/sms) et<code>FileSystem.OpenAppPackageFileAsync</code>. Tout se dégrade en no-op ; vérifiez <code>IsSupported</code>.</p><p><code>control.RequestAnimationFrame</code> plus <code>Majorsilence.Forms.Animation</code> (<code>Tween&lt;T&gt;</code>, <code>Easing</code>, <code>Animator</code>)offrent une animation alignée sur l’affichage sous Avalonia et une horloge manuelle sous Headless.</p><h2 id="tooling">Outillage</h2><ul> <li>Le serveur MCP est un outil dotnet publié : <code>dotnet tool install -g Majorsilence.Forms.Mcp</code>, puis<code>claude mcp add majorsilence-ui -- majorsilence-mcp --port 4444</code>. Il expose <code>ui_snapshot</code>, <code>ui_find</code>,<code>ui_click</code>, <code>ui_type</code>, <code>ui_wait_for</code> et <code>ui_screenshot</code>, en dialoguant avec le <code>WebDriverServer</code> devotre application.</li> <li><code>samples/AutomationTarget</code> est une petite application volontairement récalcitrante (des contrôlesqui refusent les clics, un contrôle sans nom) pour apprendre l’outillage. Les contrôles à peinturepersonnalisée publient leur valeur et leur état via <code>IAutomationStateProvider</code>.</li> <li>Le migrateur est désormais livré <strong>uniquement</strong> sous forme d’outil dotnet(<code>dotnet tool install -g Majorsilence.Forms.Migrator</code>) ; les binaires autonomes ne sont plus attachésaux releases. Nouvelles options : <code>--map</code>, <code>--dual-build</code>, <code>--strict</code>, <code>--dry-run --diff</code>.</li> <li><code>Majorsilence.Forms.WinFormsShims.Compat</code> est un générateur de source à l’état de preuve de conceptqui émet les espaces de noms <code>System.Windows.Forms</code> et <code>System.Drawing</code> adossés à Majorsilence.Forms,de sorte qu’un code source WinForms non modifié — y compris <code>Designer.cs</code> — compile. Destiné auxbibliothèques de contrôles dont l’API publique est typée sur WinForms. Statut PoC ; voir<code>samples/WinFormsCompatDemo</code>.</li></ul><h2 id="upgrade-notes">Notes de mise à niveau</h2><ul> <li>Figez la version <strong>26.9.0</strong>. Le projet est toujours en bêta et n’a toujours pas de concepteur visuel.</li> <li>Supprimez tout <code>ScaleTransform (e.Scaling, e.Scaling)</code> dans votre code de peinture personnalisé(voir ci-dessus).</li> <li>L’identifiant du paquet de modèles est <code>Majorsilence.Forms.Templates</code>, installé avec<code>dotnet new install Majorsilence.Forms.Templates</code>. <code>dotnet new majorsilenceforms</code> génère désormaisune solution avec une bibliothèque d’interface partagée et une tête bureau ; <code>--IncludeAndroid</code>,<code>--IncludeiOS</code> et <code>--IncludeWasm</code> ajoutent des têtes.</li> <li>Les changements cassants sont listés dans <code>MIGRATION.md</code> : <code>SplitContainer.Orientation</code>,<code>TreeViewDrawMode.OwnerDrawContent</code>, les types de délégués d’événements correspondent désormais àWinForms, et les pinceaux dégradés et hachurés ont été déplacés pour correspondre à GDI+.</li> <li>Sur navigateur, Android et iOS, remplacez les appels de boîtes de dialogue bloquants par leursjumeaux asynchrones ; laissez <code>MFB001</code>–<code>MFB003</code> les trouver.</li></ul><h2 id="where-to-read-more">Pour aller plus loin</h2><ul> <li><a href="/fr/backends/">Backends de plateforme</a> et<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/backends.md"><code>docs/backends.md</code></a></li> <li><a href="/fr/getting-started/">Premiers pas</a> et<a href="/fr/migration/">Migration</a> /<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/MIGRATION.md"><code>MIGRATION.md</code></a></li> <li><a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/theming.md"><code>docs/theming.md</code></a>,<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/mvvm.md"><code>docs/mvvm.md</code></a>,<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/mobile-layout.md"><code>docs/mobile-layout.md</code></a>,<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/animation.md"><code>docs/animation.md</code></a></li> <li><a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/behaviour-gap-plan.md"><code>docs/behaviour-gap-plan.md</code></a></li> <li><a href="/fr/automation/">Automatisation</a> et<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/docs/automation.md"><code>docs/automation.md</code></a></li> <li><a href="/fr/samples/">Exemples</a></li></ul> Majorsilence https://forms.majorsilence.com/fr/blog/2026/07/21/introducing-majorsilence-forms/ 2026-07-21T15:00:00+00:00 2026-07-21T15:00:00+00:00

Présentation de Majorsilence.Forms, une bibliothèque WinForms multiplateforme open source pour .NET : conservez vos formulaires, vos contrôles et vos fichiers Designer, et exécutez la même application sous Windows, macOS et Linux sans réécriture.

<p>Sortir une application WinForms du bureau Windows a toujours signifié, jusqu’ici, une réécriturecomplète : XAML, une restructuration MVVM imposée, ou le web. C’est coûteux, risqué, et cela jette desannées de logique métier et d’expérience utilisateur qui fonctionnent, pour un code qui n’a souventbesoin que d’un coup de peinture neuve.</p><p><strong>Majorsilence.Forms</strong> adopte une autre approche : il reproduit la surface d’API de WinForms — les<code>Form</code>, les contrôles, les gestionnaires d’événements, et même le code-behind <code>*.Designer.cs</code> — etfournit une couche de compatibilité pour que les formulaires et contrôles existants migrent avec bienmoins de remous. Le modèle de programmation ne change pas ; c’est l’endroit où il s’exécute qui change.</p><h2 id="how-its-built">Comment c’est construit</h2><p>Chaque contrôle est dessiné avec <a href="https://github.com/mono/SkiaSharp">SkiaSharp</a> dans une <code>SKSurface</code>,au-dessus d’un backend hôte interchangeable :</p><ul> <li><strong>Avalonia</strong> (par défaut) — Windows, macOS et Linux pour le bureau, prêts à l’emploi, avec ses proprescibles Android, iOS et Browser (WebAssembly) comme voie vers le mobile et le web également.</li> <li><strong>Uno Platform</strong> — la portée la plus large : bureau, iOS, Android et WebAssembly.</li> <li><strong>Headless</strong> — rendu hors écran sans dépendance, pour la CI et les tests automatisés.</li></ul><p>L’assembly cœur <code>Majorsilence.Forms</code> ne référence aucun toolkit de fenêtrage — uniquement SkiaSharp.Les backends sont des assemblies séparés qui se branchent sur deux petites interfaces,<code>IPlatformBackend</code> et <code>IWindowBackend</code>. C’est cette couture qui permet à la même application, àl’identique, de cibler Avalonia aujourd’hui et Uno demain sans toucher au code applicatif. Pour ensavoir plus, voir <a href="/fr/backends/">Backends de plateforme</a>.</p><h2 id="who-its-for">À qui cela s’adresse</h2><p>Si vous disposez d’une base de code WinForms aujourd’hui limitée à Windows et que vous voulez garderl’élan — réutiliser vos contrôles, les réflexes de votre équipe, votre logique métier — plutôt que devous lancer dans une réécriture de plusieurs années, c’est pour vous que ceci a été conçu.</p><p>Le projet en est à ses débuts : l’API se stabilise et tous les recoins de WinForms ne sont pas encorecouverts. Il convient déjà très bien aux nouvelles applications métier multiplateformes, et à lamigration de vraies applications en production si vous figez la version. Consultez la<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/COMPATIBILITY_MATRIX.md">matrice de compatibilité</a> pour savoirexactement ce qui est implémenté et ce qui n’est encore qu’un stub aujourd’hui.</p><h2 id="try-it">Essayez-le</h2><pre><code>dotnet new --install MajorsilenceForms.Templatesdotnet new majorsilenceformsdotnet run</code></pre><p>Ou plongez dans une vraie application — <a href="https://github.com/majorsilence/Majorsilence.Forms/tree/main/samples/Explorer"><code>samples/Explorer</code></a>est un clone complet de l’Explorateur Windows, et <a href="https://github.com/majorsilence/Majorsilence.Forms/tree/main/samples/Outlaw"><code>samples/Outlaw</code></a>un clone d’Outlook ; tous deux tournent sans modification sur le même jeu de contrôles, sur toutes lesplateformes.</p><p>Voir <a href="/fr/getting-started/">Premiers pas</a> pour générer votre première application.</p> Majorsilence https://forms.majorsilence.com/fr/blog/2026/07/21/platform-backends-avalonia-uno-headless/ 2026-07-21T11:00:00+00:00 2026-07-21T11:00:00+00:00

Comment WinForms multiplateforme s'exécute sur Avalonia, Uno Platform et une surface Skia headless : chaque contrôle est dessiné avec SkiaSharp et le toolkit de fenêtrage en dessous n'est qu'un hôte interchangeable.

<p>Majorsilence.Forms effectue <strong>tout son dessin lui-même</strong> avec SkiaSharp. Chaque contrôle peint dansune <code>SKSurface</code>/<code>SKCanvas</code> ; le toolkit de fenêtrage en dessous n’est qu’un <em>hôte</em> — il crée lesfenêtres natives, fait tourner la boucle de messages, achemine les entrées et présente la surfaceSkia à l’écran. C’est cette séparation qui permet au même jeu de contrôles, à l’identique, de tourneraujourd’hui sur trois toolkits très différents.</p><h2 id="the-seam">La couture</h2><p>Deux interfaces définissent tout ce qu’un hôte doit fournir :</p><p><code>IPlatformBackend</code> couvre les services au niveau de l’application — le dispatcher (<code>Post</code>/<code>Invoke</code>),les timers, le presse-papiers, l’énumération des écrans et la boucle modale. <code>IWindowBackend</code> couvreune seule fenêtre native — taille et position, afficher/masquer/fermer, curseur, décorations, boîtesde dialogue de fichiers. Les entrées et les demandes de peinture circulent dans <em>l’autre</em> sens : lebackend appelle directement les méthodes neutres <code>RenderFrame(SKCanvas, …)</code> et <code>Handle*</code> de lafenêtre. Aucun type de plateforme — aucun type Avalonia, aucun type WinUI — ne franchit jamais lafrontière vers le code cœur de Majorsilence.Forms.</p><h2 id="three-backends-today">Trois backends aujourd’hui</h2><p><strong><code>Majorsilence.Forms.Avalonia</code></strong> est le backend par défaut — Avalonia 12, qui donne Windows, macOS etLinux pour le bureau sans aucune configuration. Référencez-le, et <code>Application.Run(new MyForm())</code>fonctionne tout simplement. Il ne se limite pas au bureau, d’ailleurs : Avalonia fournit ses proprescibles Android, iOS et Browser (WASM), si bien que ce même backend constitue une seconde voie vers lemobile et le web, à côté du backend Uno dédié présenté ci-dessous.</p><p><strong><code>Majorsilence.Forms.Headless</code></strong> est le backend le plus simple possible et sert aussi de modèle deréférence pour en écrire un nouveau : une boucle de messages à file de travail, un presse-papiers enmémoire, un écran virtuel et un rendu hors écran. Il n’a besoin d’aucun affichage ; c’est donc sur luique tourne la suite de tests unitaires, et il peut rendre l’exemple ControlGallery directement en PNGpour la comparaison pixel par pixel en CI :</p><pre><code>dotnet run --project samples/ControlGallery -- --render-headless out.png 1100 750 --select-row 0</code></pre><p><strong><code>Majorsilence.Forms.Uno</code></strong> cible le moteur de rendu Skia d’Uno Platform, héberge un <code>SKXamlCanvas</code>et atteint le bureau, iOS, Android et WebAssembly. Il a été vérifié de bout en bout sous macOS : l’hôteUno se lance, le backend crée la fenêtre et le <code>MainForm</code> complet de la ControlGallery se rend dans lecanvas. Comme il a besoin d’une session interactive, il s’exécute via une tête d’application dédiée —<a href="https://github.com/majorsilence/Majorsilence.Forms/tree/main/samples/Gallery.Uno"><code>samples/Gallery.Uno</code></a> — plutôt que par labuild CI headless.</p><p>Un détail mérite d’être souligné : Uno n’a pas d’API programmatique « commencer un déplacement defenêtre », si bien que le déplacement et le redimensionnement du chrome de fenêtre auto-dessiné deMajorsilence.Forms sont gérés de manière déclarative — un presenter sans bordure conserve gratuitementles marges de redimensionnement du système, et le glisser de la barre de titre s’appuie sur l’API dezone de légende (caption region) de WinUI sur la tête bureau Windows. Sous macOS, ce sont lesdécorations natives qui prennent en charge le déplacement et le redimensionnement.</p><h2 id="adding-your-own">Ajouter le vôtre</h2><p>Un nouveau backend n’est qu’un assembly de plus : référencez le cœur <code>Majorsilence.Forms</code> et votretoolkit, implémentez <code>IPlatformBackend</code> et <code>IWindowBackend</code>, et calquez-vous sur le trioAvalonia/Headless/Uno — pilotez le dispatcher dans le backend de plateforme, et présentez une surfaceSkia et traduisez les entrées dans le backend de fenêtre. Voir<a href="/fr/backends/">Backends de plateforme</a> pour la liste complète des interfaces.</p> Majorsilence https://forms.majorsilence.com/fr/blog/2026/07/21/migrating-with-majorsilence-migrate/ 2026-07-21T08:00:00+00:00 2026-07-21T08:00:00+00:00

Comment majorsilence-migrate automatise la migration d'une solution WinForms vers .NET multiplateforme — un réécriveur délibérément textuel qui traite des milliers de fichiers en quelques secondes, même ceux qui ne compilent pas actuellement.

<p><code>majorsilence-migrate</code> est l’outil en ligne de commande qui automatise le passage d’une solutionWinForms vers Majorsilence.Forms. Sa décision de conception centrale passe facilement inaperçue etmérite d’être dite explicitement : il ne construit <strong>pas</strong> d’arbre syntaxique et ne résout pas lessymboles. C’est un <strong>réécriveur textuel à base d’expressions régulières</strong>, en plusieurs passes, sur letexte source brut — et c’est voulu.</p><h2 id="why-textual-not-roslyn">Pourquoi textuel, et non Roslyn</h2><p>Extrait du commentaire présent dans le code source de l’outil : <em>« Il s’agit d’une transformationdélibérément textuelle — elle n’analyse pas l’arbre syntaxique — ce qui la garde rapide et toléranteaux fichiers qui ne compilent pas actuellement. »</em></p><p>Ce compromis apporte deux choses qu’un outil conscient des symboles ne peut pas offrir :</p><ul> <li><strong>Il fonctionne sur du code cassé.</strong> Une solution à moitié migrée, un fichier qui référence un typeque personne n’a encore porté, un projet avec une référence manquante — rien de tout cela n’arrêtele réécriveur, parce qu’il n’a jamais besoin que le code compile, ni même qu’il soit entièrementanalysable. Un outil fondé sur Roslyn, avec une vraie résolution de symboles, refuserait de toucherà un projet tant qu’il ne se construit pas, ce qui va à l’encontre d’une <em>première passe</em> sur unebase de code héritée.</li> <li><strong>Il est rapide.</strong> Pas de compilation, pas de <code>MSBuildWorkspace</code>, pas de chargement du graphe deprojets — il traite des milliers de fichiers en quelques secondes.</li></ul><p>Le prix à payer : pas de véritable résolution de symboles entre projets. Le réécriveur ne peut pastoujours savoir si une référence nue à <code>Panel</code> désigne <code>System.Windows.Forms.Panel</code> ou votre propreclasse du même nom — il s’appuie à la place sur le préfixe d’espace de noms et sur le contexte des<code>using</code>/<code>Imports</code>. En pratique, c’est rarement ambigu (les noms de types WinForms et Telerik sontreconnaissables), et tout ce qu’il ne reconnaît pas est signalé pour revue manuelle plutôt que devinéen silence.</p><h2 id="the-optional-roslyn-engine">Le moteur Roslyn optionnel</h2><p>Pour le cas réellement ambigu — un type personnalisé partageant un nom nu avec un type WinForms/GDI+dans le même fichier — il existe un second moteur, à activer explicitement : <code>--engine roslyn</code>. Ilutilise <code>MSBuildWorkspace</code> et une vraie résolution de symboles au lieu d’expressions régulières,<em>par-dessus</em> le moteur textuel plutôt qu’à sa place ; plusieurs passes restent textuelles même en modeRoslyn, parce qu’elles n’ont jamais été des problèmes de résolution de symboles.</p><p>Les compromis sont à l’inverse de ceux du moteur par défaut : il lui faut une solution ou un projetqui se charge réellement via MSBuild (un simple répertoire ou un fichier isolé retombe sur le moteurtextuel avec un avertissement), il est plus lent de plusieurs ordres de grandeur parce quel’évaluation MSBuild domine l’exécution, et si un projet échoue à se charger, seuls les fichiers de ceprojet retombent sur le moteur textuel — l’exécution ne s’interrompt pas. Si MSBuild lui-même estintrouvable, l’exécution entière échoue franchement plutôt que de se dégrader en silence.</p><p><strong>Quand y recourir :</strong> après une première passe avec le moteur par défaut <code>--engine text</code>, sur unprojet qui se charge déjà proprement, si vous constatez dans le diff un cas précis et confirmé decollision de noms. Pour la passe initiale sur une grande base de code héritée, éventuellement à moitiécassée, le moteur textuel par défaut reste le bon outil.</p><h2 id="whats-next">La suite</h2><p>Voir <a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/MIGRATION.md"><code>MIGRATION.md</code></a> dans le dépôt pour le détailpasse par passe, et<a href="https://github.com/majorsilence/Majorsilence.Forms/blob/main/COMPATIBILITY_MATRIX.md"><code>COMPATIBILITY_MATRIX.md</code></a> pour ce qui estréellement implémenté une fois que votre code migré compile.</p> Majorsilence