Files
LN-Code-Editor/lib/views/terminal_view.dart
T
2026-09-17 18:41:33 +08:00

456 lines
17 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/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/services/internal_project_service.dart';
import 'package:code_editor/widgets/virtual_keyboard_widget.dart';
import 'package:code_editor/widgets/terminal_selection_overlay.dart';
import 'package:flutter/material.dart';
import 'package:path/path.dart' as p;
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?.trim();
final String? subtitleText = (sessionWorkspace != null && sessionWorkspace.isNotEmpty)
? (InternalProjectService.instance.isInternalProject(sessionWorkspace)
? p.basename(sessionWorkspace)
: sessionWorkspace)
: 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: [
// 系统选择与管理入口已收敛隐藏,统一使用默认主系统 (Ubuntu)
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();
/// 终端控制器与 View GlobalKey(用于选区、手柄与上下文菜单定位)
late final xterm.TerminalController _terminalController = xterm.TerminalController();
final ScrollController _terminalScrollController = ScrollController();
final GlobalKey<xterm.TerminalViewState> _terminalViewKey = GlobalKey<xterm.TerminalViewState>();
/// 终端原有的输入处理器与输出出口(用于串联,而不是替换)
TerminalInputHandler? _delegateInputHandler;
void Function(String)? _delegateOnOutput;
// 双指捏合缩放终端字号状态
final Map<int, Offset> _pointerPositions = {};
double? _initialPinchDistance;
double? _initialPinchFontSize;
double? _activeZoomFontSize;
bool _isPinching = false;
Offset? _initialLocalFocal;
double _initialScrollV = 0.0;
void _handlePointerDown(PointerDownEvent event, double currentFontSize) {
_pointerPositions[event.pointer] = event.position;
if (_pointerPositions.length == 2) {
final points = _pointerPositions.values.toList();
_initialPinchDistance = (points[0] - points[1]).distance;
_initialPinchFontSize = _activeZoomFontSize ?? currentFontSize;
final globalFocal = (points[0] + points[1]) / 2;
final renderBox = context.findRenderObject() as RenderBox?;
_initialLocalFocal = renderBox != null ? renderBox.globalToLocal(globalFocal) : globalFocal;
_initialScrollV = _terminalScrollController.hasClients ? _terminalScrollController.offset : 0.0;
// 双指缩放开始时,清除可能残留的选区,避免手柄或菜单错位
_terminalController.clearSelection();
setState(() {
_isPinching = true;
});
}
}
void _handlePointerMove(PointerMoveEvent event) {
if (!_pointerPositions.containsKey(event.pointer)) return;
_pointerPositions[event.pointer] = event.position;
if (_pointerPositions.length >= 2 &&
_initialPinchDistance != null &&
_initialPinchDistance! > 10.0 &&
_initialPinchFontSize != null &&
_initialLocalFocal != null) {
final points = _pointerPositions.values.toList();
final currentDistance = (points[0] - points[1]).distance;
final scale = currentDistance / _initialPinchDistance!;
final rawFontSize = (_initialPinchFontSize! * scale).clamp(SettingsProvider.minFontSize, SettingsProvider.maxFontSize);
final newFontSize = (rawFontSize * 10).round() / 10.0;
final fontScale = newFontSize / _initialPinchFontSize!;
final currentGlobalFocal = (points[0] + points[1]) / 2;
final renderBox = context.findRenderObject() as RenderBox?;
final currentLocalFocal = renderBox != null
? renderBox.globalToLocal(currentGlobalFocal)
: currentGlobalFocal;
if (_terminalScrollController.hasClients && _terminalScrollController.position.maxScrollExtent > 0) {
final targetScrollV = (_initialScrollV + _initialLocalFocal!.dy) * fontScale - currentLocalFocal.dy;
_terminalScrollController.jumpTo(targetScrollV.clamp(0.0, _terminalScrollController.position.maxScrollExtent));
}
if (_activeZoomFontSize != newFontSize) {
setState(() {
_activeZoomFontSize = newFontSize;
});
}
}
}
void _handlePointerUp(PointerUpEvent event) {
_pointerPositions.remove(event.pointer);
if (_pointerPositions.length < 2 && _isPinching) {
_finishPinchZoom();
}
}
void _handlePointerCancel(PointerCancelEvent event) {
_pointerPositions.remove(event.pointer);
if (_pointerPositions.length < 2 && _isPinching) {
_finishPinchZoom();
}
}
void _finishPinchZoom() {
final finalSize = _activeZoomFontSize;
if (finalSize != null) {
try {
final settings = context.read<SettingsProvider?>();
settings?.setTerminalFontSize(finalSize.roundToDouble());
} catch (_) {}
}
setState(() {
_isPinching = false;
_initialPinchDistance = null;
_initialPinchFontSize = null;
_activeZoomFontSize = null;
_initialLocalFocal = null;
_initialScrollV = 0.0;
});
}
@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();
_terminalScrollController.dispose();
_terminalController.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final session = widget.session;
final settings = context.watch<SettingsProvider?>();
final terminalFont = settings?.terminalFont ?? AppFonts.terminalMonospace;
final currentBaseFontSize = settings?.terminalFontSize ?? 13.0;
final displayFontSize = _activeZoomFontSize ?? currentBaseFontSize;
final terminalStyle = xterm.TerminalStyle(
fontSize: displayFontSize,
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: Stack(
children: [
Positioned.fill(
child: Listener(
behavior: HitTestBehavior.translucent,
onPointerDown: (e) => _handlePointerDown(e, currentBaseFontSize),
onPointerMove: _handlePointerMove,
onPointerUp: _handlePointerUp,
onPointerCancel: _handlePointerCancel,
child: TerminalSelectionOverlay(
terminal: session.terminal,
controller: _terminalController,
terminalViewKey: _terminalViewKey,
scrollController: _terminalScrollController,
focusNode: session.focusNode,
child: xterm.TerminalView(
session.terminal,
key: _terminalViewKey,
controller: _terminalController,
scrollController: _terminalScrollController,
focusNode: session.focusNode,
autofocus: true,
theme: terminalThemeWithBackground(backgroundColor),
textStyle: terminalStyle,
cursorType: xterm.TerminalCursorType.block,
padding: const EdgeInsets.fromLTRB(10.0, 8.0, 10.0, 20.0),
),
),
),
),
// 双指缩放实时字号悬浮胶囊提示
if (_isPinching && _activeZoomFontSize != null)
Positioned(
top: 16,
left: 0,
right: 0,
child: Center(
child: Container(
padding: const EdgeInsets.symmetric(horizontal: 14, vertical: 6),
decoration: BoxDecoration(
color: backgroundColor.computeLuminance() > 0.5
? Colors.black.withValues(alpha: 0.75)
: Colors.white.withValues(alpha: 0.85),
borderRadius: BorderRadius.circular(16),
boxShadow: [
BoxShadow(
color: Colors.black.withValues(alpha: 0.2),
blurRadius: 8,
offset: const Offset(0, 2),
),
],
),
child: Text(
'${_activeZoomFontSize!.round()} pt',
style: TextStyle(
color: backgroundColor.computeLuminance() > 0.5
? Colors.white
: Colors.black87,
fontSize: 13,
fontWeight: FontWeight.w600,
letterSpacing: 0.3,
),
),
),
),
),
],
),
),
if (keyboardEnabled && keyboardConfig != null && keyboardConfig.hasKeys)
VirtualKeyboardWidget(
controller: null,
focusNode: session.focusNode,
sink: TerminalKeyboardSink(
terminal: session.terminal,
focusNode: session.focusNode,
),
modifierState: _modifiers,
config: keyboardConfig,
),
],
),
),
);
}
}