# @angular-architects/native-federation-v4 中文文档

规范地址：https://npmcn.com/package/%40angular-architects/native-federation-v4/

版本：21\.2\.17
npm 元数据更新时间：2026-10-28T15:24:52.266Z
中文译文更新时间：2026-11-06T04:11:43.456Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40angular-architects/native-federation-v4
原文对照：https://npmcn.com/package/%40angular-architects/native-federation-v4/?lang=original
项目主页：https://native-federation.com/docs/v4/angular-adapter/
源码仓库：https://github.com/native-federation/angular-adapter

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：262 kB，209 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：12 个
- peer 依赖：@angular/build \>=21\.2\.0，@angular/localize \>=21\.2\.0
- 首次发布：2026-01-22T09:13:27.091Z
- 最新版本发布：2026-10-28T15:24:51.878Z
- 近 30 天下载量：27798（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

[![npm version](https://img.shields.io/npm/v/@angular-architects/native-federation-v4)](https://www.npmjs.com/package/@angular-architects/native-federation-v4) \[![npm downloads](https://img.shields.io/npm/dm/@angular-architects/native-federation-v4)\[http

## 安装

```sh
npm install @angular-architects/native-federation-v4
```

也可以使用：`pnpm add @angular-architects/native-federation-v4`、`yarn add @angular-architects/native-federation-v4`、`bun add @angular-architects/native-federation-v4`

## README

# @angular-architects/native-federation-v4 (英语)

[![npm version](https://img.shields.io/npm/v/@angular-architects/native-federation-v4)](https://www.npmjs.com/package/@angular-architects/native-federation-v4) [![npm downloads](https://img.shields.io/npm/dm/@angular-architects/native-federation-v4)](https://www.npmjs.com/package/@angular-architects/native-federation-v4) [![license](https://img.shields.io/npm/l/@angular-architects/native-federation-v4)](https://github.com/native-federation/angular-adapter/blob/main/LICENSE)

角适配器 **土著联合会**:Module Federation的心理模型,由微前端和以插件为主的架构在浏览器标准(ES模块和导入地图)上执行.

📖 **[文档](https://native-federation.com/docs/v4/angular-adapter/)**

> \[注\] 这是 **v4 桥包** 对角20和角21。 从v3升级? 见 [移徙指南](https://native-federation.com/docs/v4/angular-adapter/migration-v4/),或运行 `ng update @angular-architects/native-federation-v4`。v3来源生活在 [模块组合-插件存储器](https://github.com/angular-architects/module-federation-plugin/tree/21.x.x/libs/native-federation)。 。 。 .

## 特征

-   **留在角CLI上** ——来自Angular基于Esbuild的应用程序Builder和dev服务器的代表,所以你保留了每一个CLI优化.
-   **网络标准** ——远程是用导入地图连接在一起的平面ES模块.
-   **共同依赖关系** ——将一个库装入一次横跨主机和远程,并带有semver-aware版本的谈判.
-   **图表** —— 说 `ng add` 将项目变成主机或远程; `ng update` 移来移去.
-   **安全部门改革、递增水和I18N** ——支持出框.

## 版本数

适配器遵循Angular的版本编号:使用匹配您Angular主和次要的适配器放出(例如. `21.2.x` 用于角21.2.x).

| 你的角质 | 安装 |
| --- | --- |
| 22岁以上 | `@angular-architects/native-federation` |
| 20 - 21页 | `@angular-architects/native-federation-v4` |

`@angular-architects/native-federation-v4` 是一个桥包:它将土著联合会 v4 带到仍在Angular 20 或 21 上的项目. 从Angular 22开始, v4 船主 `@angular-architects/native-federation` 数据包,所以放下 `-v4` 升级时的后缀( y)`ng update @angular-architects/native-federation` 做这个给你.

## 快开始

安装适配器,然后使一个工程成为远程,另一个则成为主机:

```bash
npm i @angular-architects/native-federation-v4 -D

ng g @angular-architects/native-federation-v4:init --project mfe1 --port 4201 --type remote
ng g @angular-architects/native-federation-v4:init --project shell --port 4200 --type dynamic-host
```

示意图 `angular.json` 在联邦建设者, 移动你的靴子 `bootstrap.ts` 生成一个 `federation.config.mjs`数字 :

```js
import {
  withNativeFederation,
  fromPackageJson,
} from "@angular-architects/native-federation-v4/config";

export default withNativeFederation({
  name: "mfe1",
  exposes: {
    "./Component": "./projects/mfe1/src/app/app.component.ts",
  },
  shared: fromPackageJson({
    singleton: true,
    strictVersion: true,
    requiredVersion: "auto",
    build: "package",
  })
    // includeSecondaries is an opt-out of ignoreUnusedDeps, so every Angular
    // entrypoint is shared and builds can't publish different sets of them.
    .patch(["@angular/*"], { includeSecondaries: { keepAll: true } })
    .get(),
  skip: ["rxjs/ajax", "rxjs/fetch", "rxjs/testing", "rxjs/webSocket"],
  features: {
    denseChunking: true,
    denseExternals: true,
  },
});
```

像懒惰路线一样在外壳中装入曝光组件, 然后运行 `ng serve mfe1` 财务报告和审定财务报表 `ng serve shell`编辑 [开始](https://native-federation.com/docs/v4/angular-adapter/getting-started/) 向导走遍每一步 [游乐场](https://github.com/native-federation/playground) 拥有可运行的主机,远程和SSSR等实例.

## 文档

-   [构建器](https://native-federation.com/docs/v4/angular-adapter/builder/) ——建设/服务目标及其接受的每个选项
-   [图表](https://native-federation.com/docs/v4/angular-adapter/schematics/) —— 说 `init`, (中文(简体) ), `appbuilder`, (中文(简体) ), `remove` 和 Nx 生成器
-   [角配置](https://native-federation.com/docs/v4/angular-adapter/configuration/) —— 说 `withNativeFederation`, (中文(简体) ), `fromPackageJson`, (中文(简体) ), `shareAngularLocales`, (中文(简体) ), `autoShareScope`
-   [运行时间](https://native-federation.com/docs/v4/angular-adapter/runtime/) —— 说 `initFederation`, (中文(简体) ), `loadRemoteModule` 和动态远程
-   [安全部门改革和水分](https://native-federation.com/docs/v4/angular-adapter/ssr/), (中文(简体) ), [编号 18N](https://native-federation.com/docs/v4/angular-adapter/i18n/) 财务报告和审定财务报表 [本地化](https://native-federation.com/docs/v4/angular-adapter/localization/)
-   [自定义构建器](https://native-federation.com/docs/v4/angular-adapter/custom-builder/) —— 插入您的自建插件
-   [心理模式](https://native-federation.com/docs/v4/mental-model/) 财务报告和审定财务报表 [土著和模块联合会](https://native-federation.com/docs/v4/native-and-module-federation/)
-   [财务问题](https://native-federation.com/docs/v4/faq/)

使用AI编码助理? 指着它 [`llms.txt`](https://native-federation.com/llms.txt)。 。 。 .

## 捐款

欢迎提出问题和拉动要求——见 [捐款额](https://github.com/native-federation/angular-adapter/blob/main/CONTRIBUTING.md)。 。 。 .

## 贷项

谢谢 [扎克・杰克逊](https://twitter.com/ScriptedAlchemy) 原本是模组联合会 及其精神模型 给角CLI团队的. [艾伦·阿吉乌斯](https://twitter.com/AlanAgius4) 和查尔斯·莱丁, 对于基于建筑的建造者 这个适配器所建,和 [弗洛里安·拉普尔](https://twitter.com/FlorianRappl) 编辑 [角建筑师团队](https://www.angulararchitects.io/en/) 他们的反馈和贡献。 找到我们本土联盟的后方 [文档网站](https://native-federation.com/team/)。 。 。 .

## 许可证

[麻省理工学院](https://github.com/native-federation/angular-adapter/blob/main/LICENSE)

## 常见问题

### @angular-architects/native-federation-v4 是什么？

\[\[http

### 如何安装 @angular-architects/native-federation-v4？

在项目目录运行 npm install @angular-architects/native-federation-v4，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@angular/build（\>=21\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @angular-architects/native-federation-v4 支持 TypeScript 吗？

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

### @angular-architects/native-federation-v4 支持 ESM 还是 CommonJS？

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

### @angular-architects/native-federation-v4 可以商用吗？

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

### @angular-architects/native-federation-v4 的下载量有多少？

根据 npm 官方下载统计，@angular-architects/native-federation-v4 在 2026/10/06 – 2026/11/04 这 30 天内被下载 27,798 次，日均约 927 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @angular-architects/native-federation-v4 还在维护吗？

最新版本 21\.2\.17 发布于 2026/10/28（10 天前）；至今共发布 44 个版本，其中过去 12 个月发布了 44 个；首次发布于 2026/01/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。