三亩地 三亩地SAN MU DI · CODE DIARY
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天,欢迎挑你感兴趣的翻一翻。

eas 热更新相关

eas 热更新相关

几个问题:

eas 打包 和 eas 热更新

打包命令:eas build --profile [profile name] --platform all
热更新命令:eas update --channel [channel name] --message “测试版本1.0.1”

eas.json vs app.json(app.config.js)

The knowledge sources provided don’t contain the full content of thehttps://docs.expo.dev/eas-update/expo-dev-client/page, so I’ll answer based on the available related documentation.


EAS 热更新完整流程

整体流程概览
安装依赖 → 配置项目 → 创建构建 → 发布更新 → 用户接收更新

第一步:安装依赖
npx expoinstallexpo-updates

[安装 expo-updates]


第二步:配置项目
eas update:configure

该命令会自动完成:

  • app.json中添加updates.urlruntimeVersion
  • eas.json各构建 profile 中添加channel属性

配置完成后app.json示例:

{"expo":{"runtimeVersion":{"policy":"appVersion"},"updates":{"url":"https://u.expo.dev/your-project-id"}}}

eas.json示例:

{"build":{"preview":{"distribution":"internal","channel":"preview"},"production":{"channel":"production"}}}

[配置项目]


第三步:创建构建

Channel 信息会在构建时烧录进原生代码,所以必须先有构建才能接收更新:

eas build--profileproduction

[EAS Build 与 Update]


第四步:发布更新

修改 JS 代码后,推送热更新:

eas update--channelproduction--message"修复登录页面 bug"

发布后 EAS 服务器会将更新分发给所有channel=productionruntimeVersion匹配的 App。[发布更新]


第五步:用户接收更新
方式说明
自动后台下载App 启动时自动检查并下载,下次冷启动生效
Development Build通过 Extensions 面板手动加载指定更新,适合测试
Expo Orbit扫码直接安装并启动更新
编程控制使用expo-updatesuseUpdateshook 主动检查并提示用户

[测试更新]


注意事项
  • 热更新只能更新 JS 代码,涉及原生模块变更时必须重新构建
  • 每次修改原生层后需同步更新runtimeVersion,否则新旧版本 App 可能收到不兼容的更新
  • 默认情况下 debug 构建不会启用expo-updates,需要 release 或特殊配置的 debug 构建才能测试热更新效果 [调试说明]

Channel 与 Profile 的关系

Profile 是 eas.json 配置文件中环境的简称,用于构建时指定运行哪组环境配置。

Channel 代表当前应用环境的唯一标识。构建完成后,该标识会被记录在应用中。进行热更新时,系统只会拉取与该标识匹配的热更新资源包。

runtimeVersion的书写方式

参考这里:点击

备注:我理解应该使用平台特定运行版本。避免不兼容的更新

← 返回列表