git2dart_binaries 1.14.0

Dart bindings to libgit2, provides ability to use libgit2 library in Dart and Flutter.

git2dart binaries

Dart bindings to libgit2

git2dart package provides ability to use libgit2 in Dart/Flutter.

Managed libgit2 lifecycle

The package owns native-library discovery and one checked libgit2 increment per Dart isolate. Use libgit2Runtime instead of constructing a second loader or calling the generated lifecycle methods directly:

import 'package:git2dart_binaries/git2dart_binaries.dart';

final features = libgit2Runtime.withCall(
  (bindings) => bindings.git_libgit2_features(),
);

final owner = libgit2Runtime.acquireOwner(debugLabel: 'repository');
owner.bindDestructor(() {
  // Destroy the native owner here.
});

owner.release(); // exact-once; fallback finalization uses the same token
final remainingNativeOwners = libgit2Runtime.shutdown();

shutdown() is synchronous, guarded by live calls/owners, idempotent after success, and terminal for the calling isolate. A positive return value is valid when another isolate or external native consumer still owns an increment.

The generated Libgit2.git_libgit2_init() and Libgit2.git_libgit2_shutdown() methods remain available as raw ABI, but direct consumer calls are unsupported because they bypass package accounting. The former eager libgit2 and libgit2Opts globals were removed intentionally; backward source compatibility is not provided.

Ffigen

To generate bindings with ffigen use (adjust paths to yours):

dart run ffigen --compiler-opts "-I/path/to/git2dart/libgit2/headers/ -I/lib64/clang/12.0.1/include"

Validation evidence

The validation suite distinguishes evidence instead of treating an unavailable native prerequisite as a pass:

• Host-independent tests execute the cache-manifest and platform-proof CLIs, Android TLS state transitions, the exact-pinned analyzer AST policy, and the parsed workflow graph.
• Native ABI, loader, and expanded-package tests require an explicitly injected binding and matching platform payload. A missing payload is reported as unavailable; it is not native success.
• The build_package workflow is authoritative for same-run evidence. It downloads the generated binding and Linux payload, assembles a disposable package bundle, compiles a clean public consumer, and loads the bundled native library before publish dry-run or publication can be eligible.

Focused local commands:

flutter test -j 1 test/native_cache_manifest_cli_test.dart test/platform_release_proof_test.dart
flutter test -j 1 test/android_ssl_helper_test.dart test/android_ssl_helper_diagnostic_test.dart
flutter test -j 1 test/architecture_policy_ast_test.dart test/workflow_policy_graph_test.dart
flutter test -j 1 test/package_consumer_bundle_test.dart
flutter analyze

Set GIT2DART_FIXTURE_PACKAGE_ROOT only to an explicit expanded fixture package when running local consumer/native proof. CI does not use a global-cache or checkout fallback: its bundle inputs come from artifacts produced by that run.

Licence

MIT. See LICENSE file for more information.