安装

环境要求

要求	版本
Flutter	≥ 3.12.2
Dart SDK	≥ 3.12.2

在项目根目录执行：

bash

flutter pub add flutter_miuix

或手动在 pubspec.yaml 中添加：

yaml

dependencies:
  flutter_miuix: ^1.0.1

然后执行：

bash

flutter pub get

一个 import 即可使用全部公开 API：

dart

import 'package:flutter_miuix/miuix.dart';

安装 flutter_miuix 时会自动引入以下依赖，无需手动配置：

依赖	用途
`material_color_utilities`	HCT 色彩科学 + Material 动态配色方案（TonalSpot / Vibrant 等 9 种），用于从种子色生成整套 miuix 配色
`dynamic_color`	Android 系统壁纸取色（`miuixPlatformDynamicColors` 的 Android 实现），其他平台自动回退到固定种子色

液态玻璃效果所需的片段着色器（shaders/miuix_bloom_stroke.frag）已随包打包，同样无需任何额外配置。

所有平台（Android / iOS / macOS / Windows / Linux / Web）均完整支持，无需平台侧配置。唯一的差异是壁纸动态取色只在 Android 上生效，其他平台会回退到固定种子色（详见主题定制）。