SwiftTerm 是一个 VT100/Xterm 终端模拟器库，适用于可以嵌入到 macOS、iOS 应用程序、基于文本的无头应用程序或其他自定义场景的 Swift 应用程序。它已被用于多个商业 SSH 客户端，包括 Secure Shellfish、La Terminal 和 CodeEdit

查看 API 文档

此仓库包含一个 UI 不可知论的终端模拟器引擎，以及使用 UIKit 的 iOS 前端和使用 AppKit 的 macOS 前端。一个基于 curses 的终端模拟器（用于在控制台应用程序中模拟 xterm）作为 TermKit 库的一部分提供。

示例代码 在 TerminalApp 目录中，有一些用于 Mac 和 iOS 的最小示例应用程序，展示了如何在库中使用它。

• 示例 Mac 应用程序具有 MacOS 的 Terminal.app 的大部分功能，但没有配置 UI。
• 示例 iOS 应用程序使用 SSH 库连接到远程系统（因为 iOS 上没有本地 shell 可以运行），并且示例恰好硬编码到我的家用机器，您可以在源代码中更改它。

配套应用 SwiftTermApp 构建了一个实际的 iOS 应用程序，它使用了这个库，并且比此模块中的测试应用程序更完整，并提供了适当的配置 UI。

这是我最初的 XtermSharp 的移植版本，它本身基于 xterm.js。在这一点上，我认为 SwiftTerm 是比这两者更高级的终端模拟器（除了选择/辅助功能），因为它比它们更好地处理 UTF、Unicode 和字素簇，并且对终端仿真的覆盖更全面。XtermSharp 通常也在努力跟上。

• 相当不错的终端仿真，优于或等同于 XtermSharp 和 xterm.js（并且在许多方面更全面）
• Unicode 渲染（包括 Emoji、组合字符和表情符号）
• 可重用和可插拔的引擎允许在其之上构建多个用户界面。
• 选择引擎（在视图中支持 macOS）
• 支持颜色（ANSI、256 色、真彩色）
• 支持鼠标事件
• 支持终端大小调整操作（由远程主机控制或本地控制）
• 终端输出中的超链接
• AppKit、UIKit 前端；ncurses 前端单独提供
• 本地进程和 SSH 连接支持（最后一个需要一些组装）
• 适当的 CoreText 渲染可以轻松处理强化的 Unicode 测试套件。
• Sixel 图形（使用 img2sixel 进行测试）
• iTerm2 风格的图形渲染（使用 imgcat 进行测试）
• 经过模糊测试和滥用测试
• 在我看来速度很快

SwiftTerm 库本身包含引擎和前端的源代码。前端根据目标平台有条件地编译。

引擎位于此目录中，而 macOS 的代码位于 Mac 下，iOS 的代码位于 iOS 下。鉴于这两者有很多共同特征，共享代码位于 Apple 下。

SwiftTerm 使用 Swift Package Manager 进行构建，您可以使用此项目或其 fork 的 URL 将库添加到您的项目中。

macOS AppKit NSView 实现 TerminalView 是一个可重用的 NSView 控件，可以通过实现 TerminalViewDelegate 连接到任何源。
我预计常见的情况是托管本地 Unix 命令，所以我包含了 LocalProcessTerminalView，它是一个将 TerminalView 连接到 Unix 伪终端并在那里运行命令的实现。

有一个等效的 UIKit UIView 实现 TerminalView，它像其 NSView 同伴一样，是一个可嵌入和可重用的视图，可以通过实现相同的 TerminalViewDelegate 连接到您的应用程序。与在 Mac 上运行的 NSView 情况不同，在 Mac 上运行本地命令是一种常见情况，鉴于 iOS 不提供对进程的访问，最常见的情况是将此终端连接到远程主机。连接到远程系统的最安全方法是使用 SSH。

iOS 和 UIKit 代码共享很多代码，这些代码位于 Apple 目录下。

核心库目前没有提供连接到 SSH 的便捷方法，纯粹是为了避免额外的依赖。但是这个 git 模块引用了一个模块，该模块拉取了一个预编译的 SSH 客户端（Frugghi's SwiftSH），以及 iOS 示例中的一个 UIKitSsshTerminalView，它将 iOS 的 TerminalView 连接到 SSH 连接。

如果您正在使用 Xcode，则在 TerminalApp 目录中有两个顶级项目，一个用于 Mac，一个用于 iOS，一个名为 "iOSTerminal.xcodeproj"，另一个名为 "MacTerminal.xcodeproj"。

这是必需的，因为如果您在项目中有一个 Mac 项目，Xcode 不会为 iOS 提供代码完成。所以我不得不将它们分开。这两个项目都引用了同一个 SwiftTerm 包。

当使用这些项目时，如果您选择终端应用程序，它将运行这个应用程序。要运行测试套件，请选择“SwiftTerm”目标，您可以使用“SwiftTermFuzz”来运行模糊测试器。

您可以使用 swift build 来构建包，并使用 swift test 来运行测试套件 - 但请注意，测试套件期望检出 esctest 目录才能运行。如果您想在本地执行此操作，可以在文件 .github/workflows/swift.yml 中查看我如何在 GitHub 操作上运行这些操作。

如果使用 Xcode，您可以选择“SwiftTerm”项目，然后使用 Command-U 来运行测试套件。

GitHub issues 页面有一个所需功能和增强功能的列表

从长远来看，我还想添加一个 tvOS UIView、一个用于 Linux 的 SwiftGtk 前端。

24 位颜色

Midnight Commander

强大的 UTF-8 支持，出色的渲染效果：

支持现代应用程序发出的超链接

iOS 支持

Sixel 支持

• Digital 的 VT100 用户指南
• 终端指南 - 非常好且直观，但不是规范性的
• Xterm 控制序列
• VT510 视频终端程序员信息

其他有用的文档

• VT330/VT340 程序员参考手册第 2 卷：图形编程
• DEC 的 ANSI 兼容视频终端的解析器
• 代码和标准
• Linux 控制台文档 它们是 vt100 的子集，但通常易于理解。
• Sixel 图形

测试套件

• VTTest - 很旧，但仍然很好
• EscTest - 非常棒：iTerm 的作者 George Nachman 创建了这个测试套件，它成为了 FreeDesktop 标准。从那时起，xterm 维护者和许多文本应用程序的维护者 Thomas E. Dickey 也为这项工作做出了贡献。

• 感谢 xterm.js 开发人员，他们最初编写了一个终端模拟器，该模拟器在允许最大程度重用的许可下获得许可。
• Marcin Krzyzanowski，他出色地改进和管理了 AppKit/CoreText 上的渲染引擎，使其成为今天的辉煌渲染器 - 并感谢他对渲染引擎的贡献
• Greg Munn 在 XtermSharp 中做了大量工作，以支持 Visual Studio for Mac 的需求
• Anders Borum 贡献了可靠性修复、sixel 解析器以及将 SwiftTerm 投入生产所需的更改。
• Miguel de Icaza - 我 - 一直在寻找编写一些 Swift 代码的借口。