gpui-migration

gpui 新旧 API 对照表(2025-01 大重构前 → 当前)。遇到 ViewContext/WindowContext/View/Model/new_view/FocusableView/旧 spawn 闭包等旧 API,或迁移旧 gpui 代码、修复相关编译错误时使用。同时收录 gpui-component 的更名(TextInput→Input、open_modal→open_dialog 等)。

Jump to install

Repository: zerx-lab/gpui_ai_profile
Last source activity: July 17, 2026 at 05:26
Detected SKILL.md language: Chinese
Stars: 0
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/zerx-lab/gpui_ai_profile --skill gpui-migration

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

gpui-app

从零搭建 gpui / gpui-component 桌面应用的起步模板。涵盖 Cargo.toml git 依赖(gpui + gpui_platform + gpui-component)、main.rs 入口(application().run / open_window / Root)、资产与图标注册、WindowOptions、退出与激活。创建新 gpui 项目、初始化工程、写 main.rs 或配置依赖时使用。

2026-07-17

View all from this repository

name	gpui-migration
description	gpui 新旧 API 对照表(2025-01 大重构前 → 当前)。遇到 ViewContext/WindowContext/View/Model/new_view/FocusableView/旧 spawn 闭包等旧 API,或迁移旧 gpui 代码、修复相关编译错误时使用。同时收录 gpui-component 的更名(TextInput→Input、open_modal→open_dialog 等)。

gpui 新旧 API 对照

训练语料中的 gpui 代码大多基于 2025-01 重构前的 API。凡命中"旧"列的写法,一律按"新"列改写;全部条目已对照 zed 主干 crates/gpui 源码核实。

类型与上下文

旧(已删除)	新(当前)
`AppContext`(具体类型)	`App`;`AppContext` 现为 trait(约束泛型用,如 `C: AppContext`)
`WindowContext`	两个独立参数:`window: &mut Window, cx: &mut App`
`ViewContext<T>`	`Context<T>`(+ 独立 `&mut Window` 参数)
`ModelContext<T>`	`Context<T>`
`AsyncAppContext`	`AsyncApp`(`AsyncWindowContext` 仍存在,deref 到 `AsyncApp`)
`View<T>`、`Model<T>`	统一 `Entity<T>`;视图 = `Entity<V> where V: Render`
`WeakView<T>`、`WeakModel<T>`	`WeakEntity<T>`
`FocusableView`	`Focusable`:`fn focus_handle(&self, cx: &App) -> FocusHandle`

旧	新
`App::new().run(…)` / `Application::new().run(…)`	`gpui_platform::application().run(\|cx: &mut App\| …)`
`cx.new_view(\|cx\| …)` / `cx.new_model(…)` / `build_view`	`cx.new(\|cx\| …) -> Entity<T>`
`cx.add_window(…)`	`cx.open_window(options, \|window, cx\| cx.new(…)) -> Result<WindowHandle<V>>`(`add_window` 仅 `TestAppContext`)
`WindowBounds::Fixed(bounds)`	`WindowBounds::Windowed(bounds)`;其余 `Maximized(…)`/`Fullscreen(…)`
`cx.observe(&entity, \|this, entity, cx\|)`(签名同)	不变;需要窗口 → `cx.observe_in(&entity, window, \|this, entity, window, cx\|)`
`cx.subscribe(&entity, \|this, entity, event, cx\|)`	不变;需要窗口 → `cx.subscribe_in(&entity, window, \|this, entity, event, window, cx\|)`

旧	新
`fn render(&mut self, cx: &mut ViewContext<Self>) -> impl IntoElement`	`fn render(&mut self, window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement`
`cx.listener(\|this, ev, cx\| …)` 3 参	`cx.listener(\|this, ev, window, cx\| …)` 4 参,返回 `Fn(&E, &mut Window, &mut App)`
`.on_click(\|ev, cx\| …)` 2 参	`.on_click(\|ev, window, cx\| …)` 3 参
`.on_action(\|action, cx\| …)`	`.on_action(\|action, window, cx\| …)`;或 `.on_action(cx.listener(Self::handler))`,handler 为 `fn(&mut self, &A, &mut Window, &mut Context<Self>)`
`uniform_list(cx, "id", n, \|this, range, cx\| …)`	`uniform_list("id", n, f)`,`f: Fn(Range<usize>, &mut Window, &mut App) -> Vec<R>`;绑定实体用 `cx.processor(\|this, range, window, cx\| …)`

旧	新
`cx.spawn(\|this, mut cx\| async move { … })`	`cx.spawn(async move \|this, cx\| { … })`,收到 `(WeakEntity<T>, &mut AsyncApp)`
`cx.spawn(\|mut cx\| async move { … })`(App 上)	`cx.spawn(async move \|cx\| { … })`,收到 `&mut AsyncApp`
`cx.spawn_in(window, \|this, mut cx\| async …)`	`cx.spawn_in(window, async move \|this, cx\| …)`,收到 `(WeakEntity<T>, &mut AsyncWindowContext)`
`window.spawn(\|cx\| async …)`	`window.spawn(cx, async move \|cx\| …)`
`this.update(&mut cx, \|this, cx\| …)`	`this.update(cx, \|this, cx\| …)`(`cx` 已是 `&mut AsyncApp`;`WeakEntity::update` 返回 `Result`)
`this.update(&mut cx, …)` 带窗口	`this.update_in(cx, \|this, window, cx\| …)`
`cx.background_executor().spawn(fut)`	仍可用;简写 `cx.background_spawn(fut)`(纯 `Future`,内部不可碰实体)

旧/幻觉	当前
`TextInput`	`input::{Input, InputState}`:状态 `cx.new(\|cx\| InputState::new(window, cx))`,渲染 `Input::new(&state)`,事件 `InputEvent::{Change, PressEnter, Focus, Blur}`
`ContextModal` trait	`WindowExt` trait
`window.open_modal` / `close_modal`	`window.open_dialog(cx, \|dialog, window, cx\| …)` / `window.close_dialog(cx)`;另有 `open_alert_dialog`/`open_sheet`/`push_notification`
`cx.theme().surface` / `.card`	无此字段;用 `background`/`popover`/`sidebar`/`muted`/`secondary`
`cx.theme().destructive`	`danger` / `danger_foreground`
`Button::new("id", "label")`	`Button::new("id").label("label")`;变体经 `ButtonVariants`:`.primary()`/`.danger()`/`.warning()`/`.success()`/`.ghost()`/`.link()`/`.outline()`
`.medium()`	不存在;默认即中号(`Sizable` 仅 `.xsmall()/.small()/.large()/.with_size(…)`)

gpui-migration

Install options

Review the source files

gpui 新旧 API 对照

类型与上下文

gpui 新旧 API 对照

类型与上下文

构造与生命周期

渲染与事件回调(元数变化)

异步(重构为 async 闭包)

gpui-component 更名/移除(0.5.x)

快速自检

gpui-migration

Source facts

Install options

Review the source files

More from this repository

gpui 新旧 API 对照

类型与上下文

gpui 新旧 API 对照

类型与上下文

构造与生命周期

渲染与事件回调(元数变化)

异步(重构为 async 闭包)

gpui-component 更名/移除(0.5.x)

快速自检

More from this repository