Files
LN-Code-Editor/lib/views/terminal_view.dart
T
2026-09-15 00:50:53 +08:00

294 lines
10 KiB
Dart
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import 'package:code_editor/l10n/app_localizations.dart';
import 'package:code_editor/models/app_font.dart';
import 'package:code_editor/models/distro_manifest.dart';
import 'package:code_editor/models/terminal_session.dart';
import 'package:code_editor/models/virtual_keyboard_config.dart';
import 'package:code_editor/providers/distro_provider.dart';
import 'package:code_editor/providers/project_provider.dart';
import 'package:code_editor/providers/settings_provider.dart';
import 'package:code_editor/providers/terminal_provider.dart';
import 'package:code_editor/utils/terminal_theme_helper.dart';
import 'package:code_editor/widgets/distro_extract_dialog.dart';
import 'package:code_editor/widgets/distro_selector_dialog.dart';
import 'package:code_editor/widgets/terminal_drawer.dart';
import 'package:code_editor/widgets/terminal_keyboard_sink.dart';
import 'package:code_editor/widgets/terminal_modifier_state.dart';
import 'package:code_editor/widgets/virtual_keyboard_widget.dart';
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:xterm/xterm.dart' as xterm;
import 'package:xterm/xterm.dart' show TerminalInputHandler, defaultInputHandler;
/// 终端视图(支持多系统实例切换、全屏会话保持、右侧抽屉多会话管理与交互)
class TerminalView extends StatefulWidget {
const TerminalView({super.key});
@override
State<TerminalView> createState() => _TerminalViewState();
}
class _TerminalViewState extends State<TerminalView> {
final GlobalKey<ScaffoldState> _scaffoldKey = GlobalKey<ScaffoldState>();
@override
void initState() {
super.initState();
// 首次或进入终端时:检测已安装系统。如果不存在任何系统,自动从软件内置导入 alpine
WidgetsBinding.instance.addPostFrameCallback((_) async {
if (!mounted) return;
final distroProvider = context.read<DistroProvider?>();
final l10n = AppLocalizations.of(context)!;
final defaultSessionName = l10n.sessionDefaultName;
final projectRoot = context.read<ProjectProvider?>()?.rootPath;
if (distroProvider == null) {
context.read<TerminalProvider>().ensureInitialized(
defaultName: defaultSessionName,
workspacePath: projectRoot,
);
return;
}
await distroProvider.init();
if (!mounted) return;
if (!distroProvider.hasAnySystem) {
// 自动从软件内置资源导入 Ubuntu 24.04(推荐主力开发环境),名称为 ubuntu
final success = await DistroExtractDialog.show(
context: context,
systemName: DistroRepository.defaultSystemName,
task: (onProgress, isCancelled) {
return distroProvider.importBuiltinUbuntu(
systemName: DistroRepository.defaultSystemName,
onProgress: onProgress,
isCancelled: isCancelled,
);
},
);
if (success && mounted) {
final termProvider = context.read<TerminalProvider>();
if (termProvider.isEmpty) {
termProvider.createSession(
name: defaultSessionName,
distroId: DistroRepository.defaultSystemName,
workspacePath: projectRoot,
activate: true,
);
}
}
} else {
// 已有系统,确保初始化首个会话
final termProvider = context.read<TerminalProvider>();
if (termProvider.isEmpty) {
final system = distroProvider.selectedSystem ?? DistroRepository.defaultSystemName;
termProvider.createSession(
name: defaultSessionName,
distroId: system,
workspacePath: projectRoot,
activate: true,
);
}
}
});
}
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final l10n = AppLocalizations.of(context)!;
final provider = context.watch<TerminalProvider>();
final activeSession = provider.activeSession;
final sessions = provider.sessions;
final activeIndex = provider.activeIndex;
final titleText = activeSession?.name ?? l10n.sessionDefaultName;
// 副标题严格取自当前会话绑定的工作目录根路径
final sessionWorkspace = activeSession?.workspacePath;
final String? subtitleText = (sessionWorkspace != null && sessionWorkspace.trim().isNotEmpty)
? sessionWorkspace.trim()
: null;
return Scaffold(
key: _scaffoldKey,
appBar: AppBar(
backgroundColor: theme.colorScheme.primaryContainer,
foregroundColor: theme.colorScheme.onSurface,
leading: IconButton(
icon: const Icon(Icons.arrow_back),
tooltip: l10n.back,
onPressed: () => Navigator.of(context).pop(),
),
title: Column(
crossAxisAlignment: CrossAxisAlignment.start,
mainAxisSize: MainAxisSize.min,
children: [
Text(
titleText,
style: const TextStyle(
fontSize: 16.0,
fontWeight: FontWeight.bold,
),
overflow: TextOverflow.ellipsis,
),
if (subtitleText != null)
Text(
subtitleText,
style: TextStyle(
fontSize: 11.0,
color: theme.colorScheme.onSurfaceVariant,
),
overflow: TextOverflow.ellipsis,
),
],
),
actions: [
// 系统选择与管理按钮(位于会话列表左侧)
IconButton(
icon: const Icon(Icons.dns_outlined),
tooltip: l10n.systemManagementTooltip,
onPressed: () {
DistroSelectorDialog.show(context);
},
),
IconButton(
icon: const Icon(Icons.format_list_bulleted),
tooltip: l10n.sessionListTooltip,
onPressed: () {
_scaffoldKey.currentState?.openEndDrawer();
},
),
],
),
endDrawer: const TerminalDrawer(),
body: sessions.isEmpty
? Center(
child: Text(
l10n.noActiveSessions,
style: const TextStyle(color: Colors.grey),
),
)
: IndexedStack(
index: (activeIndex >= 0 && activeIndex < sessions.length) ? activeIndex : 0,
children: [
for (final session in sessions)
_TerminalSessionBody(
key: ValueKey(session.id),
session: session,
),
],
),
);
}
}
/// 单个真实交互式终端会话的终端渲染与交互容器
class _TerminalSessionBody extends StatefulWidget {
final TerminalSession session;
const _TerminalSessionBody({
super.key,
required this.session,
});
@override
State<_TerminalSessionBody> createState() => _TerminalSessionBodyState();
}
class _TerminalSessionBodyState extends State<_TerminalSessionBody> {
/// 小键盘修饰键的运行时状态:键盘组件与终端共用同一份
late final TerminalModifierState _modifiers = TerminalModifierState();
/// 终端原有的输入处理器与输出出口(用于串联,而不是替换)
TerminalInputHandler? _delegateInputHandler;
void Function(String)? _delegateOnOutput;
@override
void initState() {
super.initState();
final terminal = widget.session.terminal;
// ① 按键事件(硬件键盘、小键盘 key 格)都会经过 inputHandler:
// 把运行时修饰键叠加进事件,再交给 xterm 默认链路。
_delegateInputHandler = terminal.inputHandler;
terminal.inputHandler = ModifierAwareInputHandler(
state: _modifiers,
delegate: _delegateInputHandler ?? defaultInputHandler,
);
// ② 软键盘 / IME 打进来的字符不产生 KeyEvent,只能在这里改写。
_delegateOnOutput = terminal.onOutput;
terminal.onOutput = (data) {
final transformed = applyModifierToTypedText(data, _modifiers.mods);
_delegateOnOutput?.call(transformed ?? data);
if (transformed != null) _modifiers.consume();
};
}
@override
void dispose() {
final terminal = widget.session.terminal;
if (terminal.inputHandler is ModifierAwareInputHandler) {
terminal.inputHandler = _delegateInputHandler;
}
terminal.onOutput = _delegateOnOutput;
_modifiers.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final session = widget.session;
final settings = context.watch<SettingsProvider?>();
final terminalFont = settings?.terminalFont ?? AppFonts.terminalMonospace;
final terminalStyle = xterm.TerminalStyle(
fontSize: 13.0,
fontFamily: terminalFont.fontFamily ?? 'monospace',
fontFamilyFallback: terminalFont.fallback,
);
// 终端小键盘:开关与配置均独立于编辑区
final keyboardEnabled = settings?.keyboardEnabledFor(KeyboardScope.terminal) ?? false;
final keyboardConfig = settings?.keyboardConfigFor(KeyboardScope.terminal);
// 终端背景颜色(设置项):容器与 xterm 主题保持一致
final backgroundColor = settings?.terminalBackgroundColor ?? const Color(0xFF1E1E1E);
return Container(
color: backgroundColor,
child: SafeArea(
top: false,
child: Column(
children: [
Expanded(
child: xterm.TerminalView(
session.terminal,
focusNode: session.focusNode,
autofocus: true,
theme: terminalThemeWithBackground(backgroundColor),
textStyle: terminalStyle,
cursorType: xterm.TerminalCursorType.block,
padding: const EdgeInsets.symmetric(horizontal: 10.0, vertical: 8.0),
),
),
if (keyboardEnabled && keyboardConfig != null && keyboardConfig.hasKeys)
VirtualKeyboardWidget(
controller: null,
focusNode: session.focusNode,
sink: TerminalKeyboardSink(
terminal: session.terminal,
focusNode: session.focusNode,
),
modifierState: _modifiers,
config: keyboardConfig,
),
],
),
),
);
}
}