# @camunda/rpa-integration 中文文档

规范地址：https://npmcn.com/package/%40camunda/rpa-integration/

版本：2\.0\.0
npm 元数据更新时间：2026-10-30T15:26:22.012Z
中文译文更新时间：2026-11-09T00:49:25.161Z
软件包许可：Camunda License 1\.0

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

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

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

- 包体积（解压后）：5.7 MB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：4 个
- peer 依赖：react ^19，preact \*，react-dom ^19，@camunda/design-system \>=0\.63\.0
- 首次发布：2024-12-18T09:56:08.892Z
- 最新版本发布：2026-10-13T11:10:20.550Z
- 近 30 天下载量：15402（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 8 个）

## 中文简介

> \[!信息\] > 此存储库仍在进行中

## 安装

```sh
npm install @camunda/rpa-integration
```

也可以使用：`pnpm add @camunda/rpa-integration`、`yarn add @camunda/rpa-integration`、`bun add @camunda/rpa-integration`

## README

> \[!信息\] 此存储库仍在进行中

# @camunda/ rpa- 整合

在Camunda内部编辑和测试RPA文件的UI组件.

## 安装

```
npm install @camunda/rpa-integration
```

## 使用量

### RPA 编辑器

林瑞的出口 `RPAEditor`。这是主要入口,并创建了摩纳科 编辑 RPA 文件以及给定容器中元数据的属性面板.

编辑器还处理额外的UI组件的状态. 您可以添加一个 `workerConfig` 确定应使用哪个RPA工人实例进行测试.

```js
import { RPAEditor } from '@camunda/rpa-integration';


const editor = RPACodeEditor({
  container: editorContainer,
  propertiesPanel: {
    container: propertiesContainer
  },
  workerConfig: {
    host: 'localhost',
    port: 36227
  },
  value: `{}`
});
```

编辑会揭露一个事件Bus. 您可以监听编辑或配置更改. 以下事件被曝光

-   `model.changed`: 文件已更改
-   `config.changed`: 运行时配置已更改
-   `dialog.run.open`: 打开运行的对话框( 参见测试和配置 UI)
-   `dialog.config.open`: 打开配置对话框(参见测试和配置 UI)

### 测试和运行器配置

此外,编辑器会曝光可以用来渲染调试UI的React组件. 他们 预期 `editor` 作为道具.

这些组件是建立在 [`@camunda/design-system`](https://github.com/camunda/design-system), (中文(简体) ), 同伴依赖。 在应用程序中装入其样式一次 :

```js
import '@camunda/design-system/styles.css';
```

对话框预计将在容器中提供,并增加一个 `onSubmit` 调用。 这个 在提交表单时使用。 您可以使用这个回调关闭模式或类似元素 .

示例

```JS
import React, { useEffect, useRef, useState } from 'react';

import { RunDialog } from '@camunda/rpa-integration';

function TestButton(props) {
  const editor = props.editor;
  const eventBus = editor.eventBus;

  const [ isOpen, setIsOpen ] = useState(false);
  const buttonRef = useRef();

  useEffect(() => {
    const cb = () => {
      setIsOpen(true);
    };

    eventBus.on('dialog.run.open', cb);

    return () => {
      eventBus.off('dialog.run.open', cb);
    };
  }, [ eventBus ]);

  const onClose = () => {
    setIsOpen(false);
  };

  return <>
    <button
      ref={ buttonRef }
      onClick={ () => setIsOpen(!isOpen) }
    >
      Test RPA Script
    </button>

    { isOpen &&
        <div style={ { padding: '12px' } }>
          <RunDialog
            editor={ editor }
            onSubmit={ onClose }
          />
        </div>
    }
  </>;
}
```

## 常见问题

### @camunda/rpa-integration 是什么？

\[\!信息\] \> 此存储库仍在进行中

### 如何安装 @camunda/rpa-integration？

在项目目录运行 npm install @camunda/rpa-integration，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19）、preact（\*）、react-dom（^19）、@camunda/design-system（\>=0\.63\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @camunda/rpa-integration 支持 TypeScript 吗？

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

### @camunda/rpa-integration 支持 ESM 还是 CommonJS？

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

### @camunda/rpa-integration 可以商用吗？

@camunda/rpa-integration 使用 Camunda License 1\.0 许可。声明的许可为 Camunda License 1\.0，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @camunda/rpa-integration 的下载量有多少？

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

### @camunda/rpa-integration 还在维护吗？

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