> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 固件升级

点击 Activity bar 的 **Upgrade** 图标  进入固件升级视图。Wuji Studio 提供向导式固件升级流程。

![固件升级](https://mintcdn.com/wuji-0bbde051/l_0u7HfQSm-D4qqb/shared/assets/source/images/zh/wuji-studio/upgrade-steps.png?fit=max\&auto=format\&n=l_0u7HfQSm-D4qqb\&q=85\&s=89d7ec902d665a2a4fa7284b5e3caf64)

## 升级流程

### 第 1 步：选择设备

进入升级视图后，Sidebar 列出所有已连接设备。Sidebar 按产品类型分组展示设备，无法识别的设备归入 **Other Devices** 分组。

选择要升级的目标设备后：

* 显示设备当前固件版本
* 自动检测是否有可用的新版本
* 如果已是最新版本，会给出提示

### 第 2 步：选择固件

应用自动从服务器获取可用固件列表，按版本号从新到旧排序。每个固件条目显示：

* 版本号
* 发布日期
* 发布说明（Release Notes）

选择目标版本后，会显示从当前版本到目标版本的累积变更记录，帮助理解将获得的全部功能更新。

> [!WARNING]
>
> 如果选择的目标版本低于当前版本（降级），升级界面会显示警告提示，并用删除线标记将丢失的功能。请确认降级影响后再继续。

### 第 3 步：升级中

确认升级后，进度条实时显示升级状态：

1. **准备** — 初始化升级环境
2. **传输中** — 将固件传输到设备
3. **验证** — 校验固件完整性

> [!WARNING]
>
> * 升级过程中请勿关闭应用或断开设备连接。如果尝试关闭应用，会弹出确认对话框提醒升级正在进行。
>   升级过程中出现问题，请查阅[故障排查](https://docs.wuji.tech/docs/zh/wuji-studio/latest/troubleshooting.md)。

### 第 4 步：升级结果

* **成功**：显示升级前后的版本对比和验证结果
* **失败**：显示错误详情和升级日志，提供重试选项。升级失败时固件会自动回滚到之前的版本


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.