尧图网页设计 
如何为Expo应用做OTA热更新Expo Skills的EAS Update配置、发布与健康监控完全指南【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skillsExpo EAS Update是 Expo 官方提供的 OTAOver-The-Air空中下载热更新服务可以跳过应用商店审核直接向已安装用户推送 JavaScript 代码和资源更新。本文将介绍如何使用官方Expo SkillsAI 智能体技能集合快速完成 EAS Update 的一键配置、发布流程与健康监控帮助你在 10 分钟内上手 Expo 热更新。一、OTA热更新能做什么哪些改动不能热更新EAS Update 的核心价值修 Bug、改文案、调样式、更新资源无需重新提交应用商店。用户下次启动 App 即可拿到新版代码。但有一个关键边界 改动类型能否热更新JavaScript / TypeScript 代码✅ 可以样式、文案、图片资源✅ 可以新增/修改原生代码Swift、Kotlin、原生库❌ 需要重新打包构建升级 Expo SDK / 原生配置❌ 需要重新打包构建先搞懂 5 个核心概念EAS Update 的匹配逻辑由 5 个概念组成理解了它们就不会再问为什么我的更新没生效概念通俗解释Build构建包用户安装的本地 App包含原生代码和一个固定频道Update更新一次发布的 JS Bundle 资源对应特定平台与运行时版本Branch分支一条有序的更新流其中最新且兼容的更新会生效Channel频道构建包内嵌的稳定投递目标在服务端指向某个分支Runtime Version运行时版本更新与本地原生代码之间的兼容性边界一句话总结匹配规则平台相同 运行时版本匹配 频道指向发布该更新的分支三者同时满足更新才会被安装。二、认识 Expo SkillsExpo 官方的 AI 技能包Expo Skills 是 Expo 团队官方出品的 AI 智能体技能集合把何时用哪个 Expo/EAS API、工作流怎么组织、有哪些平台限制这些专家知识封装成一个个SKILL.md技能文件安装后即可让 Claude Code、Cursor、Codex 等 AI 编程助手按官方最佳实践干活。与本文相关的两个技能eas-update负责配置、发布、测试与调试 OTA 热更新源码见 plugins/expo/skills/eas-update/SKILL.mdeas-update-insights负责更新发布后的健康监控——崩溃率、启动数、唯一用户、包体大小源码见 plugins/expo/skills/eas-update-insights/SKILL.md一键安装步骤在 Expo 项目根目录执行支持 Cursor、OpenCode、GitHub Copilot 等主流 AI 工具npx skillslatest add expo/skills --skill *安装后重启或刷新 AI 会话即可。Claude Code / Codex 用户则建议走官方插件市场安装expo插件后续更新由市场统一管理详见 plugins/expo/README.md。三、一键配置 EAS Update3 条命令搞定EAS Skills 的eas-update技能强调一条黄金法则不要手动瞎猜配置比如手写updates.url、runtimeVersion让 CLI 来干脏活。第 1 步安装热更新运行时npx expo install expo-updates第 2 步自动配置npx eas-clilatest update:configure这条命令会处理项目关联、连续原生生成Continuous Native Generation、已提交的ios/android/原生目录等全部细节。配置完成后记得让 AI 帮你 review 一下它改动的 diff——这正是eas-update技能内置的工作流。 如果项目已有eas.jsonCLI 只会给尚未设置频道的构建 profile 补充同名频道不会破坏你现有的频道分配。第 3 步可选确认构建 profile若项目尚未做过eas build:configure按提示执行一次为 preview / staging / production 各准备一个构建 profile。四、如何正确发布一次OTA更新发布会改动远端状态并影响线上用户所以技能中特别强调发布前务必明确目标频道、环境和平台生产频道production只在明确需要时才发。推荐发布流程先预览再生产# 1. 先发到 preview 频道验证 npx eas-clilatest update --channel preview --message 修复结算页崩溃 # 2. 验证通过后再推广到 production npx eas-clilatest update --channel production --message v1.0.2 修复结算页崩溃⚠️ 从 SDK 55 开始发布必须显式指定 EAS 环境--environment确保导出的代码带上正确的环境变量。发布后如何验证记住两次冷启动正式版构建默认优先启动速度App 可能先跑旧代码后台下载新更新下次重启才生效。所以手动测试时完全杀掉App不是切后台重新打开 → 第 1 次启动发现并下载更新若改动仍未出现再完全杀掉并重新打开 → 第 2 次启动运行新更新这就是技能文档中总结的至多两次冷启动up to two cold launches规则。除非你的产品确实需要等待更新完成的体验否则不要为此调高启动等待超时fallbackToCacheTimeout。五、健康监控用 Insights 命令盯住发布质量更新发布 ≠ 万事大吉。Expo Skills 的eas-update-insights技能提供了一组终端命令直接查询发布健康度——这些数据与 expo.dev 控制台的更新详情页同源命令用途eas update:list列出最近的更新组拿到groupIDeas update:insights groupId查看单平台崩溃率、启动数、唯一用户、包体大小、按日明细eas update:view groupId --insights更新详情 指标一并展示eas channel:insights --channel name查看某频道下内置版 vs OTA 版用户占比与最热门更新典型工作流验证刚发布的更新是否健康# 拿到 production 分支最新发布的 group ID GROUP_ID$(eas update:list --branch production --json --non-interactive | jq -r .currentPage[0].group) # 等几分钟到几小时有用户量后看崩溃率 eas update:insights $GROUP_ID --json --non-interactive \ | jq .platforms[] | {platform, installs: .totals.installs, crashRate: .totals.crashRatePercent}看什么指标crashRatePercent崩溃率突增或 iOS/Android 表现不对称一边飙、一边平就是需要立即排查的信号installs/uniqueUsers采用率信号判断有多少人真正拉到了新版daily时间序列用于发现某天的启动失败突然尖峰两个字段参考文档值得收藏update-insights-schema.md 和 channel-insights-schema.md。 注意口径installs统计的是下载了清单和启动资源的用户确认运行要等下一次更新检查最多约 24 小时因此指标会略滞后于真实状态崩溃是 App 自报的进程被杀前未上报的崩溃不会计入。六、热更新没生效按顺序做 6 项排查这是新手最高频的问题eas-update技能给出了一条标准的排查清单确认发布目标更新是否发到了正确的 EAS 项目、频道/分支、平台和环境对比兼容性安装包的平台 运行时版本与发布的更新是否匹配确认构建包含新配置App 配置更新 URL、频道只在新编译的构建包中生效旧包不会自动带上检查频道映射频道 → 分支的服务端映射是否正确分支上的活动更新是哪一条完整终止重开给正式版构建留出先下载、后应用的正常生命周期两次冷启动查原生日志配合官方调试指南检查导出与配置问题技能中反复强调一条红线永远不要绕过兼容性或防变砖保护机制来让更新看起来生效——那可能把线上用户全部打变砖。七、写在最后用三句话回顾 Expo EAS Update 热更新的核心思路✅配置交给eas update:configure不手写 URL 和 runtimeVersion✅发布preview 先行、production 谨慎记住两次冷启动验证法✅监控发布后用eas update:insights盯崩溃率与采用率异常即回滚把 Expo Skills 装进你的 AI 编程助手以上每一步都可以直接让它按官方最佳实践执行并随时向你解释为什么这么配。热更新从此不再是黑盒。【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何为Expo应用做OTA热更新：Expo Skills的EAS Update配置、发布与健康监控完全指南
如何为Expo应用做OTA热更新Expo Skills的EAS Update配置、发布与健康监控完全指南【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skillsExpo EAS Update是 Expo 官方提供的 OTAOver-The-Air空中下载热更新服务可以跳过应用商店审核直接向已安装用户推送 JavaScript 代码和资源更新。本文将介绍如何使用官方Expo SkillsAI 智能体技能集合快速完成 EAS Update 的一键配置、发布流程与健康监控帮助你在 10 分钟内上手 Expo 热更新。一、OTA热更新能做什么哪些改动不能热更新EAS Update 的核心价值修 Bug、改文案、调样式、更新资源无需重新提交应用商店。用户下次启动 App 即可拿到新版代码。但有一个关键边界 改动类型能否热更新JavaScript / TypeScript 代码✅ 可以样式、文案、图片资源✅ 可以新增/修改原生代码Swift、Kotlin、原生库❌ 需要重新打包构建升级 Expo SDK / 原生配置❌ 需要重新打包构建先搞懂 5 个核心概念EAS Update 的匹配逻辑由 5 个概念组成理解了它们就不会再问为什么我的更新没生效概念通俗解释Build构建包用户安装的本地 App包含原生代码和一个固定频道Update更新一次发布的 JS Bundle 资源对应特定平台与运行时版本Branch分支一条有序的更新流其中最新且兼容的更新会生效Channel频道构建包内嵌的稳定投递目标在服务端指向某个分支Runtime Version运行时版本更新与本地原生代码之间的兼容性边界一句话总结匹配规则平台相同 运行时版本匹配 频道指向发布该更新的分支三者同时满足更新才会被安装。二、认识 Expo SkillsExpo 官方的 AI 技能包Expo Skills 是 Expo 团队官方出品的 AI 智能体技能集合把何时用哪个 Expo/EAS API、工作流怎么组织、有哪些平台限制这些专家知识封装成一个个SKILL.md技能文件安装后即可让 Claude Code、Cursor、Codex 等 AI 编程助手按官方最佳实践干活。与本文相关的两个技能eas-update负责配置、发布、测试与调试 OTA 热更新源码见 plugins/expo/skills/eas-update/SKILL.mdeas-update-insights负责更新发布后的健康监控——崩溃率、启动数、唯一用户、包体大小源码见 plugins/expo/skills/eas-update-insights/SKILL.md一键安装步骤在 Expo 项目根目录执行支持 Cursor、OpenCode、GitHub Copilot 等主流 AI 工具npx skillslatest add expo/skills --skill *安装后重启或刷新 AI 会话即可。Claude Code / Codex 用户则建议走官方插件市场安装expo插件后续更新由市场统一管理详见 plugins/expo/README.md。三、一键配置 EAS Update3 条命令搞定EAS Skills 的eas-update技能强调一条黄金法则不要手动瞎猜配置比如手写updates.url、runtimeVersion让 CLI 来干脏活。第 1 步安装热更新运行时npx expo install expo-updates第 2 步自动配置npx eas-clilatest update:configure这条命令会处理项目关联、连续原生生成Continuous Native Generation、已提交的ios/android/原生目录等全部细节。配置完成后记得让 AI 帮你 review 一下它改动的 diff——这正是eas-update技能内置的工作流。 如果项目已有eas.jsonCLI 只会给尚未设置频道的构建 profile 补充同名频道不会破坏你现有的频道分配。第 3 步可选确认构建 profile若项目尚未做过eas build:configure按提示执行一次为 preview / staging / production 各准备一个构建 profile。四、如何正确发布一次OTA更新发布会改动远端状态并影响线上用户所以技能中特别强调发布前务必明确目标频道、环境和平台生产频道production只在明确需要时才发。推荐发布流程先预览再生产# 1. 先发到 preview 频道验证 npx eas-clilatest update --channel preview --message 修复结算页崩溃 # 2. 验证通过后再推广到 production npx eas-clilatest update --channel production --message v1.0.2 修复结算页崩溃⚠️ 从 SDK 55 开始发布必须显式指定 EAS 环境--environment确保导出的代码带上正确的环境变量。发布后如何验证记住两次冷启动正式版构建默认优先启动速度App 可能先跑旧代码后台下载新更新下次重启才生效。所以手动测试时完全杀掉App不是切后台重新打开 → 第 1 次启动发现并下载更新若改动仍未出现再完全杀掉并重新打开 → 第 2 次启动运行新更新这就是技能文档中总结的至多两次冷启动up to two cold launches规则。除非你的产品确实需要等待更新完成的体验否则不要为此调高启动等待超时fallbackToCacheTimeout。五、健康监控用 Insights 命令盯住发布质量更新发布 ≠ 万事大吉。Expo Skills 的eas-update-insights技能提供了一组终端命令直接查询发布健康度——这些数据与 expo.dev 控制台的更新详情页同源命令用途eas update:list列出最近的更新组拿到groupIDeas update:insights groupId查看单平台崩溃率、启动数、唯一用户、包体大小、按日明细eas update:view groupId --insights更新详情 指标一并展示eas channel:insights --channel name查看某频道下内置版 vs OTA 版用户占比与最热门更新典型工作流验证刚发布的更新是否健康# 拿到 production 分支最新发布的 group ID GROUP_ID$(eas update:list --branch production --json --non-interactive | jq -r .currentPage[0].group) # 等几分钟到几小时有用户量后看崩溃率 eas update:insights $GROUP_ID --json --non-interactive \ | jq .platforms[] | {platform, installs: .totals.installs, crashRate: .totals.crashRatePercent}看什么指标crashRatePercent崩溃率突增或 iOS/Android 表现不对称一边飙、一边平就是需要立即排查的信号installs/uniqueUsers采用率信号判断有多少人真正拉到了新版daily时间序列用于发现某天的启动失败突然尖峰两个字段参考文档值得收藏update-insights-schema.md 和 channel-insights-schema.md。 注意口径installs统计的是下载了清单和启动资源的用户确认运行要等下一次更新检查最多约 24 小时因此指标会略滞后于真实状态崩溃是 App 自报的进程被杀前未上报的崩溃不会计入。六、热更新没生效按顺序做 6 项排查这是新手最高频的问题eas-update技能给出了一条标准的排查清单确认发布目标更新是否发到了正确的 EAS 项目、频道/分支、平台和环境对比兼容性安装包的平台 运行时版本与发布的更新是否匹配确认构建包含新配置App 配置更新 URL、频道只在新编译的构建包中生效旧包不会自动带上检查频道映射频道 → 分支的服务端映射是否正确分支上的活动更新是哪一条完整终止重开给正式版构建留出先下载、后应用的正常生命周期两次冷启动查原生日志配合官方调试指南检查导出与配置问题技能中反复强调一条红线永远不要绕过兼容性或防变砖保护机制来让更新看起来生效——那可能把线上用户全部打变砖。七、写在最后用三句话回顾 Expo EAS Update 热更新的核心思路✅配置交给eas update:configure不手写 URL 和 runtimeVersion✅发布preview 先行、production 谨慎记住两次冷启动验证法✅监控发布后用eas update:insights盯崩溃率与采用率异常即回滚把 Expo Skills 装进你的 AI 编程助手以上每一步都可以直接让它按官方最佳实践执行并随时向你解释为什么这么配。热更新从此不再是黑盒。【免费下载链接】skillsA collection of AI agent skills for working with Expo projects and Expo Application Services项目地址: https://gitcode.com/gh_mirrors/skills9/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考