# @globalpayments/vega-angular 中文文档

规范地址：https://npmcn.com/package/%40globalpayments/vega-angular/

版本：2\.110\.1
npm 元数据更新时间：2026-11-11T03:28:31.924Z
中文译文更新时间：2026-11-16T16:14:19.588Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40globalpayments/vega-angular
原文对照：https://npmcn.com/package/%40globalpayments/vega-angular/?lang=original
项目主页：https://github.com/heartlandpayments/Vega/tree/main#readme
源码仓库：https://github.com/heartlandpayments/Vega#main

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

- 包体积（解压后）：2 MB，53 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：@angular/core \>=12\.0\.0，@angular/common \>=12\.0\.0
- 首次发布：2026-05-26T07:58:09.149Z
- 最新版本发布：2026-11-11T03:28:31.756Z
- 近 30 天下载量：6717（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：120（近 12 个月 120 个）

## 中文简介

@ globalpays/vega 的角特有包装

## 安装

```sh
npm install @globalpayments/vega-angular
```

也可以使用：`pnpm add @globalpayments/vega-angular`、`yarn add @globalpayments/vega-angular`、`bun add @globalpayments/vega-angular`

## README

# 维加角

> 角特定包装 [@ 全球支付/vega](https://www.npmjs.com/package/@globalpayments/vega)

## 如何使用

关于安装指导,请参见: [https://vega.globalpayers.com/guides/getting-started-developers#angular 页面存档备份,存于互联网档案馆](https://vega.globalpayments.com/guides/getting-started-developers#angular)

## 促进发展

这个库是用 [角 CLI 函数](https://github.com/angular/angular-cli) (原始内容存档于2019-09-26). results 13.2.0.

这是Angular特定包装 [@ 全球支付/vega](https://github.com/heartlandpayments/Vega/tree/main/vega-stencil) 带有以下文件结构(我们只列出一些重要的文件路径):

```text
...
├── src
│   ├── lib
│   │   ├── components-module.ts
│   │   └── stencil-generated
│   │       ├── angular-component-lib
│   │       │   └── utils.ts
│   │       └── components.ts => 
│   ...
...
```

-   `./src/lib/components-module.ts`: 用于导出自动生成的角指令代理的角模块
-   `./src/lib/stencil-generated/components.ts`: stencil 自动生成的角指令代理,导入后可用作角元件
-   `./src/lib/stencil-generated/angular-component-lib/utils.ts`: 工具类,包括用于 `components.ts`

### 先决条件

运行时确定所有依赖已安装

```bash
> npm run install
```

### 正在更改 `vega-stencil`

一旦你建造 `vega-stencil` 带有命令 `npm run build`,stencil 将自动将相应的组件类填入 `./src/lib/stencil-generated/components.ts`

**记住,如果创建了新的组件,则需要修改 `./src/lib/components-module.ts` 以导入新组件**

### 开始吧

生成编译的 lib 版本用于 `vega-angular` 请跑

```bash
> ng build vega-angular
```

而建造的"自由"可以在 `./dist/vega-angular`

为了使用未发表的 lib `vega-angular` 直接针对您的角软件包, 您可以选择以下选项之一 :

1.  直接通过运行将本地软件包安装到您的角应用软件包中 :
    
    ```bash
    > npm install file:<relative path to "./dist/vega-angular">
    ```
    
2.  使用 [npm 符号链接](https://docs.npmjs.com/cli/v8/commands/npm-link) 通过运行
    
    ```bash
    > npm link
    ```
    
    **说明:** 您可能也想要为 vega- stencil 设置同义链接, 因为它是 vega- angular 的直接依赖, 这样您就可以为您的 angular app 消耗两个软件包的本地变化

### 麻烦解决

如果遇到以下错误

```bash
✖ Compiling with Angular sources in Ivy partial compilation mode.
../../projects/vega-angular/src/lib/stencil-generated/value-accessor.ts:4:1 - error NG2004: Directive ValueAccessor has no selector, please add it!

  4 @Directive({})
    ~~~~~~~~~~~~~~
  5 export class ValueAccessor implements ControlValueAccessor {
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
...
 38   }
    ~~~
 39 }
    ~
```

这是一个已知的问题 在stencil [https://github.com/ionic-team/stencil-ds-output-targets/issues/174 互联网档案馆的存檔,存档日期2014-12-12](https://github.com/ionic-team/stencil-ds-output-targets/issues/174)请添加选择器 `vega-value-accessor` 如下文所述,可解决这一问题:

```ts
@Directive({ selector: 'vega-value-accessor' })
export class ValueAccessor implements ControlValueAccessor {
    ...
}
```

### 发布软件包

请检查 [我们的维基将军](https://github.com/heartlandpayments/Vega/blob/main/readme.md#publish-package)

## 常见问题

### @globalpayments/vega-angular 是什么？

@ globalpays/vega 的角特有包装

### 如何安装 @globalpayments/vega-angular？

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

### @globalpayments/vega-angular 支持 TypeScript 吗？

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

### @globalpayments/vega-angular 支持 ESM 还是 CommonJS？

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

### @globalpayments/vega-angular 可以商用吗？

@globalpayments/vega-angular 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @globalpayments/vega-angular 的下载量有多少？

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

### @globalpayments/vega-angular 还在维护吗？

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

