
引言:为什么要自己写一个工具箱?
在应用商店里,我们能看到形形色色的“工具箱”App。它们通常集成了二维码扫描、图片压缩、单位换算、随机数生成、甚至是一些小游戏。这类 App 开发门槛看似不高,但如果你想把它做得流畅、高颜值、功能稳定且代码结构优雅,其实非常考验开发者的基本功。
市面上很多开源工具箱要么 UI 万年不更新(停留在 Material 2 时代),要么把所有的逻辑塞进一个 2000 行的 main.dart 里,毫无架构可言。
这篇文章将从零开始,使用 Flutter 3.x 和 Dart 3,带你打造一个现代化、基于 Material 3 设计规范、采用模块化架构的跨平台工具箱 App。我们将深入探讨:
- 项目目录结构设计:如何让代码不变成一坨屎山。
- 极致 UI 体验:沉浸式状态栏、动态取色(Material You)。
- 状态管理:使用 Riverpod 实现解耦。
- 核心功能实战:实现一个基于设备硬件信息的系统工具,以及一个使用原生通道(Method Channel)的进阶功能。
准备好了吗?打开你的 Android Studio 或 VS Code,我们开始。
第一章:项目初始化与架构设计
1.1 创建项目
首先,打开终端,创建一个新的 Flutter 项目:
flutter create toolbox_appcd toolbox_app由于我们要做的是一个商业级应用,建议将包名修改为你的域名倒写,例如 com.iyu6.toolbox。
1.2 为什么你的项目需要架构?
新手最容易犯的错误,就是新建一个 Flutter 项目后,直接把所有的 Container、Text、onPressed 全塞进 lib/main.dart。当你的功能超过 3 个,这个文件就会变得难以维护。
我们采用 Feature-First(按功能划分) 的目录结构。在 lib/ 下创建以下文件夹:
· core/:核心配置、主题、路由、网络请求等全局内容。 · features/:具体的业务模块。比如 home(首页)、qrcode(二维码)、system_info(系统信息)。 · shared/:跨模块复用的 UI 组件。
你的 lib 目录结构应该长这样:
lib/ ┣ core/ ┃ ┣ theme/ # App 颜色、字体配置 ┃ ┣ router/ # 页面路由管理 ┃ ┗ utils/ # 工具类(格式化、校验等) ┣ features/ ┃ ┣ home/ # 主页 ┃ ┃ ┣ widgets/ # 仅限主页使用的组件 ┃ ┃ ┗ home_page.dart ┃ ┣ system_info/ ┃ ┗ qrcode/ ┣ shared/ ┃ ┗ widgets/ # 通用组件(自定义按钮、卡片等) ┗ main.dart1.3 引入核心依赖
在 pubspec.yaml 中,我们需要引入几个神级库来辅助开发:
dependencies: flutter: sdk: flutter # 状态管理与依赖注入 flutter_riverpod: ^2.4.0 # 路由管理 go_router: ^12.0.0 # 图标库(扩展 Material 图标) phosphor_flutter: ^2.0.0 # 获取设备硬件信息 device_info_plus: ^9.1.0 # 获取包信息 package_info_plus: ^5.0.0 # 动态色彩 dynamic_color: ^1.6.0保存后,在终端运行 flutter pub get 拉取依赖。
第二章:打造极致视觉体验 (Material 3)
一个优秀的工具箱,第一眼的视觉效果决定了用户是否会留下来。Flutter 3 原生支持 Material 3,我们要充分利用它。
2.1 动态色彩 (Material You)
Material You 的核心是:App 的配色应该根据用户的壁纸自动生成。我们可以使用 dynamic_color 库来实现。虽然在 iOS 上不支持,但在 Android 12+ 上,这能带来极佳的沉浸感。
修改 lib/core/theme/app_theme.dart:
import 'package:flutter/material.dart';
class AppTheme { static ThemeData getLightTheme(ColorScheme? dynamicScheme) { final ColorScheme colorScheme = dynamicScheme ?? ColorScheme.fromSeed( seedColor: const Color(0xFF6750A4), // 兜底颜色:紫色 );
return ThemeData( useMaterial3: true, colorScheme: colorScheme, // 统一卡片圆角 cardTheme: const CardTheme( elevation: 0, shape: RoundedRectangleBorder( borderRadius: BorderRadius.all(Radius.circular(16)), side: BorderSide(color: Colors.transparent, width: 1), ), ), // 自定义 AppBar 样式 appBarTheme: AppBarTheme( centerTitle: true, elevation: 0, scrolledUnderElevation: 2, backgroundColor: colorScheme.surface, foregroundColor: colorScheme.onSurface, ), ); }
static ThemeData getDarkTheme(ColorScheme? dynamicScheme) { final ColorScheme colorScheme = dynamicScheme ?? ColorScheme.fromSeed( seedColor: const Color(0xFF6750A4), brightness: Brightness.dark, );
return ThemeData( useMaterial3: true, colorScheme: colorScheme, ); }}2.2 沉浸式状态栏
为了让 App 看起来不像一个粗糙的网页套壳,我们需要将状态栏设置为透明,让内容延伸到状态栏下面。
在你的 main.dart 中,加入以下代码:
import 'package:flutter/services.dart';
void main() { WidgetsFlutterBinding.ensureInitialized();
// 设置沉浸式状态栏 SystemChrome.setSystemUIOverlayStyle(const SystemUiOverlayStyle( statusBarColor: Colors.transparent, statusBarIconBrightness: Brightness.dark, // 浅色模式用深色图标 systemNavigationBarColor: Colors.transparent, ));
runApp(const MyApp());}第三章:构建响应式首页
首页是工具箱的门面,我们需要一个美观的网格布局来展示所有工具。
3.1 使用 GoRouter 管理路由
在 core/router/app_router.dart 中配置:
import 'package:go_router/go_router.dart';import '../../features/home/home_page.dart';import '../../features/system_info/system_info_page.dart';
final appRouter = GoRouter( initialLocation: '/', routes: [ GoRoute( path: '/', builder: (context, state) => const HomePage(), ), GoRoute( path: '/system_info', builder: (context, state) => const SystemInfoPage(), ), ],);3.2 首页布局实现
我们把首页分成两个区域:顶部的欢迎卡片,以及下方的工具网格。
import 'package:flutter/material.dart';import 'package:go_router/go_router.dart';
class HomePage extends StatelessWidget { const HomePage({super.key});
@override Widget build(BuildContext context) { final colorScheme = Theme.of(context).colorScheme;
return Scaffold( appBar: AppBar( title: const Text('我的工具箱'), ), body: CustomScrollView( slivers: [ // 顶部欢迎区域 SliverToBoxAdapter( child: Padding( padding: const EdgeInsets.all(16.0), child: Container( padding: const EdgeInsets.all(24), decoration: BoxDecoration( gradient: LinearGradient( colors: [colorScheme.primary, colorScheme.tertiary], begin: Alignment.topLeft, end: Alignment.bottomRight, ), borderRadius: BorderRadius.circular(24), ), child: Column( crossAxisAlignment: CrossAxisAlignment.start, children: [ Text( '欢迎回来', style: TextStyle(color: colorScheme.onPrimary, fontSize: 16), ), const SizedBox(height: 8), Text( '高效 · 实用 · 极简', style: TextStyle( color: colorScheme.onPrimary, fontSize: 24, fontWeight: FontWeight.bold, ), ), ], ), ), ), ),
// 工具网格 SliverPadding( padding: const EdgeInsets.symmetric(horizontal: 16), sliver: SliverGrid( gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount( crossAxisCount: 3, mainAxisSpacing: 12, crossAxisSpacing: 12, childAspectRatio: 0.9, ), delegate: SliverChildListDelegate([ _buildToolItem( context, icon: Icons.memory, label: '系统信息', color: Colors.blue, onTap: () => context.push('/system_info'), ), _buildToolItem( context, icon: Icons.qr_code, label: '二维码', color: Colors.green, onTap: () {}, // 留空待实现 ), ]), ), ), ], ), ); }
Widget _buildToolItem(BuildContext context, { required IconData icon, required String label, required Color color, required VoidCallback onTap, }) { return Card( child: InkWell( onTap: onTap, borderRadius: BorderRadius.circular(16), child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Container( padding: const EdgeInsets.all(12), decoration: BoxDecoration( color: color.withOpacity(0.1), shape: BoxShape.circle, ), child: Icon(icon, color: color, size: 28), ), const SizedBox(height: 12), Text( label, style: const TextStyle(fontWeight: FontWeight.w500), ), ], ), ), ); }}3.3 入口文件组装
回到 main.dart:
import 'package:flutter/material.dart';import 'package:dynamic_color/dynamic_color.dart';import 'core/router/app_router.dart';import 'core/theme/app_theme.dart';
void main() { runApp(const MyApp());}
class MyApp extends StatelessWidget { const MyApp({super.key});
@override Widget build(BuildContext context) { return DynamicColorBuilder( builder: (ColorScheme? lightDynamic, ColorScheme? darkDynamic) { return MaterialApp.router( title: '工具箱', debugShowCheckedModeBanner: false, theme: AppTheme.getLightTheme(lightDynamic), darkTheme: AppTheme.getDarkTheme(darkDynamic), themeMode: ThemeMode.system, // 跟随系统深色模式 routerConfig: appRouter, ); }, ); }}到这里,你的 App 就已经具备了极其现代、响应式的 UI 骨架了。
第四章:获取设备系统信息
工具箱 App 往往包含“设备信息”模块,让用户查看 CPU、内存、系统版本等。我们将使用 device_info_plus 这个插件。
4.1 封装硬件信息服务
新建 features/system_info/device_info_service.dart:
import 'dart:io';import 'package:device_info_plus/device_info_plus.dart';
class DeviceInfoService { final DeviceInfoPlugin _deviceInfo = DeviceInfoPlugin();
Future<Map<String, String>> getDeviceInfo() async { final Map<String, String> info = {};
if (Platform.isAndroid) { final androidInfo = await _deviceInfo.androidInfo; info['操作系统'] = 'Android ${androidInfo.version.release}'; info['设备型号'] = '${androidInfo.manufacturer} ${androidInfo.model}'; info['SDK 版本'] = androidInfo.version.sdkInt.toString(); info['CPU 架构'] = androidInfo.supportedAbis.join(', '); } else if (Platform.isIOS) { final iosInfo = await _deviceInfo.iosInfo; info['操作系统'] = 'iOS ${iosInfo.systemVersion}'; info['设备型号'] = iosInfo.utsname.machine; info['设备名称'] = iosInfo.name; } return info; }}4.2 编写系统信息页面 UI
新建 features/system_info/system_info_page.dart:
import 'package:flutter/material.dart';import 'device_info_service.dart';
class SystemInfoPage extends StatefulWidget { const SystemInfoPage({super.key});
@override State<SystemInfoPage> createState() => _SystemInfoPageState();}
class _SystemInfoPageState extends State<SystemInfoPage> { Map<String, String> _info = {}; bool _isLoading = true;
@override void initState() { super.initState(); _loadData(); }
Future<void> _loadData() async { final data = await DeviceInfoService().getDeviceInfo(); setState(() { _info = data; _isLoading = false; }); }
@override Widget build(BuildContext context) { return Scaffold( appBar: AppBar(title: const Text('系统信息')), body: _isLoading ? const Center(child: CircularProgressIndicator()) : ListView( padding: const EdgeInsets.all(16), children: _info.entries.map((entry) { return Card( margin: const EdgeInsets.only(bottom: 12), child: ListTile( title: Text( entry.key, style: const TextStyle(fontWeight: FontWeight.bold), ), subtitle: Text(entry.value), ), ); }).toList(), ), ); }}第五章:终极进阶——使用 Method Channel 调用原生代码
虽然 Flutter 插件生态很丰富,但在实际开发中,你总会遇到需要直接调用 Android 或 iOS 原生能力的需求。比如:调用 Android 独有的 Toast、读取系统底层日志。
这时候,你就必须掌握 Method Channel。我们将手动实现一个 Android 原生 Toast 的功能。
5.1 编写 Dart 端的通道
在 lib/core/platform/native_channel.dart 中:
import 'package:flutter/services.dart';
class NativeBridge { // 定义一个唯一的通道名称,必须和原生端保持一致 static const MethodChannel _channel = MethodChannel('com.iyu6.toolbox/native');
/// 调用 Android 原生 Toast static Future<void> showToast(String message) async { try { await _channel.invokeMethod('showToast', {'message': message}); } on PlatformException catch (e) { print("调用原生通道失败: '${e.message}'."); } }}5.2 编写 Android 原生端 (Kotlin)
打开 android/app/src/main/kotlin/…/MainActivity.kt。我们需要重写 configureFlutterEngine 方法:
package com.example.toolbox_app
import android.os.Bundleimport android.widget.Toastimport io.flutter.embedding.android.FlutterActivityimport io.flutter.embedding.engine.FlutterEngineimport io.flutter.plugin.common.MethodChannel
class MainActivity: FlutterActivity() { // 这里的名称必须和 Dart 端一致 private val CHANNEL = "com.iyu6.toolbox/native"
override fun configureFlutterEngine(flutterEngine: FlutterEngine) { super.configureFlutterEngine(flutterEngine)
MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result -> if (call.method == "showToast") { // 从 Dart 端获取参数 val message = call.argument<String>("message") if (message != null) { // 调用 Android 原生 Toast Toast.makeText(this, message, Toast.LENGTH_SHORT).show() result.success(true) } else { result.error("INVALID_ARG", "参数不能为空", null) } } else { result.notImplemented() } } }}5.3 在 Flutter 端调用
现在,你可以在任何地方像调用普通 Dart 方法一样调用它:
ElevatedButton( onPressed: () { NativeBridge.showToast("这是来自 Android 原生的提示!"); }, child: const Text('唤醒原生 Toast'),)第六章:进阶功能与性能优化建议
打造一个工具箱 App 不难,但要打造一个体验如丝般顺滑的工具箱,还需要注意以下几点。
6.1 使用 Isolate 处理耗时计算
如果工具箱里包含诸如“生成超大文件哈希”或“图像压缩”的功能,千万不要在主线程(UI 线程)里处理,否则界面会卡死。
Dart 提供了 Isolate(隔离区)来实现真正的多线程。你可以使用 compute 函数快速将任务丢进后台:
import 'package:flutter/foundation.dart';
// 必须是一个顶级函数或静态方法String heavyCalculation(int count) { // 模拟耗时运算 int sum = 0; for (int i = 0; i < count; i++) { sum += i; } return "计算结果: $sum";}
// 在按钮点击中调用ElevatedButton( onPressed: () async { // 开启新的 Isolate 执行,不会卡住 UI String result = await compute(heavyCalculation, 1000000000); print(result); }, child: const Text('后台运算'),)6.2 路由动画自定义
GoRouter 支持自定义页面过渡动画。比如,你可以让工具页面从底部滑出,类似于 Modal 的形式:
GoRoute( path: '/system_info', pageBuilder: (context, state) => CustomTransitionPage( key: state.pageKey, child: const SystemInfoPage(), transitionsBuilder: (context, animation, secondaryAnimation, child) { // 从底部滑动进入 return SlideTransition( position: Tween<Offset>( begin: const Offset(0, 1), end: Offset.zero, ).animate(CurvedAnimation(parent: animation, curve: Curves.easeOutCubic)), child: child, ); }, ),),第七章:打包发布
当你的工具都开发完毕,测试跑通后,就到了最后一步:打包。
7.1 修改 App 图标
不要用 Flutter 默认的蓝色爱心。你可以使用 flutter_launcher_icons 插件一键生成所有尺寸的图标。
在 pubspec.yaml 中加入:
dev_dependencies: flutter_launcher_icons: "^0.13.1"
flutter_launcher_icons: android: "launcher_icon" ios: true image_path: "assets/icon.png"然后在终端运行 flutter pub run flutter_launcher_icons。
7.2 构建 Release 包
在 Android Studio 中配置好签名(keystore)后,在终端执行:
flutter build apk --release --split-per-abi加入 —split-per-abi 参数可以让 Flutter 针对 ARMv7、ARM64 和 x86_64 分别打包。这样做的好处是,用户下载的安装包体积会锐减约 40%。
总结
以上就是使用 Flutter 从零开发一个现代化工具箱 App 的完整流程。
回顾一下我们用到的高级技巧:
- Material You 动态取色,提升视觉上限。
- Feature-First 架构,告别单文件屎山代码。
- 原生通道(Method Channel)通信,打破跨平台限制。
- Isolate 多线程,避免耗时计算卡顿 UI。
Flutter 的魅力就在于,它让你能用一套代码,同时兼顾开发效率和原生的极致体验。希望这篇教程能给你带来启发。
附录:Flutter 开发必备参考文档与视频教程
为了方便大家在开发过程中查阅资料,我整理了这套官方文档、优质开源项目和精选视频教程清单。建议直接加进浏览器书签栏。
一、官方权威文档(首选)
官方文档永远是最准的,如果第三方教程跟官方冲突,请无条件相信官方。
- Flutter 官方中文文档 · 链接:https://docs.flutter.cn/ · 简介:官方汉化版文档。包含环境搭建、基础组件介绍、状态管理、网络请求等全套内容。适合入门,但部分最新特性可能更新较慢。
- Flutter 官方英文文档 · 链接:https://docs.flutter.dev/ · 简介:最权威、最新的原版文档。遇到中文文档里看不懂的地方,或者想了解最新 API,直接来这里搜。
- Dart 官方语言文档 · 链接:https://dart.dev/guides · 简介:Flutter 的基础是 Dart 语言。空安全(Null Safety)、异步编程(Future、Stream)搞不清楚时,这里是最好的查漏补缺之地。
- API 参考手册 (API Reference) · 链接:https://api.flutter.dev/ · 简介:不知道 ListView 有哪些参数、Container 的约束规则时,直接搜索。没有比它更详细的组件字典了。
二、视频教程(精选)
- B站 - 技术胖 Flutter 基础教程 · 链接:https://www.bilibili.com/video/BV1S4411E7LY · 简介:老牌入门视频。基础概念(Widget、State、Layout)讲得非常通俗易懂,适合完全没接触过声明式 UI 的小白。
- B站 - 完整全栈 Flutter 实战教程 · 链接:https://www.bilibili.com/video/BV1Wv411h7kN · 简介:偏向实战,涵盖网络请求、本地存储、状态管理和常用的 UI 布局。适合看完基础视频后,跟着做完整项目的人。
- YouTube - Flutter Official (官方频道) · 链接:https://www.youtube.com/@flutterdev · 简介:官方频道。每年 Google I/O 大会后发布的 “What’s new in Flutter” 视频必看,新特性(如 Impeller 渲染引擎、Material 3)讲得最透。
- YouTube - The Net Ninja (Flutter 系列) · 链接:https://www.youtube.com/playlist?list=PL4cUxeGkcC9jLYyp2Aoh6hcWuxFDX6PBJ · 简介:英文频道,发音清晰。注重代码规范和架构设计,适合想要提升代码质量的中级开发者。
三、优质开源项目与资源
- Flutter Samples (官方示例集) · 链接:https://github.com/flutter/samples · 简介:官方维护的示例代码库。涵盖动画、平台集成、桌面端支持,是最好的参考书。
- Pub.dev (Dart 包管理仓库) · 链接:https://pub.dev/ · 简介:找功能插件(二维码、蓝牙、文件读写)的首选。看一个库靠不靠谱,主要看其 Likes、Pub Points 和最近更新时间。
- Phosphor Icons · 链接:https://phosphoricons.com/ · 简介:极其强大的图标库,支持 Flutter。风格统一,包含线性、粗体、填充,配合 phosphor_flutter 包使用效果极佳。
- Flutter Awesome · 链接:https://flutterawesome.com/ · 简介:非常全的 Flutter UI 组件和第三方包聚合站。当你想实现酷炫的底部导航栏或登录 UI 时,直接来这搜。
四、社区与问题排查
- Stack Overflow · 链接:https://stackoverflow.com/questions/tagged/flutter · 简介:全球最大的程序员问答社区。90% 的疑难杂症在这里都有答案,搜索时加上 Flutter 标签即可。
- Github Issues · 链接:https://github.com/flutter/flutter/issues · 简介:如果你确信遇到了 Flutter 框架本身的 Bug,直接来这里搜。很多底层的坑,早就有人在 Issue 里给出了临时解决方案。
遇到问题,先看官方文档,再看 Stack Overflow,最后去 Github 搜源码。形成这个习惯,你距离高级开发者就不远了。
分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
最后更新于 ,距今已过 14 天
部分内容可能已过时