SuperAPI AI 工具集

Core Layer Patterns

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:为 Flutter Clean Architecture 项目提供跨层复用的核心层,位于 lib/core/,不包含 Flutter 专属逻辑,聚焦纯 Dart 模式。目录涵盖 errors、utils、config、di 四部分。

主要能力:一是错误处理,Failures 表示领域层可预期错误,通过 Either<Failure, T> 由用例返回;Exceptions 表示数据层异常,由数据源抛出、仓库捕获并转换为 Failure。二是扩展方法,为 String(大写首字母、邮箱与电话校验、去空白)、DateTime(是否今天/昨天、相对时间)、List(越界安全取值、去重)、BuildContext(屏幕尺寸、主题、SnackBar)提供便捷扩展。三是校验器 Validators,提供 email、password、phone、required、min/maxLength 及 compose 组合校验,可直接作为 TextFormField 的 validator。四是应用配置 AppConfig,含 appName、apiBaseUrl、apiKey、超时与日志开关,提供 development、staging、production 工厂构造。五是主题配置 ThemeConfig,提供 Material 3 的亮色与暗色主题。六是依赖注入 DependencyInjection.init,使用 Get 与 GetStorage 按核心、数据源、仓库、用例顺序注册,在 main 中调用。

使用方式:按上述目录创建文件,在 main.dart 中先 WidgetsFlutterBinding.ensureInitialized(),再 await GetStorage.init() 与 await DependencyInjection.init(),然后 runApp。数据源、仓库、用例的注册代码在资料中以注释示例给出,需自行补全。

限制与注意:资料未提供版本、许可、依赖版本、平台与收费信息;敏感配置不应硬编码,应使用环境变量。