Structure d'un projet¶
Quatre fichiers suffisent : Program.cs, App.axaml, une fenêtre, son code-behind.
MonApp/
├── MonApp.csproj
├── Program.cs ← point d'entrée
├── App.axaml ← thème, ressources globales
├── App.axaml.cs ← création de la fenêtre principale
├── MainWindow.axaml ← interface
├── MainWindow.axaml.cs ← code-behind
└── Assets/ ← images, polices, icônes
Qui démarre quoi¶
sequenceDiagram
participant P as Program.Main
participant B as AppBuilder
participant A as App
participant W as MainWindow
P->>B: BuildAvaloniaApp() : plateforme, police, logs
B->>A: Initialize() → charge App.axaml (thème)
B->>A: OnFrameworkInitializationCompleted()
A->>W: desktop.MainWindow = new MainWindow()
W->>W: InitializeComponent() → charge MainWindow.axaml
Note over W: la fenêtre s'affiche
Program.cs¶
Program.cs
using Avalonia;
internal sealed class Program
{
[STAThread]
public static void Main(string[] args)
=> BuildAvaloniaApp().StartWithClassicDesktopLifetime(args);
// Utilisé aussi par le prévisualiseur : ne pas supprimer.
public static AppBuilder BuildAvaloniaApp()
=> AppBuilder.Configure<App>()
.UsePlatformDetect() // Win32 / macOS / X11 + Skia + HarfBuzz
.WithInterFont() // police Inter embarquée
.LogToTrace(); // logs dans la sortie Debug
}
Avant Main, rien d'Avalonia
N'utilisez aucun contrôle ni Dispatcher avant l'appel à StartWithClassicDesktopLifetime.
App.axaml¶
App.axaml
<Application xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="MonApp.App"
RequestedThemeVariant="Default">
<Application.Styles>
<FluentTheme />
</Application.Styles>
<Application.Resources>
<SolidColorBrush x:Key="MarqueBrush" Color="#6D28D9" />
</Application.Resources>
</Application>
RequestedThemeVariant : Default (suit le système), Light ou Dark.
App.axaml.cs¶
App.axaml.cs
using Avalonia;
using Avalonia.Controls.ApplicationLifetimes;
using Avalonia.Markup.Xaml;
public partial class App : Application
{
public override void Initialize() => AvaloniaXamlLoader.Load(this);
public override void OnFrameworkInitializationCompleted()
{
if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
{
desktop.MainWindow = new MainWindow();
}
else if (ApplicationLifetime is ISingleViewApplicationLifetime singleView)
{
// Navigateur, iOS, Linux embarqué : pas de fenêtre, une seule vue.
singleView.MainView = new MainView();
}
base.OnFrameworkInitializationCompleted();
}
}
Fenêtre et code-behind¶
<Window xmlns="https://github.com/avaloniaui"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="MonApp.MainWindow"
Title="Mon application"
Width="800" Height="500"
WindowStartupLocation="CenterScreen">
<TextBlock Text="Bonjour Avalonia 12"
HorizontalAlignment="Center"
VerticalAlignment="Center" />
</Window>
Mon application
Bonjour Avalonia 12
flowchart LR
X["MainWindow.axaml<br/>x:Class='MonApp.MainWindow'"] -- "compilé en" --> G["partial class MainWindow<br/>(généré : InitializeComponent, champs x:Name)"]
C["MainWindow.axaml.cs<br/>partial class MainWindow"] -- "fusionné avec" --> G
x:Class relie le XAML à la classe C#. Les deux doivent avoir le même nom complet et la classe doit être partial.
Le cycle de vie desktop¶
stateDiagram-v2
[*] --> Startup
Startup --> EnCours : MainWindow affichée
EnCours --> Shutdown : dernière fenêtre fermée<br/>ou Shutdown()
Shutdown --> Exit
Exit --> [*]
if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
{
// Quitter quand la fenêtre principale se ferme (par défaut : dernière fenêtre)
desktop.ShutdownMode = ShutdownMode.OnMainWindowClose;
desktop.Startup += (_, e) => Console.WriteLine($"Args : {string.Join(' ', e.Args)}");
desktop.Exit += (_, _) => Console.WriteLine("Au revoir");
desktop.MainWindow = new MainWindow();
}
Quitter depuis n'importe où :
if (Application.Current?.ApplicationLifetime is IClassicDesktopStyleApplicationLifetime d)
d.Shutdown();
Assets¶
Depuis C# :