Merge branch 'release-4.2.0'

Author: greenrobot-team

CONTRIBUTING.md

@@ -1,22 +1,24 @@
-Contributing
-------------------
-This project is completely managed on GitHub using its [issue tracker](https://github.com/objectbox/objectbox-dart/issues).
+# Contributing
 
-Anyone can contribute, be it by coding, improving docs or just proposing a new feature. 
+For public issues see the [GitHub issue tracker](https://github.com/objectbox/objectbox-dart/issues).
+
+We welcome smaller contributions, be it by coding, improving docs or just proposing a new feature. 
 Look for tasks having a [**"help wanted"**](https://github.com/objectbox/objectbox-dart/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) tag. 
-When picking up an existing issue, please let us know in the issue comment. 
+When picking up an existing issue, please talk to us beforehand by commenting in the issue. 
 Don't hesitate to reach out for guidance or to discuss a solution proposal!
 
-### Code contributions
+## Code contributions
+
 When creating a Pull Request for code changes, please check that you cover the following:
-* Include tests for the changes you introduce. See the [test folder](objectbox/test) for examples.
-* Formatted the code using `dartfmt -l 120`. You can configure your IDE to do this automatically, 
-  e.g. VS Code needs the project-specific settings `"editor.defaultFormatter": "Dart-Code.dart-code"` and `"dart.lineLength": 120`.
-* Update the `## latest` section in the `CHANGELOG.md` - add a single-line comment what changes.
-  This only applies if the change is "external", i.e. it affects objectbox-dart library users.
 
-### Basic technical approach
+- Include tests for the changes you introduce. See the [test package](objectbox_test) for examples.
+- Formatted your changes using `dart format`.
+- If the change affects users of this library, update the `## latest` section in the `CHANGELOG.md` 
+  by adding a single-line comment what changes.
+
+## Basic technical approach
+
 ObjectBox offers a [C API](https://github.com/objectbox/objectbox-c) which can be called by [Dart FFI](https://dart.dev/server/c-interop).
 The C API is also used by the ObjectBox language bindings for [Go](https://github.com/objectbox/objectbox-go), [Swift](https://github.com/objectbox/objectbox-swift), and [Python](https://github.com/objectbox/objectbox-python).
 These languages may serve as an inspiration for this Dart implementation.
-Internally, ObjectBox uses [FlatBuffers](https://google.github.io/flatbuffers/) to store objects.
+Internally, ObjectBox uses [FlatBuffers](https://google.github.io/flatbuffers/) to store objects.

README.md

@@ -12,8 +12,8 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/objectbox/objectbox-dart/actions/workflows/dart.yml">
-    <img src="https://github.com/objectbox/objectbox-dart/actions/workflows/dart.yml/badge.svg" alt="Build and test">
+  <a href="https://github.com/objectbox/objectbox-dart/actions/workflows/test.yml">
+    <img src="https://github.com/objectbox/objectbox-dart/actions/workflows/test.yml/badge.svg" alt="Build and test">
   </a>
   <a href="https://pub.dev/packages/objectbox">
     <img src="https://img.shields.io/pub/v/objectbox.svg?label=pub.dev&logo=dart&style=flat-square" alt="pub.dev package">
@@ -25,8 +25,6 @@
 
 # Flutter database with vector support - easy to use & fast Dart object persistence, plus on-device vector search 💙
 
-
-
 Very first on-device vector database for Flutter / Dart AI apps. Intuitive APIs, simply fast. 
 Persist local Dart objects with ease & speed, efficiently manage vectors.
 
@@ -63,6 +61,7 @@ final query = box           // Query
 final List<Person> people = query.find();
 query.close();
 ```
+
 Ready? Continue with the ➡️ **[Getting Started guide](https://docs.objectbox.io/getting-started)**.
 
 ## Why use ObjectBox
@@ -78,6 +77,7 @@ Plus: We built a data synchronization solution that allows you to keep data in s
 and servers, both online and offline.
 
 ### Features
+
 🏁 **Very first [on-device vector database](https://docs.objectbox.io/on-device-ann-vector-search)** - for AI apps that work any place.\
 
 🏁 **High performance** - superfast response rates enabling real-time applications.\
@@ -95,7 +95,6 @@ Oh, and there is one more thing...
 
 😮 [**Data Sync**](https://objectbox.io/sync/) - keeps data in sync offline or online, between devices and servers.
 
-
 ## Getting Started
 
 Continue with our ➡️ **[Getting Started guide](https://docs.objectbox.io/getting-started)**. It has resources and video tutorials on how to use ObjectBox in your Flutter or Dart app.
@@ -110,7 +109,7 @@ Continue with our ➡️ **[Getting Started guide](https://docs.objectbox.io/get
 
 We tested across the four main database operations, CRUD (create, read, update, delete). Each test was run multiple times and executed  manually outside of the measured time. Data preparation and evaluation were done outside of the measured time. 
 
-Here are the benchmarks for ObjectBox vs sqflite vs Hive 👇
+Here are the benchmarks for ObjectBox vs sqflite vs Hive (last updated 2021-09-11) 👇
 
 ![](https://raw.githubusercontent.com/objectbox/objectbox-dart/main/.github/benchmarks.png)
 
@@ -135,19 +134,21 @@ For general news on ObjectBox, [check our blog](https://objectbox.io/blog)!
 Do you want to check out the ObjectBox code itself? E.g. see in action, run tests, or even contribute code?
 Great! Clone/check out this repository and run this to generate code and get you started quickly:
 
-    ./tool/init.sh
+```bash
+./tool/init.sh
+```
 
 Also, make sure to have a look at the [contribution guidelines](CONTRIBUTING.md) - we are looking forward to your contribution.
 
 ## Packages
 
 This repository holds all ObjectBox Dart/Flutter packages as separate directories:
 
-* [objectbox](objectbox) - main library code
-* [objectbox_generator](generator) - code generator
-* [objectbox_flutter_libs](flutter_libs) - core binary library dependency for Flutter (Android/iOS) - no dart/flutter code
-* [objectbox_sync_flutter_libs](sync_flutter_libs) - core binary library dependency with [**ObjectBox Sync**](https://objectbox.io/sync/) enabled
-* [benchmark](benchmark) - used internally to microbenchmark and compare various implementations during development of objectbox-dart
+- [objectbox](objectbox) - main library code
+- [objectbox_generator](generator) - code generator
+- [objectbox_flutter_libs](flutter_libs) - core binary library dependency for Flutter (Android/iOS) - no dart/flutter code
+- [objectbox_sync_flutter_libs](sync_flutter_libs) - core binary library dependency with [**ObjectBox Sync**](https://objectbox.io/sync/) enabled
+- [benchmark](benchmark) - used internally to microbenchmark and compare various implementations during development of objectbox-dart
 
 There's also a separate repository benchmarking objectbox (and other databases) in Flutter: 
 [objectbox-dart-performance](https://github.com/objectbox/objectbox-dart-performance). And another one testing and 
@@ -157,11 +158,10 @@ comparing the performance of our FlatBuffers fork vs the upstream version: [flat
 
 ObjectBox supports multiple platforms and languages: 
 
-* [Java Database](https://github.com/objectbox/objectbox-java) (+ Kotlin): runs on Android, desktop, and servers.
-* [Swift Database](https://github.com/objectbox/objectbox-swift): build fast mobile apps for iOS and macOS.
-* [Go Database](https://github.com/objectbox/objectbox-go): great for data-driven tools and embedded server applications.
-* [C / C++ Database](https://github.com/objectbox/objectbox-c): native speed with zero copy access to FlatBuffer objects.
-
+- [Java Database](https://github.com/objectbox/objectbox-java) (+ Kotlin): runs on Android, desktop, and servers.
+- [Swift Database](https://github.com/objectbox/objectbox-swift): build fast mobile apps for iOS and macOS.
+- [Go Database](https://github.com/objectbox/objectbox-go): great for data-driven tools and embedded server applications.
+- [C / C++ Database](https://github.com/objectbox/objectbox-c): native speed with zero copy access to FlatBuffer objects.
 
 ## License
 

benchmark/README.md

@@ -11,8 +11,11 @@ Also see the full-application benchmark in https://github.com/objectbox/objectbo
 which provides a better picture of the potential "real world" performance.
 
 ## Compile for production
+
 To get the most optimized version, build executables instead of running on Dart VM, for example:
 
-`dart compile exe bin/basics.dart`
+```bash
+dart compile exe bin/basics.dart
+```
 
 See https://dart.dev/tools/dart-compile for more options.

flutter_libs/pubspec.yaml

@@ -3,7 +3,7 @@ description: Superfast NoSQL Flutter / Dart database. This package contains Flut
 # Link to actual directory in repository so file links on pub.dev work.
 repository: https://github.com/objectbox/objectbox-dart/tree/main/flutter_libs
 homepage: https://objectbox.io
-version: 4.1.0
+version: 4.2.0
 
 environment:
   sdk: '>=2.18.0 <4.0.0'
@@ -14,7 +14,7 @@ dependencies:
     sdk: flutter
   # This is here just to ensure compatibility between objectbox-dart code and the libraries used
   # You should still depend on objectbox directly in your Flutter application.
-  objectbox: 4.1.0
+  objectbox: 4.2.0
   path_provider: ^2.0.0
 
 dev_dependencies:

generator/lib/src/version.dart

@@ -4,5 +4,5 @@ class Version {
   ///
   /// This string is updated by the /tool/set-version.sh script
   /// as part of the release process.
-  static const String current = "4.1.0";
+  static const String current = "4.2.0";
 }

generator/pubspec.yaml

@@ -3,13 +3,13 @@ description: ObjectBox Flutter / Dart database binding code generator - finds an
 # Link to actual directory in repository so file links on pub.dev work.
 repository: https://github.com/objectbox/objectbox-dart/tree/main/generator
 homepage: https://objectbox.io
-version: 4.1.0
+version: 4.2.0
 
 environment:
   sdk: '^3.5.0' # analyzer 6.5.0 requires meta 1.14.0 requires Flutter SDK 3.24.0 requires 3.5.0
 
 dependencies:
-  objectbox: 4.1.0
+  objectbox: 4.2.0
   analyzer: '>=6.5.0 <8.0.0' # dart_style 2.3.7 requires 6.5.0
   build: ^2.4.1
   collection: ^1.18.0 # Would require 1.19.1, but Flutter 3.24.0 has 1.18.0 pinned

objectbox/CHANGELOG.md

@@ -1,9 +1,11 @@
 ## latest
 
-* Allow analyzer 7, dart_style 3, source_gen 2 and pointycastle 4.
+## 4.2.0 (2025-04-15)
+
+* Requires at least Dart SDK 3.4 or Flutter SDK 3.22.
+* Allow analyzer 7, dart_style 3, source_gen 2 and pointycastle 4. [#705](https://github.com/objectbox/objectbox-dart/issues/705)
 * Examples: demos are compatible with JDK 21 included with Android Studio Ladybug or later, require
   Flutter SDK 3.24 (with Dart SDK 3.5) or newer.
-* Requires at least Dart SDK 3.4 or Flutter SDK 3.22.
 * Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to [4.2.0](https://github.com/objectbox/objectbox-c/releases/tag/v4.2.0).
 * Update ObjectBox database for Flutter Android apps to 4.2.0.
   If your project is [using Admin](https://docs.objectbox.io/data-browser#admin-for-android), make

objectbox/README.md

@@ -10,8 +10,8 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/objectbox/objectbox-dart/actions/workflows/dart.yml">
-    <img src="https://github.com/objectbox/objectbox-dart/actions/workflows/dart.yml/badge.svg" alt="Build and test">
+  <a href="https://github.com/objectbox/objectbox-dart/actions/workflows/test.yml">
+    <img src="https://github.com/objectbox/objectbox-dart/actions/workflows/test.yml/badge.svg" alt="Build and test">
   </a>
   <a href="https://pub.dev/packages/objectbox">
     <img src="https://img.shields.io/pub/v/objectbox.svg?label=pub.dev&logo=dart&style=flat-square" alt="pub.dev package">
@@ -49,6 +49,7 @@ Oh, and there is one more thing...
 😮 [**Data Sync**](https://objectbox.io/sync/) - sync only when and where needed.
 
 ## On this page
+
 - [Sneak peek](#sneak-peek---persist-dart-objects-with-objectbox)
 - [Getting Started](#getting-started)
 - [Flutter Database Performance Benchmarks](#flutter-database-performance-benchmarks)
@@ -102,6 +103,7 @@ Read the ➡️ **[Getting Started guide](https://docs.objectbox.io/getting-star
 It has resources and video tutorials on how to use ObjectBox in your Flutter or Dart app.
 
 We also have some video tutorials, each featuring a different example app: 
+
 - [Shop order app](https://youtu.be/AxYbdriXKI8)
 - [Restaurant: chef and order apps](https://youtu.be/r9Lc2r22KBk)
 - [Task-list app (in Spanish)](https://youtu.be/osUq6B92-BY)
@@ -111,7 +113,7 @@ We also have some video tutorials, each featuring a different example app:
 
 We tested across the four main database operations, CRUD (create, read, update, delete). Each test was run multiple times and executed  manually outside of the measured time. Data preparation and evaluation were also done outside of the measured time. 
 
-Here are the benchmarks for ObjectBox vs sqflite vs Hive 👇
+Here are the benchmarks for ObjectBox vs sqflite vs Hive (last updated 2021-09-11) 👇
 
 ![](https://raw.githubusercontent.com/objectbox/objectbox-dart/main/.github/benchmarks.png)
 
@@ -140,8 +142,8 @@ See the [FAQ](https://docs.objectbox.io/faq) and [Troubleshooting](https://docs.
 
 ## See also
 
-* [Changelog](CHANGELOG.md)
-* [Contribution guidelines](../CONTRIBUTING.md)
+- [Changelog](CHANGELOG.md)
+- [Contribution guidelines](../CONTRIBUTING.md)
 
 ## License
 

objectbox/example/dart-native/vectorsearch_cities/pubspec.yaml

@@ -6,7 +6,7 @@ environment:
   sdk: ^2.18.6
 
 dependencies:
-  objectbox: ^4.1.0
+  objectbox: ^4.2.0
 
 dev_dependencies:
   build_runner: ^2.4.9

objectbox/example/flutter/event_management_tutorial/event_manager/pubspec.yaml

@@ -12,7 +12,7 @@ dependencies:
   flutter:
     sdk: flutter
 
-  objectbox: ^4.1.0
+  objectbox: ^4.2.0
   objectbox_flutter_libs: any
   intl: any