Pakete, Repositories und App-Kategorien suchen

Paketdetailsv7.5.0

theme_extensions_builder_annotation

Anmerkungen für das theme_extensions_builder. Dieses Paket tut ohne theme_extensions_builder nichts.

AndroidiOSLinuxmacOSWebWindows
30-Tage-Downloads
193.000
Likes
4
Pub-Punkte
160

Paket installieren

flutter pub add theme_extensions_builder_annotation

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Dart-Paket, das Anmerkungen für theme_extensions_builder bereitstellt und die einfache Erstellung und Verwaltung von Theme-Erweiterungen in Flutter-Anwendungen ermöglicht. Es dient als Begleitpaket zu theme_extensions_builder und bietet Unterstützung für die Kompilierzeit-Codegenerierung über Anmerkungen. Dieses Paket enthält selbst keine ausführbare Logik, sondern verbessert die Produktivität von Entwicklern, indem es die Theme-Konfiguration vereinfacht und Boilerplate-Code reduziert. Es ist ausschließlich für die Verwendung mit dem theme_extensions_builder-Paket vorgesehen.

Anwendungsfälle

  • Themen-Erweiterungsklassen generieren
  • Themenkonfiguration vereinfachen
  • Typsichere Theme-Verwaltung aktivieren
  • Reduzierung von Boilerplate beim Thema-Setup
  • Unterstützung dynamischer Theming-Workflows

Hauptmerkmale

  • Codegenerierung zur Kompilierzeit
  • Integration mit theme_extensions_builder
  • Typsichere Theme-Definitionen
  • Minimale Laufzeitüberhead
  • Anmerkungsorientierte Entwicklung

Geeignet für

  • Flutter-Entwickler, die theme_extensions_builder verwenden
  • Teams, die wartbare Themen-Systeme priorisieren
  • Projekte, die skalierbare Theming-Lösungen erfordern
  • Entwickler, die weniger Boilerplate suchen
  • Apps mit komplexen oder dynamischen Themenanforderungen

Hinweise

  • Benötigt theme_extensions_builder zum Funktionieren
  • Keine eigenständige Funktionalität
  • Abhängig von build_runner für Codegenerierung
  • Beschränkt auf die Verwendung innerhalb unterstützter Flutter-Projekte
  • Nicht geeignet für einfache statische Themen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

theme_extensions_builder

pub package License: MIT

📖 Full documentation: packages/theme_extensions_builder/README.md

theme_extensions_builder is a powerful code generator for Flutter's ThemeExtension classes. It eliminates boilerplate code by automatically generating copyWith, lerp, ==, and hashCode methods, along with convenient BuildContext extensions for easy theme access.

🎯 Quick Links

📦 Installation

Add the packages to your project:

flutter pub add theme_extensions_builder_annotation
flutter pub add --dev theme_extensions_builder
flutter pub add --dev build_runner

Or add to pubspec.yaml:

dependencies:
  theme_extensions_builder_annotation: ^7.5.0

dev_dependencies:
  build_runner: ^2.13.0
  theme_extensions_builder: ^7.5.0

🚀 Quick Start

Using @ThemeExtensions

For classes extending ThemeExtension:

import 'package:flutter/material.dart';
import 'package:theme_extensions_builder_annotation/theme_extensions_builder_annotation.dart';

part 'app_theme.g.theme.dart';

@ThemeExtensions()
class AppTheme extends ThemeExtension<AppTheme> with _$AppTheme {
  const AppTheme({
    required this.primaryColor,
    required this.spacing,
  });

  final Color primaryColor;
  final double spacing;
}

Generate code:

dart run build_runner build

Use in your app:

Widget build(BuildContext context) {
  final theme = context.appTheme;
  
  return Container(
    padding: EdgeInsets.all(theme.spacing),
    color: theme.primaryColor,
  );
}
Using @ThemeGen

For standalone theme data classes:

@ThemeGen()
class ButtonThemeData with _$ButtonThemeData {
  const ButtonThemeData({
    required this.backgroundColor,
    this.borderRadius = 8.0,
  });

  final Color backgroundColor;
  final double borderRadius;

  static ButtonThemeData? lerp(ButtonThemeData? a, ButtonThemeData? b, double t) =>
      _$ButtonThemeData.lerp(a, b, t);
}

📋 Choose Your Annotation

@ThemeExtensions (Recommended)

For classes extending Flutter's ThemeExtension - ideal for most use cases.

Perfect for:

  • Full Flutter theme integration
  • Automatic theme switching with lerp animations
  • Easy access via BuildContext (e.g., context.appTheme)

Generates:

  • Complete ThemeExtension implementation with copyWith and lerp
  • BuildContext extension for convenient access
  • Equality operators and hashCode
@ThemeGen

For standalone theme data classes without ThemeExtension inheritance.

Perfect for:

  • Custom theme systems outside standard Flutter themes
  • Maximum control over class structure
  • Nested theme data objects

Generates:

  • copyWith and merge methods
  • Static lerp method
  • Equality operators and hashCode

📖 Example

Check out the example project for a comprehensive Flutter app with:

  • 5 Theme Extensions: App, Button, Card, Typography, and Spacing themes
  • Theme Switching: Seamless light/dark mode transitions
  • Custom Components: Buttons, cards, and typography showcases
  • Best Practices: Real-world organization patterns

🛠️ Development

The repository is a pub workspace: one flutter pub get at the root resolves every package, including the example app.

flutter pub get
scripts/prepare_push.sh     # format, analyze, build and test every package
scripts/update_goldens.sh   # regenerate the golden files after a generator change

The generator tests run on the Dart SDK alone. The Flutter classes the fixtures use are small stand-ins in packages/theme_extensions_builder/test/fixtures/flutter_stubs.dart, with the same lerp and merge signatures as the real ones. The example app is where the generated code meets the real framework, so CI regenerates and analyzes it on every push.

📄 License

MIT License - see the LICENSE file for details.

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Ranglisten