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 的令牌