v6.2.1 Dart & Flutter · MIT-lizenziert

Dependency Injection,
zur Build-Zeit verdrahtet.

Ein schlanker, einfach zu verwendender Dependency-Injection-Container-Builder für Dart. Annotiere deine Services mit @Service und überlasse build_runner das Generieren des Containers.

$ dart pub add catalyst_builder catalyst_builder_contracts
lib/main.dart
import 'package:catalyst_builder/catalyst_builder.dart';
import 'main.catalyst_builder.plugin.g.dart';

@Service()
class ApiClient {
  ApiClient(this.config);
  final AppConfig config;
}

@GenerateServiceContainerPlugin(
  pluginClassName: 'AppPlugin',
)
void main() {
  final container = ServiceContainer()
    ..useAppPlugin()
    ..boot();

  // Fully wired – no manual factories.
  final api = container.resolve<ApiClient>();
}
6.2.1 Neueste Version
150/160 Pub-Punkte
6 Unterstützte Plattformen
MIT Open-Source-Lizenz
✓ Verifizierter Publisher
SO FUNKTIONIERT'S

Drei Schritte von der Annotation zur vollständig verdrahteten App.

1 annotate

Markiere deine Services

Dekoriere Klassen mit @Service und deinen Einstiegspunkt mit @GenerateServiceContainerPlugin.

@Service()
class UserRepository { … }
2 generate

build_runner ausführen

Der Builder schreibt eine *.catalyst_builder.plugin.g.dart-Datei neben deinen annotierten Einstiegspunkt.

$ dart run build_runner build
3 boot

Container starten

Erstelle einen ServiceContainer, registriere das generierte Plugin, starte es – und löse dann alles auf.

container.useAppPlugin();
container.boot();
FUNKTIONEN

Alles, was du brauchst. Nichts, was du von Hand verdrahten musst.

Aufgebaut um SOLID-Prinzipien und Dependency Inversion – damit deine App testbar bleibt, während sie wächst.

Generierung zur Compilezeit

Der Container wird mit build_runner generiert – keine Reflection zur Laufzeit, perfekt für Flutter.

Annotationsbasiert

Deklariere Services mit @Service oder ordne sie zentral mit @ServiceMap.

Programmiere gegen Interfaces

Stelle eine Implementierung über ihre Abstraktion bereit – mit exposeAs, jederzeit austauschbar.

Plugin-Architektur

Jedes Paket kann ein eigenes generiertes Container-Plugin mitbringen – kombiniere sie in deiner Root-App.

Läuft überall

Pure Dart und Flutter: Android, iOS, Web, Windows, macOS und Linux.

Schlank & offen

Kleine Footprint, volle Pub-Punkte, MIT-Lizenz – in jedem Projekt nutzbar, kommerziell oder nicht.

ZWEI PAKETE

Generiere, wo du es brauchst. Hänge contracts überall sonst an.

catalyst_builder Builder

Nutze es in deinem Root- oder Plugin-Paket, um das ServiceContainerPlugin zu generieren.

pub.dev/packages/catalyst_builder →
catalyst_builder_contracts Contracts

Nutze es in Paketen, die selbst keinen Container generieren, aber auflösbare Services bereitstellen.

pub.dev/packages/catalyst_builder_contracts →
SCHNELLSTART

In unter einer Minute startklar.

Pakete hinzufügen, Einstiegspunkt annotieren, generieren – fertig. Die Dokumentation führt durch eine komplette Flutter-App.

1 · Installieren
$ dart pub add dev:build_runner \
    catalyst_builder catalyst_builder_contracts
2 · lib/main.dart annotieren
import 'package:catalyst_builder_contracts/catalyst_builder_contracts.dart';

@GenerateServiceContainerPlugin(pluginClassName: 'AppPlugin')
void main() { … }
3 · Generieren & starten
$ dart run build_runner build
final container = ServiceContainer();
container.useAppPlugin();
container.boot();
runApp(const MainApp());

Der Builder übernimmt das Verdrahten.
Du schreibst die App.

Frei und Open Source. Sterne das Repo, öffne ein Issue oder sende einen Pull Request – Beiträge sind willkommen.