SuperAPI AI 工具集

codex-expo-run-actions

编程与开发

查看项目

更新于 11-17 02:51

技能介绍

用途

Codex Run Actions for Expo 用于把 Expo 项目连接到 Codex 应用的操作栏。目标是在项目内提供一个本地运行脚本,并配合 .codex/environments/environment.toml 动作配置,让用户在 Codex 应用中按 Run 即可启动 Expo 开发服务器,并在动作终端中查看 Expo CLI / Metro 日志。

主要能力

  • 确认当前工作区是否为 Expo 应用:检查 package.json,以及 app.json、app.config.js、app.config.ts 或 package.json 中的 expo 字段。若 Expo 应用位于子包中,不应在 monorepo 根目录接入 Codex 动作。
  • 发现包管理器:优先使用 packageManager 中声明的包管理器,否则根据锁文件推断;生成的运行脚本仍保留对 npx expo 的安全回退。
  • 创建或更新 script/build_and_run.sh。默认无参数模式会启动 Expo 开发服务器(expo start),并让开发服务器保持在前台,使 Codex 动作终端拥有日志和 Ctrl-C 行为。
  • 支持可选模式:--ios 启动 Expo 并打开 iOS 模拟器;--android 启动并打开 Android;--web 启动 Web 模式;--dev-client 以 dev-client 模式启动;--tunnel 启动隧道;--export-web 导出 Web。
  • 写入 .codex/environments/environment.toml:始终添加或更新一个名为 Run 的主动作,指向 ./script/build_and_run.sh;仅在用户要求或项目明显需要时,才添加 Run iOS、Run Android、Run Web 或 Run Dev Client 等直接按钮。若环境文件已存在,则更新匹配的已有动作而不是重复添加。
  • 接入后可通过运行 ./script/build_and_run.sh --help 或短时非服务器模式进行语法检查。

使用方式

在需要接入时,按上述流程创建或更新脚本与环境配置文件。参考资料 references/expo-run-button-bootstrap.md 提供了 Expo 脚本与环境动作的规范示例。

适用场景

适用于希望从 Codex 应用操作栏一键启动 Expo 开发服务器、查看 Metro 日志的场景,也适用于需要 iOS、Android、Web、dev-client 或隧道等直接启动按钮的项目。

限制与注意事项

  • 优先尝试 Expo Go / expo start,不要把 Codex Run 按钮默认设置为 expo run:ios、expo run:android、prebuild 或 EAS Build。
  • 除非用户明确要求并接受认证、时间和成本权衡,否则不要把 eas build、eas submit 或商店部署等云动作接入 Codex 按钮。
  • 不要创建嵌套 git 仓库。
  • 不要在 .codex/environments/environment.toml 或运行脚本中放置密钥。
  • 不要从运行脚本中把 Metro 放到后台;动作终端应显示活动的服务器日志。
  • 如果项目使用 pnpm、yarn 或 bun,不要硬编码 npm。
  • 在仅做接入配置的任务中,不要启动长时间运行的 Metro 服务器,除非用户要求运行应用。

输出预期

完成设置变更后,应总结:接入的 Expo 应用根目录、运行脚本路径、Codex 环境文件路径、添加或更新的动作,以及如何从 shell 启动同一路径。