Flutter Chen Common #

🌟 简介 #

本库为Flutter应用开发提供一站式解决方案，包含：

• 可定制的主题系统
• 完整的国际化支持
• 企业级网络请求封装
• N+高质量常用组件
• 常用开发工具及扩展集合
• 刷新列表全方面解决方案
• 开箱即用的通用各类弹窗
• 图片处理全流程解决方案
• 阿里云OSS集成

特性 #

• 🎨 主题系统：通过 ThemeExtension 全局配置颜色/圆角/间距等样式
• 🌍 国际化支持：内置中英文，支持自定义文本和动态语言切换
• ⚡ 优先级覆盖：支持全局主题配置 + 组件级参数覆盖
• 📱 自适应设计：完美适配 iOS/Material 设计规范

安装 #

在 pubspec.yaml 中添加依赖：

dependencies:
  flutter_chen_common: 最新版本

运行命令：

flutter pub get

快速开始 #

网络请求配置 #

/// 初始化RequestClient，传入baseUrl以及请求拦截器
await RequestClient.init(
  baseUrl: Env.getEnvConfig().baseUrl,
  interceptors: [RequestInterceptor()]);

/// 使用
RequestClient.instance.request(
  "/xxxx",
  method: HttpType.post.name,
)

其他配置以及OSS #

/// 初始化SharedPreferences
await SpUtil.init();

ComConfig.setOssConfig(Global.ossConfig);

static Future<Map<String, dynamic>> ossConfig() async {
  var res = await AppApi.ossToken();
  var params = {
    "accessKeyId": res["accessKeyId"],
    "policy": res["policy"],
    "signature": res["signature"],
    "url": "https://${res["bucket"]}.oss-ap-southeast-1.aliyuncs.com",
    "dir": "appName"
    };
  return params;
}

全局主题配置 #

MaterialApp(
  theme: ThemeData.light().copyWith(
    extensions: [
      ComTheme.light()
    ]
  ),
  home: HomePage(),
)

主题系统 #

内置主题 #

可配置属性 #

ComTheme(
	theme: ComColors.lightTheme,			// 颜色体系
  shapes: ComShapes.standard,				// 圆角体系
  spacing: ComSpacing.standard,			// 间距体系
  primaryGradient: LinearGradient(
    colors: [
      ComColors.lightTheme.shade500,
      ComColors.lightTheme.shade500,
    ],
  ),
  success: Colors.green.shade600,
  error: Colors.red.shade600,
  warning: Colors.orange.shade600,
  link: Colors.blue.shade600,
)

// 色系
static MaterialColor lightTheme = const MaterialColor(
  0xFF3783FD,
  <int, Color>{
    50: Color(0xfff8f6f9), // surface 背景色
    100: Color(0xfff8f2fa), // surfaceContainerLow 浅色背景色
    200: Color(0xfff2ecf4), // surfaceContainer 标准背景色
    300: Color(0xffece6ee), // surfaceContainerHigh 较深背景色
    400: Color(0xffe6e0e9), // surfaceContainerHighest 深色背景色
    500: Color(0xFF3783FD), // primary 主题色
    600: Color(0xff1d1b20), // onSurface 主要内容色
    700: Color(0xFF909399), // onSurfaceVariant 次要内容色
    800: Color(0xffffffff), // surfaceContainerLowest 相同色
    900: Color(0xff322f35), // inverseSurface 相反色
  },
);

📦 工具类（Utils） #

🎨 通用帮助类（Helpers） #

🎨 通用组件（Widgets） #

RefreshWidget #

class DemoLogic extends PagingController {
  @override
  Future<PagingResponse> loadData() async {
    // TODO: implement loadData
    dynamic result = {"current": 1, "total": 3, "records": []};
    await Future.delayed(2000.milliseconds, () {
      for (var i = 0; i < 20; ++i) {
        result["records"]?.add(i);
      }
    });

    return PagingResponse.fromMapJson(result);
  }
}

class DemoPage extends StatelessWidget {
  DemoPage({Key? key}) : super(key: key);

  final logic = Get.find<DemoLogic>();

  @override
  Widget build(BuildContext context) {
    return GetBuilder<DemoLogic>(
      builder: (controller) {
        return Scaffold(
            body: RefreshWidget(
              controller: logic,
              slivers: [
                RefreshListWidget(
                    itemBuilder: (item, index) => _buildItem(index),
                    controller: logic,
                    showList: false),
              ],
            ));
      },
      id: logic.pagingState.refreshId,
    );
  }

  Widget _buildItem(index) {
    if (index % 3 == 0) {
      return Container(
        color: Colors.deepOrange,
        width: double.infinity,
        height: 300.h,
      );
    }
    return Container(
      color: Colors.green,
      width: double.infinity,
      height: 200.h,
    );
  }
}

示例项目 #

查看完整示例：

git clone https://github.com/Er-Dong-Chen/flutter-common.git
cd flutter-common/example
flutter run

贡献指南 #

欢迎提交 PR 或 Issue！贡献前请阅读：

• 代码规范
• 全局主题指南
• 国际化指南
• 测试要求

许可证 #

MIT License - 详情见 LICENSE 文件