avalonia-deployment
Use when packaging or deploying Avalonia apps for Windows, macOS, Linux, WebAssembly, Android, or iOS.
linuxdevel · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add linuxdevel/Avalonia-skills --skill avalonia-deployment技能说明
name: avalonia-deployment description: Use when packaging or deploying Avalonia apps for Windows, macOS, Linux, WebAssembly, Android, or iOS.
Avalonia Deployment
Overview
Avalonia apps are .NET apps — standard dotnet publish with -r <RID> produces executables. Platform-specific packaging tools handle OS-native bundles.
Runtime Identifiers (RIDs)
| Platform | RID |
|---|---|
| Windows x64 | win-x64 |
| Windows ARM64 | win-arm64 |
| macOS x64 (Intel) | osx-x64 |
| macOS ARM64 (Apple Silicon) | osx-arm64 |
| Linux x64 | linux-x64 |
| Linux ARM64 | linux-arm64 |
Target Frameworks
| 11.3 | 12.0 / 12.1 | |
|---|---|---|
| Desktop / shared | net6.0+, netstandard2.0, .NET Framework | net8.0 min, net10.0 recommended (no netstandard/.NET Framework) |
| Android / iOS / Mac Catalyst | net8.0-android / net8.0-ios etc. | net10.0-android / net10.0-ios / net10.0-maccatalyst (required) |
| Browser | net8.0-browser+ | net8.0-browser+ (net10.0-browser recommended) |
Removed in 12: Avalonia.Browser.Blazor, Avalonia.Tizen, Avalonia.Direct2D1 (use Skia).
Basic Publish
# Self-contained single file (Windows)
dotnet publish -r win-x64 -c Release --self-contained true -p:PublishSingleFile=true
# Framework-dependent (requires .NET installed)
dotnet publish -r win-x64 -c Release --self-contained false
Windows
Options:
- MSIX — Use Visual Studio packaging project or
msix-packaging-tool - Installer (Inno Setup / WiX) — point at publish output
- Single EXE —
PublishSingleFile=true+ self-contained
<!-- .csproj for Windows -->
<PropertyGroup>
<PublishSingleFile>true</PublishSingleFile>
<SelfContained>true</SelfContained>
<RuntimeIdentifier>win-x64</RuntimeIdentifier>
<IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
</PropertyGroup>
macOS
# Publish
dotnet publish -r osx-arm64 -c Release --self-contained true
# Bundle as .app using dotnet-bundle tool:
dotnet tool install --global Dotnet.Bundle
dotnet msbundle -r osx-arm64 /p:CFBundleVersion=1.0.0
Info.plist properties in .csproj:
<PropertyGroup>
<CFBundleName>MyApp</CFBundleName>
<CFBundleIdentifier>com.mycompany.myapp</CFBundleIdentifier>
<CFBundleVersion>1.0.0</CFBundleVersion>
<NSHighResolutionCapable>true</NSHighResolutionCapable>
</PropertyGroup>
Notarization requires Apple Developer account + xcrun notarytool.
Linux
# AppImage
dotnet publish -r linux-x64 -c Release --self-contained true
# Then use appimagetool to wrap the publish output
# Debian package (.deb)
dotnet publish -r linux-x64 -c Release
# Use dpkg-deb or dotnet-deb NuGet tool
dotnet tool install --global dotnet-deb
dotnet deb -r linux-x64 -c Release
WebAssembly (WASM)
Separate project (MyApp.Browser.csproj):
<Project Sdk="Microsoft.NET.Sdk.WebAssembly">
<PropertyGroup>
<TargetFramework>net10.0-browser</TargetFramework>
<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Avalonia.Browser" Version="12.1.4"/>
</ItemGroup>
</Project>
(11.x) templates used Microsoft.NET.Sdk.BlazorWebAssembly / net8.0; Avalonia.Browser.Blazor is removed in 12. Entry point uses StartBrowserAppAsync("out"); App uses ISingleViewApplicationLifetime (unchanged in 12).
dotnet publish -c Release
# Output is static files (wwwroot/) — host on any static server
Android
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0-android</TargetFramework> <!-- (11.x) net8.0-android / net9.0-android -->
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Avalonia.Android" Version="12.1.4"/>
</ItemGroup>
</Project>
dotnet publish -f net10.0-android -c Release
# Produces .apk / .aab (AndroidPackageFormats)
Entry (12.0+): MainActivity : AvaloniaMainActivity + [Application] AndroidApp : AvaloniaAndroidApplication<App>; App sets IActivityApplicationLifetime.MainViewFactory (see avalonia-app-development). (11.x) AvaloniaMainActivity<App> + ISingleViewApplicationLifetime.
iOS / Mac Catalyst
<TargetFramework>net10.0-ios</TargetFramework> <!-- (11.x) net8.0-ios / net9.0-ios -->
<PackageReference Include="Avalonia.iOS" Version="12.1.4"/>
Requires macOS + Xcode. Produces .ipa. iOS uses ISingleViewApplicationLifetime and the scene delegate lifecycle (12.0+; AvaloniaAppDelegate.Window is null after startup).
Mac Catalyst (12.0+) — same Avalonia.iOS project, add a target; needs dotnet workload install maccatalyst:
<TargetFrameworks>net10.0-ios;net10.0-maccatalyst</TargetFrameworks>
dotnet build -f net10.0-maccatalyst
Prefer the default AppKit macOS backend for new desktop apps; Catalyst is for UIKit-heavy / MAUI-hybrid scenarios.
Linux Wayland (12.1+, experimental)
Opt-in: add Avalonia.Wayland and call .UseWayland() on the AppBuilder. UsePlatformDetect() does not select it; X11 remains default.
SBOM (12.1+)
Avalonia 12.1.0+ packages ship a Software Bill of Materials listing the framework's NuGet packages (supports CRA/compliance work).
Trimming
Enable for smaller binaries — may break reflection-heavy code:
<PublishTrimmed>true</PublishTrimmed>
<TrimmerRootDescriptor>TrimmerRoots.xml</TrimmerRootDescriptor>
Watch for reflection in converters, ViewLocator. Compiled bindings (default ON in 12, opt-in in 11) avoid binding reflection and are trim-friendly; reflection bindings (ReflectionBinding) are not.
Community Deployment Tools
| Tool | NuGet / Repo | Purpose |
|---|---|---|
| PupNet Deploy | GitHub: kuiperzone/PupNet-Deploy | Cross-platform deployment: AppImage, Flatpak, deb, rpm, MSIX, zip |
| dotnet-deb | dotnet-deb tool | Generate Debian .deb packages |
| Dotnet.Bundle | Dotnet.Bundle tool | macOS `.ap |