Shaft多窗口终极指南用SubWindow快速创建独立原生窗口【免费下载链接】ShaftA cross-platform GUI framework for Swift, built for demanding workloads and developer ergonomics项目地址: https://gitcode.com/gh_mirrors/sh/ShaftShaft 是一个面向 Swift 的跨平台 GUI 框架而它的SubWindow组件正是多窗口开发的利器——只需几行代码就能为主窗口之外弹出独立运行的原生窗口每个窗口拥有独立的控件层级互不干扰。如图所示Shaft 可以同时在屏幕上运行多个独立窗口它们各自渲染不同的页面内容这就是SubWindow提供的原生多窗口能力。什么是 Shaft 的 SubWindowSubWindow是一个StatefulWidget它在被渲染时会自动通过后端Shaft.Backend创建一个新的原生视图并把子控件渲染进去。你可以把它理解为主窗口里的一个按钮点一下就能开一个新窗口——而且新窗口完全由框架托管无需手写平台代码。它的核心定义位于 View.swiftpublic final class SubWindow: StatefulWidget { public init( onCreateWindow: OnCreateWindow? nil, onWindowCreated: OnWindowCreated? nil, onWindowDestroyed: OnWindowDestroyed? nil, WidgetBuilder child: () - Widget ) }三个回调各司其职回调触发时机典型用途onCreateWindow窗口创建前自定义创建逻辑返回已有原生视图onWindowCreated窗口创建成功后设置标题、大小、位置等属性onWindowDestroyed窗口销毁前保存状态、清理资源一键创建独立原生窗口创建子窗口最简单的写法就是把内容包进SubWindow即可。官方示例见 Demo_MultiWindow.swiftSubWindow( onWindowCreated: { view in if let view view as? DesktopView { view.title My Window view.size .init(400, 400) } } ) { Text(Sub Window 1) .center() .background(.init(0xFFFF_FFFF)) }这段代码会在主界面下方弹出一个 400×400 的独立窗口里面居中显示一行文字。子窗口渲染时会通过内部的BoxToViewAdapter自动适配布局约束你写的控件代码和在主窗口中完全一样无需任何特殊处理。快速配置窗口属性在桌面平台上创建回调返回的视图实现了DesktopView协议定义见 Backend.swift你可以在onWindowCreated中直接配置这些属性title窗口标题size/position窗口大小与左上角位置alwaysOnTop是否置顶显示visible窗口是否可见displayID窗口所在的显示器支持多屏场景requestFocus()主动请求键盘焦点onWindowCreated: { view in if let view view as? DesktopView { view.position .init(100, 100) view.alwaysOnTop true // 悬浮提示窗口常用技巧 } }这套属性让悬浮通知面板多屏看板这类需求都能轻松实现而且代码完全跨平台——Windows、Linux、macOS 上行为一致。窗口生命周期回调创建与销毁SubWindow帮你管好窗口的整个生命周期框架内部实现见 View.swiftinitState阶段调用backend.createView()创建原生窗口随后触发onWindowCreated渲染阶段子控件作为新窗口的根内容渲染dispose阶段窗口不再需要时先触发onWindowDestroyed再调用backend.destroyView()销毁窗口。也就是说只要SubWindow从 widget 树中移除对应的原生窗口就会自动关闭并释放——不存在窗口泄漏的顾虑。用户手动点掉窗口、或你通过条件渲染移除它都走同一条清理路径。自定义窗口创建onCreateWindow如果默认创建方式不够用比如你想复用某个已存在的原生视图可以实现onCreateWindow回调手动返回一个NativeViewSubWindow( onCreateWindow: { // 返回自定义创建的原生视图返回 nil 则放弃创建 customBackend.createView() } ) { Text(Custom window) }这正是 Shaft 模块化设计的体现Backend 层抽象了平台差异你甚至可以为特殊场景如终端 UI、Wayland 合成器实现自己的后端。整体分层如下图所示——SubWindow依赖的createView/destroyView就位于Shaft.Backend协议中。亲自动手运行官方 Multi Window 演示想立刻体验三步即可跑起来git clone https://gitcode.com/gh_mirrors/sh/Shaft cd Shaft swift run Playground启动后在左侧导航栏的Demos分组中点击Multi Window菜单注册见 main.swift即可看到子窗口弹出的完整演示页面内还附带了分步讲解。 小贴士Playground 应用本身就是一个可交互的文档每个演示页都包含原理说明和可复制的代码片段。为什么选择原生多窗口零平台代码不写一行 Cocoa 或 Win32Swift 控件直接渲染进原生窗口独立渲染每个窗口拥有独立的 widget 层级与事件循环接入主窗口卡顿不影响子窗口生命周期托管创建、销毁、内存回收全部由框架处理跨平台一致同一份代码在 Windows、Linux、macOS 表现相同。总结SubWindow让 Shaft 的多窗口开发回归了声明式的简洁一个组件、三个可选回调、一段普通控件代码就能弹出可配置的独立原生窗口。无论你是想做一个悬浮面板、弹出式工具窗口还是多屏协同应用它都是 Swift 跨平台开发中最省心的多窗口方案。【免费下载链接】ShaftA cross-platform GUI framework for Swift, built for demanding workloads and developer ergonomics项目地址: https://gitcode.com/gh_mirrors/sh/Shaft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考