@everframe/metro

中文文档
1.7.0发布于 2026/11/04MITTypeScriptES Module近 30 天下载 2396

Metro序列器将一个建构身份印入Everframe符号化的 React Industrial 捆绑.

中文使用文档

@ everframe/ metro (英语)

withEverframe(config, { projectRoot, dev }) 保存现有的地铁 为Android和iOS配置并添加同步身份多填充. 它生成一个构建的ID并写入 .everframe/<buildId>/manifest.partial.json 带有 identity.js 混合填充剂。 组合填充 globalThis.__EVERFRAME_BUILD__ 在应用程序模块执行之前.

每个平台都有自己的ID和捆绑名称: index.android.bundle 在安卓上, main.jsbundle (原始内容存档于2018-03-26). On iOS. 原生版本、发布标签和OTA供应商更新ID 不可替换此捆绑的身份 。 设定 enabled: false 当对应时 SDK被排除在建筑物之外.

每个构建任务使用一个孤立的运行目录 。 地铁两站台 在配置时间。 集合读取所生成的身份 绘制地图,检查部分阶段和编译的建设身份证,并推广已完成的身份证 构建到 latest-<platform>.json。收集前的后期配置负载为 安全; 不要在收藏和上传之间运行另一个 Metro 引用 。 保留匹配的字节代码和地图; 重用不同生成字节的构建 ID 不是一个新版本 .

在赫尔墨斯编译器释放了字节代码及其构成的地图后:

npx @everframe/cli build collect --staging .everframe --platform android \
  --bundle path/to/index.android.bundle \
  --source-map path/to/index.android.bundle.map
npx @everframe/cli build verify --staging .everframe --platform android --release
npx @everframe/cli sourcemaps upload-hermes --manifest .everframe \
  --platform android --app-id "$EVERFRAME_APP_ID"

提供范围d EVERFRAME_API_TOKEN 仅用于构建/上载进程。 见 博览会更新指南 用于导出和装入捆绑的身份.

来源承诺

当前反应原生SDK将已装入的Hermes捆绑的身份附加到普通反馈报告和崩溃中. 发布健康监测可以被禁用;报告仍然解决了准确上传的捆绑,包括OTA更新共享本地版本/构建.

反应原生iOS/Android 建立可选的 Git 承诺、分支和肮脏的记录 状态。 Metro 在写入中转文件前抓取这些文件; 收集并上传 保存该快照,包括世博会出口和OTA更新. 保留 .everframe/ 在你的Git忽略规则。 缺失的 Git 退出不会停止构建或上传 .

明确 withEverframe(config, { commit: '<full-sha>' }) 优先于 本地头部,然后是CI倒置(GITHUB_SHA, (中文(简体) ), CI_COMMIT_SHA, (中文(简体) ), BITBUCKET_COMMIT, (中文(简体) ), BUILD_SOURCEVERSION) (中文(简体) ). 使用完整的40-或64-特征 十六进制承诺. 已调试的退出会省略分支; 未知状态, 而非干净 .

everframe sourcemaps upload-hermes, (中文(简体) ), upload-expo-export原生状态 dsym, (中文(简体) ), elf,以及 r8 接受上传命令 --commit <full-sha>。带有 不同犯罪记录的分支/肮脏事实。 遗留记录没有 出处未知; 延迟的上传从未读取过上传者的头部 . 直接单艺术上传从工作目录中检测到 Git, 这样使用 --commit 当上传旧文件时。 本地人口总数 dsym upload-build 财务报告和审定财务报表 elf upload-build 命令(包括 Xcode/ Gradle 集成) 离开源 默认来源不明:其符号可能包括再利用或销售二进制. 使用 --commit 只有在每一件选定文物属于该来源时,才能进行; 以自己的明确承诺上传每个已知的文物。 自动 土生土长的源的归属仍然是后续工作.

服务必须支持添加剂 vcs 在使用这些字段之前显示字段 工具版本。 老年客户仍然得到最新服务的支持。 部署 服务器在发布新工具前的支持; 不在其中剥去出处 对任意上传失败的反应.

版本与发布记录

@everframe/metro 共发布 14 个版本,首次发布于 2026/10/12;过去 12 个月发布了 14 个版本。

版本发布日期距今
1.7.0latest2026/11/049 天前
1.6.72026/10/2916 天前
1.6.52026/10/2717 天前
1.6.42026/10/2717 天前
1.6.22026/10/2717 天前
1.6.12026/10/2420 天前

关于 @everframe/metro 的常见问题

@everframe/metro 是什么?

Metro序列器将一个建构身份印入Everframe符号化的 React Industrial 捆绑.

如何安装 @everframe/metro?

在项目目录运行 npm install @everframe/metro,或使用 pnpm add / yarn add / bun add。

@everframe/metro 支持 TypeScript 吗?

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

@everframe/metro 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@everframe/metro 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@everframe/metro 可以商用吗?

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

@everframe/metro 的下载量有多少?

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

@everframe/metro 还在维护吗?

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