196 lines
5.3 KiB
Dart
196 lines
5.3 KiB
Dart
import 'package:flutter/foundation.dart';
|
|
|
|
/// 通知条目类型(决定默认配色与图标)
|
|
enum NoticeKind {
|
|
/// 进行中(带进度圈)
|
|
progress,
|
|
|
|
/// 已完成
|
|
success,
|
|
|
|
/// 失败(默认保留到手动关闭)
|
|
failure,
|
|
|
|
/// 纯信息
|
|
info,
|
|
}
|
|
|
|
/// 探测阶段(对应 l10n 文案 key)
|
|
///
|
|
/// 队列线性执行:每个模块依次经历
|
|
/// [queued] 排队 → [checkingDependency] 依赖检测 → [installingDependency] 自动补全
|
|
/// → [detecting] 执行探测 → [finalizing] 结果整理。
|
|
enum ProbeNoticePhase { queued, checkingDependency, installingDependency, detecting, finalizing }
|
|
|
|
/// 探测失败分类(对应 l10n 文案 key)
|
|
enum NoticeFailure {
|
|
toolchainMissing,
|
|
dependencyInstallFailed,
|
|
executionFailed,
|
|
unparsable,
|
|
timeout,
|
|
}
|
|
|
|
/// 结构化通知文案:**模型层不含任何用户可见字符串**,
|
|
/// 实际文字由 UI 层 `resolveNoticeDisplay()` 通过 l10n 解析(禁止硬编码)。
|
|
sealed class NoticeText {
|
|
const NoticeText();
|
|
}
|
|
|
|
/// 模块探测阶段文案:排队 / 依赖检测 / 自动补全 / 执行探测 / 整理
|
|
class ModulePhaseText extends NoticeText {
|
|
/// 模块展示名(如 'Gradle',来自 ProjectModule.displayName,不是文案)
|
|
final String moduleDisplayName;
|
|
final ProbeNoticePhase phase;
|
|
|
|
/// 可选技术细节(例如安装过程中的最后一行输出),展示为副标题
|
|
final String? detail;
|
|
|
|
const ModulePhaseText({
|
|
required this.moduleDisplayName,
|
|
required this.phase,
|
|
this.detail,
|
|
});
|
|
}
|
|
|
|
/// 模块探测完成(带发现的任务数)
|
|
class ModuleDoneText extends NoticeText {
|
|
final String moduleDisplayName;
|
|
final int taskCount;
|
|
|
|
const ModuleDoneText(this.moduleDisplayName, {this.taskCount = 0});
|
|
}
|
|
|
|
/// 整轮探测因超出时间预算而中止(已完成 [completed]/[total] 个模块)
|
|
class ProbeBudgetExceededText extends NoticeText {
|
|
final int completed;
|
|
final int total;
|
|
|
|
const ProbeBudgetExceededText({required this.completed, required this.total});
|
|
}
|
|
|
|
/// 模块探测失败(带失败分类与可选技术细节,如缺失的工具名 / stderr 末尾)
|
|
class ModuleFailureText extends NoticeText {
|
|
final String moduleDisplayName;
|
|
final NoticeFailure failure;
|
|
final String? detail;
|
|
|
|
const ModuleFailureText({
|
|
required this.moduleDisplayName,
|
|
required this.failure,
|
|
this.detail,
|
|
});
|
|
}
|
|
|
|
/// 后台组件安装/卸载阶段通知(支持排队、执行中)
|
|
class ComponentInstallPhaseText extends NoticeText {
|
|
final String componentName;
|
|
final bool isUninstall;
|
|
final bool isQueued;
|
|
final String? detail;
|
|
|
|
const ComponentInstallPhaseText({
|
|
required this.componentName,
|
|
this.isUninstall = false,
|
|
this.isQueued = false,
|
|
this.detail,
|
|
});
|
|
}
|
|
|
|
/// 后台组件安装/卸载成功通知
|
|
class ComponentInstallDoneText extends NoticeText {
|
|
final String componentName;
|
|
final bool isUninstall;
|
|
|
|
const ComponentInstallDoneText({
|
|
required this.componentName,
|
|
this.isUninstall = false,
|
|
});
|
|
}
|
|
|
|
/// 后台组件安装/卸载失败通知
|
|
class ComponentInstallFailureText extends NoticeText {
|
|
final String componentName;
|
|
final bool isUninstall;
|
|
final String? error;
|
|
|
|
const ComponentInstallFailureText({
|
|
required this.componentName,
|
|
this.isUninstall = false,
|
|
this.error,
|
|
});
|
|
}
|
|
|
|
/// 一条通知(业务无关:任务探测、以后的下载/编译进度都可复用)
|
|
@immutable
|
|
class NoticeItem {
|
|
/// 稳定标识(如 'probe:gradle'),用于插入/移除动画定位与就地更新
|
|
final String id;
|
|
|
|
final NoticeKind kind;
|
|
final NoticeText text;
|
|
|
|
/// 0..1 进度;null 表示不定进度
|
|
final double? progress;
|
|
|
|
/// 完成后是否必须由用户手动关闭(失败场景用)
|
|
final bool sticky;
|
|
|
|
/// 完成后延时自动关闭(成功场景用)
|
|
final Duration? autoCloseAfter;
|
|
|
|
/// 用户点击 × 时的附加动作(例如"正在探测"的通知被关闭 => 取消探测)
|
|
final VoidCallback? onUserDismiss;
|
|
|
|
/// 关闭前是否需要二次确认(破坏性操作,例如取消正在进行的探测)
|
|
final bool confirmBeforeDismiss;
|
|
|
|
const NoticeItem({
|
|
required this.id,
|
|
required this.kind,
|
|
required this.text,
|
|
this.progress,
|
|
this.sticky = false,
|
|
this.autoCloseAfter,
|
|
this.onUserDismiss,
|
|
this.confirmBeforeDismiss = false,
|
|
});
|
|
|
|
NoticeItem copyWith({
|
|
NoticeKind? kind,
|
|
NoticeText? text,
|
|
double? progress,
|
|
bool? sticky,
|
|
Duration? autoCloseAfter,
|
|
bool? confirmBeforeDismiss,
|
|
bool clearProgress = false,
|
|
bool clearAutoClose = false,
|
|
}) {
|
|
return NoticeItem(
|
|
id: id,
|
|
kind: kind ?? this.kind,
|
|
text: text ?? this.text,
|
|
progress: clearProgress ? null : (progress ?? this.progress),
|
|
sticky: sticky ?? this.sticky,
|
|
autoCloseAfter:
|
|
clearAutoClose ? null : (autoCloseAfter ?? this.autoCloseAfter),
|
|
onUserDismiss: onUserDismiss,
|
|
confirmBeforeDismiss: confirmBeforeDismiss ?? this.confirmBeforeDismiss,
|
|
);
|
|
}
|
|
|
|
@override
|
|
bool operator ==(Object other) =>
|
|
other is NoticeItem &&
|
|
other.id == id &&
|
|
other.kind == kind &&
|
|
other.text == text &&
|
|
other.progress == progress &&
|
|
other.sticky == sticky &&
|
|
other.autoCloseAfter == autoCloseAfter;
|
|
|
|
@override
|
|
int get hashCode =>
|
|
Object.hash(id, kind, text, progress, sticky, autoCloseAfter);
|
|
}
|