# @amsterdam/asc-assets 中文文档

规范地址：https://npmcn.com/package/%40amsterdam/asc-assets/

版本：0\.38\.0
npm 元数据更新时间：2026-03-26T12:50:49.316Z
中文译文更新时间：2026-11-06T20:50:23.456Z
软件包许可：MPL-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40amsterdam/asc-assets
原文对照：https://npmcn.com/package/%40amsterdam/asc-assets/?lang=original
项目主页：https://github.com/Amsterdam/amsterdam-styled-components/tree/main/packages/asc-assets#readme
源码仓库：https://github.com/Amsterdam/amsterdam-styled-components

弃用说明：Amsterdam Styled Components is no longer supported\. Use Amsterdam Design System \(https://designsystem\.amsterdam\) instead\.

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

- 包体积（解压后）：1.1 MB，1019 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^17\.0\.2 \|\| ^18\.1\.0，react-dom ^17\.0\.2 \|\| ^18\.1\.0
- 首次发布：2020-09-22T09:39:27.450Z
- 最新版本发布：2022-11-28T11:19:19.164Z
- 近 30 天下载量：2357（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 0 个）

## 中文简介

包含图标和字体

## 安装

```sh
npm install @amsterdam/asc-assets
```

也可以使用：`pnpm add @amsterdam/asc-assets`、`yarn add @amsterdam/asc-assets`、`bun add @amsterdam/asc-assets`

## README

# 资产

这是一个单独的软件包,包含:

-   字体(包括CSS) `font-face` (定义)
-   图标( SVG 为反应组件)

## 安装

通过运行将此软件包添加到您的工程中 :

```bash
npm install @amsterdam/asc-assets
```

## 基本用途

### 图标

```jsx
import { IconName } from '@amsterdam/asc-assets'

return <IconName />
```

### 字体

目前包含您应用程序中使用的字体有两种方式,您可以在您的构建中从这个包中复制,或者包含来自阿姆斯特丹CDN的版本. 请注意,如果您想要使用阿姆斯特丹主机的版本,您必须有一个运行在 `amsterdam.nl` 域空间.

#### 使用阿姆斯特丹CDN

将以下代码添加到您的 `index.html` 文件 :

```html
<link href="https://static.amsterdam.nl/fonts/fonts.css" rel="stylesheet" />
```

没有别的事可做, 您的应用程序中应该有字体 .

#### 在构建时复制文件

这个步骤假设您正在使用WebPack,但应该也可以使用其他工具或简单的 shell脚本来完成.

在您的 WebPack 配置中添加以下代码 :

```js
new CopyWebpackPlugin({
  patterns: [
    {
      from: './node_modules/@amsterdam/asc-assets/static/fonts',
      to: 'fonts',
    },
  ],
})
```

并确保在您的样式表中导入 CSS 文件 :

```scss
@import '~@amsterdam/asc-assets/static/fonts/fonts.css';
```

## 构建工程

```bash
npm run build # generates JSX components using the optimized SVG icons
```

## 常见问题

### @amsterdam/asc-assets 是什么？

包含图标和字体注意：该包已被作者标记为弃用——Amsterdam Styled Components is no longer supported\. Use Amsterdam Design System \(https://designsystem\.amsterdam\) instead\.

### 如何安装 @amsterdam/asc-assets？

在项目目录运行 npm install @amsterdam/asc-assets，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.2 \|\| ^18\.1\.0）、react-dom（^17\.0\.2 \|\| ^18\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @amsterdam/asc-assets 支持 TypeScript 吗？

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

### @amsterdam/asc-assets 支持 ESM 还是 CommonJS？

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

### @amsterdam/asc-assets 可以商用吗？

@amsterdam/asc-assets 使用 MPL-2\.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。

### @amsterdam/asc-assets 的下载量有多少？

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

### @amsterdam/asc-assets 还在维护吗？

最新版本 0\.38\.0 发布于 2022/11/28（3 年前）；至今共发布 37 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/09/22。作者已将其标记为弃用，新项目建议寻找替代方案。