构建可重复使用 软件包
- Updated: 2021/07/06
构建可重复使用 软件包
查看指南，了解如何建立 软件包 的可重用性。
- 了解您的传入数据
- 在设置操作 软件包 需要用户填写的字段时，请详细说明设置属性类型以限制您 软件包 收到数据的类型。
- 限制输入，以减少收到包时必须完成的检查的负担。
- Javadoc 包括 34 个定义的属性类型，因此请在构建 软件包 时查看这些属性类型，以选择适当的字段类型。
- 设置 软件包，使其取一个存储值。 例如，软件包 正在代表 机器人 执行 API 调用，请验证 API 密钥或令牌的操作输入字段的 AttributeType 已设置为凭据。 这样，鼓励用户使用存储在 凭据保管库 中的值来获得 软件包 所需的敏感输入数据。
- 妥善使用标签
- 在 CommandPkg 注释中，妥善使用不同的标签、node_label 和相应的描述。
- 使用这些标签作为行动的简短描述，仅使用几个词语来描述行动。
- 复制与默认操作 软件包 中显示相同的命名样式。
- 每个操作都是 软件包 的子元素，并且操作标签与操作窗格中的 软件包 图标一起显示。 使用简称来描述每个操作。
- 记录特定字段的预期输入格式。 对 @Pkg 注释使用参数描述。 这允许 软件包 开发人员查看特定输入字段必须使用的格式、要求或数据。 例如：
@Pkg(label = "开始日期", description="日期格式为 MM/DD/YYYY"
- 单元测试您的组件
- 在 软件包 开发期间，创建单元测试以验证 软件包 的每个组件和操作是否按预期工作。
- 验证单个测试单元、单个类或单个操作的行为，以确保其按预期运行。
- 在开发流程的早期阶段审查并记录任何特性或功能缺陷。
- 错误处理
- 在 机器人 逻辑中包含错误处理，以确保所有错误都得到妥善处理。 如果未处理错误，可能会阻止 机器人 运行程序执行其他任务。
- 创建有意义的错误消息，以帮助 机器人 使用者解决错误。
- 作为 软件包 开发人员，请记住以下建议：
- 使用 Try/Catch 块以容纳错误。
- 使用多捕捉块查找特定错误，并使用 BotCommandException 返回自定义错误消息。 例如：
//create array of 3 items int[] myIntArray = new int[]{1, 0, 7}; try { //print 4th item in array System.out.println(myIntArray[3]); //Perform operation on first and second items in array int result = myIntArray[0] / myIntArray[1]; } catch (ArrayIndexOutOfBoundsException e) { //Throw custom message for IndexOutofBounds throw new BotCommandException("The array does have the number of expected items."); } catch (ArithmeticException e) { //Throw custom message on Atithmetic Exception throw new BotCommandException("Math Operation Error with " + Integer.toString(myIntArray[0]) + " and " + Integer.toString(myIntArray[1])); }
- 单一责任原则
-
软件包 是一系列操作。 在 软件包 中，每个操作都必须有单一的责任，并且该行动必须涵盖该责任。
- 遵循单一责任原则有助于您的 软件包 使用者轻松实施，简化测试，并避免不必要的修改。
- 您提供的操作使 软件包 使用者能够自定义他们在其 机器人 内使用 软件包 的方式，并帮助他们的 机器人 尽可能地高效。
- 提供示例
- 提交 软件包 到 Bot Store 时，包括演示 机器人，演示如何使用 软件包。
- 使用 Automation 360 操作并允许 软件包 使用者使用这些操作来履行他们的 机器人 功能。
- 务必提供示例 机器人 和描述，以帮助 软件包 使用者了解正确使用所需的知识。