SDK Setup Guides
...
C#
Release Notes

Ditto v1 for C#

csharp c# c sharp updates version changelog



C# / .NET Version 1.1.11

Released: Fri Sep 9th 2022, 4:11 pm

Release Notes:

  • Fixed: a very rare deadlock when running on macOS or iOS and starting sync immediately after creating the Ditto instance.

Installation:

Command Line

Install-Package Ditto -Version 1.1.11

PackageReference

<PackageReference Include="Ditto" Version=1.1.11" />

C# / .NET Version 1.1.10

Released: Thu Jul 7th 2022, 12:53 pm

Release Notes:

  • Changed: reduced total memory overhead during sync.

Installation:

Command Line

Install-Package Ditto -Version 1.1.10

PackageReference

<PackageReference Include="Ditto" Version=1.1.10" />

C# / .NET Version 1.1.9

Released: Wed Jun 15th 2022, 6:27 pm

Release Notes:

  • Changed: reduced CRDT memory overhead.
  • Changed: HTTP/WebSocket service now allows any origin for CORS, so it may be used from a webapp on localhost.
  • Changed: a Small Peer may now act as an authentication service on its HTTP transport.
  • Fixed: a peer using an online identity would fail to sync peer-to-peer after app restarts.

Installation:

Command Line

Install-Package Ditto -Version 1.1.9

PackageReference

<PackageReference Include="Ditto" Version=1.1.9" />

C# / .NET Version 1.1.9-alpha1

Released: Wed Jun 8th 2022, 8:12 pm

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.1.9-alpha1

PackageReference

<PackageReference Include="Ditto" Version=1.1.9-alpha1" />

C# / .NET Version 1.1.8

Released: Fri Jun 3rd 2022, 12:13 am

Release Notes:

  • Fixed: Ditto with OnlinePlaygroundV2 identity would fail to sync with the Big Peer if internet access isn't available at the time when Ditto is instantiated.
  • Fixed: cloud sync would stop working when setting a newly created transport config.
  • Added: a new DittoTransportConditionChanged event handler to Ditto, allowing to observe the status of network transports.
  • Deprecated: DittoIdentity.token and replaced with DittoIdentity.Token.

Installation:

Command Line

Install-Package Ditto -Version 1.1.8

PackageReference

<PackageReference Include="Ditto" Version=1.1.8" />

C# / .NET Version 1.1.7

Released: Fri May 13th 2022, 7:18 am

Release Notes:

Synchronized version bump release.

Installation:

Command Line

Install-Package Ditto -Version 1.1.7

PackageReference

<PackageReference Include="Ditto" Version=1.1.7" />

C# / .NET Version 1.1.6

Released: Mon May 9th 2022, 5:04 am

Release Notes:

  • Fixed: a correctness issue in replication when peer permissions changed in the middle of a replication exchange.
  • Fixed: error when querying a collection and there was a type mismatch for a field being used in a comparison in the query.
  • Fixed: restarting an app too quickly could lead to multiple connection attempts to rejoin peers in the mesh.
  • Fixed: apps using
  • Changed: improvements to Ditto mesh performance via fastest-available-transport prioritization.

Installation:

Command Line

Install-Package Ditto -Version 1.1.6

PackageReference

<PackageReference Include="Ditto" Version=1.1.6" />

C# / .NET Version 1.1.5

Released: Fri Apr 8th 2022, 1:00 am

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.1.5

PackageReference

<PackageReference Include="Ditto" Version=1.1.5" />

C# / .NET Version 1.1.4

Released: Thu Apr 7th 2022, 11:25 pm

Release Notes:

  • Changed: improved replication performance in some scenarios.

Installation:

Command Line

Install-Package Ditto -Version 1.1.4

PackageReference

<PackageReference Include="Ditto" Version=1.1.4" />

C# / .NET Version 1.1.3

Released: Tue Mar 22nd 2022, 3:13 am

Release Notes:

  • Added: OnlinePlaygroundV2 identity allowing for basic authentication for playgrounds
  • Deprecated: OnlinePlayground identity, use newly added OnlinePlaygroundV2 instead
  • Fixed: document IDs are now validated when synced and removed if invalid (some of our early versions of the SDK stored malformed IDs under certain circumstances)

Installation:

Command Line

Install-Package Ditto -Version 1.1.3

PackageReference

<PackageReference Include="Ditto" Version=1.1.3" />

C# / .NET Version 1.1.2

Released: Mon Feb 28th 2022, 6:36 am

Release Notes:

  • Added: method
  • Deprecated:

Installation:

