@expo/cli

中文文档
58.1.21发布于 2026/11/17MITCommonJS构建来源已验证近 30 天下载 5889.3万

博览会CLI

中文使用文档
文档目录7 节
  1. 设计
  2. 格式
  3. 环境
  4. 测试
  5. 单位测试准则
  6. E2E 测试准则
  7. 来自博览会CLI

Expo CLI

为Android, iOS, 和网络构建和运行通用 React Industrial 应用程序的最快方式

📚 读取文档  二. 支助  在博客上多学点  二. 支助  为博览会CLI做出贡献

Discord

Expo on X   Expo on GitHub   Expo on Reddit   Expo on LinkedIn   Expo on LinkedIn

如果您喜欢使用此项目, 请确定会主演 GitHub Repo


这个 @expo/cli 软件包是应通过 expo 软件包,比如 npx expo start (或 npx expo 页:1.

npx expo

如果你喜欢使用该项目,请请在博览会GitHub Repo上亮相!

设计

这一国家行动倡议的目的如下:

  • 作为启动本地开发服务器的最小接口,该服务器可以模拟一个生产EAS Updates服务器. 开发服务器是本地运行时间(Expo Go, Dev Client)和JS Bundler(Metro, Webpack)之间的代理服务器.
    • 为了实现网络安全显示签名,比如AsyncStorage或权限,如果两者都需要https/SSL,我们需要一个经过认证的博览会账户。 这是我们唯一包括认证命令的原因 login, (中文(简体) ), logout, (中文(简体) ), whoami, (中文(简体) ), register。标准网络CLI没有认证命令,因为他们要么没有设置https,要么通过软件包模拟 devcert。 。 。 .
  • Xcode等各种本土工具的管弦, Simulator.app,Android Studio,ADB等让本土建筑尽可能无痛. run:ios, (中文(简体) ), run:android 命令.
  • 执行一个版本 prebuild 命令,可以长期可靠地与项目一起工作。 Prebuild就像一个捆绑器 对于本地代码,它生成 机器人 财务报告和审定财务报表 欧斯 基于工程 Expo 配置的文件夹( X)应用程序.json) (中文(简体) ).
    • npx expo config 是辅助工具 npx expo prebuild 并用于调试/内测.
  • 正在安装版本库 npx expo install 这是纯粹出于必要性而诞生的最低限度的用途,因为在React Industrial的版本很难正确.

捐款

开发 CLI 运行( 默认监视模式) :

pnpm build

我们强烈建议为博览会的CLI设置一个化名,这样你就可以在电脑周围的项目中尝试. 打开你的 .zshrc (英语) 或其他配置文件并添加:

alias nexpo="/path/to/expo/packages/@expo/cli/build/bin/cli"

那就用这个 nexpo 喜欢 nexpo config。也可以设置调试版本 :

alias expo-inspect="node --inspect /path/to/expo/packages/@expo/cli/build/bin/cli"

那样你就可以运行它和参观 chrome://inspect/#devices 在克罗姆语中,并按下 "打开专用的 DevTools 为节点" 以获取一个调试器附于您的进程。 调试 CLI 时, 您会希望尽可能使工人禁用, 这将让所有代码运行在同一线索上, 这主要适用于 start 命令,即:. expo-inspect start --max-workers 0。 。 。 .

格式

  • 一定要更新 CHANGELOG.md 每个公关都会有变化。 您只需要添加消息, 我们的 GitHub bot 会自动建议在 diff 中添加您的姓名和 PR 编号 .
  • 结束 async 函数与 Async 喜欢 runAsync。这就是我们在世博会上的功能格式.
  • 丢出错误时, 总是选择 CommandError 改为 Error 这有助于调试,使经验更加一致.
  • 利用统一的 Log 模块代替 console.log。 。 。 .
  • 在使用变量进行记录时,使用以下格式 Something happened (foo: bar, baz: foz)。 。 。 .
    • 避免其他格式,如 Something happened: bar, foz 或者说 Something happened: foo=bar, baz=foz。 。 。 .
  • 命令名称等主要 UI 组件(expo start),论据(--port),以及 --help 电文应在内部修改,由博览会团队负责,以确保开发者的经验在整个博览会工具中统一。 修改这些核心方面的外部捐款可能遭到拒绝.
  • 使用 profile 与该工具的通用方法 EXPO_PROFILE=1 用于测量执行时间的环境变量.
  • 避免全球性的和单子的试验,因为这些使试验更难,更不可预测。 我们(在编写本报告时)唯一的全球问题是: isOffline 布尔.

