Aller au contenu

Nouveautés d'Avalonia 12

Ce qui change quand on vient d'Avalonia 11, et ce qui arrive de nouveau.

Plateformes

  • .NET 8 minimum, .NET 10 recommandé. .NET Framework et .NET Standard ne sont plus supportés.
  • Android et iOS : .NET 10 uniquement.
  • Supprimés : Direct2D1, Tizen, Avalonia.Browser.Blazor.
  • SkiaSharp 3.0.
<TargetFramework>net10.0</TargetFramework>

Compiled bindings par défaut

{Binding} est maintenant compilé : le chemin est vérifié à la compilation, il faut donc indiquer le type de données avec x:DataType.

<Window xmlns:vm="using:MonApp.ViewModels"
        x:DataType="vm:MainViewModel">
  <TextBlock Text="{Binding Titre}" />   <!-- erreur de compilation si Titre n'existe pas -->
</Window>

Détails : Compiled bindings.

Renommages courants

Avalonia 11 Avalonia 12
TextBox.Watermark TextBox.PlaceholderText
TextBox.UseFloatingWatermark TextBox.UseFloatingPlaceholder
ToggleButton.Checked / Unchecked ToggleButton.IsCheckedChanged
Popup.PlacementMode / ContextMenu.PlacementMode Placement
GotFocusEventArgs FocusChangedEventArgs
Gestures.Pinch="…" Pinch="…"
Window.SystemDecorations Window.WindowDecorations
RenderOptions.TextRenderingMode TextOptions.TextRenderingMode
TextBlock.LetterSpacing TextElement.LetterSpacing
CubicBezierEasing SplineEasing
AttachDevTools() AttachDeveloperTools()
<!-- v11 -->
<TextBox Watermark="Rechercher…" />
<!-- v12 -->
<TextBox PlaceholderText="Rechercher…" />
// v11
toggle.Checked += OnChecked;
// v12
toggle.IsCheckedChanged += (_, _) => Debug.WriteLine(toggle.IsChecked);

Presse-papiers et glisser-déposer

// v11
await clipboard.SetTextAsync("x");
var t = await clipboard.GetTextAsync();

// v12
await clipboard.SetTextAsync("x");
var t = await clipboard.TryGetTextAsync();

IDataObject → IAsyncDataTransfer, DataFormats → DataFormat, DragDrop.DoDragDrop → DoDragDropAsync, DragEventArgs.Data → DragEventArgs.DataTransfer. Voir Presse-papiers et Glisser-déposer.

Dialogues de fichiers

OpenFileDialog, SaveFileDialog et OpenFolderDialog sont supprimés. On passe par StorageProvider :

var fichiers = await TopLevel.GetTopLevel(this)!.StorageProvider
    .OpenFilePickerAsync(new FilePickerOpenOptions { Title = "Ouvrir" });

Voir Fichiers et dossiers.

TopLevel

Ne castez plus la racine visuelle en Window : utilisez TopLevel.GetTopLevel(visual).

var topLevel = TopLevel.GetTopLevel(this);
var clipboard = topLevel?.Clipboard;

Fenêtres

  • WindowState n'est plus une styled property : impossible de la définir dans un style.
  • ExtendClientAreaChromeHints est supprimé : utilisez WindowDecorations + ExtendClientAreaToDecorationsHint.
  • Les contrôles TitleBar / CaptionButtons sont remplacés par WindowDrawnDecorations.

Nouvelles fonctionnalités

  • Navigation par pages

    NavigationPage, ContentPage, TabbedPage, DrawerPage : pile de navigation façon mobile. Navigation

  • Performances

    Jusqu'à 3× plus rapide sur Android.

  • Focus

    FocusManager public, annulation des changements de focus, nouvelle API de parcours.

  • Multi-dispatchers

    Un Dispatcher par thread (Dispatcher.CurrentDispatcher).

  • Tests headless

    Support de xUnit v3 et NUnit 4.

  • WebView

    Le contrôle WebView natif devient open source.

Validation des données

Le plugin DataAnnotations est désactivé par défaut. Les erreurs remontent via INotifyDataErrorInfo (voir Validation).

Dispatcher

Dispatcher.UIThread fonctionne toujours. Attention : DispatcherTimer utilise désormais le dispatcher du thread courant. Créez-le sur le thread UI.

Migration

Si votre projet v11 compile sans avertissement d'obsolescence, la migration est en général rapide. Liste complète : breaking changes officiels.