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 |
Mobile
Android et iOS nécessitent .NET 10 et les workloads correspondants :
dotnet workload install android ios.
Installer les templates¶
| 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¶
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.