环境

  • 始终小心依赖的过渡性大小. 软件包恐惧症 用于确定软件包是否精益求精。 尽量减少CLI的依赖性.
  • 我们利用 taskr + 键 swc,这个部分灵感来自Next.js的本地CLI.
  • 建设管道将把CLI版本内置为环境变量,在CLI代码库的任何地方都可以访问. 你可以通过 process.env.__EXPO_VERSION 而不是读取本地 package.json 在运行时间.
  • 与传统全球博览会CLI不同的是,这种CLI是和 expo 表示 SDK 版本始终存在 .
    • 减少 SDK 特定任务,因为只有一个 SDK 应计入一个版本 @expo/cli。 。 。 .
    • 这个 @expo/config 方法 getConfig 无需 skipSDKVersionRequirement 在任何情况下,自从 expo 应始终安装。 实例: getConfig('...', { skipSDKVersionRequirement: true }); 不应该被使用.
  • 另外,与全球博览会CLI不同,我们可以假设,节点模块总是安装的,因为这个CLI应该通过项目的地方使用 节点( 模块) 文件夹.
    • 这意味着我们无法进行升级操作 expo 软件包,因为这些软件包可能会杀死运行的过程。 需要此模式的特征( 如 expo upgrade(a) 应在独立的全球工具中生活.

测试

有三种测试脚本:

  • pnpm test: 受控单位和集成测试
  • pnpm test:e2e: 结束对 CLI 命令的测试
  • pnpm test:playwright: 以 CLI 结束对 Expo SDK 的测试

  • 您可以使用 --watch 旗帜。 示例 pnpm test --watch config。 。 。 .
  • 我们用回扣 it 块。 示例 it(works)。 。 。 .
  • 如果拉动请求完全自成一体 packages/@expo/cli/ 文件夹( 即无) pnpm-lock.yaml 然后大多数本地CI测试会被跳过,使CI在PRs中通过得更快.

单位测试准则

  • 使用 nock 用于网络请求.
  • 无顶级 describe 块将所有测试包入文件.
  • 测试函数时,将函数传递到 describe 块而不是字符串函数名 :
    • describe(foobar, () => {}) 改为 describe('foobar', () => {})
  • 使用虚拟 fs 通过 memfs 只要可能,就应该.
  • 我们有很多全球模块 模拟 已经设置了, 在撰写测试时考虑它们 .
  • GitHub 副驾驶可以让写作测试少一点乏味.

E2E 测试准则

  • E2E测试应具有弹性和可靠性,确保为网络请求留出充足的时间.
  • 在本地测试时,你必须 安装了套装。 。 。 .
  • 当本地测试时, 您应该尝试重用节点模块, 以获得更快的结果 。 在那个 npx expo prebuild 财务报告和审定财务报表 npx expo start 例如,我们使用一种默认重用项目+的帮助方法 节点( 模块) 当运行本地。 这可能是 已切换 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}每一次 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}把新项目绑起来.
  • 拖曳测试项目时,请使用临时文件夹 os.tmpdir() 当计算机重新启动时,此文件夹会自动清理.

来自博览会CLI

TL; 大卫: expo-cli 是"让它工作",而 @expo/cli 是"做对了,快点".

全球遗产 expo-cli 软件包被折旧为赞成此版本 @expo/cli 软件包,原因如下:

  • expo-cli 太大了 安装得太久了 这使得CI沮丧地建立起来,因为你还需要瞄准用于缓存的全球节点模块.
  • expo-cli 几乎所有版本的 expo 软件包,意思是每次发行都变得更加复杂.
  • expo-cli 合并服务命令( 如 遗留 ) build, (中文(简体) ), submit, (中文(简体) ), publish),项目级命令类似 expo start我们从此将服务分为 eas-cli 命令输入 npx expo (单位:千美元)@expo/cli) (中文(简体) ). 这种结构对于开发者来说更为优化/快,因为他们可以在需要时安装/更新命令.
  • 这种CLI使用更多的Node.js标准特性,例如: $EDITOR 而不是习惯 $EXPO_EDITOR 环境变量。 也正在从 $EXPO_DEBUG 更接近于 $DEBUG=expo:*。这些类型的修改使得 Expo CLI 与现有工具玩得更好.
  • DevTools UI已经被去皮化,以减少网络安装大小,将复杂度最小化,并为未来的调试UIs(Hermes/v8 Chrome debuger)留有空间.
  • 这个 expo start:web 财务报告和审定财务报表 expo web 命令已被滚入 npx expo start 现在我们懒散地装入平台,直到设备要求它们.
  • 其他缺失或β特征来自 expo-cli 可能还是被迁移到这个新的CLI。 更详尽的细目,见 启动命令 PR。 。 。 .

版本与发布记录

@expo/cli 共发布 555 个版本,首次发布于 2022/03/24;过去 12 个月发布了 214 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
58.1.21latest2026/11/17今天
57.0.342026/11/125 天前
58.1.202026/11/115 天前
57.0.332026/11/0512 天前
58.1.192026/11/0413 天前
58.1.182026/10/3117 天前

其他发布通道:sdk-50 → 0.17.7,sdk-53 → 0.24.24,sdk-52 → 0.22.28,canary-sdk-55 → 55.0.13-canary-20260429-a5e59cf,canary-sdk-56 → 56.1.13-canary-20260701-9100865,canary → 58.0.0-canary-20260909-ea7a89a。

关于 @expo/cli 的常见问题

@expo/cli 是什么?

博览会CLI

如何安装 @expo/cli?

在项目目录运行 npm install @expo/cli,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:expo(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 expo-internal,可以用 npx expo-internal 直接运行。

@expo/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/expo__cli 是否存在。

@expo/cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@expo/cli 可以商用吗?

@expo/cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@expo/cli 的下载量有多少?

根据 npm 官方下载统计,@expo/cli 在 2026/10/14 – 2026/11/12 这 30 天内被下载 58,892,669 次,日均约 1,963,089 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@expo/cli 还在维护吗?

最新版本 58.1.21 发布于 2026/11/17(今天);至今共发布 555 个版本,其中过去 12 个月发布了 214 个;首次发布于 2022/03/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。