This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 57).
Expo DevMenu
一个为调试构建提供开发者菜单的库。
expo-dev-menu 可作为任何 Expo 项目中的 独立库 使用。对于不需要完整 expo-dev-client 启动器界面的 brownfield 应用 来说,它尤其有用。
expo-dev-menu 为 React Native 应用提供了开发者菜单 UI,其中包括:
- 一个强大且可扩展的菜单 UI,可通过摇一摇手势或三指长按访问
- 快速访问常见开发操作
- 支持自定义菜单项以扩展功能
安装
- npx expo install expo-dev-menuIf you are installing this in an existing React Native app, make sure to install expo in your project.
用法
安装后,开发者菜单将在你的调试构建中可用。你可以通过以下方式打开它:
- 摇一摇手势:摇动你的设备
- 三指长按:用三根手指在屏幕上长按
- 通过编程:在代码中调用
DevMenu.openMenu()
扩展开发菜单
可以使用 registerDevMenuItems API 扩展开发菜单,以包含额外按钮:
import { registerDevMenuItems } from 'expo-dev-menu'; const devMenuItems = [ { name: '我的自定义按钮', callback: () => console.log('你好,世界!'), }, ]; registerDevMenuItems(devMenuItems);
这将在开发菜单中创建一个新分区,其中包含你已注册的按钮:
注意: 之后对
registerDevMenuItems的调用将覆盖所有先前的条目。
与 expo-dev-client 一起使用
如果你正在使用 开发构建,请改为安装 expo-dev-client。它包含了 expo-dev-menu,以及额外的开发工具:
- 一个可配置的启动器 UI,用于在开发服务器之间切换
- 改进的调试工具
- 支持从 EAS Update 加载更新
- npx expo install expo-dev-client更多信息请查看 expo-dev-client 参考文档。
API
import * as DevMenu from 'expo-dev-menu';
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 |