upgrading-expo

Upgrading Expo - Expo SDK 版本升级技能

技能概述

Upgrading Expo 是一个帮助你安全升级 Expo SDK 版本的自动化技能，能够处理破坏性变更、依赖更新和配置迁移，确保升级过程平滑无风险。

适用场景

版本升级：当你需要将 Expo 项目从旧版本（如 SDK 48）升级到新版本（如 SDK 50）时，该技能会提供完整的升级流程指导。

破坏性变更处理：当 Expo 发布新版本并引入 API 变更或配置修改时，该技能能帮你识别并适配这些变化。

依赖兼容性维护：当第三方包与新版 Expo SDK 不兼容时，该技能会指导你使用 expo-doctor 检测并解决依赖冲突。

核心功能

升级前规划与检查：自动审查 Expo SDK 发布说明，识别影响项目的破坏性变更，检查第三方包兼容性，并建议创建功能分支和备份。

依赖与配置自动更新：使用 expo install --fix 自动更新所有 Expo 包到兼容版本，同时处理 app.json 配置迁移和原生依赖更新。

升级后验证与测试：提供完整的测试清单，包括核心功能验证、原生模块测试、iOS/Android 双平台测试，以及应用商店构建验证。

常见问题

Expo 升级会覆盖我的代码吗？

不会。Expo SDK 升级只会更新项目依赖和配置文件，不会修改你的业务代码。但需要注意，如果升级包含破坏性 API 变更，你可能需要手动调整使用了已废弃 API 的代码部分。

升级 Expo SDK 后第三方库不兼容怎么办？

首先使用 npx expo-doctor 检查依赖兼容性。对于不兼容的包，可以尝试使用 npx expo install --fix 自动修复版本冲突。如果问题依旧，需要查看该第三方库的文档，确认是否有支持新版 Expo SDK 的版本可用。

使用 expo install 还是 npm 安装包？

对于 Expo 相关的包，强烈建议使用 expo install 而不是 npm install。因为 expo install 会自动安装与当前 SDK 版本兼容的包版本，而 npm install 可能会安装不兼容的最新版本，导致项目无法正常运行。