Release Notes
Swift
4 9 2 version release release date dec 19, 2024 no swift specific changes 4 9 1 version release release date dec 13, 2024 4 9 1 swift specific changes 🛠️ fixed a retain cycle with ditto diskusage that could prevent ditto from shutting down (#sdk 237) 4 9 1 common changes 🛠️ fixed ios 18 crashes related to bluetooth le are now resolved (#15351) 🛠️ fixed disk usage stats are now reported in small peer info on android devices 4 9 0 version release release date nov 21, 2024 4 9 0 swift specific changes ➕ added a warning to the legacy livequerypublisher api docs noting that it also creates a new ditto subscription (#14052) 🛠️ fixed not releasing l2cap resources on bluetooth poweredoff caused resource exhaustion (#14344) ❗️🗑️ removed (experimental) e xperimental bus apis, including dittoswifterror buserror and dittoswifterror buserrorreason (#13715) 4 9 0 logging clarity improvements this release comes with a number of logging clarity improvements the goal of these changes are to make ditto logs more consumable and actionable for end users while there are wide ranging changes one of the principal goals of this work is to make our info level logs contain the right information to understand the state and health of the ditto sdk more information is included when physical connections start and end (such as the type of connection and the remote peer’s key) devices that try to connect to themselves now say “device has connected to itself” instead of an error about the remote site id being the same as the local peer authentication client logs have been made more human readable in particular recoverable errors are logged together with information about the recovery actions that are being undertaken several abbreviations have been replaced with human readable descriptions errors are printed using their descriptions rather than by dumping debug representations abbreviated jargon has been replaced with clearer wording in various log lines “phy ended” has become “physical connection ended” “error getting char” has become “required ditto ble characteristic not found” “error getting radio state” has become “error getting windows bluetooth radio state” peer events that represent a transport starting or stopping are now logged with the message “transport started”/”transport ended” rather than as a raw peer event= log reduced the noisiness of “starting” log lines around ditto initialization time noise from long peer keys in logs has been reduced in some places by replacing them with their truncated form noise from duplicated peer id/peer key information in replication logs has been reduced by consolidating the information “starting compression and export” is now followed by a “completed export” log at the same level successful sqlite wal recovery logs were further lowered from info to debug 4 9 0 common changes ➕ added regexp like function in dql (#12129) ➕ added peer metadata and identity service metadata to the small peer info document (#12477) ➕ added websocket connections now send x ditto peerpubkey and x ditto routing hint headers as part of the client connect handshake on all platforms except wasm32 (#13171) ➕ added small peer info now includes information about the current logger configuration (#14317) ➕ added permission rules can be written in dql (#14563) ➕ added ditto logs clearly indicate if a device has established a connection to itself (#14634) ➕ added the ability for dql select statement to produce arbitrary projection lists (#7979) ➕ added local subscription info to small peer info (#9412) ➕ added "device disk usage" information to small peer info (#9784) ➕ added "store" information to small peer info (#9785) ⭐️❗️🔄 changed internal sync metadata format changed peers that downgrade to a previous sdk version after upgrading may require full resynchronization (#14799) 🔄 changed improved (de)serialization performance and reduced its contribution to the library size (#11545) 🔄 changed in updated replication protocol, verification of a received update file no longer requires both peers to use the same approach to subscription hashing (#12672) 🔄 changed experimental multihop connectivity is more resilient to mesh disruptions (#13648) 🔄 changed synchronization protocol enhanced to reduce the amount of redundant data sent from small peers to big peers (#13737) 🔄 changed failed certificate verification due to a lagging device clock now results in a clearer error message (#14035) 🔄 changed multicast peer to peer transport is no longer deprecated to improve support for environments where mdns is unavailable (#14188) 🔄 changed replication no longer redundantly re transmits unchanged subscriptions after eviction (#14290) 🔄 changed truncated peer keys are now logged in lieu of site ids (#14362) 🔄 changed improved logging in the authentication code to provide more useful error context (#15038) 🔄 changed made the small peer "log request" feature much more responsive (#9777) 🛠️ fixed windows p2p lan now can connect to ipv6 peers (#11468) 🛠️ fixed in certain rare cases, resetting the same replication session multiple times could cause failure to converge (#12616) 🛠️ fixed internal connection tls caches are now bounded in size this prevents a long living peer from holding onto more memory than required (#13801) 🛠️ fixed small peer info "metadata" is now persisted across app launches (#13987) 🛠️ fixed bluetooth peers are handled better when disconnections occur, fixing a possible loop where a device might repeatedly try and fail to connect (#14018) 🛠️ fixed when replication sessions time out, write transactions on the document store may be blocked for a long period (#14148) 🛠️ fixed multicast peer to peer transport (non mdns) is no longer influenced by tcp listen configuration in dittotransportconfig (#14187) 🛠️ fixed an issue preventing attachment transfers under high document sync load is now resolved (#14189) 🛠️ fixed a race condition that could cause attachments to unexpectedly crash under heavy load (#14342) 🛠️ fixed device name no longer incorrectly defaults to "ditto" in small peer info, when a named device first starts syncing (#14674) 🛠️ fixed presence observers are now less likely to fire when there is no observable change to presence data (#14807) 🛠️ fixed logs report blocked by="no blocking transaction" when blocking transaction is known (#14966) 🛠️ fixed in band authentication data is now cleared on logout (#15039) 🛠️ fixed switching appids now invalidates cached authentication material correctly (#15040) 🛠️ fixed transport conditions are now reported for a wider range of failures when starting bluetooth and mdns transports (#8729) 🛠️ fixed documentation for the stopsync() method to clarify that the ditto store can be used locally after stopping sync (#8849) 🛠️ fixed auth client would hang when cached x 509 was expired (#15110) ⚠️ deprecated ❗️🗑️ removed