Deprecated: observe() and observeWithNextSignal() methods of DittoPendingCollectionsOperation, DittoPendingCursorOperation and DittoPendingIDSpecificOperation. Please use the corresponding observeLocal(deliverOn:eventHandler:) and observeLocalWithNextSignal(deliverOn:eventHandler:) variants along with a separate call tosubscribe() instead. 

Released: Wed Nov 2nd 2022, 4:51 pm

Released: Thu Oct 27th 2022, 5:14 pm

Changed: New lock file ensures we have only 1 SDK instance per working dir

Removed: Bitcode is no longer embedded in the Ditto SDK as use of this technology has been deprecated by Apple.

Fixed: Swift package manifest is now updated on the

Fixed: Reduced the amount of disk space used by sync metadata by up to 50% in some cases

Released: Thu Sep 22nd 2022, 8:02 pm

Fixed: Ensure Ditto internal auth client is shut down correctly when it's no longer needed

Fixed: The SwiftPM .zip artifact included an unintended .swiftsourceinfo file which causes mismatched versions of the Swift toolchain to cause errors. CocoaPods artifacts were unaffected.

Released: Thu Sep 15, 2022, 4:46 pm

Fixed: a very rare deadlock when starting sync immediately after creating the Ditto instance.

Released: Thu Sep 8, 2022, 3:20 pm

Released: Thu Sep 1, 2022, 11:31 am

Fixed: rare crash due to a race condition within Ditto's Bluetooth subsystem.

Changed: presence data is no longer synced with the big peer.

Released: Wed Aug 31, 2022, 10:20 am

Added: method cancel() to DittoSubscription allowing explicit canceling of a subscription.

Fixed: memory leak, observer objects returned by observeStatus() of DittoAuthenticator were never deallocated.

Fixed: Reduced size of DittoSwift framework

Changed: performing an .exec() call, outside the scope of a store.write { } block, no longer tries to obtain a write transaction and instead uses a read transaction.

Released: Fri Aug 26, 2022, 6:58 pm

Released: Sat Aug 13, 2022, 9:57 pm

Note: peers running 2.0.0 are able to sync with peers running at least version 1.1.8 of the SDK.

Added: support for explicitly typing values as registers. This is via 2 new types: DittoRegister and DittoMutableRegister, and new registerValue value accessors added to DittoDocumentPath and DittoMutableDocumentPath.

Added: DittoCounter and DittoMutableCounter types resembling the CRDT type underneath, which replace the old counter mechanics. A new counter value accessor has been added to DittoDocumentPath and DittoMutableDocumentPath, which returns a DittoCounter or a DittoMutableCounter respectively, if one is present at the document path specified.

Added: support for accessing and creating RGAs (Replicated Growable Arrays), which was the default CRDT type for arrays in Ditto v1. There are 2 new types: DittoRGA and DittoMutableRGA in v2, and new rga value accessors added to DittoDocumentPath and DittoMutableDocumentPath. Note that these are deprecated though and arrays should instead be used in registers (which is now the default).

Changed: arrays now default to being Register arrays. This means that when you want to update a property in a document that's an array you need to set the whole value as the new array. You can't perform mutating operations on an array in a document other than to fully replace it.

Added: value accessor properties have been added to DittoDocumentID: value, string{Value}, bool{Value}, int{Value}, uint{Value}, float{Value}, double{Value}, array{Value}, dictionary{Value}.

Changed: the keys DittoAccessLicense and DittoLicenseToken in Info.plist will now fail with a fatal error instead of logging a deprecation warning. Please use the key DittoOfflineOnlyLicenseToken instead.

Changed: renamed identity onlinePlaygroundV2 to just onlinePlayground, which replaces the previously deprecated onlinePlayground.

Changed: renamed Ditto method tryStartSync() to just startSync(), which replaces the previously deprecated startSync().

Removed: deprecated DittoRemotePeerV2 property meshRole, please queryOverlapGroup instead.

Removed: deprecated type DittoPeersObserver, please use DittoObserver instead.

Removed: deprecated DittoDocumentID method toNative(), please use property value instead.

Removed: deprecated DittoScopedWriteTransaction method find(query:), please use find() instead.

Removed: deprecated DittoScopedWriteTransaction methods insert() and insertWithStrategy(), please use upsert() and upsertWithStrategy() instead.

Removed: deprecated DittoCollection methods insert() and insertWithStrategy(), please use upsert() and upsertWithStrategy() instead.

Removed: deprecated identities development and online, please use the available ones instead.

Removed: deprecated Ditto methods setAccessLicense() and setLicenseToken(), please use setOfflineOnlyLicenseToken() instead.

Removed: deprecated Ditto method setTransportConfig(), please set the transportConfig property directly.

Removed: deprecated DittoAuthenticator method isAuthenticated() and property userID, please use status instead.

Released: Wed Aug 3, 2022, 7:54 am

This is a preview release of Ditto v2. Full changelog will be provided with the official release.

Released: Wed Jul 20, 2022, 4:55 am

Ditto v1 for Swift

Ditto v2 for Swift

linux_aarm_supported_version

android_supported_version

ipados_supported_version

ios_supported_version

windows_x64_supported_version

mac_supported_version

linux_x64_supported_version

Ditto v3 for Swift

ditto

SDK v4.4 (and earlier)

Welcome to Ditto Docs - V4.4

Onboarding

Core Components

Sync Overview

Data Structures and Types

CRUD Fundamentals

Authentication and Initialization