# @equinor/ioc-common-frontend 中文文档

规范地址：https://npmcn.com/package/%40equinor/ioc-common-frontend/

版本：22\.0\.0
npm 元数据更新时间：2026-11-02T09:40:27.195Z
中文译文更新时间：2026-11-14T07:35:25.584Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40equinor/ioc-common-frontend
原文对照：https://npmcn.com/package/%40equinor/ioc-common-frontend/?lang=original
项目主页：https://github.com/equinor/ioc-common-frontend#readme
源码仓库：https://github.com/equinor/ioc-common-frontend

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

- 包体积（解压后）：5.9 MB，655 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：46 个
- peer 依赖：react \>=19\.0\.0，lexical \>=0\.53\.0，react-dom \>=19\.0\.0，@types/react \>=19\.0\.0，@types/react-dom \>=19\.0\.0，styled-components \>=5\.3
- 首次发布：2022-11-15T09:40:19.209Z
- 最新版本发布：2026-11-02T09:40:27.035Z
- 近 30 天下载量：2127（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：328（近 12 个月 26 个）

## 中文简介

国家防范机制库,供国际奥委会预防故障小组维护的应用程序使用

## 安装

```sh
npm install @equinor/ioc-common-frontend
```

也可以使用：`pnpm add @equinor/ioc-common-frontend`、`yarn add @equinor/ioc-common-frontend`、`bun add @equinor/ioc-common-frontend`

## README

# 国际奥委会共同前沿 ![NPM](https://img.shields.io/npm/l/@equinor/ioc-common-frontend) [![npm](https://img.shields.io/npm/v/@equinor/ioc-common-frontend?logo=Npm)](https://github.com/equinor/ioc-common-frontend/releases)

国家防范机制库,用于共享前端代码,供维护的应用程序使用 国际奥委会预防故障小组

## 预览

要预览故事本中这个包的组件,请前往 [故事书](https://vigilant-giggle-adeaa4b7.pages.github.io/)。 。 。 .

## 如何使用

用于安装此软件包

```bash
yarn add @equinor/ioc-common-frontend
```

或使用 npm.

```bash
npm install @equinor/ioc-common-frontend
```

然后通过命名的导入使用组件或函数

```javascript
import { Button } from "@equinor/ioc-common-frontend"

...

export const YourComponent = () => {

    ...

    return {
        <div>
            <Button />
        </div>
    }
}
```

## 地方发展与条件顾问

使用 yalc 在条件顾问中测试一个未公布的共同前端构建 。 这个 两个储存库都有独立的 Dev 容器,只共享 Docker 名称的音量 `ioc-yalc-store`。 。 。 .

1.  在其 Dev 容器中打开共同前端并运行 `Yalc: Watch & Push` 从 VS代码的任务拾取器. 这构建了完整的软件包,包括 声明,并在"共同前端源"改变时发布. (你们) 也可以使用 `Yalc: Push Once`,手动按需推动更改,避免 每个文件保存的重建)
2.  在其dev 容器中打开条件顾问并运行 `Yalc: Run with Common Frontend`。此链接到共享的前端 存储,监视更新,并启动条件顾问前端.
3.  在条件中运行共同前端测试并练习受影响的工作流程 顾问.
4.  条件顾问完成后停止任务. 它恢复出版的 依赖性自动.

如果任务在清理完成前中断, 请运行 `Yalc: Restore Published Frontend Libraries`雅尔克更改条件顾问 包单和临时锁文件; 不执行这些本地 `file:.yalc/` 参考文献.

## 依赖性决议

留着 `resolutions` 输入 `package.json` 尽可能缺席。 A 类 全球解决办法超越了过渡性依赖性选择,可以隐藏 不兼容的亲子依赖,所以这是一个暂时的例外,而不是 一般的依赖管理机制.

在添加一个前, 选择升级直接父和刷新 `yarn.lock`中。如果仍然需要重置,请添加到 `package.json` 添加 同一软件包改为 `approvedResolutions` 内 `scripts/check-resolutions.mjs`。 。 。 . 它的条目必须说明:

-   为什么正常的依赖解决不充分;
-   需要推翻的问题、咨询或上游变化;
-   客观删除条件,例如父软件包版本或本地 依赖范围使得覆盖变得多余 .

