Preparing 5.3.0 release

greenrobot · greenrobot · commit 09b5ee03b168 · 2026-03-23T19:51:05.000+01:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,26 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.0 (2026-03-23)
+------------------
+* Change log level at runtime, i.e. `obx_log_level_set()`/`obx_log_level_get()`
+* New log level "trace" for most internal details
+* Log level "verbose" can now be enabled (debug log builds only)
+* **Breaking:** `OBXLogLevel` enum values changed; recompile with new header if you used these
+  (previously 10/20/30/40/50 for Verbose..Error, now 0-10 matching the runtime log level).
+* Admin: Status tab "Count and Sizes" now only counts all objects on click to preserve resources
+* Admin: Status tab "Count and Sizes" now has a sum row at the bottom
+* Admin: Status tab "System and Info" now shows additional information
+  * Process memory / RSS
+  * Database size and free disk size
+  * CPU counts and loads
+
+### Sync
+
+* Conflict resolution via sync clock and sync precedence (allows last win with custom conflict resolution)
+* Fix bad Sync client state after multiple full sync messages were interrupted
+* Fix adding indexes to Sync types
+
 5.2.0 (2026-03-06)
 ------------------
 * Admin: new "Counts and Sizes" view (via Status page) to give an overview over all types their object counts and sizes
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.2.0)
+        set(DL_VERSION 5.3.0)
 
         # 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.2.0** (2026-03-06).
+**Latest version: 5.3.0** (2026-03-23).
 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.2.0}
+version=${1:-5.3.0}
 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,26 @@
 ObjectBox C and C++ API Changelog
 =================================
 
+5.3.0 (2026-03-23)
+------------------
+* Change log level at runtime, i.e. `obx_log_level_set()`/`obx_log_level_get()`
+* New log level "trace" for most internal details
+* Log level "verbose" can now be enabled (debug log builds only)
+* **Breaking:** `OBXLogLevel` enum values changed; recompile with new header if you used these
+  (previously 10/20/30/40/50 for Verbose..Error, now 0-10 matching the runtime log level).
+* Admin: Status tab "Count and Sizes" now only counts all objects on click to preserve resources
+* Admin: Status tab "Count and Sizes" now has a sum row at the bottom
+* Admin: Status tab "System and Info" now shows additional information
+  * Process memory / RSS
+  * Database size and free disk size
+  * CPU counts and loads
+
+### Sync
+
+* Conflict resolution via sync clock and sync precedence (allows last win with custom conflict resolution)
+* Fix bad Sync client state after multiple full sync messages were interrupted
+* Fix adding indexes to Sync types
+
 5.2.0 (2026-03-06)
 ------------------
 * Admin: new "Counts and Sizes" view (via Status page) to give an overview over all types their object counts and sizes
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.2.0"
+PROJECT_NUMBER         = "5.3.0"
 
 # 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.2.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.0 # 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.2.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.0 # 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.2.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.0 # 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.2.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases
