Activiti

活动

主页：http://activiti.org

Activiti 是一个轻量级工作流程和业务流程管理 (BPM) 平台，面向业务人员、开发人员和系统管理员。其核心是一个超快且坚如磐石的 Java BPMN 2 流程引擎。它是开源的，并根据 Apache 许可证分发。 Activiti 可以在任何 Java 应用程序、服务器、集群或云中运行。它与 Spring 完美集成，非常轻量级并且基于简单的概念。

* *注意：我们将用于设计和编码项目的下一个主要版本的开发分支的所有内容移至主分支。如果您想为 6.x 版本做出贡献，请查看 6.x 分支。**

如果您想了解有关我们的存储库结构的更多信息，您可以阅读我们的 GitBook。

配置 IntelliJ

• 强制语言级别 21，在（意外）使用仅在较新的 Java 版本中提供的功能时快速失败。

  • 打开菜单File ，菜单项Project Structure
  • 单击列表项Modules ，对于每个模块，选项卡Sources 、组合框Language level应自动设置为21 ...

• 避免在下次运行/调试时忽略某些资源的更改（并且您被迫使用 mvn）

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项Compiler ，文本字段Resource Pattern ：更改为!?*.java （删除其他内容）

• 构建时避免StackOverflowError

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项Compiler 、树项Java Compiler 、文本字段其他命令行参数
  • 添加-J-Xss1024k

• 推荐的代码风格：使用 Google Java 风格指南和 editorconfig

  • 从以下位置下载 IntelliJ 代码样式 xml：[https://google.github.io/styleguide/intellij-java-google-style.xml]
  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项“代码样式” ，单击“齿轮”并选择“导入方案” ，然后选择“IntelliJ 代码样式 xml”
  • 浏览您下载 xml 的位置并将其打开。检查 GoogleStyle 是否为活动方案。
    • 注意：IntelliJ IDEA 不会自动格式化您的代码。编码完成后，您必须按 Ctrl+Alt+L 键盘组合来触发自动格式化。
  • 有一个.editorconfig定义了缩进、文件编码、行结尾。
  • 如果禁用它，则需要手动正确设置文件编码和空格数。
  • Eclipse 代码样式 xml：[https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • Eclipse 需要 editorconfig-eclipse 插件才能支持 EditorConfig 文件。

• 手动设置正确的文件编码（UTF-8，属性文件除外）和行尾字符 (unix)：

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项代码样式，树项常规
    • 组合框行分隔符（用于新文件） ： Unix
  • 单击树项文件编码
    • 组合框全局编码： UTF-8
    • 组合框属性文件的默认编码： ISO-8859-1
      • 注意：正常的 i18n 属性文件必须采用 java ResourceBundle合约指定的ISO-8859-1格式。

• 按 T​​ab 时手动设置正确的空格数：

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项代码样式，树项常规
  • 单击Java选项卡
    • 复选框使用制表符： off
    • 文本字段选项卡大小： 4
    • 文本字段缩进： 4
    • 文本字段连续缩进： 8
  • 打开选项卡XML
    • 复选框使用制表符： off
    • 文本字段选项卡大小： 2
    • 文本字段缩进： 2
    • 文本字段连续缩进： 4

• 设置正确的文件头（不要包含@author或无意义的javadoc）：

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项“文件模板” 、选项卡“包括” 、列表项“ File Header
  • 删除行@author Your Name 。
    • 我们不接受源文件中的@author行，请参阅下面的常见问题解答。
  • 删除整个 javadoc，因为自动模板化数据毫无意义。

• 设置正确的许可证头

  • 打开菜单File 、菜单项Settings或菜单IntelliJ IDEA 、菜单项Preferences... （如果在 Mac 上）
  • 单击树项目版权，树项目版权配置文件
    • 单击导入按钮导入版权配置文件
    • 选择文件：Alfresco_Software.xml
  • 单击树项目版权
    • Combobox默认项目版权： Alfresco Software

常问问题

• 为什么你的源代码中不接受@author行？

  • 因为 java 文件中的作者标签是维护的噩梦

    • 很大一部分是错误的、不完整的或不准确的。
    • 大多数时候，它只包含原作者。许多文件已被其他作者完全重构/扩展。
    • Git 是准确的，这是找到正确作者的规范来源。

  • 因为作者标签促进了代码所有权，从长远来看这是不好的。

    • 如果人们创作一件他们认为属于别人所有的作品，他们往往会：
      • 只修复他们被分配要修复的内容，而不是所有损坏的内容
      • 如果该代码无法正常工作，则放弃责任
      • 害怕踩到主人的脚。

  • 致谢作者：

    • 与 Open Hub 一起也有统计数据
    • 在 GitHub Web 界面中。

开发命令

添加许可证标头

要使用所需的许可证格式化文件：

mvn license:format

格子风格

要检查您的代码风格是否遵守所有规则：

mvn checkstyle:check -DskipCheckstyle=false

地点

生成 Maven 站点：

mvn clean site site:stage

该网站将在以下位置生成： target/staging/index.html

持续集成/持续交付

在 GH Actions 上运行。

对于要由 CI 验证的 Dependabot PR，应将标签“CI”添加到 PR 中。

需要设置以下秘密：

姓名	描述
BOT_GITHUB_TOKEN	用于在 GH 上启动其他版本的代币
BOT_GITHUB_USERNAME	发布传播 PR 的用户名
NEXUS_USERNAME	内部 Maven 存储库用户名
NEXUS_PASSWORD	内部 Maven 存储库密码
SLACK_NOTIFICATION_BOT_TOKEN	用于在失败时通知 slack 的令牌