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 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>();
}Drei Schritte von der Annotation zur vollständig verdrahteten App.
Markiere deine Services
Dekoriere Klassen mit @Service und deinen Einstiegspunkt mit @GenerateServiceContainerPlugin.
@Service()
class UserRepository { … }build_runner ausführen
Der Builder schreibt eine *.catalyst_builder.plugin.g.dart-Datei neben deinen annotierten Einstiegspunkt.
$ dart run build_runner buildContainer starten
Erstelle einen ServiceContainer, registriere das generierte Plugin, starte es – und löse dann alles auf.
container.useAppPlugin();
container.boot();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.
Generiere, wo du es brauchst. Hänge contracts überall sonst an.
Nutze es in deinem Root- oder Plugin-Paket, um das ServiceContainerPlugin zu generieren.
Nutze es in Paketen, die selbst keinen Container generieren, aber auflösbare Services bereitstellen.
pub.dev/packages/catalyst_builder_contracts →In unter einer Minute startklar.
Pakete hinzufügen, Einstiegspunkt annotieren, generieren – fertig. Die Dokumentation führt durch eine komplette Flutter-App.
$ dart pub add dev:build_runner \
catalyst_builder catalyst_builder_contractsimport 'package:catalyst_builder_contracts/catalyst_builder_contracts.dart';
@GenerateServiceContainerPlugin(pluginClassName: 'AppPlugin')
void main() { … }$ dart run build_runner buildfinal 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.