@gedeagas/react-native-bundle-visualizer

中文文档
3.1.8发布于 2025/08/19MIT近 30 天下载 2954

See what's inside your react-native bundle

原始使用文档
文档目录7 节
  1. Purpose
  2. Usage
  3. Or install as a dev-dependency
  4. CI/CD Usage
  5. Command line arguments
  6. Version compatibility
  7. License

@gedeagas/react-native-bundle-visualizer

See what's inside of your react-native bundle 📦

bundle-visualizer-animation

Uses the awesome source-map-explorer to visualize the output of the Metro bundler.

Purpose

Sometimes, importing a single javascript library can drastically increase your bundle size. This package helps you to identify such a library, so you can keep the bundle size low and loading times fast.

Usage

Make sure npx is installed and run the following command in your project root

npx @gedeagas/react-native-bundle-visualizer

Or install as a dev-dependency

yarn add --dev @gedeagas/react-native-bundle-visualizer

And run it:

yarn run react-native-bundle-visualizer

or when using npm:

npm install --save-dev @gedeagas/react-native-bundle-visualizer
npx react-native-bundle-visualizer

CI/CD Usage

For CI/CD environments where you need to capture just the bundle size for comparison or monitoring, use the --bundle-size-only option (outputs 3 decimal places):

# Output only the bundle size in megabytes (e.g., "2.450MB")
npx @gedeagas/react-native-bundle-visualizer --bundle-size-only

# Example: Capture bundle size in a variable
BUNDLE_SIZE=$(npx @gedeagas/react-native-bundle-visualizer --bundle-size-only)
echo "Bundle size: $BUNDLE_SIZE"

# Example: Compare bundle sizes in CI
PREV_SIZE=$(cat .bundle-size-cache 2>/dev/null || echo "0MB")
CURRENT_SIZE=$(npx @gedeagas/react-native-bundle-visualizer --bundle-size-only)
echo $CURRENT_SIZE > .bundle-size-cache

# Extract numeric values for comparison (removes "MB" suffix)
PREV_NUM=$(echo $PREV_SIZE | sed 's/MB//')
CURRENT_NUM=$(echo $CURRENT_SIZE | sed 's/MB//')

if (( $(echo "$CURRENT_NUM > $PREV_NUM" | bc -l) )); then
  echo "⚠️  Bundle size increased from $PREV_SIZE to $CURRENT_SIZE"
  exit 1
else
  echo "✅ Bundle size is $CURRENT_SIZE (was $PREV_SIZE)"
fi

Command line arguments

All command-line arguments are optional. By default a production build will be created for the ios platform.

OptionDescriptionExample
platformPlatform to build (default is ios)--platform ios
devDev or production build (default is false)--dev false
entry-fileEntry-file (when omitted tries to auto-resolve it)--entry-file ./index.ios.js
bundle-outputOutput bundle-file (default is tmp)--bundle-output ./myapp.bundle
formatOutput format html, json or tsv (default is html) (see source-map-explorer options)--format json
only-mappedExclude "unmapped" bytes from the output (default is false). This will result in total counts less than the file size.--only-mapped
verboseDumps additional output to the console (default is false)--verbose
reset-cacheRemoves cached react-native files (default is false)--reset-cache
--expoSet this to true/ false based on whether using expo or not. For eg, set --expo true when using expo. Not required to pass this for react-native cli. (default is false)--expo false
--no-border-checksPass the same flag to the underlying source-map-explorer to disable invalid mapping column/line checks.--no-border-checks
--bundle-size-onlyOutput only the bundle size in plain megabytes with "MB" suffix (3 decimal places, e.g., "2.450MB") (useful for CI/CD environments). This will suppress all other output and return just the formatted size.--bundle-size-only

Use react-native-bundle-visualizer@2 when targetting Expo SDK 40 or lower.

Version compatibility

VersionComments
3.xCompatible with React-Native CLI bootstrapped projects and Expo SDK 41 or higher.
2.xCompatible with React-Native CLI bootstrapped projects and Expo SDK 40 or earlier.
1.xUses the Haul bundler instead instead of the Metro output.

License

MIT

版本与发布记录

@gedeagas/react-native-bundle-visualizer 共发布 6 个版本,首次发布于 2025/08/07;过去 12 个月发布了 0 个版本。

版本发布日期距今
3.1.8latest2025/08/191.2 年前
3.1.72025/08/151.3 年前
3.1.62025/08/071.3 年前
3.1.52025/08/071.3 年前
3.1.42025/08/071.3 年前
3.1.32025/08/071.3 年前

关于 @gedeagas/react-native-bundle-visualizer 的常见问题

@gedeagas/react-native-bundle-visualizer 是什么?

See what's inside your react-native bundle

如何安装 @gedeagas/react-native-bundle-visualizer?

在项目目录运行 npm install @gedeagas/react-native-bundle-visualizer,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 react-native-bundle-visualizer,可以用 npx react-native-bundle-visualizer 直接运行。

@gedeagas/react-native-bundle-visualizer 支持 TypeScript 吗?

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

@gedeagas/react-native-bundle-visualizer 可以商用吗?

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

@gedeagas/react-native-bundle-visualizer 的下载量有多少?

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

@gedeagas/react-native-bundle-visualizer 还在维护吗?

最新版本 3.1.8 发布于 2025/08/19(1.2 年前);至今共发布 6 个版本,其中过去 12 个月发布了 0 个;首次发布于 2025/08/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。