+            GIT_TAG v5.3.0 # 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 == 2 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
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 == 2 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
               "Versions of objectbox.h and objectbox-sync.hpp files do not match, please update");
 
 namespace obx {
diff --git a/include/objectbox.h b/include/objectbox.h
@@ -52,7 +52,7 @@ extern "C" {
 /// When using ObjectBox as a dynamic library, you should verify that a compatible version was linked using
 /// obx_version() or obx_version_is_at_least().
 #define OBX_VERSION_MAJOR 5
-#define OBX_VERSION_MINOR 2
+#define OBX_VERSION_MINOR 3
 #define OBX_VERSION_PATCH 0  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
@@ -196,22 +196,18 @@ OBX_C_API bool obx_has_feature(OBXFeature feature);
 // Utilities
 //----------------------------------------------
 
-/// Log level as passed to obx_log_callback.
+/// Log level used by obx_log_level_set(), obx_log_level_get(), and obx_log_callback().
+/// @note Values were changed in version 5.3 (previously 10/20/30/40/50 for Verbose..Error);
+///       update your code if you relied on the old numeric values.
 typedef enum {
-    /// Log level for verbose messages (not emitted at the moment)
-    OBXLogLevel_Verbose = 10,
-
-    /// Log level for debug messages (may be limited to special debug builds)
-    OBXLogLevel_Debug = 20,
-
-    /// Log level for info messages
-    OBXLogLevel_Info = 30,
-
-    /// Log level for warning messages
-    OBXLogLevel_Warn = 40,
-
-    /// Log level for error messages
-    OBXLogLevel_Error = 50,
+    OBXLogLevel_All = 0,      ///< Enable all log output.
+    OBXLogLevel_Trace = 1,    ///< Most detailed; typically only for short-term investigations.
+    OBXLogLevel_Verbose = 2,  ///< Very detailed; not printed by default.
+    OBXLogLevel_Debug = 3,    ///< Detailed output useful during development/debugging.
+    OBXLogLevel_Info = 4,     ///< Informational messages (default for release builds).
+    OBXLogLevel_Warn = 6,     ///< Noteworthy issues that are not necessarily errors.
+    OBXLogLevel_Error = 8,    ///< Only for "bad things happened" (e.g. internal errors).
+    OBXLogLevel_None = 10,    ///< Disable all log output.
 } OBXLogLevel;
 
 /// Callback for logging, which can be provided to store creation via options.
@@ -229,13 +225,27 @@ OBX_C_API size_t obx_db_file_size(char const* directory);
 /// Enable (or disable) debug logging for ObjectBox internals.
 /// This requires a version of the library with the DebugLog feature.
 /// You can check if the feature is available with obx_has_feature(OBXFeature_DebugLog).
+/// @Deprecated: prefer obx_log_level_set() with OBXLogLevel_Debug / OBXLogLevel_Info.
 OBX_C_API obx_err obx_debug_log(bool enabled);
 
-/// Checks if debug logs are enabled for ObjectBox internals. This depends on the availability of the DebugLog feature.
+/// Checks if debug logs are enabled for ObjectBox internals.
+/// This depends on the availability of the DebugLog feature.
 /// If the feature is available, it returns the current state, which is adjustable via obx_debug_log().
-/// Otherwise, it always returns false for standard release builds (or true if you are having a special debug version).
+/// Otherwise, it always returns false for standard release builds
+/// (or true if you are having a special debug version).
+/// @Deprecated: Prefer obx_log_level_get() and compare against OBXLogLevel_Debug.
 OBX_C_API bool obx_debug_log_enabled();
 
+/// Sets the runtime log level for ObjectBox internals.
+/// Log messages below the given level will not be printed (provided they are compiled into the library).
+/// @note Without the DebugLog feature, log messages at debug level and below are not compiled in;
+///       use obx_has_feature(OBXFeature_DebugLog) to check.
+OBX_C_API obx_err obx_log_level_set(OBXLogLevel log_level);
+
+/// Gets the current runtime log level for ObjectBox internals.
+/// @returns One of the OBXLogLevel values.
+OBX_C_API OBXLogLevel obx_log_level_get();
+
 /// Gets the number, as used by ObjectBox, of the current thread.
 /// This e.g. allows to "associate" the thread with ObjectBox logs (each log entry contains the thread number).
 OBX_C_API int obx_thread_number();
@@ -624,6 +634,21 @@ typedef enum {
     /// If a date property has this flag (max. one per entity type), the date value specifies the time by which
     /// the object expires, at which point it MAY be removed (deleted), which can be triggered by an API call.
     OBXPropertyFlags_EXPIRATION_TIME = 65536,
+
+    /// Marks a Long (64-bit integer) property as the sync clock, a "hybrid logical clock" to resolve Sync conflicts.
+    /// These clock values allow "last write wins" conflict resolution.
+    /// There can be only one sync clock per sync entity type; which is also recommended for basic conflict resolution.
+    /// For new objects, initialize a property value to 0 to reserve "a slot" in the object data.
+    /// ObjectBox Sync will update this property automatically on put operations.
+    /// As a hybrid clock, it combines a wall clock with a logical counter to compensate for some clock skew effects.
+    OBXPropertyFlags_SYNC_CLOCK = 131072,
+
+    /// Marks a Long (64-bit integer) property as the "sync precedence" to customize Sync conflict resolution.
+    /// Developer-assigned precedence values are then used to resolve conflicts via "higher precedence wins".
+    /// Defining and assigning precedence values are completely in the hands of the developer (the ObjectBox user).
+    /// There can be only one sync precedence per sync entity type.
+    /// Typically, it is combined with a sync clock, with the latter being the tie-breaker for equal precedence values.
+    OBXPropertyFlags_SYNC_PRECEDENCE = 262144,
 } OBXPropertyFlags;
 
 /// A property type of an external system (e.g. another database) that has no default mapping to an ObjectBox type.
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 == 2 && OBX_VERSION_PATCH == 0,  // NOLINT
+static_assert(OBX_VERSION_MAJOR == 5 && OBX_VERSION_MINOR == 3 && OBX_VERSION_PATCH == 0,  // NOLINT
               "Versions of objectbox.h and objectbox.hpp files do not match, please update");
 
 #ifdef __clang__
@@ -721,6 +721,13 @@ class Store {
     /// (or true if you are having a special debug version).
     static bool debugLogEnabled() { return obx_debug_log_enabled(); }
 
+    /// Sets the runtime log level for ObjectBox internals.
+    /// @throws Exception if the call fails (e.g. level out of range).
+    static void logLevelSet(OBXLogLevel level) { internal::checkErrOrThrow(obx_log_level_set(level)); }
+
+    /// Gets the current runtime log level for ObjectBox internals.
+    static OBXLogLevel logLevelGet() { return obx_log_level_get(); }
+
     /// Delete the store files from the given directory
     static void removeDbFiles(const std::string& directory) {
         internal::checkErrOrThrow(obx_remove_db_files(directory.c_str()));

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.2.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
	`20`	`+ GIT_TAG v5.3.0 # For latest versions, check https://github.com/objectbox/objectbox-c/releases`
`21`	`21`	`)`
`22`	`22`	`FetchContent_MakeAvailable(objectbox)`
`23`	`23`