Preparing 5.3.2 release

greenrobot · greenrobot · commit d701b03ff680 · 2026-05-05T10:32:28.000+02:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,11 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.2 (2026-05-05)
+------------------
+* Fixed a corner case with "unique replace on conflict" and absent (e.g. null) sync clock value
+* Internal fixes and improvements
+
 5.3.1 (2026-03-26)
 ------------------
 * Critical fix for sync clock handling without preset clock values (null)
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -55,7 +55,7 @@ else ()
 
     function(defineObjectBoxLib VARIANT)
         # Configuration updated for each release
-        set(DL_VERSION 5.3.1)
+        set(DL_VERSION 5.3.2)
 
         # Platform detection and other setup
         set(DL_URL https://github.com/objectbox/objectbox-c/releases/download)
diff --git a/README.md b/README.md
@@ -18,7 +18,7 @@ box.put({.text = "Buy milk"});
 
 See [ObjectBox C and C++ docs](https://cpp.objectbox.io/) for API details.
 
-**Latest version: 5.3.1** (2026-03-26).
+**Latest version: 5.3.2** (2026-05-05).
 See [changelog](CHANGELOG.md) for more details.
 
 ## Table of Contents:
diff --git a/download.sh b/download.sh
@@ -44,7 +44,7 @@ tty -s || quiet=true
 
 # Note: optional arguments like "--quiet" shifts argument positions in the case block above
 
-version=${1:-5.3.1}
+version=${1:-5.3.2}
 os=${2:-$(uname)}
 arch=${3:-$(uname -m)}
 echo "Base config: OS ${os} and architecture ${arch}"
diff --git a/doxygen/Changelog.md b/doxygen/Changelog.md
@@ -3,6 +3,11 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.2 (2026-05-05)
+------------------
+* Fixed a corner case with "unique replace on conflict" and absent (e.g. null) sync clock value
+* Internal fixes and improvements
+
 5.3.1 (2026-03-26)
 ------------------
 * Critical fix for sync clock handling without preset clock values (null)
diff --git a/doxygen/Doxyfile b/doxygen/Doxyfile
@@ -38,7 +38,7 @@ PROJECT_NAME           = "ObjectBox C and C++ API"
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = "5.3.1"
+PROJECT_NUMBER         = "5.3.2"
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
diff --git a/examples/c-tasks-lowlevel/CMakeLists.txt b/examples/c-tasks-lowlevel/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.2 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/c-tasks/CMakeLists.txt b/examples/c-tasks/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.2 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/tasks/CMakeLists.txt b/examples/tasks/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.2 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/examples/vectorsearch-cities/CMakeLists.txt b/examples/vectorsearch-cities/CMakeLists.txt
@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre
     FetchContent_Declare(
             objectbox
             GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git
-            GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.2 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
     )
     FetchContent_MakeAvailable(objectbox)
 
diff --git a/include/objectbox-sync.h b/include/objectbox-sync.h
@@ -34,7 +34,7 @@
 #include "objectbox.h"
 
 #if defined(static_assert) || defined(__cplusplus)
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 2,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
@@ -362,8 +362,7 @@ OBX_C_API obx_err obx_sync_trigger_reconnect(OBX_sync* sync);
 /// To detect disconnects early on the client side, you can also use heartbeats with a smaller interval.
 /// Use with caution, setting a low value (i.e. sending heartbeat very often) may cause an excessive network usage
 /// as well as high server load (with many clients).
-/// @param interval_ms interval in milliseconds; the default is 25 minutes (1 500 000 milliseconds),
-///        which is also the allowed maximum.
+/// @param interval_ms interval in milliseconds; the default value is between 4 and 5 minutes.
 /// @returns OBX_ERROR_ILLEGAL_ARGUMENT if value is not in the allowed range, e.g. larger than the maximum (1 500 000).
 OBX_C_API obx_err obx_sync_heartbeat_interval(OBX_sync* sync, uint64_t interval_ms);
 
@@ -641,6 +640,10 @@ OBX_C_API obx_err obx_sync_server_add_cluster_peer(OBX_sync_server* server, cons
                                                    OBXSyncCredentialsType credentials_type, const void* credentials,
                                                    size_t credentials_size, uint32_t flags);
 
+/// Enables schema version validation for clients during login; must be called before start.
+/// Strict validation rejects clients during login that use different schema versions.
+OBX_C_API obx_err obx_sync_server_client_schema_validation_strict(OBX_sync_server* server);
+
 /// Set or overwrite a previously set 'change' listener - provides information about incoming changes.
 /// @param listener set NULL to reset
 /// @param listener_arg is a pass-through argument passed to the listener
diff --git a/include/objectbox-sync.hpp b/include/objectbox-sync.hpp
@@ -21,7 +21,7 @@
 #include "objectbox-sync.h"
 #include "objectbox.hpp"
 
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 2,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.hpp files do not match, please update");
 
 namespace obx {
@@ -377,8 +377,8 @@ class SyncClient : public Closable {
 
     /// Adds or replaces a sync filter variable value for the given name to the sync client.
     /// Eventually existing values for the same name are replaced.
-    /// Client filter variables can be used in server-side sync filters to filter out objects that do not match the filter.
-    /// Filter variables can be set in two states:
+    /// Client filter variables can be used in server-side sync filters to filter out objects that do not match the
+    /// filter. Filter variables can be set in two states:
     ///  1) Added before login, e.g. before obx_sync_start() or setting credentials (no "apply" activation required).
     ///  2) After a login, updates to sync filter variables are staged and are "pending" until
     ///     obx_sync_filter_variables_apply() is called.
@@ -430,7 +430,7 @@ class SyncClient : public Closable {
     /// To detect disconnects early on the client side, you can also use heartbeats with a smaller interval.
     /// Use with caution, setting a low value (i.e. sending heartbeat very often) may cause an excessive network usage
     /// as well as high server load (when there are many connected clients).
-    /// @param interval default value is 25 minutes (1 500 000 milliseconds), which is also the allowed maximum.
+    /// @param interval the default value is between 4 and 5 minutes.
     /// @throws IllegalArgumentException if value is not in the allowed range, e.g. larger than the maximum (1 500 000).
     void setHeartbeatInterval(std::chrono::milliseconds interval) {
         internal::checkErrOrThrow(obx_sync_heartbeat_interval(cPtr(), static_cast<uint64_t>(interval.count())));
@@ -787,8 +787,7 @@ class Sync {
     /// Before start(), you can still configure some aspects of the sync client, e.g. its "request update" mode.
     /// @note While you may not interact with SyncClient directly after start(), you need to hold on to the object.
     ///       Make sure the SyncClient is not destroyed and thus synchronization can keep running in the background.
-    static std::shared_ptr<SyncClient> client(Store& store, const std::string& serverUrl,
-                                              const SyncCredentials& creds);
+    static std::shared_ptr<SyncClient> client(Store& store, const std::string& serverUrl, const SyncCredentials& creds);
 
     /// Creates a SyncBuilder to configure and build a sync client for the given store.
     /// Use the builder's fluent API to add URLs, certificates, credentials, and flags, then call build().
@@ -1041,6 +1040,11 @@ class SyncServer : public Closable {
         internal::checkErrOrThrow(obx_sync_server_history_max_size_in_kb(cPtr(), maxSizeKb, targetSizeKb));
     }
 
+    /// Enables schema version validation for clients during login; must be called before start().
+    void clientSchemaValidationStrict() {
+        internal::checkErrOrThrow(obx_sync_server_client_schema_validation_strict(cPtr()));
+    }
+
     /// Once the sync server is configured, you can "start" it to start accepting client connections.
     /// This method triggers communication in the background and will return immediately.
     void start() { internal::checkErrOrThrow(obx_sync_server_start(cPtr())); }
diff --git a/include/objectbox.h b/include/objectbox.h
@@ -53,7 +53,7 @@ extern "C" {
 /// obx_version() or obx_version_is_at_least().
 #define OBX_VERSION_MAJOR 5
 #define OBX_VERSION_MINOR 3
-#define OBX_VERSION_PATCH 1  // values >= 100 are reserved for dev releases leading to the next minor/major increase
+#define OBX_VERSION_PATCH 2  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
 // Common types
diff --git a/include/objectbox.hpp b/include/objectbox.hpp
@@ -36,7 +36,7 @@
 #include <optional>
 #endif
 
-static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 1,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 2,  // NOLINT
               "Versions of objectbox.h and objectbox.hpp files do not match, please update");
 
 #ifdef __clang__

Original file line number	Diff line number	Diff line change
`@@ -17,7 +17,7 @@ if (NOT TARGET objectbox) # Using "if" in case a (potential) parent project alre`
`17`	`17`	`FetchContent_Declare(`
`18`	`18`	`objectbox`
`19`	`19`	`GIT_REPOSITORY https://github.com/objectbox/objectbox-c.git`
`20`		`- GIT_TAG v5.3.1 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
	`20`	`+ GIT_TAG v5.3.2 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
`21`	`21`	`)`
`22`	`22`	`FetchContent_MakeAvailable(objectbox)`
`23`	`23`