SDK 升级踩雷现场expo-av 已被拆成两个包AI 还在写老写法【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/GitHub_Trending/skills9/skills凌晨两点开发者群里又炸了。有人刚把 App 升级到新版 Expo SDK编译一路绿灯结果一打开视频黑屏音频没声录音按钮点下去毫无反应。更让人崩溃的是他转头问 AI 助手“帮我改一下播放器”AI 熟练地写出一段expo-av的老代码语气还挺自信。问题在于expo-av这个包官方已经不再推荐了。它被拆成了两个新包expo-audio管声音expo-video管画面。AI 不是变笨了是它手里的说明书还停留在两年前。最近在开源圈热度不低的Expo Skills干的就是这件事给 AI 编程助手发一本“最新版施工手册”。一、这东西到底是个啥说人话它是 Expo 官方团队亲自下场写的一套“AI 技能包”MIT 协议开源目前打包了 25 个技能覆盖建项目、做导航、写动画、上架应用商店、云构建、热更新等等。你可以这么理解以前的 AI 编程助手像一个刚毕业的高材生脑子好使但没在你们公司上过班不知道内部流程。Expo Skills 就是塞进它手里的员工手册——哪个包被废弃了、新版本该怎么写、哪些坑官方已经替你踩过了一条条写清楚。其中有本最厚的“搬家指南”叫expo-upgrade专门管 SDK 升级这档子破事。而它翻开第一页就点出了这次全网哀嚎的根源。二、最狠的一刀一把瑞士军刀被拆成两把专用刀早年做 App音视频全靠expo-av一个包搞定。播放、录音、视频、全屏一个入口全包省心。但官方后来发现这玩意儿太臃肿了。就像一把瑞士军刀什么都能干什么都不算精。于是它被一刀切开管声音的叫expo-audio管画面的叫expo-video听起来只是换个名字不写法几乎是重写。以前是“先造一个播放对象再喊它播放”现在是“用一个钩子直接把播放器抱在怀里”创建、加载、销毁全自动。以前要手动调音量、调进度、改循环现在直接改属性像调电视遥控器一样顺手。最阴的一个坑是单位变了。老版本里时间单位是毫秒新版本改成了秒。也就是说原本写 30000 的地方现在得写 30。这个坑有多隐蔽编译不报错运行不崩溃只是你的进度条像抽风一样一点就飞到片尾。很多团队查了两天才发现原来是少除了个 1000。还有一个更狠的安卓上expo-av和expo-video同时装着视频会直接黑屏。官方的说法很干脆——装新的之前先把老的卸干净。这不是建议是硬性要求。至于那些细节差异手册里也全列了播放完了不会自动回到开头想重播得先手动拉回 0 秒同一个播放器不能同时塞进多个视频窗口安卓上会黑想换片源不能用“重新创建”得用官方给的替换方法。这些都不是玄学全是真实踩出来的坑。三、升级不是按个按钮是走一套流程很多人以为升级 SDK 就是改个版本号、装个包。手册里给的步骤反而更像去医院体检第一步把版本对齐。先升主包再让工具把一堆依赖统一拉到匹配版本。这一步最容易出现“装了一半”的尴尬局面。第二步做检查。官方有个诊断工具会把版本冲突、缺失的依赖、配置错误一次性列出来。它像个不讲情面的老医生哪里有问题直接点名。第三步清缓存重装。这一步最反直觉——很多人改完代码还在报错其实不是代码的问题是旧缓存还在作祟。把依赖目录、构建缓存、打包缓存全清一遍往往就好了。手册还提醒了几个特别“反人类”的点你的项目配置里可能躺着一堆历史配置项。它们多半是当年为了绕开某个 bug 临时加的几年过去bug 早修了配置还留着反而成了新版本的绊脚石。升级时这几条要一条条重新审视。还有patches目录里的补丁文件也该清一清了。更妙的是像 babel 配置、打包配置这些文件如果里面只剩下官方默认那几行官方直接建议删了。留着只是心理安慰。四、它顺手帮你避开了几个更大的雷除了音视频这几年的 Expo 升级还有几处“静悄悄的大改”导航的写法变了。从某个版本开始代码里不能再直接引用 React Navigation 的包得统一走 Expo Router 的入口。官方甚至给了自动改写工具一行命令扫全项目比人手一个个改靠谱得多。底部标签栏的写法变了。以前的图标、文字、角标是分开导入的组件现在得挂在标签项的属性下面。老写法不一定立刻报错但会慢慢失效。React 也换代了。新版 React 里读取上下文的老写法被简化forwardRef这种“套娃”也不再必需。同时官方还建议打开编译器开关让它自动帮你做性能优化省掉一堆手动缓存。还有一个内存坑要特别提醒官方明确写了某个区间的 SDK 版本在配合动画库使用时可能出现内存占用暴涨的问题。所以别一步一挪地升直接从老版本跳到最新的稳定版反而更安全。你看这些东西哪一条是能靠“问 AI 一句”问出来的五、所以普通人能用吗这里要泼盆冷水它不是给普通用户装的应用是给写 App 的人用的工具。你不需要显卡不需要服务器一台普通笔记本就够。它免费开源安装方式也很轻——用 Claude Code 或 Codex 的在插件市场里点一下用 Cursor、Copilot、Windsurf、Gemini 这些的在项目根目录跑一条安装命令重启一下助手就行。装好之后你不需要记住那些绕口的包名。直接跟 AI 说“帮我把这个项目升到最新 SDK”“这个播放器写法是不是过时了”“升级完视频黑屏怎么办”它会自己去翻对应的手册章节。最适合谁一个人扛一个 App 的独立开发者三五个人小团队里那个“什么都得管”的技术负责人接外包、手上同时维护好几个老项目的自由职业者还有被 AI 自信满满的错误代码坑过、现在看到“已为你完成”就头皮发麻的人。说实话它也不是万能药。它不替你跑测试不替你上真机验证更不会帮你决定“这个功能到底要不要重写”。它做的是把“官方最新说法”准确递到 AI 手上剩下的判断还得人来。写在最后这次 expo-av 被拆包引发的集体翻车其实说明了一件挺有意思的事AI 编程的真正瓶颈早就不是“会不会写”而是“知不知道现在该怎么写”。网上的教程、博客、问答大多停留在旧版本模型的训练数据也有天然的时间差。于是出现一个荒诞场面人类已经搬家了AI 还在照着老地址送快递。Expo Skills 这类“官方技能包”的价值就在这儿——它不教 AI 变聪明它只是把最新的地图塞进了 AI 的口袋。最后想问一句你升级依赖的时候踩过最离谱的坑是什么是那种“代码一个字没改功能自己没了”的评论区聊聊说不定你那个坑正是别人明天要掉的。【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/GitHub_Trending/skills9/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
