Skip to content

Releases

0.1.1

Choose a tag to compare

@jwinarske jwinarske released this 16 Nov 18:43
9eb75d2

Published to pub.dev as 0.1.1. Every package in this repository shares the version.

firebase_ffi

Fixed

  • GoogleServicesConfig.parse no longer requires firebase_url. The console
    writes that key only once a Realtime Database exists, so a project using Auth
    or Firestore alone could not read its own config. databaseUrl is String?,
    like the bucket beside it, and initDatabase takes it as optional.
  • Windows: linking Remote Config failed on two ICU symbols. app/src/locale.cc
    includes <icu.h> there, and GetTimezone is reached only from Remote
    Config, so no earlier Windows build had pulled the object in. icu joins the
    system libraries the SDK publishes through its package config.
  • Windows: the first Realtime Database write faulted. Repo's constructor
    abandoned setup when it could not create a directory named after the database
    url — against the emulator that name holds : and ?, both reserved in NTFS
    paths — and returned before server_sync_tree_ was built, leaving a null
    member behind a Database the SDK still handed out. The cache directory is now
    worked out only when persistence is enabled, which is off here.
  • An app initialized with no database url is refused by the Database rather
    than accepting writes it can never deliver.

Added

  • hooks.user_defines.firebase_ffi.debug_info emits debug info beside the
    optimized build: a PDB under MSVC, -g elsewhere. Off by default.
  • platforms: names linux, macos and windows. pub.dev inferred android and ios
    from the imports; neither can work, and on mobile the official FlutterFire
    plugins are the implementation.

Notes

  • The binding suite runs against the emulator suite on all three desktops now,
    not only Linux. Both Windows bugs above were found that way, within an hour
    of each other.

firebase_core_ffi

Fixed

  • A project with no Realtime Database initializes. databaseURL reaches the
    binding as null rather than as an empty string, which is what the console
    writes for a project that has none.

Changed

  • Requires firebase_ffi ^0.1.1, which carries the config fix above and the
    Windows Database fix.
  • The README installs from pub.dev rather than from a path.

firebase_auth_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

firebase_database_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

cloud_firestore_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

firebase_storage_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

cloud_functions_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

firebase_remote_config_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

firebase_app_check_ffi

Changed

  • Requires firebase_ffi ^0.1.1. That release stops google-services.json
    being rejected when the project has no Realtime Database, and fixes the first
    Database write faulting on Windows.
  • The README installs from pub.dev rather than from a path.

0.1.0

Choose a tag to compare

@jwinarske jwinarske released this 16 Nov 18:43
94ab546

Published to pub.dev as 0.1.0. Every package in this repository shares the version.

firebase_ffi

First release. Prototype: the API is small and expected to change.

Added

  • Realtime Database through a single FFI code asset — no platform channel, no
    embedder plugin. initDatabase, setString, and onValue as a
    Stream<DbSnapshot>.
  • Snapshots delivered with Dart_PostCObject_DL as kExternalTypedData, so
    the SDK's buffer is read in place. firebase::Variant is serialized to a
    tagged flat encoding and decoded in Dart.
  • Authentication on the same firebase::App as the database: signInAnonymously,
    signInWithCustomToken, signOut, currentUid, and restoredUid for a
    session restored from the platform secure store. Failures throw
    AuthException carrying the SDK's own error code and message.
  • GoogleServicesConfig — reads the console's google-services.json, which is
    what desktop Linux is configured from since it has no config file of its own.
  • tool/mint_custom_token.dart — signs a Firebase custom token for a device
    uid from a service-account key, using openssl so it needs no dependencies.
  • Build hook driving CMake, configured through hooks.user_defines:
    firebase_sdk for the SDK prefix (relative to the declaring pubspec.yaml)
    and with_firebase: false for a transport-only build.
  • Benchmarks for the FFI call and snapshot paths, comparing
    kExternalTypedData against a copying post: bin/bench.dart and
    runBenchmarks().

Fixed

  • The build hook reconfigures when a previous CMake configure failed partway.
    CMake writes CMakeCache.txt before it can fail, and treating that as
    "already configured" made every later run die as
    ninja: build.ninja: No such file or directory, long after the real error.

Changed

  • The snapshot wire format is CBOR (RFC 8949) rather than a private tagged
    encoding: TinyCBOR on the native side, the cbor package on the Dart side.
    Byte strings now survive as bytes; the previous encoding had no way to
    represent them and wrote null.

  • The build hook resolves the built library by target OS (.so / .dylib /
    .dll, including a multi-config generator's Release/ subdirectory) and
    resolves tools on PATH directly rather than shelling out to which, which
    does not exist on Windows.

  • Linking the Firebase C++ SDK is guarded to Linux and refuses other platforms
    at configure time with what a port needs, rather than failing inside the
    linker. A transport-only build has no such dependencies.

Notes

  • A missing SDK fails at configure time with instructions, rather than
    producing a library that fails at runtime.
  • The build hook derives the C++ driver from the configured C compiler, and
    falls back to g++ when the toolchain's clang cannot compile C++20 against
    the system libstdc++ — Flutter's Linux desktop build pins clang 18, which
    cannot parse a GCC 16 libstdc++.
  • Tested on Linux x86-64 and aarch64 (Raspberry Pi 5) against a live project.
    Windows and macOS are untested.

firebase_core_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseCoreFfi, registered on Linux through dartPluginClass, so an app using
    firebase_core reaches the Firebase C++ SDK unchanged.

firebase_auth_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseAuthFfi, registered on Linux through dartPluginClass, so an app using
    firebase_auth reaches the Firebase C++ SDK unchanged.

firebase_database_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseDatabaseFfi, registered on Linux through dartPluginClass, so an app using
    firebase_database reaches the Firebase C++ SDK unchanged.

cloud_firestore_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • CloudFirestoreFfi, registered on Linux through dartPluginClass, so an app using
    cloud_firestore reaches the Firebase C++ SDK unchanged.

firebase_storage_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseStorageFfi, registered on Linux through dartPluginClass, so an app using
    firebase_storage reaches the Firebase C++ SDK unchanged.

cloud_functions_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • CloudFunctionsFfi, registered on Linux through dartPluginClass, so an app using
    cloud_functions reaches the Firebase C++ SDK unchanged.

firebase_remote_config_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseRemoteConfigFfi, registered on Linux through dartPluginClass, so an app using
    firebase_remote_config reaches the Firebase C++ SDK unchanged.

firebase_app_check_ffi

First release. Prototype: the API follows the platform interface, but the
binding underneath is young and what it refuses may change.

Added

  • FirebaseAppCheckFfi, registered on Linux through dartPluginClass, so an app using
    firebase_app_check reaches the Firebase C++ SDK unchanged.