独立移动 APP (Flutter 移动专属: iOS / Android)

1. 核心技术栈清单与职责说明

架构层级	推荐选型	职责与功能定位说明
移动核心底座	Flutter 3.x (Mobile) + Dart 3.x	Google 官方跨端移动自绘引擎，基于 Skia/Impeller 在 iOS 和 Android 上实现高性能渲染
UI 与设计语言	Material 3 (移动专属 Slate Tokens)	移动端专属响应式设计体系，内置针对手机触摸屏优化的高质感圆角、卡片与交互反馈
状态管理	flutter_bloc (Cubit-First)	响应式状态管理架构，优先推行轻量 Cubit 模式，免除繁重的代码生成注解与编译负担
依赖注入与解耦	get_it	轻量级全局服务定位器（Service Locator），统一管理单例与工厂，解耦 UI、Cubit 与 Repository 数据源
声明式路由	go_router	Flutter 官方推荐路由方案，完整支持深度链接（Deep Linking）、路由守卫与重定向
网络请求层	Dio	移动端标杆网络库，支持连接池复用、请求拦截鉴权、文件断点续传与请求取消
动静三层存储	flutter_secure_storage + shared_preferences + drift	敏感凭证（Token/密钥）入安全沙箱；轻量配置走 KV；本地大容量离线业务数据由响应式 SQLite ORM drift 掌管
图片二级缓存	cached_network_image	移动端网络图片标配，提供内存与本地磁盘二级缓存、防抖占位图与渐变加载动效
运行时权限管理	permission_handler	跨端统一管理系统敏感外设权限（相册、相机、定位、通知），抹平 Android 运行时申请与 iOS 弹窗差异
系统中文本地化	flutter_localizations (SDK内置) + intl	挂载 Material/Cupertino/Widgets 三大本地化代理，消除输入框长按菜单英文（Copy/Paste），格式化中文日期与人民币符号（￥）
中文拼音与索引	lpinyin	纯 Dart 汉字转拼音中枢，支持多音字识别与拼音首字母提取，专职驱动通讯录、城市选择器及搜索联想的 A-Z 拼音排序与索引条

2. 核心选型考量与技术优势

• 纯粹面向移动生态极致轻量：彻底剥离桌面平台相关依赖插件（如 window_manager、tray_manager 等），杜绝安装包多余体积膨胀，保证移动端极速冷启动。
• 高度统一的像素级渲染：自绘引擎绕过原生 OEM 控件，iOS 与 Android 呈现 100% 像素级一致的视觉表现，消灭安卓多机型碎片化显示差异。
• 架构解耦与动静三层持久化：
  • 通过 get_it 注册全局数据仓库与网络客户端，消除 Widget 树深层传参的祖传代码难题，便于单元测试 Mock；
  • 构建“安全沙箱 + 轻量 KV + 关系型大表 SQLite”三层存储体系，支持在无网环境下通过 drift 响应式流（Stream）实时更新离线业务数据。
• 移动端高频核心体验刚需闭环：
  • cached_network_image 彻底解决移动蜂窝网络下图片重复加载与列表快速滚动时的白块闪烁；
  • permission_handler 规范化管理系统敏感权限声明与生命周期捕获，保障各大应用商店严格合规上架。
• 中文本土化与排版关键工程基线（四大避坑防御）：
  • 0MB 字体膨胀的系统回退链：显式声明 fontFamilyFallback: ['PingFang SC', 'Noto Sans SC', 'Heiti SC', 'sans-serif']，iOS 调用苹方，Android 调用思源黑体，0MB 体积代价下彻底根除日式异体汉字（如“门”、“关”日式变形笔画）与豆腐块乱码，拒绝引入数十兆外部字体包；
  • 消除原生组件英文残留：注入 flutter_localizations 官方代理并锁定 Locale('zh', 'CN')，使系统级日历 Picker、输入框上下文菜单（全选/复制/粘贴/剪切）与时间控件呈现纯正中文；
  • CJK 方块字垂直居中对齐规范：针对西文基线挤压汉字的问题，全局配置 TextTheme 开启 TextLeadingDistribution.even，结合 TextBaseline.ideographic，消除文字与图标混排时的下沉偏移，实现像素级居中；
  • 中文拼音首字母检索与交互规范：依托 lpinyin 为中文姓名、城市及商品数据自动建立拼音首字母哈希映射，无缝支撑类似微信通讯录的右侧 A-Z 字母索引条与拼音模糊搜索。

3. 适用业务场景

• 纯手机/平板移动终端原生 App（iOS 与 Android 双平台分发）；
• 涉及离线缓存、大容量本地数据、丰富手势微动效与定制化 UI 视觉呈现的消费级移动产品；
• 独立出海应用、工具类软件与移动端轻量社交产品。

4. 局限性与权衡说明

• 局限性：本技术栈专精于移动生态，不包含任何 PC 桌面端适配逻辑；与原生操作系统极端深度的平台特性（如深度定制硬件底层驱动）对接仍需编写 MethodChannel。
• 权衡建议：若项目同时规划了 PC 桌面端版本，建议视重用度评估选择第 06 节（独立桌面）或第 08 节（全端通用）方案。