import 'dart:io'; import 'package:flutter/foundation.dart'; import 'package:flutter/services.dart'; import 'package:path/path.dart' as p; import 'package:path_provider/path_provider.dart'; import '../models/distro_info.dart'; import 'distro_installer.dart'; /// 容器启动配置数据 class ProotLaunchConfig { /// 可执行程序(proot 二进制路径或 host shell) final String executable; /// 启动参数 final List arguments; /// 环境变量 final Map environment; /// 初始工作目录 final String workingDirectory; const ProotLaunchConfig({ required this.executable, required this.arguments, required this.environment, required this.workingDirectory, }); /// 格式化为命令行预览字符串 String toCommandLine() { final argsStr = arguments.map((a) => a.contains(' ') ? '"$a"' : a).join(' '); return '$executable $argsStr'; } } /// Linux 发行版与多系统实例管理器服务(单例模式,易扩展) class DistroManager { static final DistroManager _instance = DistroManager._internal(); factory DistroManager() => _instance; DistroManager._internal(); /// 自定义覆盖根目录(主要用于测试) @visibleForTesting Directory? customBaseDir; /// 获取发行版存储基础目录: `/distros` Future getBaseDistrosDir() async { if (customBaseDir != null) { return customBaseDir!; } final appDir = await getApplicationSupportDirectory(); final distrosDir = Directory(p.join(appDir.path, 'distros')); if (!distrosDir.existsSync()) { distrosDir.createSync(recursive: true); } return distrosDir; } /// 获取指定系统实例的 Rootfs 解压目录: `/distros//rootfs` Future getSystemRootDir(String systemName) async { final baseDir = await getBaseDistrosDir(); return Directory(p.join(baseDir.path, systemName, 'rootfs')); } /// 获取当前已创建并解压成功的系统实例列表(文件夹名称即系统名称) Future> listInstalledSystems() async { final baseDir = await getBaseDistrosDir(); if (!baseDir.existsSync()) return []; final List systems = []; final entities = baseDir.listSync(followLinks: false); for (final entity in entities) { if (entity is Directory) { final name = p.basename(entity.path); // 若子目录存在 rootfs/ 且包含基础目录结构,则视为有效系统实例 final rootDir = Directory(p.join(entity.path, 'rootfs')); if (rootDir.existsSync()) { systems.add(name); } } } // 按名称字母排序 systems.sort((a, b) => a.compareTo(b)); return systems; } /// 是否存在任何已安装的系统 Future hasAnySystem() async { final systems = await listInstalledSystems(); return systems.isNotEmpty; } /// 检测指定系统实例是否已安装就绪 Future isSystemInstalled(String systemName) async { if (systemName == 'host') return true; final rootDir = await getSystemRootDir(systemName); if (!rootDir.existsSync()) return false; final hasEtc = Directory(p.join(rootDir.path, 'etc')).existsSync(); final hasBin = Directory(p.join(rootDir.path, 'bin')).existsSync(); return hasEtc && hasBin; } /// 校验系统名称是否合法且未被占用 Future validateSystemName(String systemName) async { final trimmed = systemName.trim(); if (trimmed.isEmpty) { throw ArgumentError('系统名称不能为空'); } // 限制字符集:字母、数字、下划线、短横线、中文字符 final validRegex = RegExp(r'^[\w\u4e00-\u9fa5\-_]+$'); if (!validRegex.hasMatch(trimmed)) { throw ArgumentError('系统名称只能包含字母、数字、中文、下划线或短横线'); } final systems = await listInstalledSystems(); if (systems.any((s) => s.toLowerCase() == trimmed.toLowerCase())) { throw ArgumentError('已存在同名系统 "$trimmed",请使用其他名称'); } } /// 从应用内置资源导入 Alpine Linux 系统实例 /// /// [systemName] 系统名称(默认为 'alpine',同一个 rootfs 包可创建多个系统) Future importBuiltinAlpine({ required String systemName, InstallProgressCallback? onProgress, bool Function()? isCancelled, }) async { await validateSystemName(systemName); final assetPath = DistroInfo.builtinAlpineAssetPath; onProgress?.call(0.02, '正在读取应用内置系统资源包...'); final byteData = await rootBundle.load(assetPath); final bytes = byteData.buffer.asUint8List(); final targetDir = await getSystemRootDir(systemName); await DistroInstaller.installFromBytes( tarGzBytes: bytes, targetDir: targetDir, onProgress: onProgress, isCancelled: isCancelled, ); } /// 从用户本地指定的 .tar.gz 压缩包导入外部系统实例 Future importFromCustomTarGz({ required String systemName, required File tarGzFile, InstallProgressCallback? onProgress, bool Function()? isCancelled, }) async { await validateSystemName(systemName); if (!tarGzFile.existsSync()) { throw ArgumentError('所选压缩包文件不存在: ${tarGzFile.path}'); } onProgress?.call(0.02, '正在读取外部系统压缩包...'); final bytes = await tarGzFile.readAsBytes(); final targetDir = await getSystemRootDir(systemName); await DistroInstaller.installFromBytes( tarGzBytes: bytes, targetDir: targetDir, onProgress: onProgress, isCancelled: isCancelled, ); } /// 高危操作:彻底删除指定系统实例及其所有存储数据 Future deleteSystem(String systemName) async { if (systemName == 'host') return; final baseDir = await getBaseDistrosDir(); final systemDir = Directory(p.join(baseDir.path, systemName)); if (!systemDir.existsSync()) return; for (int attempt = 0; attempt < 3; attempt++) { try { if (!systemDir.existsSync()) break; await systemDir.delete(recursive: true); break; } catch (e) { if (Platform.isLinux || Platform.isAndroid) { try { await Process.run('chmod', ['-R', '777', systemDir.path]); } catch (_) {} } await Future.delayed(const Duration(milliseconds: 60)); if (attempt == 2) { try { if (systemDir.existsSync()) { systemDir.deleteSync(recursive: true); } } catch (_) {} } } } } static const MethodChannel _nativeChannel = MethodChannel('com.example.code_editor/native'); String? _cachedProotPath; String? _cachedNativeDir; /// 获取 App 原生动态库目录路径(用于定位 libproot.so 与 libtalloc.so) Future getNativeLibraryDir() async { if (_cachedNativeDir != null) return _cachedNativeDir; if (Platform.isAndroid) { try { final dir = await _nativeChannel.invokeMethod('getNativeLibraryDir'); if (dir != null && dir.isNotEmpty) { _cachedNativeDir = dir; return dir; } } catch (e) { debugPrint('获取原生动态库目录失败: $e'); } } return null; } /// 获取 proot 可执行程序的物理路径(优先检测 nativeLibraryDir/libproot.so) Future getProotExecutablePath() async { if (_cachedProotPath != null && File(_cachedProotPath!).existsSync()) { return _cachedProotPath!; } final nativeDir = await getNativeLibraryDir(); if (nativeDir != null) { final soPath = p.join(nativeDir, 'libproot.so'); if (File(soPath).existsSync()) { _cachedProotPath = soPath; return soPath; } } return 'proot'; } /// 构建 PRoot 容器启动命令与环境参数 /// /// [systemName] 当前选择的系统名称 /// [workspacePath] 挂载的代码工程路径(挂载到容器内部的 /workspace) /// [prootPath] proot 二进制路径 /// [customCommand] 自定义执行命令 Future buildLaunchConfig({ required String systemName, String? workspacePath, String prootPath = 'proot', String? customCommand, }) async { // 1. 本地 Shell 特殊处理 if (systemName == 'host') { final initialDir = (workspacePath != null && Directory(workspacePath).existsSync()) ? workspacePath : Directory.current.path; final args = customCommand != null ? ['-c', customCommand] : []; return ProotLaunchConfig( executable: '/system/bin/sh', arguments: args, environment: { 'TERM': 'xterm-256color', }, workingDirectory: initialDir, ); } // 2. Linux 容器 (PRoot 隔离环境) final rootDir = await getSystemRootDir(systemName); final nativeDir = await getNativeLibraryDir(); final effectiveProot = (prootPath == 'proot') ? await getProotExecutablePath() : prootPath; const targetShell = '/bin/sh'; // 确保容器内 DNS 配置存在(对标 proot-distro,保证网络连通与 apk/curl 正常解析) await _ensureGuestDns(rootDir); // 确保独立的 /dev/shm 目录存在(对标 proot-distro shm.py,解决 POSIX 共享内存缺失) final shmDir = await _ensureShmDir(systemName); // 确保独立的 .l2s 硬链接目录存在(对标 proot-distro --link2symlink 规范) final l2sDir = await _ensureL2sDir(systemName); // 确保独立的 sysdata 桩目录存在(对标 proot-distro sysdata.py,提供 SELinux 与 Proc 补充数据) final sysdataDir = await _ensureSysdataDir(systemName); String tmpPath = '/tmp'; try { tmpPath = (await getTemporaryDirectory()).path; } catch (_) { tmpPath = '/tmp'; } final args = [ '--kill-on-exit', '--link2symlink', // SysV IPC(共享内存/信号量/消息队列)用户态模拟:Android 的 app seccomp 策略把 // shmget/semget/msgget 全部返回 ENOSYS,PRoot 用 libandroid-shmem 在容器内模拟这一套。 // 需要 jniLibs 里同时提供 libandroid-shmem.so(proot 的 NEEDED 依赖)。 '--sysvipc', '-0', // 模拟 root 权限 (uid 0) '-k', '5.4.0-proot', // 伪装内核版本(解决 musl libc 调用 clone3/ppoll 时的 Function not implemented) '-L', // 修复 lstat 符号链接大小属性 '-r', rootDir.path, // 根文件系统路径 '-b', '/dev', // 挂载标准设备节点(宿主已有 /dev/stdin, stdout, stderr 等软链接) '-b', '/dev/urandom:/dev/random', // 补充随机数设备节点 if (shmDir != null) ...['-b', '${shmDir.path}:/dev/shm'], // 挂载独立 POSIX 共享内存 '-b', '/proc', // 挂载进程信息 '-b', '/sys', // 挂载系统信息 if (sysdataDir != null) ...[ '-b', '${p.join(sysdataDir.path, 'sys_empty')}:/sys/fs/selinux', '-b', '${p.join(sysdataDir.path, 'sysctl_entry_cap_last_cap')}:/proc/sys/kernel/cap_last_cap', '-b', '${p.join(sysdataDir.path, 'sysctl_inotify_max_user_watches')}:/proc/sys/fs/inotify/max_user_watches', ], ]; if (Directory(tmpPath).existsSync()) { args.addAll(['-b', '$tmpPath:/tmp']); } // 挂载工作区 String containerWorkDir = '/root'; if (workspacePath != null && Directory(workspacePath).existsSync()) { args.addAll(['-b', '$workspacePath:/workspace']); containerWorkDir = '/workspace'; } // 设置容器内工作目录 args.addAll(['-w', containerWorkDir]); // 用 /usr/bin/env -i 彻底隔离宿主(Android app 进程)继承的环境变量, // 只注入标准纯净的容器环境变量;若修复 Shim 已部署则注入 LD_PRELOAD。 // Shim 的两项职责见 DistroInstaller.ensureSeccompShim 的注释。 await DistroInstaller.ensureSeccompShim(rootDir); final shimFile = File(p.join(rootDir.path, 'lib', 'libfix_seccomp.so')); final hasShim = shimFile.existsSync(); final guestEnvArgs = [ '/usr/bin/env', '-i', 'HOME=/root', 'USER=root', 'TERM=xterm-256color', 'LANG=C.UTF-8', 'PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin', if (hasShim) 'LD_PRELOAD=/lib/libfix_seccomp.so', ]; args.addAll(guestEnvArgs); // 登录 Shell 或自定义命令 if (customCommand != null && customCommand.isNotEmpty) { args.addAll([targetShell, '-c', customCommand]); } else { args.addAll([targetShell, '-l']); } final env = { 'HOME': '/root', 'USER': 'root', 'TERM': 'xterm-256color', 'LANG': 'C.UTF-8', 'PATH': '/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin', 'TMPDIR': tmpPath, 'PROOT_TMP_DIR': tmpPath, if (l2sDir != null) 'PROOT_L2S_DIR': l2sDir.path, if (nativeDir != null) 'LD_LIBRARY_PATH': nativeDir, }; // Process.start 的宿主工作目录必须在 Android 宿主真实存在 final hostWorkDir = rootDir.path; return ProotLaunchConfig( executable: effectiveProot, arguments: args, environment: env, workingDirectory: hostWorkDir, ); } /// 确保容器内具备标准 DNS 解析文件 `/etc/resolv.conf`(对标 proot-distro) Future _ensureGuestDns(Directory rootDir) async { try { final etcDir = Directory(p.join(rootDir.path, 'etc')); if (!etcDir.existsSync()) { etcDir.createSync(recursive: true); } final resolvConf = File(p.join(etcDir.path, 'resolv.conf')); if (!resolvConf.existsSync() || (await resolvConf.length()) == 0) { // "可达优先"排序:国内公共 DNS 在前(8.8.8.8/1.1.1.1 在国内常被丢包, // 排在首位会让 musl/glibc 解析器先等一次超时)。与 DistroInstaller // 的 guestResolvConf 保持一致。 await resolvConf.writeAsString( DistroInstaller.guestResolvConf, flush: true, ); } } catch (e) { debugPrint('配置容器 DNS 失败 (非阻塞): $e'); } } /// 确保容器实例拥有独立的 POSIX 共享内存目录(对标 proot-distro shm.py) Future _ensureShmDir(String systemName) async { try { final baseDir = await getBaseDistrosDir(); final shmDir = Directory(p.join(baseDir.path, systemName, 'shm')); if (!shmDir.existsSync()) { shmDir.createSync(recursive: true); } return shmDir; } catch (e) { debugPrint('创建容器 shm 目录失败 (非阻塞): $e'); return null; } } /// 确保容器实例拥有独立的 .l2s 硬链接跟踪目录(对标 proot-distro login/__init__.py) Future _ensureL2sDir(String systemName) async { try { final baseDir = await getBaseDistrosDir(); final l2sDir = Directory(p.join(baseDir.path, systemName, '.l2s')); if (!l2sDir.existsSync()) { l2sDir.createSync(recursive: true); } return l2sDir; } catch (e) { debugPrint('创建容器 .l2s 目录失败 (非阻塞): $e'); return null; } } /// 确保容器实例拥有独立的 sysdata 桩目录与 SELinux 覆盖节点(对标 proot-distro sysdata.py) Future _ensureSysdataDir(String systemName) async { try { final baseDir = await getBaseDistrosDir(); final sysdataDir = Directory(p.join(baseDir.path, systemName, 'sysdata')); if (!sysdataDir.existsSync()) { sysdataDir.createSync(recursive: true); } // 1. 空目录用于覆盖 /sys/fs/selinux(禁用 selinux 检测) final emptyDir = Directory(p.join(sysdataDir.path, 'sys_empty')); if (!emptyDir.existsSync()) { emptyDir.createSync(recursive: true); } // 2. /proc/sys/kernel/cap_last_cap 桩 final capFile = File(p.join(sysdataDir.path, 'sysctl_entry_cap_last_cap')); if (!capFile.existsSync()) { capFile.writeAsStringSync('40\n'); } // 3. /proc/sys/fs/inotify/max_user_watches 桩 final inotifyFile = File(p.join(sysdataDir.path, 'sysctl_inotify_max_user_watches')); if (!inotifyFile.existsSync()) { inotifyFile.writeAsStringSync('4096\n'); } return sysdataDir; } catch (e) { debugPrint('创建容器 sysdata 目录失败 (非阻塞): $e'); return null; } } }