fall_core 0.0.5

Fall Core - A Flutter AOP and Dependency Injection framework inspired by Spring, providing enterprise-level DI and AOP capabilities.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.0.5 - 2025-08-31

Removed

• GetX依赖: 完全移除GetX依赖，实现真正的轻量级核心框架
• InjectUtil工具类: 将InjectUtil移动到fall_gen项目中，进一步分离关注点
• 外部依赖: 移除get包依赖，减少包大小和复杂性

Changed

• 核心架构: 从基于GetX的依赖注入转为纯注解定义模式
• 服务管理: 简化为直接实例化模式，更加直观
• 文档更新: 更新所有示例代码和文档，移除GetX相关内容

Improved

• 包大小: 显著减小包大小，提高安装和构建速度
• 简洁性: 无外部依赖，更纯粹的核心框架
• 学习成本: 减少学习成本，不需要学习GetX相关概念
• 灵活性: 用户可以选择任意的依赖注入框架或自己管理服务

Technical Details

• 零依赖: 除Flutter SDK外无任何第三方依赖
• 更小包体积: 从23KB减少到约15KB左右
• 更快构建: 减少依赖解析时间

Migration Guide

如果您从 0.0.4 升级到 0.0.5：

1. 移除GetX依赖: 从pubspec.yaml中移除get依赖
2. 更新服务创建: 用直接实例化替换Get.lazyPut和Get.find
3. 使用fall_gen: 如需自动依赖注入，请使用fall_gen项目
4. 更新导入: 不再需要导入GetX相关包

0.0.4 - 2025-08-31

Added

• AutoScan注解: 新增AutoScan配置注解，用于配置代码生成器扫描范围
• Fall_gen集成: 支持与fall_gen项目的配置协作

Fixed

• 重新添加回来，引用不是错误

0.0.3 - 2025-08-31

Fixed

• 移除flutter sdk:flutter的依赖

0.0.2 - 2025-08-31

Changed

• 架构重构: 将代码生成器功能分离到独立的 fall_gen 项目
• 核心简化: 保留仅最基本的 AOP 和依赖注入功能
• 项目结构: 示例项目将单独创建，不再包含在此包中

Removed

• 代码生成器: 移除 build_runner 相关的代码生成功能
• AutoScan 工具: 移除自动扫描和注册功能
• 依赖清理: 移除 analyzer、dart_style 等代码生成相关依赖

Fixed

• 文档更新: 更新 README 和相关文档，移除代码生成器相关内容
• 示例代码: 更新示例代码，使用手动注册方式
• 错误提示: 更新依赖注入失败提示，移除 AutoScan 引用

Technical Details

• 轻量化: 核心包更加轻量，仅包含必要的运行时功能
• 可维护性: 通过分离代码生成器，提高项目的可维护性
• 灵活性: 用户可以选择仅使用核心功能或结合 fall_gen 使用完整功能

Migration Guide

如果您从 0.0.1 升级到 0.0.2：

1. 移除 build_runner 依赖：从 pubspec.yaml 中移除 build_runner
2. 手动注册服务：替换 AutoScan.registerServices() 为手动注册
3. 使用 fall_gen：如需代码生成功能，请添加 fall_gen 作为 dev_dependencies

0.0.1 - 2025-08-25

Added

• Initial release of Fall Core framework
• Dependency Injection System
  • @Service annotation for service registration
  • @Auto annotation for automatic dependency injection
  • Support for named services with name parameter
  • Lazy loading and singleton lifecycle management
  • Integration with GetX for dependency lookup
• Aspect-Oriented Programming (AOP)
  • @Aop annotation for method interception
  • @NoAop annotation to exclude methods from AOP
  • Hook system with BeforeHook, AfterHook, AroundHook, and ThrowHook
  • Automatic proxy class generation for AOP functionality
• Code Generation
  • Compile-time code generation using build_runner
  • service_generator for automatic service registration
  • aop_generator for AOP proxy class generation
  • Type-safe code generation avoiding runtime reflection
• Core Components
  • AutoScan utility for automatic service registration and injection
  • AopService for managing hooks and AOP functionality
  • InjectUtil for dependency injection utilities
  • LoggerFactory for business and system logging
• Annotations System
  • Complete annotation system for DI and AOP
  • Support for custom configuration parameters
  • Build-time validation and error reporting
• Example Application
  • Comprehensive example demonstrating all features
  • Sample services with AOP integration
  • Test cases for various scenarios

Features

• Enterprise-Grade Architecture: Inspired by Spring Framework
• Compile-Time Safety: No runtime reflection, all code generated at build time
• Performance Optimized: Minimal runtime overhead with compile-time optimization
• Developer Friendly: Annotation-driven development with clear APIs
• Modular Design: Clean separation of concerns with AOP support
• Comprehensive Logging: Built-in logging system with hook integration

Technical Details

• Minimum Dart SDK: 3.8.1
• Flutter support with GetX integration
• Build runner integration for code generation
• Compatible with modern Flutter development practices

Documentation

• Complete API documentation
• Quick start guide
• Advanced usage examples
• Best practices and guidelines

[Unreleased]

Planned Features

• Performance monitoring hooks
• Enhanced error handling and validation
• Additional lifecycle management options
• Plugin system for custom generators
• Integration with other state management solutions

---

Note: This is the first stable release of Fall Core. We follow semantic versioning, so any breaking changes will be clearly documented and versioned appropriately.