Aller au contenu

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>
using Avalonia.Controls;

namespace MonApp;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();   // généré à partir du XAML
    }
}
Aperçu
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

MonApp.csproj
<ItemGroup>
  <AvaloniaResource Include="Assets\**" />
</ItemGroup>
<Image Source="/Assets/logo.png" Width="64" />
<Window Icon="/Assets/app.ico" />

Depuis C# :

using Avalonia.Media.Imaging;
using Avalonia.Platform;

var bitmap = new Bitmap(AssetLoader.Open(new Uri("avares://MonApp/Assets/logo.png")));