Expo DevClient
一个允许创建开发版本并包含实用开发工具的库。
For the complete documentation index, see llms.txt. Use this file to discover all available pages.
expo-dev-client 会为你的调试构建添加各种实用的开发工具:
- 一个可配置的启动器 UI,因此你可以启动更新(例如来自 PR 预览)并在不同的开发服务器之间切换,而无需重新编译原生应用
- 改进的调试工具(例如支持 检查网络请求)
- 一个强大且可扩展的开发者菜单 UI
Expo 文档将包含 expo-dev-client 的调试构建称为 开发构建。
安装
- npx expo install expo-dev-client如果你要在一个已有的 React Native 应用中安装它,请先在你的项目中安装 expo。然后,按照 在现有 React Native 项目中安装 expo-dev-client 中的说明进行操作。
在 app 配置中进行配置
如果你在项目中使用 config plugins(Continuous Native Generation (CNG)),你可以使用其内置的 config plugin 来配置 development client 启动器。该插件允许你配置各种无法在运行时设置、且需要构建新的应用二进制文件才能生效的属性。如果你的应用不使用 CNG,那么你需要手动配置该库。
Example app.json with config plugin
{ "expo": { "plugins": [ [ "expo-dev-client", { "launchMode": "most-recent", "defaultLaunchURL": "http://localhost:8081", "android": { "defaultLaunchURL": "http://10.0.0.2:8081" }, "toolsButton": "true", "skipOnboarding": "false", "showMenuAtLaunch": "true" } ] ] } }
Configurable properties
| Name | Default | Description |
|---|---|---|
launchMode | "most-recent" | 决定是启动最近打开的项目,还是进入启动器屏幕。
|
addGeneratedScheme | true | 默认情况下, |
defaultLaunchURL | - | 直接启动到此 URL,而不是进入启动器屏幕。
如果 |
toolsButton | true | 是否显示悬浮工具按钮。 |
skipOnboarding | false | 跳过应用首次启动时在开发者菜单中显示的引导屏幕。 |
showMenuAtLaunch | true | 在启动应用后立即显示开发者菜单。 |
TV 支持
- 该库仅在 SDK 54 及更高版本中支持 TV。
- Android TV:支持所有操作,与 Android 手机类似。
- Apple TV:支持使用本地或隧道式 packager 的基本操作。目前尚不支持 EAS 认证,以及列出 EAS builds 和 updates。
API
import * as DevClient from 'expo-dev-client';
Methods
A method that closes development client menu when called.
voidA method that hides development client menu when called.
voidA method that opens development client menu when called.
void| Parameter | Type |
|---|---|
| items | ExpoDevMenuItem[] |
A method that allows to specify custom entries in the development client menu.
Promise<void>Types
An object representing the custom development client menu entry.
| Property | Type | Description |
|---|---|---|
| callback | () => void | Callback to fire, when user selects an item. |
| name | string | Name of the entry, will be used as label. |
| shouldCollapse(optional) | boolean | A boolean specifying if the menu should close after the user interaction. Default: false |