패키지, 저장소 및 앱 카테고리 검색

패키지 상세v7.5.0

theme_extensions_builder_annotation

theme_extensions_builder에 대한 주석입니다. 이 패키지는 theme_extensions_builder 없이 아무것도 하지 않습니다.

AndroidiOSLinuxmacOSWebWindows
30일 다운로드
19.3만
좋아요
4
Pub 점수
160

패키지 설치

flutter pub add theme_extensions_builder_annotation

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

Flutter 애플리케이션에서 테마 확장을 간편하게 생성하고 관리할 수 있도록 theme_extensions_builder용 주석을 제공하는 Dart 패키지입니다. theme_extensions_builder의 보조 도구로서, 주석을 통해 컴파일 시 코드 생성을 지원합니다. 이 패키지는 실행 가능한 로직을 포함하지 않지만, 테마 구성의 단순화와 반복 코드 감소를 통해 개발자 생산성을 높입니다. theme_extensions_builder 패키지와 전용으로 사용되도록 설계되었습니다.

사용 사례

  • 테마 확장 클래스 생성
  • 테마 구성 간소화
  • 타입 안전한 테마 처리 활성화
  • 테마 설정에서 반복 코드 줄이기
  • 동적 테마 워크플로우 지원

주요 기능

  • 컴파일 시 코드 생성
  • theme_extensions_builder와의 통합
  • 타입 안전한 테마 정의
  • 최소의 런타임 오버헤드
  • 주석 기반 개발

적합한 대상

  • theme_extensions_builder를 사용하는 Flutter 개발자
  • 유지보수 가능한 테마 시스템을 우선시하는 팀
  • 확장 가능한 테마 솔루션을 필요로 하는 프로젝트
  • 보일러플레이트를 줄이려는 개발자
  • 복잡하거나 동적 테마 요구사항을 가진 앱

고려 사항

  • 정상 작동하려면 theme_extensions_builder가 필요합니다
  • 독립적인 기능 없음
  • 코드 생성을 위해 build_runner에 의존합니다
  • 지원되는 Flutter 프로젝트 내에서만 사용 가능
  • 간단한 정적 테마에 적합하지 않습니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

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.

카테고리

의존성

의존성 목록 1 개

소스 저장소

이 패키지를 사용하는 프로젝트

순위