Linux

NSH 应用也能在 Linux 上运行。Linux 后端用 GTK 4 控件渲染应用，用 Pango 排版文字；核心、响应式图、渲染器、Taffy 布局和 nsh/ui/mobile 组件与 iOS、Android 上完全相同，因此同一个 bundle 可以在所有平台上运行。在 Linux 上，Platform.OS 为 "linux"，并会应用 desktop={{…}} 属性。窗口标题、自定义标题栏、 菜单栏和右键菜单由 nsh/desktop 提供。

#环境要求

• GTK 4.14 及以上。构建 NSH 的 Linux 运行时（从源码构建，或在 Linux 上运行 cargo xtask dist） 还需要它们的开发包和 clang：Debian 与 Ubuntu（24.04 及以上）为 libgtk-4-dev clang，Arch 为 gtk4 clang，Fedora 为 gtk4-devel clang。
• Web 视图需要 WebKitGTK 6.0（2.40 及以上）：构建运行时需要 Debian 与 Ubuntu 上的 libwebkitgtk-6.0-dev、Arch 上的 webkitgtk-6.0、Fedora 上的 webkitgtk6.0-devel。开发宿主和发布运行器默认使用它，因此打包后的应用运行的机器上需要装有 WebKitGTK 6.0（Debian 与 Ubuntu 上为 libwebkitgtk-6.0-4；GNOME 桌面自带）。在没有它的开发包的机器上，cargo xtask dist 构建的运行时中 Web 视图为占位视图，其应用只需要 GTK。
• 应用要播放的视频格式对应的 GStreamer 插件（GTK 通过 GStreamer 播放视频）。

#运行应用

在 Linux 上，nsh run 会在一个 GTK 窗口（默认 390×844）中打开应用，和其他目标一样支持热重载、在终端显示日志并提供错误浮层：

nsh run my-app                 # 在 Linux 上默认就是 --target linux

在源码仓库中，nsh run 会先构建开发宿主（nsh-linux-host）；在 Linux 上制作的发行版把它放在 runtime/linux/ 中。 Ctrl-C 会关闭窗口，关闭窗口也会结束 nsh run。宿主也可以单独运行一个构建好的 bundle：

nsh build my-app --release -o build
dist/nsh/runtime/linux/nsh-linux-host --bundle build/bundle.nshc --size 1024x768   # 源码仓库中：target/debug/nsh-linux-host

--size 是窗口的默认尺寸；平铺式窗口管理器可能会给窗口另一个尺寸。

#打包

nsh package my-app --target linux [--run]

会写出一个目录，以及同样内容的压缩包：

out/<Name>/
  <Name>                 可执行文件（nsh 的发布版运行器）
  nsh/bundle.nshc        编译后的应用
  nsh/assets/…           应用导入的资源
  nsh/app.json           窗口标题和应用 id
  <id>.desktop           桌面条目（StartupWMClass 为应用 id）
  <id>.png               图标（nsh.json 指定了图标时）
out/<Name>.tar.gz

可执行文件会在自身旁边找到 nsh/（指向它的符号链接也可以，例如放在 ~/.local/bin 中）。运行应用的机器上必须装有 GTK 4、 Pango 和 WebKitGTK 6.0。要让应用出现在桌面的启动器中，把可执行文件（或其链接）放到 PATH 中，把 .desktop 文件放到 ~/.local/share/applications，把图标放到图标主题目录中。--run 会在打包后启动应用。

#嵌入 GTK 应用

nsh-platform-linux crate（位于 NSH 仓库中）为 Rust 编写的 GTK 应用提供 AppView：一个作为 GTK 控件的 NSH 引擎。每个 AppView 相互独立，可以同时运行多个。

use std::rc::Rc;
use nsh_platform_linux::{gtk4 as gtk, AppOptions, AppView, AssetBase, Bundle};
use gtk::prelude::*;

