Merge branch 'objectbox-c-0.19' into 'main'

Update C API to 0.19

See merge request objectbox/objectbox-dart!55

Author: greenrobot-team

dev-doc/updating-c-library.md

@@ -9,18 +9,18 @@ Dart won't error on C function signature mismatch, leading to obscure memory bug
 Update `flutter_libs` and `sync_flutter_libs` with **compatible library versions**:  
 
 - Linux and Windows
-  - Shortcut: search and replace e.g. `set(OBJECTBOX_VERSION 0.18.0)` in `CMakeLists.txt`.
+  - Shortcut: search and replace e.g. `set(OBJECTBOX_VERSION 0.19.0)` in `CMakeLists.txt`.
   - [flutter_libs Linux](../flutter_libs/linux/CMakeLists.txt)
   - [flutter_libs Windows](../flutter_libs/windows/CMakeLists.txt)
   - [sync_flutter_libs Linux](../sync_flutter_libs/linux/CMakeLists.txt)
   - [sync_flutter_libs Windows](../sync_flutter_libs/windows/CMakeLists.txt)
 - Android ([view releases](https://github.com/objectbox/objectbox-java/releases))
   ```
-  ./tool/set-android-version.sh 3.5.0
+  ./tool/set-android-version.sh 3.7.0
   ```
 - Swift (iOS/macOS) ([view releases](https://github.com/objectbox/objectbox-swift/releases))
   ```
-  ./tool/set-swift-version.sh 1.8.0
+  ./tool/set-swift-version.sh 1.9.0
   ```
 
 ## Dart bindings

flutter_libs/android/build.gradle

@@ -46,6 +46,6 @@ android {
 
     dependencies {
         // https://search.maven.org/search?q=g:io.objectbox%20objectbox-android
-        implementation "io.objectbox:objectbox-android:3.5.1"
+        implementation "io.objectbox:objectbox-android:3.7.0"
     }
 }

flutter_libs/ios/objectbox_flutter_libs.podspec

@@ -14,7 +14,7 @@ Pod::Spec.new do |s|
   s.source_files     = 'Classes/**/*'
 
   s.dependency 'Flutter'
-  s.dependency 'ObjectBox', '1.8.1'
+  s.dependency 'ObjectBox', '1.9.0'
 
   # Flutter.framework does not contain a i386 slice.
   s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES', 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'i386' }

flutter_libs/linux/CMakeLists.txt

@@ -41,7 +41,7 @@ target_link_libraries(${PLUGIN_NAME} PRIVATE PkgConfig::GTK)
 # ----------------------------------------------------------------------
 # Download and add objectbox-c prebuilt library.
 
-set(OBJECTBOX_VERSION 0.18.1)
+set(OBJECTBOX_VERSION 0.19.0)
 
 set(OBJECTBOX_ARCH ${CMAKE_SYSTEM_PROCESSOR})
 if (${OBJECTBOX_ARCH} MATCHES "x86_64")

flutter_libs/macos/objectbox_flutter_libs.podspec

@@ -14,7 +14,7 @@ Pod::Spec.new do |s|
   s.source_files     = 'Classes/**/*'
 
   s.dependency 'FlutterMacOS'
-  s.dependency 'ObjectBox', '1.8.1'
+  s.dependency 'ObjectBox', '1.9.0'
 
   s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES' }
   s.swift_version = '5.3'

flutter_libs/windows/CMakeLists.txt

@@ -47,7 +47,7 @@ set(objectbox_flutter_libs_bundled_libraries
 # ----------------------------------------------------------------------
 # Download and add objectbox-c prebuilt library.
 
-set(OBJECTBOX_VERSION 0.18.1)
+set(OBJECTBOX_VERSION 0.19.0)
 
 set(OBJECTBOX_ARCH ${CMAKE_SYSTEM_PROCESSOR})
 if (${OBJECTBOX_ARCH} MATCHES "AMD64")

install.sh

@@ -5,7 +5,7 @@ set -eu
 # It's important that the generated dart bindings and the c-api library version match. Dart won't error on C function
 # signature mismatch, leading to obscure memory bugs.
 # For how to upgrade the version see dev-doc/updating-c-library.md
-cLibVersion=0.18.1
+cLibVersion=0.19.0
 os=$(uname)
 cLibArgs="$*"
 

objectbox/CHANGELOG.md

@@ -1,5 +1,37 @@
 ## latest
 
+* **Query support for integer and floating point lists**: For integer lists (excluding byte lists)
+  greater, less and equal are supported on elements of the vector (e.g. "has element greater").
+  
+  For floating point lists greater and less queries are supported on elements of the vector
+ (e.g. "has element greater").
+
+  A simple example is a shape entity that stores a palette of RGB colors:
+  ```dart
+  @Entity()
+  class Shape {
+      @Id()
+      int id = 0;
+
+      // An array of RGB color values that are used by this shape.
+      Int32List? palette;
+  }
+  
+  // Find all shapes that use red in their palette
+  final query = store.box<Shape>()
+          .query(Shape_.palette.equals(0xFF0000))
+          .build();
+  query.findIds();
+  query.close();
+  ```
+* Update: [objectbox-c 0.19.0](https://github.com/objectbox/objectbox-c/releases/tag/v0.19.0).
+  Notably now requires glibc 2.28 or higher (and GLIBCXX_3.4.25); e.g. at least **Debian Buster 10 
+  (2019) or Ubuntu 20.04**.
+* Update: [objectbox-swift 1.9.0](https://github.com/objectbox/objectbox-swift/releases/tag/v1.9.0).
+* Update: [objectbox-android 3.7.0](https://github.com/objectbox/objectbox-java/releases/tag/V3.7.0).
+  If you are [using Admin](https://docs.objectbox.io/data-browser#setup), make sure to update to 
+  `io.objectbox:objectbox-android-objectbrowser:3.7.0`.
+
 ## 2.2.1 (2023-08-22)
 
 * Resolve an issue where not all query results are returned, when an entity constructor or property 

objectbox/example/flutter/objectbox_demo_relations/android/app/build.gradle

@@ -81,5 +81,5 @@ dependencies {
     // Add objectbox-android-objectbrowser only for debug builds.
     // Warning: when objectbox_flutter_libs updates check if version
     // needs update, e.g. check https://github.com/objectbox/objectbox-dart/releases.
-    debugImplementation("io.objectbox:objectbox-android-objectbrowser:3.5.1")
+    debugImplementation("io.objectbox:objectbox-android-objectbrowser:3.7.0")
 }

objectbox/lib/src/modelinfo/enums.dart

@@ -156,50 +156,86 @@ abstract class OBXPropertyFlags {
 
   /// Unique on-conflict strategy: the object being put replaces any existing conflicting object (deletes it).
   static const int UNIQUE_ON_CONFLICT_REPLACE = 32768;
+
+  /// 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.
+  static const int EXPIRATION_TIME = 65536;
 }
 
 abstract class OBXPropertyType {
-  /// < 1 byte
+  /// < Not a actual type; represents an uninitialized or invalid type
+  static const int Unknown = 0;
+
+  /// < A boolean (flag)
   static const int Bool = 1;
 
-  /// < 1 byte
+  /// < 8-bit integer
   static const int Byte = 2;
 
-  /// < 2 bytes
+  /// < 16-bit integer
   static const int Short = 3;
 
-  /// < 2 bytes
+  /// < 16-bit character
   static const int Char = 4;
 
-  /// < 4 bytes
+  /// < 32-bit integer
   static const int Int = 5;
 
-  /// < 8 bytes
+  /// < 64-bit integer
   static const int Long = 6;
 
-  /// < 4 bytes
+  /// < 32-bit floating point number
   static const int Float = 7;
 
-  /// < 8 bytes
+  /// < 64-bit floating point number
   static const int Double = 8;
+
+  /// < UTF-8 encoded string (variable length)
   static const int String = 9;
 
-  /// < Unix timestamp (milliseconds since 1970) in 8 bytes
+  /// < 64-bit (integer) timestamp; milliseconds since 1970-01-01 (unix epoch)
   static const int Date = 10;
+
+  /// < Relation to another entity
   static const int Relation = 11;
 
-  /// < Unix timestamp (nanoseconds since 1970) in 8 bytes
+  /// < High precision 64-bit timestamp; nanoseconds since 1970-01-01 (unix epoch)
   static const int DateNano = 12;
 
   /// < Flexible" type, which may contain scalars (integers, floating points), strings or
   /// < containers (lists and maps). Note: a flex map must use string keys.
   static const int Flex = 13;
+
+  /// < Variable sized vector of Bool values (note: each value is one byte)
+  static const int BoolVector = 22;
+
+  /// < Variable sized vector of Byte values (8-bit integers)
   static const int ByteVector = 23;
+
+  /// < Variable sized vector of Short values (16-bit integers)
   static const int ShortVector = 24;
+
+  /// < Variable sized vector of Char values (16-bit characters)
   static const int CharVector = 25;
+
+  /// < Variable sized vector of Int values (32-bit integers)
   static const int IntVector = 26;
+
+  /// < Variable sized vector of Long values (64-bit integers)
   static const int LongVector = 27;
+
+  /// < Variable sized vector of Float values (32-bit floating point numbers)
   static const int FloatVector = 28;
+
+  /// < Variable sized vector of Double values (64-bit floating point numbers)
   static const int DoubleVector = 29;
+
+  /// < Variable sized vector of String values (UTF-8 encoded strings).
   static const int StringVector = 30;
+
+  /// < Variable sized vector of Date values (64-bit timestamp).
+  static const int DateVector = 31;
+
+  /// < Variable sized vector of Date values (high precision 64-bit timestamp).
+  static const int DateNanoVector = 32;
 }