@architect/hydrate

中文文档
6.0.2发布于 2026/07/01Apache-2.0CommonJS构建来源已验证近 30 天下载 416.9万

架构依赖水合器和共享文件管理器

中文使用文档
文档目录3 节
  1. hydrate.install(options[, callback]) → [Promise]
  2. hydrate.update(options[, callback]) → [Promise]
  3. hydrate.shared(options[, callback]) → [Promise]

@architect/hydrate GitHub CI status

@ architect/ 水合物 确保建筑师管理的所有功能都安装了它们的依赖性. 包含所有必需的依赖性的函数被认为是"水分"——因此名称!

@ architect/ 水合物 支持使用以下软件包管理器以下列语言管理的依赖性:

  • 节点.js 通过 npm 使用 package.json (可选) package-lock.json),或者通过 yarn 使用 package.json 财务报告和审定财务报表 yarn.lock
  • 蟒 通过 pip3 使用一个 requirements.txt 文件
  • 鲁比 通过 bundle 使用 Gemfile 财务报告和审定财务报表 Gemfile.lock 文件

所需资源

  • 节点.js 22或以后 必须使用 @architect/hydrate 6.0.0及以上版本
  • 对于Node.js 20 支持, 使用 @architect/hydrate 5.x版本 翻译:

安装

npm install @architect/hydrate

API 密码

所有方法都接受 options 对象可以包括以下属性:

  • autoinstall - 说吧 布尔 - 通过静态代码分析启用或禁用自动Lambda依赖树
    • 默认为 false
    • 用于 install
  • basepath - 说吧 字符串 - 用于Hydrate搜索函数的文件系统路径
    • 默认当前工作目录
    • 如果您想要将一个函数或一个子集的函数水化,则有用
    • 用于 install + 键 update
  • copyShared - 说吧 布尔 - 启用或禁止复制共享代码文件夹(例如:. src/shared进入Lambdas
    • 如果您想要将外部依赖性水化, 则需要禁用
    • 默认为 true
    • 用于 install + 键 update
  • cwd - 说吧 字符串 - Hydrate 项目的根文件系统路径正在工作
    • 当前工作目录的默认值
    • 可能与 basepath; 如果与 basepath,指定项目的一个子集,其中 basepath,例如:
      • { cwd: '/your/project/', basepath: '/your/project/src/http/' } 运行水合物对 /your/project/ (无需使用) process.chdir),并且只有水合物在 /your/project/src/http/**
    • 用于 install + 键 update + 键 shared
  • hydrateShared - 说吧 布尔 - 在共享代码文件夹中启用或禁用依赖水合(例如:. src/shared(中文(简体) )
    • 如果您想要将外部依赖性水化, 则需要禁用
    • 默认为 true
    • 用于 install + 键 update
  • inventory - 说吧 对象 - 建筑设计清单对象;内部一般使用
  • local - 说吧 布尔 - 在安装可作为特定平台二进制分发的依赖性时,偏好本地平台
  • only - 说吧 字符串 - 指定可能共享文件的子集 shared 复制到 Lambdas 中
    • 默认 Falsy
    • 接受 : shared, (中文(简体) ), views,或 staticJson
    • 用于 shared
  • quiet - 说吧 布尔 - 禁用(大多数)记录
  • symlink - 说吧 布尔 - 启用或禁用链接,而不是完整目录复制,对本地发展有用
    • 默认为 false
    • 用于 install + 键 update + 键 shared
  • timeout - 说吧 数目 - 给每个软件包管理程序执行的时间(以毫秒计)
    • 用于 install + 键 update
  • verbose - 说吧 布尔 - 启用动词记录

说明 cwd 对 basepath数字 : cwd 用于 Hydrate 查找您的工程的表单和关键文件和文件夹, 而 basepath 瞄准特定路径。 当存在疑问时, 既不包含参数, Hydrate 将默认处理工作目录; 如果您知道需要在某个特定的地方瞄准 Hydrate , 但不确定要使用哪个参数, 使用 cwd。 。 。 .

hydrate.install(options[, callback]) → [Promise]

安装函数依赖性,然后引用 hydrate.shared()。 。 。 .

确保本地发展行为接近 staging 财务报告和审定财务报表 production 尽可能, hydrate.install() (和其他水合物功能)使用:

  • 节点.js数字 : npm ci 若为 package-lock.json 已存在 npm i (一) 如果不是;或 yarn
  • 蟒数字 : pip3 install
  • 鲁比数字 : bundle install

注:默认 update 还在共享文件夹中安装依赖性, 如 src/shared 财务报告和审定财务报表 src/views。 。 。 .

hydrate.update(options[, callback]) → [Promise]

更新函数依赖性,然后引用 hydrate.shared()。 。 。 .

update 功能几乎与 install,但是它将更新对新版本的依赖性 如果它们存在通过以下方式做到这一点:

  • 节点.js数字 : npm update 或者说 yarn upgrade
  • 蟒数字 : pip3 install -U --upgrade-strategy eager
  • 鲁比数字 : bundle update

注:默认 update 也更新共享文件夹中的依赖性, 如 src/shared 财务报告和审定财务报表 src/views。 。 。 .

hydrate.shared(options[, callback]) → [Promise]

复制共享代码( 从 src/shared 财务报告和审定财务报表 src/views,或者您的习惯 @shared + 键 @views 路径,如果有的话)进入所有函数.

版本与发布记录

@architect/hydrate 共发布 181 个版本,首次发布于 2019/05/31;过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
6.0.2latest2026/07/014 个月前
5.0.2v5-latest2026/03/048 个月前
5.0.2-RC.12026/03/048 个月前
6.0.02025/11/2811 个月前
5.0.2-RC.0RC2025/11/2511 个月前
5.0.12025/09/271.1 年前

其他发布通道:turbologger → 1.4.3-turbologger-1,RC → 5.0.2-RC.0,v5-latest → 5.0.2。

关于 @architect/hydrate 的常见问题

@architect/hydrate 是什么?

架构依赖水合器和共享文件管理器

如何安装 @architect/hydrate?

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

@architect/hydrate 支持 TypeScript 吗?

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

@architect/hydrate 支持 ESM 还是 CommonJS?

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

@architect/hydrate 需要什么版本的 Node.js?

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

@architect/hydrate 可以商用吗?

@architect/hydrate 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@architect/hydrate 的下载量有多少?

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

@architect/hydrate 还在维护吗?

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