AvaloniaUI.Parcel.macOS 1.1.1

Prefix Reserved
dotnet tool install --global AvaloniaUI.Parcel.macOS --version 1.1.1
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local AvaloniaUI.Parcel.macOS --version 1.1.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=AvaloniaUI.Parcel.macOS&version=1.1.1
                    
nuke :add-package AvaloniaUI.Parcel.macOS --version 1.1.1
                    

Avalonia Parcel

Parcel is a packaging tool for Avalonia UI applications. It's designed as a two-app solution (GUI and console tool) that handles building, signing and packaging applications across Windows, macOS, and Linux platforms.

Prerequisites

Parcel requires .NET 6.0 or newer runtime to be installed on your system.

Installation

Install as .NET Global Tool

Install the Parcel globally using the .NET CLI:

  • For .NET 10+

    dotnet tool install --global AvaloniaUI.Parcel
    
  • For .NET 6 to .NET 9

    You need to install platform-specific package:

    Windows:

    dotnet tool install --global AvaloniaUI.Parcel.Windows
    

    macOS:

    dotnet tool install --global AvaloniaUI.Parcel.macOS
    

    Linux:

    dotnet tool install --global AvaloniaUI.Parcel.Linux
    

After installation, you can launch it from terminal using:

parcel

Once the Parcel has opened, you will be asked to input AvaloniaUI Portal credentials that were used to license the tool.

Alternatively, it's possible to run CLI commands from terminal on existing parcel project:

parcel pack ./SampleApp.parcel -r osx-x64 -p dmg -o ./artifacts

This command will bundle, sign and package application into a dmg file from the pre-configured parcel project.

:::note CLI is not available in free community license. :::

Further Reading

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.1.1 275 8/25/2026
1.1.0 289 8/11/2026
1.0.6 252 7/2/2026
1.0.5 508 5/25/2026
1.0.4 404 3/17/2026
1.0.3 367 12/6/2025
1.0.2 358 10/24/2025
1.0.1 228 10/23/2025
1.0.0 264 10/13/2025

# 1.1.1

## Enhancements

* Windows: Sign the NSIS uninstaller with the installer.
* macOS: Validate P12 signing certificates before use.
* Linux: Added an "X11 Window Class" setting to override the window class declared by the desktop entry.

## Fixes

* macOS: Sign nested executables with the hardened runtime so notarization accepts the app.
* macOS: "Additional signing patterns" now match files anywhere in the app bundle, not only under `Contents/MacOS`.
* Linux: Fixed windows not being associated with the desktop entry, causing a wrong or generic icon in taskbars and app switchers. DEB/RPM desktop entries now declare `StartupWMClass`.

# 1.1.0

## Enhancements

* Windows: Added MSIX packaging support.
* macOS: Added PKG packaging support.
* Added File Associations and URL Schemes support for all target platforms.
* Added an "Exclude files" setting to remove files and directories from the published output before packaging.
* Application Icon and Company are now declared once under the Basics page instead of being repeated per platform. Both can still be overridden per platform.

## Breaking changes

* The `Company` setting moved from Windows to the Basics page, so the `PARCEL_WINDOWS_COMPANY` environment variable is now `PARCEL_GENERAL_COMPANY`.
* macOS: The "Sign DMG" setting was renamed from `DmgSign` to `SignDmg`, so `PARCEL_MACOS_DMG_SIGN` is now `PARCEL_MACOS_SIGN_DMG`.
* Windows: The Azure Artifact Signing settings were renamed from `TrustedSigning*` to `ArtifactSigning*`, so `PARCEL_WINDOWS_TRUSTED_SIGNING_*` are now `PARCEL_WINDOWS_ARTIFACT_SIGNING_*`.
* Existing project files are migrated automatically when opened.

## Fixes

* Fixed the default icon being used in some conditions instead of the one specified in the project.
* Windows: Fixed signing failing with "The filename or extension is too long" when "Additional signing patterns" matched enough files to exceed the command line length limit.
* macOS: Fixed several issues and incompatibilities with App Store Connect.

