Flutter / Dart

dart:ffi wrapper. Desktop needs the C ABI next to the app. iOS links Nuvexa.xcframework. Android ships libnuvexa.so in the APK.

From NuvexaDB v1.0.6:

The Flutter zip contains nuvexadb-flutter-1.0.6.tgz (pubspec.yaml + lib/). The Dart sources do not change by RID; the native zip must match the device.

flutter create acme_store
cd acme_store

Unpack nuvexadb-flutter-1.0.6.tgz to a sibling folder. In pubspec.yaml:

dependencies:
  nuvexadb:
    path: ../nuvexadb-flutter

Desktop / tests:

export NUVEXA_NATIVE_LIB="/absolute/path/to/libnuvexa.dylib"

iOS: add Nuvexa.xcframework to the Xcode Runner target; the Dart library uses DynamicLibrary.process().

Android: place libnuvexa.so at android/app/src/main/jniLibs/arm64-v8a/libnuvexa.so (or consume the published AAR). The loader then opens libnuvexa.so.

flutter pub get

import 'package:nuvexadb/nuvexadb.dart';

final path = 'app.nvx';
final db = NuvexaDatabase.create(path, key: key);
// ...
db.close();

if (NuvexaDatabase.isEncrypted(path) && key == null) {
  throw StateError('Encrypted .nvx — pass key');
}
final opened = NuvexaDatabase.open(path, key: key);
opened.close();

On a phone, use path_provider application-documents or support directory, not the project folder.

db.close();
File(path).deleteSync();
final wal = File('$path-wal');
if (wal.existsSync()) wal.deleteSync();

db.insert('users', '{"name":"Ada","age":36}');
print(db.listCollections());
db.renameCollection('users', 'people');
db.dropCollection('people');

final id = db.insert('users', '{"name":"Ada","age":36}');
db.insertMany('users', '[{"name":"Grace","age":85}]');
final ada = db.findById('users', id);
db.replace('users', '{"_id":"$id","name":"Ada Lovelace","age":36}');
db.deleteById('users', id);
final rows = db.execute(r'db.users.find({ age: { $gte: 21 } }).limit(20)');

On mobile, keep the key in the platform secure store (flutter_secure_storage or equivalent). Do not bake 1234 into Dart source.

db.changeEncryptionKey(currentKey, nextKey);

See Encryption notes.