Repository navigation
Releases
0.1.1
Published to pub.dev as 0.1.1. Every package in this repository shares the version.
firebase_ffi
Fixed
GoogleServicesConfig.parseno longer requiresfirebase_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.databaseUrlisString?,
like the bucket beside it, andinitDatabasetakes it as optional.- Windows: linking Remote Config failed on two ICU symbols.
app/src/locale.cc
includes<icu.h>there, andGetTimezoneis reached only from Remote
Config, so no earlier Windows build had pulled the object in.icujoins 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 beforeserver_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_infoemits debug info beside the
optimized build: a PDB under MSVC,-gelsewhere. 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.
databaseURLreaches 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 stopsgoogle-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 stopsgoogle-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 stopsgoogle-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 stopsgoogle-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 stopsgoogle-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 stopsgoogle-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 stopsgoogle-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
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, andonValueas a
Stream<DbSnapshot>. - Snapshots delivered with
Dart_PostCObject_DLaskExternalTypedData, so
the SDK's buffer is read in place.firebase::Variantis serialized to a
tagged flat encoding and decoded in Dart. - Authentication on the same
firebase::Appas the database:signInAnonymously,
signInWithCustomToken,signOut,currentUid, andrestoredUidfor a
session restored from the platform secure store. Failures throw
AuthExceptioncarrying the SDK's own error code and message. GoogleServicesConfig— reads the console'sgoogle-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, usingopensslso it needs no dependencies.- Build hook driving CMake, configured through
hooks.user_defines:
firebase_sdkfor the SDK prefix (relative to the declaringpubspec.yaml)
andwith_firebase: falsefor a transport-only build. - Benchmarks for the FFI call and snapshot paths, comparing
kExternalTypedDataagainst a copying post:bin/bench.dartand
runBenchmarks().
Fixed
- The build hook reconfigures when a previous CMake configure failed partway.
CMake writesCMakeCache.txtbefore 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, thecborpackage 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'sRelease/subdirectory) and
resolves tools on PATH directly rather than shelling out towhich, 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 tog++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 throughdartPluginClass, so an app using
firebase_corereaches 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 throughdartPluginClass, so an app using
firebase_authreaches 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 throughdartPluginClass, so an app using
firebase_databasereaches 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 throughdartPluginClass, so an app using
cloud_firestorereaches 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 throughdartPluginClass, so an app using
firebase_storagereaches 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 throughdartPluginClass, so an app using
cloud_functionsreaches 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 throughdartPluginClass, so an app using
firebase_remote_configreaches 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 throughdartPluginClass, so an app using
firebase_app_checkreaches the Firebase C++ SDK unchanged.