# 1.0.6

## Enhancements

* Added a "Problems signing in?" link to the login dialog.
* Improved `--packages` parameter validation in CLI mode.
* Added a warning when `IncludeAllContentForSelfExtract` is used with non-zip package formats.
* Windows, macOS: Added an "Additional signing patterns" setting to sign extra files beyond the main executable.
* Windows: Added an "Azure Key Vault URL" setting to support GCC High with a non-default endpoint.
* macOS: Improved bundle validation to detect potential code signing issues.
* macOS: Added a "Resource file patterns" setting to package matching files into Contents/Resources as symlinks.

## Fixes

* Fixed MSBuild property evaluation breaking when project tasks write noise to StdOut (requires .NET 8.0.300+).
* Fixed some project configuration errors being surfaced as internal exceptions.
* Fixed relative symlink target resolution when materializing bundles.
* macOS: Fixed DMG packaging failing when the package name is too long.
* macOS: Improved code signing reliability.
* macOS: Improved notarization error messages.
* macOS: Fixed ZIP package creation that could be rejected by Apple notarization.

# 1.0.5

## Enhancements

* Improved integration with the macOS native menu bar, including a recent items list, and removed the in-window menu.
* Added "Save As" and "Move To" commands to save a .parcel project outside the .NET project directory.
* Added the `AVALONIA_TOOLS_LICENSE_KEY` environment variable for consistency with the branding. Previous keys are still supported for backward compatibility.
* macOS: Added support for an extra LICENSE file in DMG packages.
* Windows: Renamed Azure "Trusted Signing" to "Artifact Signing" to match the new Azure service name.

## Fixes

* All "parcel step" subcommands now accept optional --runtime parameter
* Improved compatibility with tools like Nerdbank.GitVersioning, allowing to define Parcel property that reads MSBuild value generated by these tools.

# 1.0.4

## Enhancements

* XPF license keys are now accepted via `ACCELERATE_LICENSE_KEY`/`AVALONIA_TOOLS_LICENSE_KEY`.
* Added `AVALONIA_TOOLS_LOG_LEVEL` environment variable to control file logger verbosity of Parcel itself. Does not affect packaging logging.
* Linux: Added Copyright field to DEB/RPM packages

## Fixes

* Fixed `$(SolutionDir)` MSBuild property not being set when publishing from Parcel
* macOS: fixed titlebar alignment issues on macOS 26
* Linux: fixed incorrect permission detection for secondary executable files and shell scripts
* Linux: package name is lower-case normalized
* Fixed `PublishSingleFile` and `SelfContained` being incorrectly applied to referenced executable projects instead of only the main project
* Improved error handling for MCP tool and added server instructions

# 1.0.3

## Enhancements

* macOS: new visual DMG layout editor
* Linux: ability to define RPM and DEB additional dependencies

## Fixes

* Windows: fixed "Require Admin" setting being ignored
* Linux: fixed "create-rpm" CLI option not being available
* Fixed potential network issues when downloading additional tools during packaging
* Fixed Parcel icon being low-quality on Windows

# 1.0.2

## Fixes

* Windows: fixed uninstaller removing shortcuts for other apps
* Windows: fixed nested directories being flattened
* Windows: include missing FileDescription metadata
* Windows: utilize NSIS branding field, using company name if available

# 1.0.1

## Enhancements

* Linux: new option to create "/usr/bin/" symlink to the application executable, enabled by default
* Linux: installation directory name is now configurable with better defaults
* Linux: if icon is SVG, it will be used as "scalable" icon in DEB/RPM packages

## Fixes

* MacOS: fixed codesign when using keychain credentials
* Linux: fixed invalid icon generation for Linux DEB/RPM packages
* Linux: fixed RPM package generation
* Windows: fixed NSIS installer not being DPI-aware
* Windows: fixed application not running on ARM
* Fixed unicode support in the packaging log output
* Fixed error with invalid version string breaking packaging dialog
* Fixed bug with Parcel expecting OutputDirectory available even when packaging failed
* Fixed random exception during folder picker dialog