Expo 项目升级
升完版本后清掉各类缓存,尤其是带原生目录的裸工作流项目。
功能与用途
这个技能聚焦升级后的收尾工作——把该清的缓存清干净,否则升级带来的问题会以各种莫名其妙的形式冒出来,让你误以为是升级本身有问题。针对带原生目录的裸工作流项目,几处缓存要分别处理:移动端依赖缓存要走重新安装并更新索引,构建产物缓存要用不带构建缓存的方式重新跑一次,安卓侧则要在原生目录里执行一次清理命令。这些步骤只在项目里存在对应原生目录时才适用,托管工作流不需要。适合刚完成版本升级、遇到构建失败或运行异常却找不到原因的团队,先按这份清单把缓存清一遍,往往能省掉大量排查时间。
适用场景
- 跨版本依赖诊断与升级:使用 expo install 与 expo-doctor 排查版本冲突,一键更新核心库与废弃包。
- 裸工程缓存与构建清理:针对含 ios/android 目录的项目,更新 Podfile 索引并执行 Gradle clean 清除构建遗留。
- 新架构与编译器特性迁移:指引适配 React 19、React Compiler 以及新架构过渡,清理废弃的打包配置与补丁。
适用人群
- 移动应用开发者
- 前端开发
- 技术团队
使用步骤
- 确认项目里是否存在原生目录
- 存在移动端目录时重新安装依赖并更新索引
- 用不带构建缓存的方式重新运行一次
- 存在安卓目录时执行清理命令
- 清理后重新构建验证问题是否消失
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Guidelines for upgrading Expo SDK versions and fixing dependency issues
使用前准备
- 已完成版本升级的项目
- 可用的原生构建工具链
依赖与权限
- 读取用户主动提供的内容