longbridge/nsh

选用指南

AI 根据 README 整理 · 2026/10/19 17:26:28

适用场景

适用于需要跨平台原生 UI 的应用，或希望动态加载 TSX 界面、嵌入现有原生应用的场景。

查看 README 依据

# Native Shell (NSH) **Native UI in Rust and TSX, embedded in your app or shipped on its own.** Native Shell is a Rust engine for cross-platform apps and AI-generated UI. Write your app in Rust, use TSX for dynamically delivered screens, or combine both with shared Rust components. Each platform renders with its own UI: native views on iOS, Android, macOS, Windows and Linux, GPUI in GPUI apps and HTML on the web. Embed NSH in an existing app or package it as a standalone app. Hosts can load TSX modules at run time as plugins,

delivered as signed packages and run in a sandbox the host configures. Documentation, guides and live demos: **[nsh.dev](https://nsh.dev)**. ## Features - Write apps in Rust, TSX, or both, and render with each platform's own UI, sharing the same reactive engine, flexbox and grid layout, system text, input and accessibility. - Embed in existing native apps alongside components such as maps and web views, or package as standalone apps and static websites. - Deliver TSX screens at run time with signed packages and host-controlled sandbox capabilities.

使用方式

通过 nsh 命令行工具创建、运行和打包应用，支持多种目标平台。

查看 README 依据

<details> <summary>Windows (PowerShell)</summary> ```powershell irm https://nsh.dev/install.ps1 | iex ``` </details> Choose how to write your app: | | Rust | TSX | |---|---|---| | Create | `nsh init my-app --rust` | `nsh init my-app` | | Write | Rust components, typed styles and signals | TSX components, Tailwind classes and signals | | Iterate | Rebuild and restart on Rust changes | Hot updates that preserve state | | Toolchain | `nsh` and [Rust](https://rustup.rs) | `nsh` | You can also combine them: TSX screens import your Rust components and modules. See

[Building with Rust](https://nsh.dev/docs/rust) for Rust apps and mixed projects. Run either app on your chosen platform: <details> <summary>iOS</summary> ```sh nsh run my-app --target ios # iOS simulator; requires Xcode nsh run my-app --target catalyst # Mac Catalyst window on macOS ``` </details> <details> <summary>Android</summary> ```sh nsh run my-app --target android # emulator or device; requires the Android SDK ``` </details> <details> <summary>macOS</summary> ```sh nsh run my-app --target macos # AppKit window ``` </details> <details>

部署要求

需要安装 nsh 命令，运行 iOS 需要 Xcode，Android 需要 Android SDK，Linux 需要 GTK 4.14+，GPUI 需要 Vulkan。

查看 README 依据

| macOS | AppKit, Core Animation, CoreText | `AppView` (Rust, `nsh-platform-macos`) | macOS 14+ | | Windows | Win32, Direct2D, DirectWrite | `AppView` (Rust, `nsh-platform-windows`) | Windows 10 1809+ | | Linux | GTK 4, Pango | `AppView` (Rust, `nsh-platform-linux`) | GTK 4.14+ | | GPUI (macOS, Windows, Linux) | GPUI (GPUI Fast) | `AppView` (Rust, a GPUI view, `nsh-platform-gpui`) | macOS, Windows; Linux with Vulkan | | Web | HTML, CSS | `createPlayer` (JavaScript) or an iframe | Modern browsers |

[Building with Rust](https://nsh.dev/docs/rust) for Rust apps and mixed projects. Run either app on your chosen platform: <details> <summary>iOS</summary> ```sh nsh run my-app --target ios # iOS simulator; requires Xcode nsh run my-app --target catalyst # Mac Catalyst window on macOS ``` </details> <details> <summary>Android</summary> ```sh nsh run my-app --target android # emulator or device; requires the Android SDK ``` </details> <details> <summary>macOS</summary> ```sh nsh run my-app --target macos # AppKit window ``` </details> <details>