文档
平台概览
NSH 运行在手机、桌面和网页上：iOS、Android、macOS、Windows、Linux、GPUI 和 Web。每个平台都有自己的后端，用平台自己的界面技术绘制：同一个模块在 iPhone 上是 UIKit 视图，在 Mac 上是 AppKit 视图，在 Linux 上是 GTK 4 控件，在 GPUI 应用里是 GPUI 元素，在浏览器里是 HTML，文本、输入、无障碍和深色模式都是平台自己的。后端之上的部分全部共享：QuickJS、响应式图、渲染器、Taffy 布局和组件在每个平台上都是同一份 Rust 代码，所以一个 bundle 可以在所有平台上运行。
在每个平台上，NSH 的主要用途都一样：把模块嵌入你自己的原生应用，由它在运行时加载。开发时借助热更新（nsh run）；同样的模块也可以打包成可安装的应用（nsh package），这是受支持的第二种用法。
#一览
| 平台 | 后端；文本 | 运行环境 | 开发 | 打包 |
|---|---|---|---|---|
| iOS | UIKit；CoreText | iOS 15.0+，真机和模拟器 | nsh run --target ios | .app（模拟器）、签名的 .ipa |
| Android | Android 视图；StaticLayout | Android 9（API 28）+，arm64-v8a 和 x86_64 | nsh run --target android | 签名的 .apk |
| macOS | AppKit 与 Core Animation；CoreText | macOS 14+ | nsh run --target macos | ad hoc 签名的 .app |
| Windows | 用 Direct2D 绘制的 Win32 窗口；DirectWrite | Windows 10 1809+、Windows 11 | nsh run（Windows 上的默认目标） | 一个目录和一个 .zip |
| Linux | GTK 4 控件；Pango | GTK 4.14+ | nsh run（Linux 上的默认目标） | 一个目录和一个 .tar.gz |
| GPUI | GPUI；GPUI 的文字系统 | macOS、Windows、Linux（Vulkan） | nsh run --target gpui | 与所在桌面平台相同 |
| Web | HTML 与 CSS；浏览器的字体 | 现代浏览器，桌面和手机 | nsh run --target web | 一个静态网站 |
- GPUI 用姊妹项目 GPUI Kit 所基于的 GPUI 绘制模块，在 macOS、Windows 和 Linux 上表现一致：一套渲染覆盖三个桌面平台，
AppView可以放进 GPUI 和 GPUI Kit 应用自己的元素树。 - Web 把应用渲染成浏览器页面里的 HTML：
nsh package --target web发布一个静态网站，可部署到任意 Web 服务器或 CDN；你自己的网页可以用createPlayer或 iframe 嵌入应用。本站的在线示例和 Playground 也由它运行。 - Mac Catalyst 在 Mac 上用 iPhone 尺寸的窗口（390×844）运行 iOS 后端，用于开发。它是 macOS 上
nsh run的默认目标：最快看到模块在手机上的样子。
#开发与打包
不传 --target 时，nsh run 选择本机的平台：macOS 上是 Mac Catalyst，Linux 上是 GTK 窗口，Windows 上是 Win32 窗口。手机要从电脑上连接：iOS 需要装有 Xcode 的 Mac，Android 可以在装有 Android SDK 的 macOS、Linux 或 Windows 上开发（安装）。
nsh run my-app --target macos # 或 ios、android、windows、linux、gpui、web、catalyst
nsh package my-app --target macos # 或 ios、ios-simulator、android、windows、linux、gpui、web桌面后端只为运行它的机器构建：Mac 应用在 Mac 上打包，Windows 应用在 Windows 上打包，Linux 应用在 Linux 上打包。各目标的输出、签名和图标见打包。
#嵌入原生应用
| 平台 | 宿主视图 | 发布形式 | 宿主语言 |
|---|---|---|---|
| iOS | NshAppView（一个 UIView） | NativeShell.xcframework | Swift |
| Android | NshView（一个 FrameLayout） | nsh.aar | Java 或 Kotlin |
| macOS | AppView（一个 NSView） | nsh-platform-macos crate | Rust |
| Windows | AppView（一个子窗口） | nsh-platform-windows crate | Rust |
| Linux | AppView（一个 GTK 控件） | nsh-platform-linux crate | Rust |
| GPUI（macOS、Windows、Linux） | AppView（一个 GPUI 视图） | nsh-platform-gpui crate | Rust |
| Web | createPlayer（一个页面元素）或 iframe | nsh package --target web 生成的运行时文件 | JavaScript 或 HTML |
每个视图都是一个拥有独立虚拟机的引擎，一个应用可以同时显示多个。在每个平台上，宿主都可以注册自己的原生视图给模块使用（原生组件）。
#为每个平台编写
应用的大部分代码不需要判断平台：元素、样式、布局和模块在各处行为一致。平台确实不同的地方，NSH 给它一个固定的位置（平台特定代码）：
- 平台专属属性放在
ios={{…}}、android={{…}}、web={{…}}或desktop={{…}}（macOS、Windows、Linux 和桌面浏览器）里。 Platform.select按操作系统取值，也可以按mobile和desktop整体取值；Platform.OS是"ios"、"android"、"macos"、"windows"、"linux"或"web"。- 输入跟随平台。 手机上是触摸和软键盘；桌面上是鼠标、触控板和键盘。
nsh/ui/mobile 的组件由 NSH 绘制，所以在桌面上也能运行，样子和在手机上一样。桌面布局用基础元素（View、Text、Scroll、List 等）和 Platform.select({ desktop: … }) 搭建，示例应用 gallery 的桌面布局就是这样做的；桌面 UI 套件也在路上。
每个后端都列出了它尚不支持的内容：macOS、Windows、Linux、GPUI。