expo-upgrade · 有步骤地升级 Expo SDK

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

现有依赖包含expo-av；定制原生录音权限；目标SDK由团队另行指定。

输出

编辑示例 · 未运行

核对目标SDK是否要求从expo-av迁移到expo-audio或expo-video。
列出播放、录音、权限请求的调用位置，分别映射新API。
保存原生权限描述和构建配置；暂不执行prebuild --clean。
在目标设备验证首次授权、拒绝授权、后台中断和录音保存。

先确认目标版本与兼容性，再处理依赖、迁移和原生构建问题，保留可回退的升级记录。

具体任务

制定SDK升级路径：核对当前与目标版本，识别依赖和原生能力变化。

排查升级后构建故障：结合锁文件、原生改动与报错缩小不兼容范围。

必需材料

当前SDK、package.json及锁文件

明确目标版本和原生改动

可选材料

构建报错

设备验证清单

使用门槛

能运行项目原有构建；升级前保留当前代码、锁文件和原生定制。

这个 Skill 额外提供的方法

将依赖更新、API迁移和设备验证区分开，便于找到回归来源。

编辑示例（未运行）

先确认音频模块的迁移范围

任务：为含录音功能的Expo项目写升级检查单

输入：
现有依赖包含expo-av；定制原生录音权限；目标SDK由团队另行指定。

结果片段：
1. 核对目标SDK是否要求从expo-av迁移到expo-audio或expo-video。
2. 列出播放、录音、权限请求的调用位置，分别映射新API。
3. 保存原生权限描述和构建配置；暂不执行prebuild --clean。
4. 在目标设备验证首次授权、拒绝授权、后台中断和录音保存。

以下为官方编辑构造的示例，未运行上游 Skill。目标版本尚未给出，示例保留版本核对步骤，不把固定源中的版本建议泛化为当前最新版。

首次任务

任务：制定SDK升级路径。
任务重点：核对当前与目标版本，识别依赖和原生能力变化。

必需材料：
- 当前SDK、package.json及锁文件：[填写或粘贴我的材料；未具备则说明]
- 明确目标版本和原生改动：[填写或粘贴我的材料；未具备则说明]

可选补充：
- 构建报错：[可填写，未提供不应假定存在]
- 设备验证清单：[可填写，未提供不应假定存在]

请交付按依赖排序的行动步骤、执行前提与可判断的完成标准。仅依据这些材料处理；缺少决定结果的信息时先说明缺口，不补造事实。未执行的检查、修改或外部操作明确标为未执行。

使用前提：能运行项目原有构建；升级前保留当前代码、锁文件和原生定制。
处理边界：不得直接照抄latest或预览版命令；清理原生目录、上传反馈或修改签名配置需要明确范围

验收要求：
1. 目标版本和依赖兼容性均有依据。
2. 原生定制有保留与回退方式。
3. 关键能力在目标设备实际验证。

验收方法

目标版本和依赖兼容性均有依据

原生定制有保留与回退方式

关键能力在目标设备实际验证

依赖与准备

Expo/React Native 项目及平台构建环境；保留该固定版本 references 目录并查证目标SDK迁移说明。

使用边界

不得直接照抄latest或预览版命令

清理原生目录、上传反馈或修改签名配置需要明确范围

排错

依赖检查仍报冲突：查看锁文件与被排除的包，避免只改版本字符串。

模拟器通过真机失败：复查原生权限、签名和设备专属能力。

固定来源

https://github.com/expo/skills/blob/c0dadf355d4caa4e1720de372f0f8766df1a8978/plugins/expo/skills/expo-upgrade/SKILL.md

先看看示例

输入

输出

方法说明