.NET Standard 2.1 .NET Framework 3.5
NuGet\Install-Package aqlaserializer -Version
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
dotnet add package aqlaserializer --version
<PackageReference Include="aqlaserializer" Version="" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add aqlaserializer --version
#r "nuget: aqlaserializer,"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install aqlaserializer as a Cake Addin
#addin nuget:?package=aqlaserializer&version=

// Install aqlaserializer as a Cake Tool
#tool nuget:?package=aqlaserializer&version=

AqlaSerializer is intended to serialize objects, not just data.

What the difference? Data serializers don't care much about language runtime specifics like references, inheritance, etc. In contrast, an object serializer should take such things into account.

AqlaSerializer primary goal is to support important .NET features like nested collections, multi-dimensional arrays, references, etc. And it still supports Google Protocol Buffers format.

Like protobuf-net AqlaSerializer makes possible to store objects as a small in size binary data (far smaller than xml). And it's more CPU effective than BinaryFormatter and other core .NET serializers (which could be unavailable on your target platform). Its format is designed to be: small in size - efficient data storage (far smaller than xml) cheap to process - both at the client and server platform independent - portable between different programming architectures extensible - to add new data to old messages.

The implementation is compatible with most of the .NET family, including .NET 3.5/4.0/4.5, .NET Standard 2.1 (.NET Core 3/3.1, .NET 5, .NET 6), Windows Phone 8, Silverlight 5, Android, iOS, UAP. The code is heavily based on Marc Gravell's protobuf-net but there are a lot of improvements and fixes.

The original protobuf-net project contains many "red" unit tests but I managed to fix a lot of them.

Some build configurations may be not available through nuget, you can download their binaries manually from github (use Project Site link).

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.1
.NET Framework net35 net40 net403 net45 net451 net452 net46 net461 net462 net463 net47 net471 net472 net48
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated 120 7/9/2022 100 5/19/2022 154 4/30/2022 129 4/30/2022 98 4/30/2022 108 4/30/2022 108 4/30/2022
2.0.1 315 12/27/2020 1,307 8/5/2016 938 5/30/2016 899 5/30/2016 851 5/30/2016 837 5/30/2016 1,101 5/28/2016 823 5/24/2016 797 5/5/2016 1,242 3/20/2016 956 1/13/2016 1,557 11/14/2015 1,302 11/1/2015 1,298 10/24/2015 1,244 10/19/2015

- dynamic string reference tracking fix
- UseBackingFieldsIfNoSetter is parameter is removed and enabled by default

- AutoTuple nullables serialization fix
- Stream.Position is not used unless it's necessary

- interfaces without subtypes and System.Object use dynamic type by default
- ISet fixes
- arrays can be deserialized into IList fields

- added support for IReadOnlyDictionary, IReadOnlySet, ISet

- added platform .NET Standard 2.1 including .NET Core 3 and .NET 5

- Types lookup optimization for RuntimeTypeModel
- RuntimeTypeModel.Add allows to specify different type family filters or custom filter
- fixed concurrency bug when not final version of RootSerializer was published to clients

- Improved compiled dll output size, compilation and cold run speed
- Added an option CompilerOptions.AlsoCompileInPlace (default: true)
- dlls for Xamarin.Android for emit support
- RunSharp dependency updated

* V2 release
- Added CompileOptions.IterativeMode
- Fixed incorrect IL generated when list.Add method has a return value
- Fixed incorrect behavior of model.CloneAsUnfrozen
- Indexers won't be added as implicit fields
- Enum flags for model ids, see model.SetEnumFlagModelId
- RunSharp dependency updated

* V2 RC2
- Removing field won't break reference tracking.

* V2 RC
- Google Protocol Buffers format support is back (I've reconsidered this) - (de)serialization.
- Nested collections.
- Multi-dimensional arrays.
- Improved reference tracking (e.g. surrogate fix and referencing arrays from inside themselves).
- Improved versioning (e.g. between reference-nonreference-null-nonnull-dynamic).
- Optimizations for better output size.
- Collection subtypes (will read subtype number to create correct concrete type).
- Array types may be registered as collections and use full set of features (null support, etc) even when passed as root objects.
- Primitive types are allowed to be set to fields marked as dynamic type.
- Reference serialization will avoid using too much recursion in LateReference mode.
- Possibility to specify different attribute sets for different models (see ModelId property on attributes).
- Attributes to specify behavior on collection and collection elements (and nested) separately.
- Significant performance improvements.

- more effficient memory usage
- if writing stream CanSeek and CanRead the serializer may use it as a buffer when its own buffer grows too big

* merged changes from the fork origin (except DNX)
* fixed AsReferenceDefault correct usage for legacy protobuf-net attributes
- fixed issue when surrogated value was not correctly reference tracked
- add method is recognized not only on IEnumerable<T> but also on its inheritors like IReadOnlyCollection<T>

* - improvements in list handling, merged changes from original protobuf-net

* - initial AqlaSerializer release