{"id":11377,"date":"2015-08-07T11:12:23","date_gmt":"2015-08-07T09:12:23","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=11377"},"modified":"2016-02-03T17:18:16","modified_gmt":"2016-02-03T16:18:16","slug":"come-utilizzare-oclint-e-valutare-la-qualita-del-codice-sorgente","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/come-utilizzare-oclint-e-valutare-la-qualita-del-codice-sorgente\/","title":{"rendered":"Come utilizzare OCLint e “valutare” la qualit\u00e0 del codice sorgente"},"content":{"rendered":"

Si pu\u00f2 dimostrare la qualit\u00e0 oggettiva di un codice sorgente? Quando penso a questa domanda non posso fare a meno di associarla alla scena de “L’attimo Fuggente” (qui:\u00a0https:\/\/www.youtube.com\/watch?v=s81k8faP_6o<\/a>) nel quale viene citato (e condannato) un metodo\u00a0scientifico<\/em> e\u00a0matematico<\/em> per valutare la qualit\u00e0 di una poesia.<\/p>\n

Allo stesso modo gli sviluppatori hanno definito delle metriche il cui scopo \u00e8 definire,\u00a0in maniera formale,\u00a0quando una porzione di codice \u00e8 migliore di un’altra. \u00a0La cosa divertente \u00e8 che ovviamente non c’\u00e8 nulla di formale in queste metriche, per cui dibattiti e controversie sono lontane dall’essere risolte. C’\u00e8 chi \u00e8 convinto che una code-coverage<\/em> del 99% sia migliore di una del 60%, c’\u00e8 chi crede che una classe da 50 righe sia per forza migliore di una da 100.. ma c’\u00e8 anche chi \u00e8 religiosamente convinto del contrario.<\/p>\n

La mia personale opinione \u00e8 che l’unica valida misura della qualit\u00e0 del codice sorgente sia questa:<\/p>\n

\"code_review\"<\/a><\/p>\n

Esistono per\u00f2 casi in cui tenere sotto controllo la qualit\u00e0 generale del codice sorgente \u00e8 utile e doveroso, specialmente quando il team inizia a diventare grande, in questo caso ci facciamo aiutare da tool come OCLint<\/strong>.<\/p>\n

OCLint (qui:\u00a0http:\/\/oclint.org<\/a>) \u00e8 un tool molto potente e versatile per l’analisi di codice C, C++ e Objective-C<\/strong>.<\/p>\n

Il modo pi\u00f9 semplice per utilizzarlo \u00e8 per\u00f2 insieme ad un altro tool: xctool<\/a>, iniziamo quindi con l’installazione di quest’ultimo.<\/p>\n

 <\/p>\n

XCTool<\/h3>\n

XCTool \u00e8 un wrapper per xcodebuild\u00a0che serve\u00a0per compilare progetti Xcode via command line veramente utile e versatile. Potete installare XCTool sia tramite HomeBrew sia scaricando direttamente il progetto da github. Io ho preferito questa seconda soluzione perch\u00e9 mi da la possibilit\u00e0 di utilizzare la versione 0.2.4 mentre su homebrew siamo fermi alla 0.2.3<\/p>\n

Una volta scaricato il progetto github per utilizzarlo baster\u00e0 invocare il comando:<\/p>\n

<path>\/xctool\/xctool.sh<\/pre>\n
Scaricate anche questo progetto Xcode di esempio<\/a> e provate a compilarlo con XCTool digitando:<\/p>\n
\/<path>\/xctool\/xctool.sh -project \"LearnOCLint.xcodeproj\" -scheme \"LearnOCLint\" build<\/pre>\n
Il risultato dovrebbe essere simile a questo:<\/p>\n
\"Screenshot<\/a><\/p>\n
XCTool pu\u00f2 generare un report in formato json che pu\u00f2 essere poi interpretato da OCLint, basta specificarlo tramite l’apposito parametro:<\/p>\n
\/<path>\/xctool\/xctool.sh -project \"LearnOCLint.xcodeproj\" -scheme \"LearnOCLint\" -reporter json-compilation-database:compile_commands.json clean build<\/pre>\n
In questo caso al termine della compilazione dovreste trovare il file compile_commands.json<\/em> direttamente nella root del progetto.<\/p>\n
Da notare che ho anche aggiunto il comando “clean”, altrimenti il file json sar\u00e0 vuoto.<\/p>\n
OCLint<\/h3>\n
Anche in questo caso decidete voi come meglio installare questo tool, io ho preferito scaricare i binari dal sito e procedere all’installazione manuale. Trovate tutte le info qui:\u00a0http:\/\/docs.oclint.org\/en\/dev\/intro\/installation.html<\/a><\/p>\n
Per eseguire finalmente l’analisi digitate questo comando:<\/p>\n
oclint-json-compilation-database -v oclint_args \"-report-type html -o report.html -rc=LONG_LINE=120\"; open report.html<\/pre>\n