开发工具

编辑页面

Expo 工具和网站概览，可在你构建项目旅程的各个方面为你提供帮助。

当你使用 Expo 创建一个新项目时，了解以下必备工具和网站可以在应用开发过程中为你提供帮助。本页面概述了一系列推荐工具。

Expo CLI

Expo CLI 是一个开发工具，在你创建新项目时会随 expo 包自动安装。你可以通过使用 npx（一个 Node.js 包运行器）来使用它。

它旨在帮助你在应用开发阶段更快地推进。例如，你与 Expo CLI 的第一次交互，就是通过运行命令 npx expo start 来启动开发服务器。

以下是在开发应用时会经常与 Expo CLI 一起使用的常见命令列表：

命令	描述
`npx expo start`	启动开发服务器（无论你使用的是开发构建还是 Expo Go）。
`npx expo prebuild`	使用 Prebuild 生成原生 Android 和 iOS 目录。
`npx expo run:android`	在本地编译原生 Android 应用。
`npx expo run:ios`	在本地编译原生 iOS 应用。
`npx expo install package-name`	通过在此命令后添加 `--fix` 选项，用于安装新库，或验证并更新项目中的特定库。
`npx expo lint`	设置并配置 ESLint。如果 ESLint 已经配置好，此命令会对你的项目文件进行 lint 检查。

简而言之，Expo CLI 允许你开发、编译、启动应用等等。有关你可以使用 CLI 执行的更多选项和操作，请参阅 Expo CLI 参考。

EAS CLI

EAS CLI 用于登录你的 Expo 账户，并使用不同的 EAS 服务（例如 Build、Update 或 Submit）来编译你的应用。你也可以使用此工具来：

将你的应用发布到应用商店
创建应用的开发、预览或生产构建
创建空中更新（OTA）
管理你的应用凭证
为 iOS 设备创建一个 ad hoc provisioning profile

要使用 EAS CLI，你需要在本地机器上全局安装它，运行以下命令：

Terminal

- npm install -g eas-cli

你可以在终端窗口中使用 eas --help 来了解更多可用命令。完整参考请查看 eas-cli npm 页面。

Expo Doctor

Expo Doctor 是一个命令行工具，用于诊断 Expo 项目中的问题。要使用它，请在项目根目录中运行以下命令：

Terminal

- npx expo-doctor

此命令会检查并分析项目代码库中与 app config 和 package.json 文件、依赖兼容性、配置文件以及项目整体健康状况相关的常见问题。检查完成后，Expo Doctor 会输出结果。

如果 Expo Doctor 发现问题，它会提供问题描述，以及如何修复或在哪里寻求帮助的建议。

默认情况下，Expo Doctor 会根据 React Native directory 验证项目的包，并在原生目录存在时检查 app config 属性是否已正确同步。你可以在项目的 package.json 文件中配置这些检查。有关更多详情，请参阅 reactNativeDirectoryCheck 和 appConfigFieldsNotSyncedCheck。

你也可以使用 npx expo-doctor --help 来显示使用信息。

Orbit

Orbit 是一款适用于 macOS 和 Windows 的应用，可实现：

在实体设备和模拟器上安装并启动来自 EAS 的构建。
在 Android 模拟器或 iOS 模拟器上安装并启动来自 EAS 的更新。
在 Android 模拟器或 iOS 模拟器上启动 snack 项目。
使用本地文件来安装并启动应用。Orbit 支持任何 Android .apk、iOS Simulator 兼容的 .app，或 ad hoc 签名的应用。
查看你 EAS 控制台中固定项目的列表。

安装

你可以通过 Homebrew 为 macOS 下载 Orbit，或者直接从 GitHub releases 下载。

Terminal

- brew install expo-orbit

如果你希望 Orbit 在登录时自动启动，请点击菜单栏中的 Orbit 图标，然后选择 Settings，再勾选 Launch on Login 选项。

Windows 版 Orbit 处于beta阶段，并且仅兼容 x64 和 x86 机器。未来将添加对其他架构的兼容性。

你可以直接从 GitHub releases 下载 Windows 版 Orbit。

Orbit 在 macOS 和 Windows 上都依赖 Android SDK，而 xcrun 仅在 macOS 上用于设备管理，这需要同时设置 Android Studio 和 Xcode。

VS Code 的 Expo Tools

Expo Tools 是一个 VS Code 扩展，可在处理应用配置文件时提升你的开发体验。它为 app 配置、EAS 配置、商店配置以及 Expo Module 配置文件等提供自动补全和智能提示等功能。

安装 Expo Tools VS Code 扩展

使用此链接安装该扩展，或直接在 VS Code 编辑器中搜索 Expo Tools。

你也可以使用它通过 VS Code 内置调试器来调试你的应用，设置断点、检查变量、通过调试控制台执行代码等。有关如何使用此扩展进行调试，请参阅使用 VS Code 调试。

使用 Snack 和 Expo Go 测试原型

Snack

Snack 是一个基于浏览器的开发环境，工作方式与 Expo Go 类似。它非常适合分享代码片段并在不下载任何工具到电脑的情况下试验 React Native。

要使用它，请前往 snack.expo.dev，编辑 App.js 中的 <Text> 组件，在右侧面板中选择一个平台（Android、iOS 或 web），并实时查看变化。

Expo Go

Expo Go 是一个免费、开源的试验环境，供学生和学习者尝试 React Native。它适用于 Android 和 iOS。

有关如何使用它的更多信息：

点击此链接前往“设置你的开发环境”指南
在你希望在哪里开发？下选择一个平台
在你希望如何开发？下选择 Expo Go
按照该指南中的说明进行操作

注意： Expo Go 的功能有限，不适合用于构建生产级项目。请改用开发构建。

如果我打开了一个使用不受支持 SDK 版本的项目，会怎样？

在 Expo Go 中运行一个为不受支持的 SDK 版本创建的项目时，你会看到以下错误：

"Project is incompatible with this version of Expo Go"

要修复此问题，建议将你的项目升级到受支持的 SDK 版本。如果你想了解如何操作，请参阅将项目升级到新的 SDK 版本。

如何从不受支持的 SDK 版本升级我的项目？

请参阅Expo SDK 升级指南中的说明，将其升级到特定的 SDK 版本。

React Native 目录

任何与 React Native 兼容的库，在你使用开发构建创建项目时，都可以在 Expo 项目中使用。

reactnative.directory 是一个可搜索的 React Native 库数据库。如果你要找的库未包含在 Expo SDK 中，可以使用该目录为你的项目查找兼容的库。

使用库

阅读本指南，了解 React Native 核心库、Expo SDK 库以及第三方库之间的区别。它还解释了如何判断第三方库的兼容性。