fn main() -> gtk::glib::ExitCode {
    let app = gtk::Application::builder().application_id("com.example.host").build();
    app.connect_activate(|app| {
        let window = gtk::ApplicationWindow::builder().application(app).default_width(390).default_height(844).build();
        let view = AppView::new(AppOptions {
            asset_base: Some(AssetBase::Directory("app/assets".into())),
            ..AppOptions::default()
        });
        // 在加载之前注册原生组件
        let code = std::fs::read_to_string("app/bundle.js").expect("bundle");
        view.load(Bundle::source(code).into());
        window.set_child(Some(&view.widget()));
        // 窗口持有视图；关闭窗口即停止应用。
        let keep = std::cell::RefCell::new(Some(Rc::clone(&view)));
        window.connect_destroy(move |_| if let Some(view) = keep.take() { view.stop() });
        window.present();
    });
    app.run()
}

AppView::load 会替换正在运行的内容；stop 结束应用。asset_base 指定 asset:/ URI 从哪里解析（AssetBase::Directory 或 AssetBase::Http）。字节码 bundle（bundle.nshc）用 unsafe { Bundle::bytecode(bytes) } 加载：字节码是受信任的输入， 只能从你自己应用的文件中加载。

原生组件通过 AppView::register_component 注册，见原生组件。

#Linux 上的差异

运行环境是桌面环境：安全区和键盘高度为 0，Platform.constants.interfaceIdiom 为 "desktop"，Platform.Version 为内核的主、次版本号， 深色模式实时跟随桌面的设置（通过 XDG 设置门户）。见设备与环境。

#键盘

按键	作用
Return	在 Input 中按 submitBehavior 行事：提交（onSubmitEditing）、提交并离开输入框，或换行（多行输入框）
Shift+Return、Alt+Return	在回车即提交的多行输入框中换行（Ctrl+Return 提交）
Tab、Shift+Tab	按屏幕顺序移到下一个 / 上一个输入框，只在最上层的模态窗口之内
Escape	离开有焦点的输入框；否则清除文本选区，再返回上一页或请求关闭最上层的模态窗口
Alt+Left、Back 键、鼠标的后退键	返回上一页（在输入框中也是）
Ctrl+方向键、Home / End，加 Shift；Ctrl+Backspace / Delete	在输入框中按词和行移动、选择、删除，与其他 GTK 应用一致
Ctrl+Z、Ctrl+Shift+Z、Ctrl+X / C / V / A	撤销、重做、剪切、复制、粘贴、全选（密码输入框拒绝剪切和复制）；Ctrl+A / Ctrl+C 选择并复制 selectable 文本
方向键；Page Up / Down、Space、Shift+Space；Home / End	滚动有焦点的视图所在或鼠标下方的滚动视图：一行、一页、到开头 / 结尾（输入框有焦点时不滚动）
Ctrl+W、F11、Ctrl+Q	关闭窗口、全屏、退出（nsh package 和 nsh run 的应用）
Ctrl+R	重新加载最新的构建（nsh run）

应用自己的快捷键（nsh/keymap）是一个窗口范围的快捷键控制器；Ctrl+Q 和 F11 不能被绑定。

快捷键适用于任何键盘布局（在西里尔或希腊字母布局下，Ctrl+C 是美式布局中输入 C 的那个键）。确认输入法组合文字（中文、日文等）的回车 不会提交。onKeyPress 报告的与 React Native 一致：输入的文字、"Enter"、"Backspace" 和 "Escape"；粘贴的文字不报告。

Web 视图是绘制在 NSH 视图之内的 WebKitGTK 页面：sheet、对话框、toast 以及排在它后面的视图会绘制在页面之上，父视图会裁剪它、改变它的透明度。 它的网站数据（cookie、存储、缓存）按应用分别保存在 ~/.local/share/<app id>/webkit 和 ~/.cache/<app id>/webkit 下。 webview 权限同样作用于框架中的页面：应用未获授权的主机的 iframe 保持空白。在页面中按 Escape 会离开页面，与文本框中一样 （除非页面自己用了它）；页面有历史记录时，Alt+Left 和鼠标的后退键在页面中后退。

不支持：

• 视频的 rate：GTK 只能以正常速度播放。onEnd 只对不循环的视频触发。
• 可缩放的滚动视图（zoomTo、缩放相关属性）。
• mixBlendMode 和 backdropFilter（背景色仍会绘制）；borderCurve: "continuous" 绘制为圆形圆角。
• 输入辅助视图和状态栏（桌面上没有对应物）。
• 无障碍：accessible 分组、自定义 accessibilityActions；实时区域改为播报。

#另见

• CLI：nsh run --target linux、nsh package --target linux
• 打包
• 平台特定代码