Command Line

Install-Package Ditto -Version 1.1.2

PackageReference

<PackageReference Include="Ditto" Version=1.1.2" />

C# / .NET Version 1.1.1

Released: Fri Feb 11th 2022, 9:38 pm

Release Notes:

  • Changed: Optimized the performance of accessing the value of a
  • Added: Experimental mesh roles API
    • Added:
    • Added:

Installation:

Command Line

Install-Package Ditto -Version 1.1.1

PackageReference

<PackageReference Include="Ditto" Version=1.1.1" />

C# / .NET Version 1.1.0

Released: Fri Jan 28th 2022, 3:21 am

Release Notes:

  • Changed: improved peer-to-peer algorithms to create meshes that are more efficient and diverse.
  • Changed: improved routing algorithms for more efficiency.
  • Changed: improved performance of query parsing.
  • Added: property
  • Added: method
  • Added: set of APIs to observe authentication status (see API reference for
  • Added: method
  • Added: property
  • Deprecated: properties
  • Deprecated: methods

Installation:

Command Line

Install-Package Ditto -Version 1.1.0

PackageReference

<PackageReference Include="Ditto" Version=1.1.0" />

C# / .NET Version 1.0.19

Released: Thu Dec 23rd 2021, 12:42 pm

Release Notes:

  • Fixed: collections were not appearing in the data browser under certain permission configurations.
  • Fixed: race condition when subscriptions were configured from multiple threads in parallel (sometimes leading to a crash).

Installation:

Command Line

Install-Package Ditto -Version 1.0.19

PackageReference

<PackageReference Include="Ditto" Version=1.0.19" />

C# / .NET Version 1.0.18

Released: Mon Dec 20th 2021, 5:22 am

Release Notes:

  • Reduced the opportunity for rapid memory growth in some scenarios.

Installation:

Command Line

Install-Package Ditto -Version 1.0.18

PackageReference

<PackageReference Include="Ditto" Version=1.0.18" />

C# / .NET Version 1.0.18-alpha2

Released: Tue Dec 14th 2021, 8:32 am

Release Notes:

  • Improve attachment sync performance.

Installation:

Command Line

Install-Package Ditto -Version 1.0.18-alpha2

PackageReference

<PackageReference Include="Ditto" Version=1.0.18-alpha2" />

C# / .NET Version 1.0.18-alpha1

Released: Wed Dec 8th 2021, 9:25 am

Release Notes:

  • Fixed an issue where document IDs that were specified inside the document's value as opposed to being specified explicitly (as a separate argument to

Installation:

Command Line

Install-Package Ditto -Version 1.0.18-alpha1

PackageReference

<PackageReference Include="Ditto" Version=1.0.18-alpha1" />

C# / .NET Version 1.0.17

Released: Thu Nov 25th 2021, 4:11 pm

Release Notes:

  • Fix an issue with write strategies not working correctly. Unexpected results could occur when performing sequences of operations on documents.

Installation:

Command Line

Install-Package Ditto -Version 1.0.17

PackageReference

<PackageReference Include="Ditto" Version=1.0.17" />

C# / .NET Version 1.0.16

Released: Fri Nov 19th 2021, 2:39 pm

Release Notes:

  • Fix an issue with live queries that involved a limit, no offset, at least one document being deleted, and some other conditions being met. Live queries that met these conditions could report incorrect sets of matching documents.
  • Fix an issue that could potentially lead to an infinite loop in the replication system, meaning no sync progress would be made.

Installation:

Command Line

Install-Package Ditto -Version 1.0.16

PackageReference

<PackageReference Include="Ditto" Version=1.0.16" />

C# / .NET Version 1.0.15

Released: Fri Nov 5th 2021, 3:03 pm

Release Notes:

  • Ensure that when performing a

Installation:

Command Line

Install-Package Ditto -Version 1.0.15

PackageReference

<PackageReference Include="Ditto" Version=1.0.15" />

C# / .NET Version 1.0.15-alpha1

Released: Wed Oct 27th 2021, 3:33 am

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.0.15-alpha1

PackageReference

<PackageReference Include="Ditto" Version=1.0.15-alpha1" />

C# / .NET Version 1.0.14

Released: Mon Oct 25th 2021, 1:31 am

Release Notes:

  • Add support for array projections to DittoQL.
  • Deprecate the
  • Deprecate the
  • Deprecate the

Installation:

Command Line

Install-Package Ditto -Version 1.0.14

PackageReference

<PackageReference Include="Ditto" Version=1.0.14" />

C# / .NET Version 1.0.13

Released: Mon Oct 18th 2021, 10:02 am

Release Notes:

  • Changed

Installation:

Command Line

Install-Package Ditto -Version 1.0.13

PackageReference

<PackageReference Include="Ditto" Version=1.0.13" />

C# / .NET Version 1.0.12

Released: Mon Oct 18th 2021, 3:00 am

Release Notes:

  • Added

Installation:

Command Line

Install-Package Ditto -Version 1.0.12

PackageReference

<PackageReference Include="Ditto" Version=1.0.12" />

C# / .NET Version 1.0.11

Released: Thu Oct 7th 2021, 10:09 pm

Release Notes:

  • Fixed
  • Added
  • Added method
  • Added

Installation:

Command Line

Install-Package Ditto -Version 1.0.11

PackageReference

<PackageReference Include="Ditto" Version=1.0.11" />

C# / .NET Version 1.0.10

Released: Fri Sep 10th 2021, 9:21 am

Release Notes:

  • Fix to stop a change in site ID from leading to an unnecessary error.
  • Improve handling of persisted authentication data. Note that this might lead to a one-off change to a peer's site ID if you weren't and continue to not be specifying an explicit site ID when creating your identity.

Installation:

Command Line

Install-Package Ditto -Version 1.0.10

PackageReference

<PackageReference Include="Ditto" Version=1.0.10" />

C# / .NET Version 1.0.9

Released: Fri Sep 3rd 2021, 3:38 pm

Release Notes:

  • Fixed an issue where
  • Updated the
  • Fixed
  • Added support for getting information about all of the collections that the device is aware of. This is achieved by accessing
  • Added multicast as a transport option to the
  • Added new identity types:
  • The
  • Added a
  • Similarly, added a
  • Report an error if more than one Ditto instance is started using the same working directory.

Installation:

Command Line

Install-Package Ditto -Version 1.0.9

PackageReference

<PackageReference Include="Ditto" Version=1.0.9" />

C# / .NET Version 1.0.8

Released: Mon Aug 2nd 2021, 9:19 am

Release Notes:

  • Improved debug logging.

Installation:

Command Line

Install-Package Ditto -Version 1.0.8

PackageReference

<PackageReference Include="Ditto" Version=1.0.8" />

C# / .NET Version 1.0.7

Released: Thu Jul 22nd 2021, 4:38 pm

Release Notes:

  • Fix bug where sync may fail if an unusually long

Installation:

Command Line

Install-Package Ditto -Version 1.0.7

PackageReference

<PackageReference Include="Ditto" Version=1.0.7" />

C# / .NET Version 1.0.6

Released: Thu Jul 8th 2021, 11:22 am

Release Notes:

  • Add

Installation:

Command Line

Install-Package Ditto -Version 1.0.6

PackageReference

<PackageReference Include="Ditto" Version=1.0.6" />

C# / .NET Version 1.0.5

Released: Fri Jun 25th 2021, 3:36 pm

Release Notes:

  • Added a new find function that accepts a query containing placeholders in the form of $args.my_arg along with a map of query arguments in the form of { "my_arg": "some value" }. The placeholders in the query will be replaced by a query-appropriate representation of the relevant value from the map of query arguments.
  • Added the ability to get a hash and/or a mnemonic (string) representation of the matching documents from a live query event. This means you can do something like this:
  • Fix for using floats in queries.
  • Accessing the store property of a Ditto instance will no longer throw an error if you have not yet activated your Ditto instance with a valid license token.
  • Deprecated SetAccessLicense and added a new function, SetLicenseToken, which will throw an appropriate exception if your provided license token is expired or invalid somehow.
  • Deprecated StartSync and added a new function, TryStartSync, which will throw an exception if your Ditto instance hasn't yet been activated via a successful call to SetLicenseToken.

Installation:

Command Line

Install-Package Ditto -Version 1.0.5

PackageReference

<PackageReference Include="Ditto" Version=1.0.5" />

C# / .NET Version 1.0.4

Released: Fri Jun 11th 2021, 3:36 pm

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.0.4

PackageReference

<PackageReference Include="Ditto" Version=1.0.4" />

C# / .NET Version 1.0.3

Released: Thu Jun 10th 2021, 9:34 am

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.0.3

PackageReference

<PackageReference Include="Ditto" Version=1.0.3" />

C# / .NET Version 1.0.2

Released: Thu May 20th 2021, 2:39 pm

Release Notes:

  • Add support for subscripting
  • Deprecated

Installation:

Command Line

Install-Package Ditto -Version 1.0.2

PackageReference

<PackageReference Include="Ditto" Version=1.0.2" />

C# / .NET Version 1.0.1

Released: Tue May 4th 2021, 9:02 am

Release Notes:

  • If you provide an invalid query then you will now get a better error message.

Installation:

Command Line

Install-Package Ditto -Version 1.0.1

PackageReference

<PackageReference Include="Ditto" Version=1.0.1" />

C# / .NET Version 1.0.0

Released: Wed Apr 21st 2021, 5:29 pm

Release Notes:

  • This release is not compatible with any previous SDK releases. There are a number of breaking changes both in terms of the SDK API and in terms of the internal systems used by the SDK to perform operations such as synchronization. If you have previously made use of the Ditto SDK and wish to update to this version then note that you will need to delete all existing Ditto data otherwise you will run into errors. If you have existing data that you need to keep then please contact us and we can advise you as to how you can migrate your data.
  • The most notable API breaking changes are:
    • Document IDs are no longer restricted to just strings. You can now create a document ID that is a string, integer, boolean, array, map, or null. This means that when making
    • The
  • Lots of performance improvements and bug fixes.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0

PackageReference

<PackageReference Include="Ditto" Version=1.0.0" />

C# / .NET Version 1.0.0-alpha9

Released: Thu Feb 4th 2021, 4:58 pm

Release Notes:

  • The exact version of the Ditto SDK can now be retrieved using the
  • Fixed a bug where mDNS advertising may continue after Ditto is stopped.
  • Fixed a hang that could occur creating an attachment fetcher while requesting many attachments at once.
  • Fixed sync failure when there are multiple overlapping subscriptions or live queries with the same query string for the same collection.
  • Fixed a potential crash and other sync failures that could occur under certain conditions.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha9

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha9" />

C# / .NET Version 1.0.0-alpha8

Released: Fri Jan 22nd 2021, 7:09 am

Release Notes:

  • Site IDs, which make up part of a Ditto identity object, are now unsigned, 64-bit integers instead of unsigned 32-bit integers.
  • Fix a crash that could occur if an offset with a value greater than the number of matching documents was provided.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha8

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha8" />

C# / .NET Version 1.0.0-alpha7

Released: Mon Jan 4th 2021, 3:12 am

Release Notes:

  • Synchronized version bump release

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha7

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha7" />

C# / .NET Version 1.0.0-alpha6

Released: Mon Dec 14th 2020, 5:00 pm

Release Notes:

  • Performance and stability improvements.
  • Fix default data insertion such that merge semantics are consistent and duplicate data isn't created.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha6

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha6" />

C# / .NET Version 1.0.0-alpha5

Released: Mon Nov 23rd 2020, 12:30 pm

Release Notes:

  • Added a new intermediate security identity for a shared secret key. This is a simplistic authentication mode which is normally only suitable for private apps where all the users and devices are trusted.
  • Fixed an issue that prevented Counter values from syncing correctly
  • Renamed DittoAttachmentStatus to DittoAttachmentFetchEvent and subsequently Incomplete status to Progre ss.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha5

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha5" />

C# / .NET Version 1.0.0-alpha4

Released: Mon Nov 9th 2020, 10:02 am

Release Notes:

  • Fix issue where attachments could stop being fetched incorrectly.
  • Introduce a

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha4

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha4" />

C# / .NET Version 1.0.0-alpha3

Released: Wed Nov 4th 2020, 12:48 am

Release Notes:

  • Added new observeWithNextSignal API to allow the application to control the delivery of the next observe callback ev ent.
  • Fixed several issues related to attachments that could delay sync.
  • Simplified log statements

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha3

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha3" />

C# / .NET Version 1.0.0-alpha2

Released: Wed Oct 14th 2020, 11:01 am

Release Notes:

Fixed several potential issues with attachment fetching that may result in the fetch callback not firing.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha2

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha2" />

C# / .NET Version 1.0.0-alpha1

Released: Fri Oct 9th 2020, 10:53 am

Release Notes:

  • Note that this is a release with breaking changes and clients using releases in the 1.0 series will not be able to communicate with clients running a version that is anything less than 1.0. This should hopefully not be an issue because this release of the SDK has changed the name to be DittoSyncKit as opposed to DittoSharp and the namespace has gone from DittoSharp to Ditto.SyncKit.
  • Lots of performance improvements and some bug fixes.

Installation:

Command Line

Install-Package Ditto -Version 1.0.0-alpha1

PackageReference

<PackageReference Include="Ditto" Version=1.0.0-alpha1" />