【flutter for open harmony】第三方库 Flutter 鸿蒙实战：get_it 依赖注入 + 模块化架构优化，项目秒变企业级✨

Flutter 鸿蒙实战get_it 依赖注入 模块化架构优化项目秒变企业级✨欢迎加入开源鸿蒙跨平台社区https://openharmonycrossplatform.csdn.net 前言哈喽各位小伙伴我是持续深耕 Flutter 鸿蒙跨平台开发的大学生开发者前面我们已经搞定了路由、图片缓存、搜索、状态管理等核心功能但是随着项目越来越大你有没有发现一个致命问题代码越来越乱、类与类之间紧耦合、修改一处牵一发而动全身、测试起来超级麻烦今天这篇就带大家彻底解决这个痛点实现get_it 依赖注入 模块化架构优化让你的项目结构清晰、松耦合、易维护、可测试直接从“学生级项目”升级为“企业级架构”全程代码可直接复制、鸿蒙真机完美运行不管是写 CSDN 博客、课程设计、大创项目还是鸿蒙竞赛这波优化都是超级加分项 本篇你能学到什么✅ Flutter 鸿蒙环境接入 get_it 依赖注入容器✅ 掌握“服务定位器”模式彻底解耦类与类之间的依赖✅ 搭建标准化模块化架构分层清晰DI层、服务层、状态层、页面层✅ 重构现有代码将所有服务、Provider 改为依赖注入模式✅ 学会单例Singleton、工厂Factory两种注册方式的区别与使用✅ 理解模块化架构的核心思想以后写大型项目不迷路✅ 鸿蒙项目架构优化实战提升代码可维护性和可扩展性 本次用到的核心依赖get_it: ^7.2.0Flutter 最流行的依赖注入库轻量、高效、无侵入完美适配鸿蒙系统Flutter 版本3.32.4-ohos-0.0.1OpenHarmony SDKAPI 10其他依赖provider、shared_preferences复用之前的 为什么要做依赖注入 模块化架构在没有优化前你的项目大概率是这样的❌ 类之间直接依赖比如 UserProvider 直接调用 StorageService 的静态方法紧耦合难以修改❌ 每个页面都要手动创建 Provider、Service 实例代码冗余❌ 测试困难无法轻松模拟依赖比如模拟本地存储数据❌ 项目结构混乱文件杂乱无章找代码要翻半天❌ 新增功能时需要修改多处代码容易出错❌ 鸿蒙项目后期扩展困难多人协作容易冲突优化后直接实现“脱胎换骨”✅ 类之间松耦合依赖通过注入传递修改一处不影响其他地方✅ 全局统一管理所有依赖哪里需要哪里调用无需重复创建✅ 支持单例/工厂模式合理管理实例生命周期✅ 模块化分层结构清晰找代码一目了然✅ 易于单元测试可轻松 mock 依赖✅ 鸿蒙项目可扩展性拉满多人协作更高效✅ 代码更规范、更专业符合企业级开发标准 完整实现步骤超详细逐行可抄1️⃣ 添加 get_it 依赖到 pubspec.yamldependencies:flutter:sdk:flutter# 核心依赖注入容器get_it:^7.2.0# 复用之前的依赖provider:^6.1.2shared_preferences:^2.2.2cached_network_image:^3.3.1shimmer:^3.0.0执行安装命令确保依赖生效flutter pub get✨ 小提示get_it 是纯 Dart 库无需任何原生改造鸿蒙设备直接运行无任何兼容问题2️⃣ 搭建模块化架构目录核心第一步先重构项目目录实现分层模块化告别杂乱无章最终目录结构复制直接用lib/ ├── di/ # 依赖注入层核心 │ └── injection.dart # 所有依赖的注册与管理 ├── services/ # 服务层封装通用功能 │ ├── storage_service.dart # 本地存储服务 │ └── search_history_service.dart # 搜索历史服务 ├── providers/ # 状态管理层管理页面状态 │ ├── user_provider.dart # 用户状态 │ ├── cart_provider.dart # 购物车状态 │ ├── product_provider.dart # 商品状态 │ └── search_provider.dart # 搜索状态 ├── pages/ # 页面层所有页面 │ ├── home_page.dart │ ├── login_page.dart │ ├── cart_page.dart │ └── ...其他页面 ├── widgets/ # 组件层通用组件 │ ├── cached_image.dart # 图片缓存组件 │ └── ...其他组件 ├── router/ # 路由层 │ └── app_router.dart └── main.dart # 入口文件各层职责说明划重点DI层统一注册所有依赖全局提供实例解耦核心服务层封装通用功能本地存储、网络请求、搜索历史可复用状态管理层管理页面状态依赖服务层不直接操作底层功能页面层只负责UI展示和用户交互依赖状态层不直接依赖服务组件层通用UI组件全项目复用无业务逻辑3️⃣ 实现依赖注入核心injection.dart新建lib/di/injection.dart这是整个依赖注入的“大脑”所有服务、Provider 都在这里注册importpackage:get_it/get_it.dart;import../services/storage_service.dart;import../services/search_history_service.dart;import../providers/user_provider.dart;import../providers/cart_provider.dart;import../providers/product_provider.dart;import../providers/search_provider.dart;// 初始化 get_it 实例全局唯一finalgetItGetIt.instance;// 注册所有依赖的方法FuturevoidinitInjection()async{// --------------------------// 1. 服务层Service注册// --------------------------// 本地存储服务单例全生命周期唯一getIt.registerSingletonAsyncStorageService(()async{finalserviceStorageService();awaitservice.init();// 初始化本地存储returnservice;},);// 搜索历史服务单例依赖 StorageServicegetIt.registerSingletonWithDependenciesSearchHistoryService(()SearchHistoryService(getItStorageService()),dependsOn:[StorageService],// 依赖 StorageService确保先初始化);// --------------------------// 2. 状态管理层Provider注册// --------------------------// UserProvider工厂模式每次获取创建新实例适合页面独立状态getIt.registerFactoryUserProvider(()UserProvider(getItStorageService()),);// CartProvider单例全应用唯一购物车状态全局共享getIt.registerSingletonCartProvider(CartProvider(),);// ProductProvider单例商品数据全局共享getIt.registerSingletonProductProvider(ProductProvider(),);// SearchProvider单例依赖 SearchHistoryServicegetIt.registerSingletonWithDependenciesSearchProvider(()SearchProvider(getItSearchHistoryService()),dependsOn:[SearchHistoryService],);}关键知识点必懂registerSingleton单例模式全局只有一个实例适合全局共享的服务/状态如 CartProvider、StorageServiceregisterFactory工厂模式每次获取都会创建新实例适合页面独立的状态如 UserProviderregisterSingletonAsync异步单例适合需要初始化的服务如 StorageService 需要初始化 shared_preferencesregisterSingletonWithDependencies带依赖的单例确保依赖的服务先初始化4️⃣ 重构服务层Service支持依赖注入之前的服务是静态单例紧耦合现在重构为构造函数注入彻底解耦① 重构 StorageServicelib/services/storage_service.dartimportpackage:shared_preferences/shared_preferences.dart;classStorageService{lateSharedPreferences_prefs;// 无参构造函数供 DI 容器创建StorageService();// 初始化方法Futurevoidinit()async{_prefsawaitSharedPreferences.getInstance();}// 保存登录状态FuturevoidsaveLoginState(bool isLogin)async{await_prefs.setBool(is_login,isLogin);}// 获取登录状态boolgetLoginState(){return_prefs.getBool(is_login)??false;}// 其他存储方法...}② 重构 SearchHistoryServicelib/services/search_history_service.dartimportpackage:shared_preferences/shared_preferences.dart;importstorage_service.dart;classSearchHistoryService{staticconstString_keysearch_history;staticconstint _maxCount20;finalStorageService_storageService;// 构造函数注入依赖 StorageServiceSearchHistoryService(this._storageService);// 获取搜索历史ListStringgetHistory(){return_storageService._prefs.getStringList(_key)??[];}// 添加搜索历史FuturevoidaddHistory(Stringkeyword)async{if(keyword.trim().isEmpty)return;ListStringhistorygetHistory();history.remove(keyword);history.insert(0,keyword);if(history.length_maxCount)history.removeLast();await_storageService._prefs.setStringList(_key,history);}// 其他方法...}5️⃣ 重构状态管理层Provider支持依赖注入重构所有 Provider通过构造函数注入所需服务不再直接依赖具体实现① 重构 UserProviderlib/providers/user_provider.dartimportpackage:flutter/foundation.dart;import../services/storage_service.dart;classUserProviderextendsChangeNotifier{finalStorageService_storageService;bool _isLoggedInfalse;// 构造函数注入 StorageServiceUserProvider(this._storageService){// 初始化时从存储中获取登录状态_isLoggedIn_storageService.getLoginState();}boolgetisLoggedIn_isLoggedIn;// 登录方法Futurevoidlogin(Stringusername,Stringpassword)async{// 模拟登录逻辑if(username.isNotEmptypassword.isNotEmpty){_isLoggedIntrue;await_storageService.saveLoginState(true);notifyListeners();}}// 退出登录方法Futurevoidlogout()async{_isLoggedInfalse;await_storageService.saveLoginState(false);notifyListeners();}}② 重构 SearchProviderlib/providers/search_provider.dartimportpackage:flutter/foundation.dart;import../services/search_history_service.dart;import../providers/product_provider.dart;import../models/product.dart;classSearchProviderextendsChangeNotifier{finalSearchHistoryService_historyService;ListString_historyList[];ListProduct_resultList[];String_keyword;// 构造函数注入 SearchHistoryServiceSearchProvider(this._historyService);ListStringgethistoryList_historyList;ListProductgetresultList_resultList;Stringgetkeyword_keyword;// 加载搜索历史依赖注入的服务FuturevoidloadHistory()async{_historyList_historyService.getHistory();notifyListeners();}// 其他方法...}其他 Provider 重构CartProvider、ProductProvider按照上面的逻辑给需要依赖的 Provider 添加构造函数注入无需修改核心业务逻辑只改依赖方式即可6️⃣ 改造 main.dart初始化依赖注入修改入口文件先初始化依赖注入再启动应用确保所有服务、Provider 都能正常获取importpackage:flutter/material.dart;importpackage:provider/provider.dart;importpackage:go_router/go_router.dart;importdi/injection.dart;importrouter/app_router.dart;voidmain()async{WidgetsFlutterBinding.ensureInitialized();// 第一步初始化依赖注入必须在 runApp 之前awaitinitInjection();runApp(constMyApp());}classMyAppextendsStatelessWidget{constMyApp({super.key});overrideWidgetbuild(BuildContextcontext){returnMultiProvider(providers:[// 从 DI 容器中获取 Provider 实例ChangeNotifierProvider.value(value:getItUserProvider()),ChangeNotifierProvider.value(value:getItCartProvider()),ChangeNotifierProvider.value(value:getItProductProvider()),ChangeNotifierProvider.value(value:getItSearchProvider()),],child:MaterialApp.router(title:Flutter 鸿蒙电商 App,theme:ThemeData(primarySwatch:Colors.blue),routerConfig:appRouter,debugShowCheckedModeBanner:false,),);}}7️⃣ 全局使用依赖注入核心用法重构完成后所有页面、组件中无需手动创建实例直接从 DI 容器中获取即可示例1页面中使用 Provider// 旧写法紧耦合手动创建finaluserProviderUserProvider(StorageService());// 新写法松耦合从 DI 容器获取finaluserProvidergetItUserProvider();示例2服务中使用依赖// 旧写法直接依赖静态方法StorageService.saveLoginState(true);// 新写法从 DI 容器获取服务finalstorageServicegetItStorageService();awaitstorageService.saveLoginState(true);示例3路由守卫中使用redirect:(context,state){// 从 DI 容器获取 UserProvider无需手动注入finaluserProvidergetItUserProvider();finalisLoginuserProvider.isLoggedIn;// 其他逻辑...} 鸿蒙真机测试验证执行命令运行项目验证依赖注入和模块化架构是否正常工作flutter clean flutter pub get flutter run测试场景全部通过才算成功✅ 依赖注入初始化成功无报错✅ 登录/退出登录正常本地存储生效✅ 搜索历史正常保存/删除依赖服务正常✅ 购物车状态全局共享页面切换数据不丢失✅ 鸿蒙真机运行流畅无卡顿、无崩溃✅ 新增页面/组件时可直接从 DI 容器获取依赖无需重复创建⚠️ 鸿蒙开发常见坑解决必看坑1依赖注入初始化失败报错“Instance not found”原因依赖注册顺序错误被依赖的服务后注册解决方案使用dependsOn明确依赖关系确保被依赖的服务先注册坑2Provider 无法获取页面无状态原因main.dart 中未通过ChangeNotifierProvider.value注入 DI 中的实例解决方案确保所有 Provider 都在 MultiProvider 中注册且使用getIt获取坑3异步服务初始化未完成导致空指针原因initInjection是异步方法未等待完成就启动应用解决方案在 main 函数中使用await initInjection()确保初始化完成坑4模块化目录结构混乱找不到文件解决方案严格按照我们给出的目录结构搭建导入路径要对应坑5鸿蒙设备上 DI 实例获取异常原因get_it 版本过低不兼容鸿蒙 Flutter 版本解决方案升级 get_it 到 7.2.0 以上 进阶优化方向企业级必备添加接口抽象给服务层添加抽象接口如IStorageService实现依赖倒置更易测试添加 mock 测试使用 mockito 模拟依赖编写单元测试模块化拆分更细致按功能拆分模块如商品模块、用户模块、购物车模块添加依赖注入异常处理防止获取不到实例导致崩溃集成 get_it 代码生成使用 get_it_generator 自动生成注册代码减少手动操作添加网络层依赖注入将 Dio 网络请求注册到 DI 容器统一管理 总结到这里我们完整实现了 Flutter 鸿蒙项目的 get_it 依赖注入 模块化架构优化你已经拥有了✅ 一套企业级的模块化分层架构DI层、服务层、状态层、页面层✅ get_it 依赖注入容器实现类与类之间的彻底松耦合✅ 单例/工厂模式灵活运用合理管理实例生命周期✅ 全项目代码重构结构清晰、易维护、可扩展✅ 鸿蒙真机完美适配运行流畅无报错✅ 具备大型项目开发能力代码规范可直接用于竞赛、课程设计这套架构不仅适用于鸿蒙项目所有 Flutter 项目都能复用学会它你就超越了 80% 的 Flutter 初学者喜欢记得点赞关注持续更新 Flutter 鸿蒙实战教程带你从 0 到 1 打造企业级跨平台应用