update C lib dependency to 0.15.1

Author: greenrobot

build/ci.sh

@@ -7,7 +7,7 @@ cd "${script_dir}/.." # move to project root dir
 
 args="$@"
 
-bash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-c/main/download.sh) --quiet --sync 0.15.0
+bash <(curl -s https://raw.githubusercontent.com/objectbox/objectbox-c/main/download.sh) --quiet --sync 0.15.1
 export CGO_LDFLAGS="-L$(pwd -P)/lib -Wl,-rpath -Wl,$(pwd -P)/lib"
 
 if [[ "$(uname)" == MINGW* ]]; then

install.ps1

@@ -7,7 +7,7 @@ $ErrorActionPreference = "Stop"
 # Configure supported HTTPS protocols
 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12, [Net.SecurityProtocolType]::Tls11, [Net.SecurityProtocolType]::Tls
 
-$libVersion = '0.15.0'
+$libVersion = '0.15.1'
 $libVariant = 'objectbox'  # or 'objectbox-sync'
 $downloadDir = 'download'
 $extractedLibDir = "$downloadDir\objectbox-$libVersion"

install.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-cLibVersion=0.15.0
+cLibVersion=0.15.1
 os=$(uname)
 cLibArgs="$*"
 

objectbox/objectbox-sync.h

@@ -34,7 +34,7 @@
 #include "objectbox.h"
 
 #if defined(static_assert) || defined(__cplusplus)
-static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 0,
+static_assert(OBX_VERSION_MAJOR == 0 && OBX_VERSION_MINOR == 15 && OBX_VERSION_PATCH == 1,
               "Versions of objectbox.h and objectbox-sync.h files do not match, please update");
 #endif
 
@@ -318,7 +318,7 @@ typedef struct OBX_sync_server OBX_sync_server;
 ///       E.g. a client with an incompatible model will be rejected during login.
 /// @param store_options Options for the server's store.
 ///        It is freed automatically (same as with obx_store_open()) - don't use or free it afterwards.
-/// @param uri The URI (following the pattern protocol:://IP:port) the server should listen on.
+/// @param uri The URI (following the pattern "protocol://IP:port") the server should listen on.
 ///        Supported \b protocols are "ws" (WebSockets) and "wss" (secure WebSockets).
 ///        To use the latter ("wss"), you must also call obx_sync_server_certificate_path().
 ///        To bind to all available \b interfaces, including those that are available from the "outside", use 0.0.0.0 as
@@ -383,7 +383,12 @@ OBX_C_API uint64_t obx_sync_server_connections(OBX_sync_server* server);
 /// The returned char* is valid until another call to obx_sync_server_stats_string() or the server is closed.
 OBX_C_API const char* obx_sync_server_stats_string(OBX_sync_server* server, bool include_zero_values);
 
-// TODO admin UI ("browser")
+/// Configure admin with a sync server, attaching the store and enabling custom sync-server functionality in the UI.
+/// This is a replacement for obx_admin_opt_store() and obx_admin_opt_store_path() - don't set them for the server.
+/// After configuring, this acts as obx_admin() - see for more details.
+/// You must use obx_admin_close() to stop & free resources after you're done; obx_sync_server_stop() doesn't do that.
+/// @param options configuration set up with obx_admin_opt_*. You can pass NULL to use the default options.
+OBX_C_API OBX_admin* obx_sync_server_admin(OBX_sync_server* server, OBX_admin_options* options);
 
 #ifdef __cplusplus
 }

objectbox/objectbox.h

@@ -1,5 +1,5 @@
 /*
- * Copyright 2018-2021 ObjectBox Ltd. All rights reserved.
+ * Copyright 2018-2022 ObjectBox Ltd. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -51,7 +51,7 @@ extern "C" {
 /// obx_version() or obx_version_is_at_least().
 #define OBX_VERSION_MAJOR 0
 #define OBX_VERSION_MINOR 15
-#define OBX_VERSION_PATCH 0  // values >= 100 are reserved for dev releases leading to the next minor/major increase
+#define OBX_VERSION_PATCH 1  // values >= 100 are reserved for dev releases leading to the next minor/major increase
 
 //----------------------------------------------
 // Common types
@@ -692,7 +692,9 @@ OBX_C_API OBX_store* obx_store_open(OBX_store_options* opt);
 /// Check if an open store was found for the given path (i.e. opened before and not yet closed).
 OBX_C_API bool obx_store_is_open(const char* path);
 
-/// Get a store previously opened with createShared() matching the given path of the DB directory.
+/// Attach to a previously opened store matching the path of the DB directory, which was used for opening the store.
+/// The returned store is a new instance (e.g. different pointer value) with its own lifetime and must also be closed.
+/// The actual underlying store is only closed when the last store OBX_store instance is closed.
 /// @returns nullptr if no open store was found (i.e. not opened before or already closed)
 OBX_C_API OBX_store* obx_store_attach(const char* path);
 
@@ -1829,7 +1831,7 @@ typedef struct OBX_admin OBX_admin;
 
 /// Initialize the http-server with the given options.
 /// Note: the given options are always freed by this function, including when an error occurs.
-/// @param opt required parameter holding the options (see obx_admin_opt_*())
+/// @param options required parameter holding the options (see obx_admin_opt_*())
 /// @returns NULL if the operation failed, see functions like obx_last_error_code() to get error details
 OBX_C_API OBX_admin* obx_admin(OBX_admin_options* options);
 

test/version_test.go

@@ -46,7 +46,7 @@ func TestVersion(t *testing.T) {
 		t.Errorf("ObjectBox-C version %v doesn't match expected regexp %v", versionLibString, format)
 	}
 	versionLibInt := versionLib.Major*10000 + versionLib.Minor*100 + versionLib.Patch
-	assert.True(t, versionLibInt >= 1500) // Update with new releases (won't fail if forgotten)
+	assert.True(t, versionLibInt >= 1501) // Update with new releases (won't fail if forgotten)
 	assert.True(t, versionLibInt < 10000) // Future next major release
 
 	assert.Eq(t, true, strings.Contains(versionInfo, versionGoString))