Aller au contenu

Installation

Un SDK .NET, les templates Avalonia, et c'est parti.

Prérequis

Outil Version
.NET SDK 10.0 recommandé (8.0 minimum sur desktop)
IDE Rider, Visual Studio 2022+ ou VS Code + extension Avalonia
dotnet --version   # doit afficher 10.x

Mobile

Android et iOS nécessitent .NET 10 et les workloads correspondants : dotnet workload install android ios.

Installer les templates

dotnet new install Avalonia.Templates
dotnet new list avalonia
Template Usage
avalonia.app Application desktop minimale (code-behind)
avalonia.mvvm Application desktop avec ViewModels (CommunityToolkit.Mvvm)
avalonia.xplat Desktop + Android + iOS + navigateur
avalonia.window / avalonia.usercontrol Ajouter une fenêtre / un UserControl
avalonia.templatedcontrol Ajouter un contrôle templaté
flowchart LR
  Q{"Quel projet ?"} -->|"desktop simple,<br/>découverte"| A["avalonia.app"]
  Q -->|"desktop structuré<br/>(recommandé)"| M["avalonia.mvvm"]
  Q -->|"aussi mobile / web"| X["avalonia.xplat"]

Créer et lancer une application

dotnet new avalonia.app -o MonApp
cd MonApp
dotnet run
dotnet new avalonia.mvvm -o MonApp
cd MonApp
dotnet run
dotnet new avalonia.xplat -o MonApp
cd MonApp
dotnet run --project MonApp.Desktop

Ajouter des éléments

dotnet new avalonia.window      -n ParametresWindow -o Views
dotnet new avalonia.usercontrol -n CarteProduit     -o Views

Le fichier projet

MonApp.csproj
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ApplicationManifest>app.manifest</ApplicationManifest>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Avalonia" Version="12.1.4" />
    <PackageReference Include="Avalonia.Desktop" Version="12.1.4" />
    <PackageReference Include="Avalonia.Themes.Fluent" Version="12.1.4" />
    <PackageReference Include="Avalonia.Fonts.Inter" Version="12.1.4" />
    <!-- Outils de développement (F12), uniquement en Debug -->
    <PackageReference Include="AvaloniaUI.DiagnosticsSupport" Version="2.2.0"
                      Condition="'$(Configuration)' == 'Debug'" />
  </ItemGroup>
</Project>

Versions

Gardez la même version pour tous les paquets Avalonia.*. Vérifiez la dernière version 12.x sur NuGet.

Prévisualiser le XAML

  • Rider : prévisualiseur intégré, rien à installer.
  • Visual Studio : extension Avalonia for Visual Studio.
  • VS Code : extension Avalonia for VS Code.

Dans tous les cas, compilez une fois le projet pour que l'aperçu fonctionne.

<!-- Taille de l'aperçu, ignorée à l'exécution -->
<UserControl xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
             mc:Ignorable="d"
             d:DesignWidth="400" d:DesignHeight="300">

Outils de développement

Lancez l'application en Debug et appuyez sur F12 : arbre visuel, propriétés, styles appliqués.

App.axaml.cs
public override void OnFrameworkInitializationCompleted()
{
#if DEBUG
    this.AttachDeveloperTools();   // v12 : remplace AttachDevTools()
#endif
    base.OnFrameworkInitializationCompleted();
}