長期以來,SAP提供的標准ABAP開發工具是我們對代碼進行檢查的唯一方式。這意味着我們只能對ABAP服務器上的ABAP代碼做出分析,而離線代碼則成為了純粹的文本,開發者無法對其進行檢查。abaplint的出現改變了這一點,它可以在一定程度上“理解”代碼,幫助我們解決一些問題,和SAP的標准工具形成有效的互補。本文會介紹ABAP開發相關的工具abaplint以及它在開發過程中的應用。
本文鏈接:https://www.cnblogs.com/hhelibeb/p/12166288.html
原創內容,轉載請注明
基本介紹
lint或linter是一種靜態分析工具,可以分析並標記代碼中的錯誤、bug、可疑結構。 abaplint是ABAP語言的linter,它基於typescript,可以在多種平台工作,作者是Lars Hvam(同時也是abapGit的作者)。
項目地址:https://github.com/abaplint/abaplint
和Code Inspector等其它靜態分析工具類似,abaplint可以做到幫助我們找到有問題的代碼、確保統一的代碼風格等事情。
應用
在編輯器中的應用
以Visual Studio Code中的abaplint插件為例,它可以分析出代碼中的錯誤,如下圖,abaplint找出了短短一段代碼中的10個問題。
鼠標划過報錯內容時,編輯器也會給出具體提示,如下圖,(上面的黑色主題的提示框邊界不是很明顯,為了讓讀者看清楚提示框,這里主題顏色使用了Solarized Light)
在持續集成(CI)中的應用
在編輯器中使用abaplint對代碼進行實時檢查是一種典型的應用方式,還有一種應用方式是通過abaplint對代碼進行自動檢查,它可以是持續集成中的一個場景。
比如,如果以Github作為代碼托管平台,可以安裝Github的abaplint應用(https://github.com/apps/abaplint),配置需要檢查的repo后,每當對相應的repo發起pr或push,都會有自動的代碼檢查,Github也會顯示檢查結果。(類似SAP系統中的傳輸前檢查CTS_REQUEST_CHECK)
下圖是我的配置,
進行一次commit之后,可以看到abaplint給出了26處問題和問題所在的代碼位置。
此外,也可以使用Travis CI或Gitlab的CI來執行abaplint的自動檢查。具體可以參考該文:《Automatic checking of your ABAP code in Github/Gitlab with CI and abaplint》
應用范圍
abaplint支持多種代碼編輯器和代碼托管平台,列表如下,
- VS Code (source)
- GitHub App
- GitHub Actions
- GitLab Pipelines
- Bitbucket Pipelines
- Azure Pipelines
- Travis CI
- Atom (待實現, source)
- Code Climate Engine, 待實現
- ABAP in Eclipse, (待實現, source)
配置
abaplint支持很多檢查規則(並且在持續地更新中),可以通過abaplint.json文件來控制各個檢查規則的啟用與關閉、設置某些具體的檢查參數。
abaplint-clean-code項目中包含了這些規則的介紹,和配置文件示例。第一次使用abaplint的用戶可以以該項目中的配置文件示例作為模板,按照自己的需要,結合規則介紹進行修改。
關於規則介紹部分,它不僅給出了規則的效果,也參考sap的style guides給出了規則存在的具體原因。
以其中一個設置為例,
"method_length": { "statements": 25, "ignoreTestClasses": false, "errorWhenEmpty": true, "reason": "https://github.com/SAP/styleguides/blob/master/clean-abap/CleanABAP.md#keep-methods-small" },
method_length是方法長度的配置項;statements的數量決定了方法的最大行數;ignoreTestClasses,忽略測試類,
errorWhenEmpty,對不含代碼的空方法報錯;reason,該設置的原因。
(個人認為25有點小,有時候容易導致淺模塊)
相關網站
abaplint項目下還有一些實用網站,這里介紹幾個我了解的。
playground.abaplint.org
一個在線編輯器,包含一個可編輯的report程序和一個可編輯的配置文件abaplint.json,可以通過它試驗abaplint的效果。
syntax.abaplint.org
一個ABAP的語法圖網站,如下,
如果你不了解語法圖,可以看這篇文章,或查找其它資料。
stats.abaplint.org
對一些開源項目的統計,包含項目的對象數量、文件數量、語句數量、方法長度、語句兼容性、對象類型、行數趨勢等信息的統計。可以幫助開源開發者分析自己的項目。效果如下圖:
abaplint的意義
abaplint目前的流行度似乎還不是很高(當前有62 star, 24 fork, 在abap標簽下分別排名第8和第10)。但我相信它是一個很有意義ABAP開源項目,未來可能會對ABAP的生態產生深遠影響。
ABAP開發者一直以來都在SAP ABAP服務器上進行開發工作,代碼的分析、測試完全在ABAP服務器上進行。復雜而笨重的SAP系統不是到處都有的,而且這些系統大多是孤立的。這意味着,開發內容的分享十分不方便。雖然理論上可以通過SAP系統工具對開發對象進行導入導出、代碼分析等工作,但在本質上,它們通常是為了一個組織內部的分享而存在的。當一個素不相識的人在github發布了一個新的開源項目時,其它人無法得知這個項目曾經在ABAP服務器上進行過怎樣的檢查,這會影響信任的構建。abaplint獨立實現了原本只能在ABAP服務器上進行的檢查,如果一個項目的每次commit包含abaplint的檢查結果,每個方法都有完整的單元測試,那么人們對這個項目的信心將大大增加。信心的增加會促使人們將更多資源投入到開源項目中,從而促進社區的成長。