---

name: upgrading-expo description: "升级 Expo SDK 版本" risk: safe source: "https://github.com/expo/skills/tree/main/plugins/upgrading-expo" date_added: "2026-02-27"

升级 Expo

概述

安全地升级 Expo SDK 版本，处理破坏性变更、依赖项和配置更新。

何时使用此技能

当你需要升级 Expo SDK 版本时使用此技能。

使用场景：

• 升级到新的 Expo SDK 版本
• 处理 SDK 版本之间的破坏性变更
• 更新依赖项以确保兼容性
• 将已弃用的 API 迁移到新版本
• 为新的 Expo 功能做准备

操作说明

此技能指导你完成 Expo SDK 版本升级：

1. 升级前规划：查看发布说明和破坏性变更
2. 依赖项更新：更新软件包以确保 SDK 兼容性
3. 配置迁移：更新 app.json 和配置文件
4. 代码更新：将已弃用的 API 迁移到新版本
5. 测试：升级后验证应用功能

升级流程

1. 升级前检查清单

• 查看 Expo SDK 发布说明
• 识别影响你应用的破坏性变更
• 检查第三方包的兼容性
• 备份当前项目状态
• 为升级创建功能分支

2. 更新 Expo SDK

# Update Expo CLI
npm install -g expo-cli@latest

# Upgrade Expo SDK
npx expo install expo@latest

# Update all Expo packages
npx expo install --fix

3. 处理破坏性变更

• 查看破坏性变更的迁移指南
• 更新已弃用的 API 调用
• 根据需要修改配置文件
• 如有必要更新原生依赖
• 彻底测试受影响的功能

4. 更新依赖项

# Check for outdated packages
npx expo-doctor

# Update packages to compatible versions
npx expo install --fix

# Verify compatibility
npx expo-doctor

5. 测试

• 测试核心应用功能
• 验证原生模块正常工作
• 检查运行时错误
• 在 iOS 和 Android 上测试
• 验证应用商店构建仍然正常

常见问题

依赖冲突

• 对 Expo 包使用 expo install 而不是 npm install
• 检查包与新 SDK 版本的兼容性
• 解决对等依赖警告

配置变更

• 根据新 SDK 要求更新 app.json
• 迁移已弃用的配置选项
• 如有需要更新原生配置文件

破坏性 API 变更

• 查看 API 迁移指南
• 更新代码以使用新 API
• 变更后测试受影响的功能

最佳实践

• 始终在功能分支中升级
• 合并前彻底测试
• 仔细查看发布说明
• 逐步更新依赖项
• 保持 Expo CLI 更新
• 使用 expo-doctor 验证设置

资源

更多信息请参阅源代码仓库。

限制

• 仅在任务明确匹配上述描述范围时使用此技能。
• 不要将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停下来寻求澄清。