@bam.tech/react-navigation-visualizer-dev-plugin

中文文档
0.1.14发布于 2026/05/04MITTypeScriptCommonJS近 30 天下载 6.7万

基于 Expo DevTools 插件的可视化工具

中文使用文档
文档目录8 节
  1. 安装
  2. 将软件包添加到您的工程中
  3. 使用量
  4. 使用方式 react-navigation
  5. 使用方式 expo-router
  6. 这个插件怎么办?
  7. 在 Metro 中发射
  8. 我堆着什么?

@bam

基于Expo DevTools插件的可视化工具,用于回放导航.

安装

将软件包添加到您的工程中

npx expo install @bam.tech/react-navigation-visualizer-dev-plugin

使用量

使用方式 react-navigation

整合 react-navigation 用 DevTools 钩子

import { useNavigationContainerRef } from '@react-navigation/native';
import { useReactNavigationDevTools } from '@bam.tech/react-navigation-visualizer-dev-plugin';

export default function App() {
  const navigationRef = useNavigationContainerRef();
  useReactNavigationDevTools(navigationRef);

  return <NavigationContainer ref={navigationRef}>{/* ... */}</NavigationContainer>;
}

使用方式 expo-router

使用时 expo-router,将 DevToole 集成到主机中 _layout.tsx 文档。 您可以导入 useNavigationContainerRef 直接从 expo-router 并传递给 useReactNavigationDevTools数字 :

import { useNavigationContainerRef } from 'expo-router';
import { useReactNavigationDevTools } from '@bam.tech/react-navigation-visualizer-dev-plugin';

export default function RootLayout() {
  const navigationRef = useNavigationContainerRef();
  useReactNavigationDevTools(navigationRef);

  return <Stack />;
}

在这种情况下, expo-router 自动管理导航容器,所以只需要在您的布局组件中添加 DevTool 设置即可.

这个插件怎么办?

在 Metro 中发射

在地铁发射器中,类型为Shift+ M 打开 dev 工具菜单,并选择 @bam.tech/react-navigation-visualizer-dev-plugin

该可视化工具可在 Navigation Tree 节

alt text

我堆着什么?

此插件的想法是显示您的当前导航状态,以及用户在通过应用程序的旅程中其进化过程.

有三类要素:

  • 堆栈导航器

    alt text

  • 标签导航器

    alt text

  • 屏幕

    alt text

您可以看到所有连续的导航状态( Dev 插件打开时录入), 如果需要, 您也可以通过点击它们来崩溃堆栈 .

版本与发布记录

@bam.tech/react-navigation-visualizer-dev-plugin 共发布 15 个版本,首次发布于 2024/11/28;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.1.14latest2026/05/046 个月前
0.1.132025/10/131.1 年前
0.1.122025/09/101.2 年前
0.1.112025/09/101.2 年前
0.1.102025/09/031.2 年前
0.1.92025/05/261.5 年前

关于 @bam.tech/react-navigation-visualizer-dev-plugin 的常见问题

@bam.tech/react-navigation-visualizer-dev-plugin 是什么?

基于 Expo DevTools 插件的可视化工具

如何安装 @bam.tech/react-navigation-visualizer-dev-plugin?

在项目目录运行 npm install @bam.tech/react-navigation-visualizer-dev-plugin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:expo(>=53.0.5)、@react-navigation/core(*)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bam.tech/react-navigation-visualizer-dev-plugin 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bam.tech/react-navigation-visualizer-dev-plugin 支持 ESM 还是 CommonJS?

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

@bam.tech/react-navigation-visualizer-dev-plugin 可以商用吗?

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

@bam.tech/react-navigation-visualizer-dev-plugin 的下载量有多少?

根据 npm 官方下载统计,@bam.tech/react-navigation-visualizer-dev-plugin 在 2026/10/08 – 2026/11/06 这 30 天内被下载 66,583 次,日均约 2,219 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@bam.tech/react-navigation-visualizer-dev-plugin 还在维护吗?

最新版本 0.1.14 发布于 2026/05/04(6 个月前);至今共发布 15 个版本,其中过去 12 个月发布了 1 个;首次发布于 2024/11/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。