DLL 软件包
- Updated: 2024/10/16
DLL 软件包
动态链接库 (DLL) 文件包含 Windows 程序可以使用的共享函数库。 DLL 软件包 使用 .dll 文件作为参考，并从 机器人 调用函数。
开始之前
在 DLL
软件包 中执行以下 操作，作为使用可用 操作 的一部分：
注：
- 由于 AutomationAnywhere.ManagedDLLWrapper.exe 使用 32 位库，因此支持 32 位 DLL 函数。
- 如果您使用自定义 DLL 创建 机器人，并且该自定义 DLL 依赖于 Apache log4net 库，那么我们建议使用：
- 自定义 DLL 中的 log4net 版本2.0.11 或更高版本。
- 即使 Bot Agent 更新是可选的，也要更新 Bot Agent（版本 21.210 或更高版本）。
- 仅支持使用 Microsoft .NET Framework 构建的 DLL。
- 运行 DLL 软件包 兼容以下版本的 Microsoft .NET： 4.6、4.7 和 4.8。
- 当您创建一个 机器人 并在循环中使用本地会话时，请确保在 机器人 中使用关闭会话 操作。 如果您不使用关闭会话命令，本地会话将在循环的每次迭代中打开 AutomationAnywhere.ManagedDLLWrapper.exe。 因此，您将耗尽内存空间，机器人 将会失败。
重要信息： 如果在父级 机器人 和子级 机器人 中使用不同版本的 DLL 软件包，当前将不支持在 机器人 之间共享会话的功能。 要在父级和子级 机器人 之间共享会话，请确保在父级和子级 机器人 中使用相同版本的软件包。
- 使用打开
操作 可指定要使用的 .dll 文件的位置和会话名称。 对其他 操作 使用此相同会话名称。 引用的
.dll自动添加为 机器人 依赖项。 - 使用运行函数 操作从.dll运行函数，并将其输出值保存为变量。
- 运行所需函数后，关闭 .dll 引用。 务必关闭 .dll 引用，以释放操作系统的内存。
Windows 和 Microsoft .NET Framework 的相应版本在运行 DLL 的设备上可用。
要查看 机器人 启动器日志，请导航到 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<current month>\Bot_Launcher-<today's date>.log.zip。 每个压缩的文件夹包含一个包含代码执行数据的文件，这对于调试很有用。
当您导入多个 DLL（其中一个主要 DLL 并从中引用其他 DLL）时，请确保在一个文件夹中包含所有 DLL。 此外，必须使用与主 DLL 中使用的名称不同的会话名称来调用引用的 DLL。 如果在主 DLL 和引用 DLL 中使用相同的会话名称，则 机器人 执行将失败。
操作 在 DLL 中 软件包
The DLL 软件包 包括以下操作:
| 操作 | 描述 |
|---|---|
| 关闭 |
请参阅 关闭 操作 |
| 打开 |
请参阅 打开 操作 |
| 运行函数 | 请参阅 使用 Run 函数 操作。 |
DLL 函数中支持的数据类型
下表列出了可在 DLL 函数中用作输入或输出参数的变量和数据类型。
注：
运行函数
操作 不支持参数到函数或将输出分配到变量字段中的任何用户定义的数据类型。
| 变量类型作为输入或输出参数 | .NET 中受支持的数据类型 |
|---|---|
| 字符串 |
|
| 数字 |
|
| 布尔值 |
|
| 日期时间 |
|
| 列表 |
注： C# IList 数据类型不受支持，并且无法与 Automation 360 List 数据类型一起使用。
|
| 表 |
注：
表格 类型变量相当于 .NET 中的二维数组类型变量。
|
| 字典 |
注： 在创建 .Net DLL 函数时，使用 IDictionary 数据类型代替 Dictionary 数据类型。
|