`yarn build` 运行此检查并拒绝无记录的决议。 审查一次 在依赖性升级期间核准决议。 移除后立即删除 条件属实,然后运行安装、审计、排字检查、测试和构建,而不包含 控制器.

## 扶养费

使用预定义的 VS 代码任务 **命令调色板** (单位:千美元)`Cmd+Shift+P`) > 时间 **任务: 运行任务**数字 :

1.  运行 **审计依赖关系** 记录当前的脆弱性。 这个用 `yarn npm audit`;其结果可能不同于 GitHub 安全警报,因为 这些工具可以使用不同的咨询数据和依赖性分析.
2.  运行 **Yarn: 升级依赖性** 以更新内部的过渡性依赖性 已声明的版本区域 `package.json`。 。 。 .
3.  可选运行 **Yarn: Dedupe 属地** 减少重复决议 内 `yarn.lock`。 。 。 .
4.  运行 **审计依赖关系** 然后将结果与基线进行比较.
5.  在更改版本范围之前调查任何剩余的脆弱性. 将受影响的直接依赖升级为 **Yarn: 升级单套件** 或者说 **Yarn: 交互式升级依赖**,审查其发布注释 打破更改,然后重复审计。 重大升级或临时升级 `resolutions` 脆弱的过境依赖可能需要入境.
6.  运行 **Yarn: 安装依赖** 以核实 `package.json` 财务报告和审定财务报表 `yarn.lock` 一致的 。 。 此任务使用 `yarn install --immutable` 财务报告和审定财务报表 不得修改锁文件.
7.  运行 **测试**, (中文(简体) ), **构建**,以及 **故事书:构建** 核查更新的 依附树.
8.  评议 `package.json` 财务报告和审定财务报表 `yarn.lock` 变化之前,他们承诺.

## 依赖性决议

留着 `resolutions` 输入 `package.json` 尽可能缺席。 A 类 全球解决办法超越了过渡性依赖性选择,可以隐藏 不兼容的亲子依赖,所以这是一个暂时的例外,而不是 一般的依赖管理机制.

在添加一个前, 选择升级直接父和刷新 `yarn.lock`中。如果仍然需要重置,请添加到 `package.json` 添加 同一软件包改为 `approvedResolutions` 内 `scripts/check-resolutions.mjs`。 。 。 . 它的条目必须说明:

-   为什么正常的依赖解决不充分;
-   需要推翻的问题、咨询或上游变化;
-   客观删除条件,例如父软件包版本或本地 依赖范围使得覆盖变得多余 .

`yarn build` 运行此检查并拒绝无记录的决议。 审查一次 在依赖性升级期间核准决议。 移除后立即删除 条件属实,然后运行安装、审计、排字检查、测试和构建,而不包含 控制器.

## 链接

有用链接 :

-   仓库 : [https://github.com/equinor/ioc-common-frontend 页面存档备份,存于互联网档案馆](https://github.com/equinor/ioc-common-frontend)
-   故事书网站: [https://vigilant-giggle-adeaa4b7. pages.github.io 互联网档案馆的存檔,存档日期2013-12-02](https://vigilant-giggle-adeaa4b7.pages.github.io/)

## 捐款

在写作时,此软件包将打开供内部和外部通过 n.

但是,仓库只供内部等值人员使用,以便张贴公关.

## 许可证发放

这个项目的代码根据麻省理工学院的许可颁发.

## 常见问题

### @equinor/ioc-common-frontend 是什么？

国家防范机制库,供国际奥委会预防故障小组维护的应用程序使用

### 如何安装 @equinor/ioc-common-frontend？

在项目目录运行 npm install @equinor/ioc-common-frontend，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.0\.0）、lexical（\>=0\.53\.0）、react-dom（\>=19\.0\.0）、@types/react（\>=19\.0\.0）、@types/react-dom（\>=19\.0\.0）、styled-components（\>=5\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @equinor/ioc-common-frontend 支持 TypeScript 吗？

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

### @equinor/ioc-common-frontend 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @equinor/ioc-common-frontend 可以商用吗？

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

### @equinor/ioc-common-frontend 的下载量有多少？

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

### @equinor/ioc-common-frontend 还在维护吗？

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